FileUtil
public class FileUtil
extends Object
java.lang.Objeto | |
↳ | com.android.tradefed.util.FileUtil |
Una clase auxiliar para operaciones relacionadas con archivos.
Resumen
Clases anidadas | |
---|---|
class | FileUtil.LowDiskSpaceException Se lanza si el espacio en disco utilizable está por debajo del umbral mínimo. |
constantes | |
---|---|
int | FILESYSTEM_FILENAME_MAX_LENGTH
|
Constructores públicos | |
---|---|
FileUtil () |
Métodos públicos | |
---|---|
static String | calculateBase64Md5 (File file) Método auxiliar para calcular base64 md5 para un archivo. |
static long | calculateCrc32 (File file) Método auxiliar para calcular CRC-32 para un archivo. |
static String | calculateMd5 (File file) Método auxiliar para calcular md5 para un archivo. |
static boolean | chmod (File file, String perms) |
static boolean | chmodGroupRW (File file) Realiza un mejor esfuerzo para hacer que el grupo de archivos dado sea legible y escribible. |
static boolean | chmodGroupRWX (File file) Realiza un mejor esfuerzo para hacer que el grupo de archivos sea ejecutable, legible y escribible. |
static boolean | chmodRWXRecursively (File file) |
static void | closeZip (ZipFile zipFile) Este método está en desuso. Movido a |
static | collectJars (File dir) Devuelve todos los archivos jar que se encuentran en el directorio dado |
static boolean | compareFileContents (File file1, File file2) Método de utilidad para realizar una comparación de contenido por bytes de dos archivos. |
static long | convertSizeToBytes (String sizeString) El inverso de |
static IOException | convertToDiskSpaceIfNeeded (IOException e) Envuelve el error en un error de espacio en disco si es necesario. |
static String | convertToReadableSize (long sizeLong) Convierta el tamaño de archivo dado en bytes a un formato más legible en formato XY [KMGT]. |
static void | copyFile (File origFile, File destFile) Un método auxiliar que copia el contenido de un archivo en un archivo local |
static File | createNamedTempDir (File parentDir, String name) Función auxiliar para crear un directorio con nombre dentro de una carpeta. |
static File | createNamedTempDir (String name) Función auxiliar para crear un directorio con nombre dentro de su carpeta temporal. |
static File | createTempDir (String prefix) Función auxiliar para crear un directorio temporal en el directorio de archivos temporales predeterminado del sistema. |
static File | createTempDir (String prefix, File parentDir) Función auxiliar para crear un directorio temporal. |
static File | createTempFile (String prefix, String suffix, File parentDir) Función de contenedor auxiliar alrededor |
static File | createTempFile (String prefix, String suffix) Función de contenedor auxiliar alrededor |
static File | createTempFileForRemote (String remoteFilePath, File parentDir) Método auxiliar que construye un archivo único en un disco temporal, cuyo nombre se corresponde lo más posible con el nombre de archivo dado por la ruta del archivo remoto |
static File | createZip (File dir) Este método está en desuso. Movido a |
static void | createZip (File dir, File zipFile) Este método está en desuso. Movido a |
static void | deleteFile (File file) Intente eliminar un archivo. |
static File | extractFileFromZip (ZipFile zipFile, String filePath) Este método está en desuso. Movido a |
static void | extractZip (ZipFile zipFile, File destDir) Este método está en desuso. Movido a |
static File | findDirectory (String dirName, File... dirs) Busque y devuelva el primer directorio |
static | findDirsUnder (File rootDir, File relativeParent) Encuentre recursivamente todos los directorios bajo el |
static File | findFile (String fileName, IAbi abi, File... dirs) Obtenga todas las rutas de archivo de los archivos en el directorio dado con un nombre que coincida con el filtro dado y también filtre el archivo encontrado por abi arch si abi no es nulo. |
static File | findFile (File dir, String fileName) Busque recursivamente en el directorio dado el primer archivo con el nombre dado |
static | findFiles (String fileName, IAbi abi, boolean includeDirectory, File... dirs) Obtenga todos los archivos en el directorio dado con un nombre que coincida con el filtro dado y también filtre los archivos encontrados por abi arch si abi no es nulo. |
static | findFiles (File dir, String filter) Obtenga todas las rutas de archivo de los archivos en el directorio dado con un nombre que coincida con el filtro dado |
static | findFilesObject (File dir, String filter) Obtenga todas las rutas de archivo de los archivos en el directorio dado con un nombre que coincida con el filtro dado |
static | findFilesObject (File dir, String filter, boolean includeDirectory) Obtenga todas las rutas de archivo de los archivos en el directorio dado con un nombre que coincida con el filtro dado |
static String | getBaseName (String fileName) Obtiene el nombre base, sin extensión, del nombre de archivo dado. |
static String | getContentType (String filePath) Obtenga el tipo de contenido del archivo según su extensión. |
static String | getExtension (String fileName) Obtiene la extensión para el nombre de archivo dado. |
static File | getFileForPath (File parentDir, String... pathSegments) Método auxiliar para crear un archivo dependiente del sistema |
static String | getPath (String... pathSegments) Método auxiliar para crear una ruta relativa dependiente del sistema |
static void | gzipFile (File file, File gzipFile) Este método está en desuso. Movido a |
static void | hardlinkFile (File origFile, File destFile) Un método auxiliar que vincula un archivo a otro archivo. |
static void | hardlinkFile (File origFile, File destFile, boolean ignoreExistingFile) Un método auxiliar que vincula un archivo a otro archivo. |
static boolean | isDiskSpaceError (String message) Devuelve verdadero si el mensaje es un error de espacio en disco. |
static boolean | mkdirsRWX (File file) Método para crear una cadena de directorios y configurarlos para que se ejecuten/lean/escriban en grupo a medida que se crean, llamando a |
static String | readStringFromFile (File sourceFile, long startOffset, long length) Un método auxiliar para leer datos de cadenas parciales de un archivo |
static String | readStringFromFile (File sourceFile) Un método auxiliar para leer datos de cadena de un archivo |
static void | recursiveCopy (File sourceDir, File destDir) Copia recursivamente el contenido de la carpeta. |
static void | recursiveDelete (File rootDir) Elimine recursivamente un archivo o directorio dado y todo su contenido. |
static void | recursiveHardlink (File sourceDir, File destDir) Contenido de la carpeta de enlace permanente recursivamente. |
static void | recursiveHardlink (File sourceDir, File destDir, boolean ignoreExistingFile, copyInsteadofHardlink) recursiveHardlink (File sourceDir, File destDir, boolean ignoreExistingFile, copyInsteadofHardlink) Contenido de la carpeta de enlace permanente recursivamente. |
static void | recursiveHardlink (File sourceDir, File destDir, boolean ignoreExistingFile) Contenido de la carpeta de enlace permanente recursivamente. |
static void | recursiveSymlink (File sourceDir, File destDir) Contenido de la carpeta de enlace simbólico recursivamente. |
static File | saveResourceFile (InputStream resourceStream, File destDir, String targetFileName) Guarde un archivo de recursos en un directorio. |
static void | setReadableRecursive (File file) Establezca recursivamente los permisos de lectura y ejecución (si es una carpeta) para un archivo determinado. |
static Long | sizeOfDirectory (File directory) Devuelve el tamaño informado por el directorio. |
static void | symlinkFile (File origFile, File destFile) Un método auxiliar que vincula un archivo a otro archivo |
static | unixModeToPosix (int mode) Convierte un número entero que representa el modo Unix en un conjunto de |
static void | writeToFile (String inputString, File destFile, boolean append) Un método auxiliar para escribir o agregar datos de cadena al archivo |
static void | writeToFile (String inputString, File destFile) Un método auxiliar para escribir datos de cadena en un archivo |
static void | writeToFile (InputStream input, File destFile, boolean append, long startOffset, long size) Un método auxiliar para escribir datos de transmisión en un archivo |
static void | writeToFile (InputStream input, File destFile) Un método auxiliar para escribir datos de transmisión en un archivo |
static void | writeToFile (InputStream input, File destFile, boolean append) Un método auxiliar para escribir datos de transmisión en un archivo |
Métodos protegidos | |
---|---|
static boolean | chmodExists () Asistente interno para determinar si 'chmod' está disponible en el sistema operativo. |
static void | setChmodBinary (String chmodName) Expuesto para la prueba. |
constantes
FILESYSTEM_FILENAME_MAX_LENGTH
public static final int FILESYSTEM_FILENAME_MAX_LENGTH
Valor constante: 255 (0x000000ff)
Constructores públicos
FileUtil
public FileUtil ()
Métodos públicos
calcularBase64Md5
public static String calculateBase64Md5 (File file)
Método auxiliar para calcular base64 md5 para un archivo.
Devoluciones | |
---|---|
String | md5 del archivo |
calcularCrc32
public static long calculateCrc32 (File file)
Método auxiliar para calcular CRC-32 para un archivo.
Devoluciones | |
---|---|
long | CRC-32 del expediente |
Lanza | |
---|---|
| IOException |
calcularMd5
public static String calculateMd5 (File file)
Método auxiliar para calcular md5 para un archivo.
Devoluciones | |
---|---|
String | md5 del archivo |
chmod
public static boolean chmod (File file, String perms)
Parámetros | |
---|---|
file | File |
perms | String |
Devoluciones | |
---|---|
boolean |
chmodGroupRW
public static boolean chmodGroupRW (File file)
Realiza un mejor esfuerzo para hacer que el grupo de archivos dado sea legible y escribible.
Tenga en cuenta que se requiere el permiso de ejecución para que los directorios sean accesibles. VerchmodGroupRWX(File)
. Si el sistema operativo subyacente no admite el comando del sistema 'chmod', configurará el archivo para que todos puedan escribirlo.Parámetros | |
---|---|
file | File : el ERROR(/File) para hacer que el propietario y el grupo puedan escribir |
Devoluciones | |
---|---|
boolean | true si el archivo se convirtió correctamente en grupo escribible, false de lo contrario |
chmodGroupRWX
public static boolean chmodGroupRWX (File file)
Realiza un mejor esfuerzo para hacer que el grupo de archivos sea ejecutable, legible y escribible.
Si el sistema operativo subyacente no admite el comando del sistema 'chmod', intentará establecer permisos para todos los usuarios.Parámetros | |
---|---|
file | File : el ERROR(/File) para hacer que el propietario y el grupo puedan escribir |
Devoluciones | |
---|---|
boolean | true si los permisos se establecieron con éxito, false de lo contrario |
chmodRWXRecursivamente
public static boolean chmodRWXRecursively (File file)
Parámetros | |
---|---|
file | File |
Devoluciones | |
---|---|
boolean |
closeZip
public static void closeZip (ZipFile zipFile)
Este método está en desuso.
Movido a ZipUtil#closeZip(ZipFile)
.
Cierra un ERROR(/ZipFile)
abierto, ignorando cualquier excepción.
Parámetros | |
---|---|
zipFile | ZipFile : el archivo para cerrar |
coleccionarfrascos
public staticcollectJars (File dir)
Devuelve todos los archivos jar que se encuentran en el directorio dado
Parámetros | |
---|---|
dir | File |
Devoluciones | |
---|---|
compararFileContents
public static boolean compareFileContents (File file1, File file2)
Método de utilidad para realizar una comparación de contenido por bytes de dos archivos.
Parámetros | |
---|---|
file1 | File |
file2 | File |
Devoluciones | |
---|---|
boolean | true si el contenido del archivo es idéntico |
convertSizeToBytes
public static long convertSizeToBytes (String sizeString)
El inverso de convertToReadableSize(long)
. Convierte el formato legible descrito en convertToReadableSize(long)
en un valor de byte.
Parámetros | |
---|---|
sizeString | String : la descripción de cadena del tamaño. |
Devoluciones | |
---|---|
long | el tamaño en bytes |
Lanza | |
---|---|
IllegalArgumentException | si no puede reconocer el tamaño |
convertToDiskSpaceIfNeeded
public static IOException convertToDiskSpaceIfNeeded (IOException e)
Envuelve el error en un error de espacio en disco si es necesario.
Parámetros | |
---|---|
e | IOException |
Devoluciones | |
---|---|
IOException |
convertToReadableSize
public static String convertToReadableSize (long sizeLong)
Convierta el tamaño de archivo dado en bytes a un formato más legible en formato XY [KMGT].
Parámetros | |
---|---|
sizeLong | long : tamaño del archivo en bytes |
Devoluciones | |
---|---|
String | cadena descriptiva del tamaño del archivo |
copiar archivo
public static void copyFile (File origFile, File destFile)
Un método auxiliar que copia el contenido de un archivo en un archivo local
Parámetros | |
---|---|
origFile | File : el archivo original que se va a copiar |
destFile | File : el archivo de destino |
Lanza | |
---|---|
| si no se pudo copiar el archivo |
createNamedTempDir
public static File createNamedTempDir (File parentDir, String name)
Función auxiliar para crear un directorio con nombre dentro de una carpeta.
Este directorio no tendrá su nombre aleatorio. Si el directorio ya existe, se devolverá.
Parámetros | |
---|---|
parentDir | File : el directorio donde crear el dir. Si es nulo, estará en /tmp |
name | String : el nombre del directorio para crear en la carpeta principal |
Devoluciones | |
---|---|
File | el directorio creado |
createNamedTempDir
public static File createNamedTempDir (String name)
Función auxiliar para crear un directorio con nombre dentro de su carpeta temporal.
Este directorio no tendrá su nombre aleatorio. Si el directorio ya existe, se devolverá.Parámetros | |
---|---|
name | String : el nombre del directorio para crear en su carpeta tmp. |
Devoluciones | |
---|---|
File | el directorio creado |
crearTempDir
public static File createTempDir (String prefix)
Función auxiliar para crear un directorio temporal en el directorio de archivos temporales predeterminado del sistema.
Parámetros | |
---|---|
prefix | String : la cadena de prefijo que se utilizará para generar el nombre del archivo; debe tener al menos tres caracteres |
Devoluciones | |
---|---|
File | el directorio creado |
Lanza | |
---|---|
| si no se pudo crear el archivo |
crearTempDir
public static File createTempDir (String prefix, File parentDir)
Función auxiliar para crear un directorio temporal.
Parámetros | |
---|---|
prefix | String : la cadena de prefijo que se utilizará para generar el nombre del archivo; debe tener al menos tres caracteres |
parentDir | File : el directorio principal en el que se creará el directorio. Si es null se utilizará el directorio temporal predeterminado del sistema. |
Devoluciones | |
---|---|
File | el directorio creado |
Lanza | |
---|---|
| si no se pudo crear el archivo |
crearTempFile
public static File createTempFile (String prefix, String suffix, File parentDir)
Función de contenedor auxiliar alrededor ERROR(/File#createTempFile(String, String, File))
que audita el posible escenario de falta de espacio en disco.
Parámetros | |
---|---|
prefix | String |
suffix | String |
parentDir | File |
Devoluciones | |
---|---|
File |
Lanza | |
---|---|
FileUtil.LowDiskSpaceException | si el espacio en disco en la partición es inferior al mínimo permitido |
Ver también:
crearTempFile
public static File createTempFile (String prefix, String suffix)
Función de contenedor auxiliar alrededor ERROR(/File#createTempFile(String, String))
que audita el posible escenario de falta de espacio en disco.
Parámetros | |
---|---|
prefix | String |
suffix | String |
Devoluciones | |
---|---|
File |
Lanza | |
---|---|
FileUtil.LowDiskSpaceException | si el espacio en disco en la partición temporal es inferior al mínimo permitido |
Ver también:
crearTempFileForRemote
public static File createTempFileForRemote (String remoteFilePath, File parentDir)
Método auxiliar que construye un archivo único en un disco temporal, cuyo nombre se corresponde lo más posible con el nombre de archivo dado por la ruta del archivo remoto
Parámetros | |
---|---|
remoteFilePath | String : la ruta remota separada por '/' para construir el nombre a partir de |
parentDir | File : el directorio principal para crear el archivo. null para usar el directorio temporal predeterminado |
Devoluciones | |
---|---|
File |
crearZip
public static File createZip (File dir)
Este método está en desuso.
Movido a ZipUtil#createZip(File)
.
Método de utilidad para crear un archivo zip temporal que contiene el directorio dado y todo su contenido.
Parámetros | |
---|---|
dir | File : el directorio para comprimir |
Devoluciones | |
---|---|
File | un ERROR(/File) que contiene el contenido del directorio |
Lanza | |
---|---|
| si no se pudo crear el archivo zip |
crearZip
public static void createZip (File dir, File zipFile)
Este método está en desuso.
Movido a ZipUtil#createZip(File, File)
.
Método de utilidad para crear un archivo zip que contiene el directorio dado y todo su contenido.
Parámetros | |
---|---|
dir | File : el directorio para comprimir |
zipFile | File : el archivo zip que se va a crear; no debería existir ya |
Lanza | |
---|---|
| si no se pudo crear el archivo zip |
borrar archivo
public static void deleteFile (File file)
Intente eliminar un archivo. Destinado a usarse al limpiar en estrofas finally
.
Parámetros | |
---|---|
file | File : puede ser nulo. |
extractFileFromZip
public static File extractFileFromZip (ZipFile zipFile, String filePath)
Este método está en desuso.
Movido a ZipUtil#extractFileFromZip(ZipFile, String)
.
Método de utilidad para extraer un archivo específico de un archivo zip a un archivo tmp
Parámetros | |
---|---|
zipFile | ZipFile : el ERROR(/ZipFile) para extraer |
filePath | String : la ruta del archivo a extraer |
Devoluciones | |
---|---|
File | el ERROR(/File) o nulo si no se encuentra |
Lanza | |
---|---|
| si no se pudo extraer el archivo |
extractZip
public static void extractZip (ZipFile zipFile, File destDir)
Este método está en desuso.
Movido a ZipUtil#extractZip(ZipFile, File)
.
Método de utilidad para extraer todo el contenido del archivo zip en el directorio dado
Parámetros | |
---|---|
zipFile | ZipFile : el ERROR(/ZipFile) para extraer |
destDir | File : el directorio local para extraer el archivo |
Lanza | |
---|---|
| si no se pudo extraer el archivo |
buscarDirectorio
public static File findDirectory (String dirName, File... dirs)
Busque y devuelva el primer directorio ERROR(/File)
entre otros directorios.
Parámetros | |
---|---|
dirName | String : El nombre del directorio que estamos buscando. |
dirs | File : La lista de directorios que estamos buscando. |
Devoluciones | |
---|---|
File | un ERROR(/File) con el directorio encontrado o Nulo si no se encuentra. |
Lanza | |
---|---|
| IOException |
encontrarDirsUnder
public staticfindDirsUnder (File rootDir, File relativeParent)
Encuentre recursivamente todos los directorios bajo el rootDir
dado
Parámetros | |
---|---|
rootDir | File : el directorio raíz para buscar en |
relativeParent | File : un padre opcional para todos ERROR(/File) s devueltos. Si no se especifica, todos ERROR(/File) s serán relativos a rootDir . |
Devoluciones | |
---|---|
Un conjunto de ERROR(/File) s, que representa todos los directorios bajo rootDir , incluido rootDir mismo. Si rootDir es nulo, se devuelve un conjunto vacío. |
encontrar archivo
public static File findFile (String fileName, IAbi abi, File... dirs)
Obtenga todas las rutas de archivo de los archivos en el directorio dado con un nombre que coincida con el filtro dado y también filtre el archivo encontrado por abi arch si abi no es nulo. Devuelve el primer archivo de coincidencia encontrado.
Parámetros | |
---|---|
fileName | String : String de la expresión regular para que coincida con la ruta del archivo |
abi | IAbi : objeto IAbi de la abi para que coincida con el objetivo |
dirs | File : una matriz varargs del objeto ERROR(/File) de los directorios para buscar archivos |
Devoluciones | |
---|---|
File | el ERROR(/File) o null si no se pudo encontrar |
encontrar archivo
public static File findFile (File dir, String fileName)
Busque recursivamente en el directorio dado el primer archivo con el nombre dado
Parámetros | |
---|---|
dir | File : el directorio para buscar |
fileName | String : el nombre del archivo a buscar |
Devoluciones | |
---|---|
File | el ERROR(/File) o null si no se pudo encontrar |
buscar archivos
public staticfindFiles (String fileName, IAbi abi, boolean includeDirectory, File... dirs)
Obtenga todos los archivos en el directorio dado con un nombre que coincida con el filtro dado y también filtre los archivos encontrados por abi arch si abi no es nulo.
Parámetros | |
---|---|
fileName | String : String de la expresión regular para que coincida con la ruta del archivo |
abi | IAbi : objeto IAbi de la abi para que coincida con el objetivo |
includeDirectory | boolean : si incluir directorios en el resultado de la búsqueda |
dirs | File : una matriz de objetos ERROR(/File) de los directorios para buscar archivos |
Devoluciones | |
---|---|
un conjunto de ERROR(/File) s o vacío si no se pudo encontrar |
buscar archivos
public staticfindFiles (File dir, String filter)
Obtenga todas las rutas de archivo de los archivos en el directorio dado con un nombre que coincida con el filtro dado
Parámetros | |
---|---|
dir | File : ERROR(/File) objeto del directorio para buscar archivos recursivamente |
filter | String : String de la expresión regular para que coincida con los nombres de los archivos |
Devoluciones | |
---|---|
un conjunto de String de rutas de archivos |
findFilesObject
public staticfindFilesObject (File dir, String filter)
Obtenga todas las rutas de archivo de los archivos en el directorio dado con un nombre que coincida con el filtro dado
Parámetros | |
---|---|
dir | File : ERROR(/File) objeto del directorio para buscar archivos recursivamente |
filter | String : String de la expresión regular para que coincida con los nombres de los archivos |
Devoluciones | |
---|---|
un conjunto de ERROR(/File) de los objetos de archivo. @Ver findFiles(File, String) |
findFilesObject
public staticfindFilesObject (File dir, String filter, boolean includeDirectory)
Obtenga todas las rutas de archivo de los archivos en el directorio dado con un nombre que coincida con el filtro dado
Parámetros | |
---|---|
dir | File : ERROR(/File) objeto del directorio para buscar archivos recursivamente |
filter | String : String de la expresión regular para que coincida con los nombres de los archivos |
includeDirectory | boolean : si incluir directorios en el resultado de la búsqueda |
Devoluciones | |
---|---|
un conjunto de ERROR(/File) de los objetos de archivo. @Ver findFiles(File, String) |
obtenerNombreBase
public static String getBaseName (String fileName)
Obtiene el nombre base, sin extensión, del nombre de archivo dado.
por ejemplo, getBaseName("archivo.txt") devolverá "archivo"Devoluciones | |
---|---|
String | el nombre basico |
getContentType
public static String getContentType (String filePath)
Obtenga el tipo de contenido del archivo según su extensión.
Parámetros | |
---|---|
filePath | String : la ruta del archivo |
Devoluciones | |
---|---|
String | tipo de contenido |
getExtension
public static String getExtension (String fileName)
Obtiene la extensión para el nombre de archivo dado.
Devoluciones | |
---|---|
String | la extensión o cadena vacía si el archivo no tiene extensión |
getFileForPath
public static File getFileForPath (File parentDir, String... pathSegments)
Método auxiliar para crear un archivo dependiente del sistema
Parámetros | |
---|---|
parentDir | File : el directorio principal a usar. |
pathSegments | String : los segmentos de ruta relativa a usar |
Devoluciones | |
---|---|
File | el ERROR(/File) que representa la ruta dada, con cada pathSegment separado por ERROR(/File#separatorChar) |
obtenerRuta
public static String getPath (String... pathSegments)
Método auxiliar para crear una ruta relativa dependiente del sistema
Parámetros | |
---|---|
pathSegments | String : los segmentos de ruta relativa a usar |
Devoluciones | |
---|---|
String | la String que representa la ruta dada, con cada pathSegment separado por ERROR(/File#separatorChar) |
archivo gzip
public static void gzipFile (File file, File gzipFile)
Este método está en desuso.
Movido a ZipUtil#gzipFile(File, File)
.
Método auxiliar para crear una versión comprimida con gzip de un único archivo.
Parámetros | |
---|---|
file | File : el archivo original |
gzipFile | File : el archivo para colocar contenidos comprimidos en |
Lanza | |
---|---|
| IOException |
archivo de enlace duro
public static void hardlinkFile (File origFile, File destFile)
Un método auxiliar que vincula un archivo a otro archivo. Retroceder a la copia en caso de vinculación de partición cruzada.
Parámetros | |
---|---|
origFile | File : el archivo original |
destFile | File : el archivo de destino |
Lanza | |
---|---|
| si no se pudo vincular el archivo |
archivo de enlace duro
public static void hardlinkFile (File origFile, File destFile, boolean ignoreExistingFile)
Un método auxiliar que vincula un archivo a otro archivo. Retroceder a la copia en caso de vinculación de partición cruzada.
Parámetros | |
---|---|
origFile | File : el archivo original |
destFile | File : el archivo de destino |
ignoreExistingFile | boolean : si es verdadero y el archivo que se vincula ya existe, omita la excepción. |
Lanza | |
---|---|
| si no se pudo vincular el archivo |
esDiskSpaceError
public static boolean isDiskSpaceError (String message)
Devuelve verdadero si el mensaje es un error de espacio en disco.
Parámetros | |
---|---|
message | String |
Devoluciones | |
---|---|
boolean |
mkdirsRWX
public static boolean mkdirsRWX (File file)
Método para crear una cadena de directorios y configurarlos para que se ejecuten/lean/escriban en grupo a medida que se crean, llamando a chmodGroupRWX(File)
. Esencialmente una versión de ERROR(/File#mkdirs())
que también ejecuta chmod(File, String)
.
Parámetros | |
---|---|
file | File : el nombre del directorio a crear, posiblemente con directorios que aún no existen. |
Devoluciones | |
---|---|
boolean | true si file existe y es un directorio, false en caso contrario. |
leerCadenaDesdeArchivo
public static String readStringFromFile (File sourceFile, long startOffset, long length)
Un método auxiliar para leer datos de cadenas parciales de un archivo
Parámetros | |
---|---|
sourceFile | File : el archivo para leer |
startOffset | long : el desplazamiento de inicio para leer del archivo. |
length | long : el número de bytes para leer del archivo. |
Devoluciones | |
---|---|
String |
Lanza | |
---|---|
| IOException |
| Excepción de archivo no encontrado |
leerCadenaDesdeArchivo
public static String readStringFromFile (File sourceFile)
Un método auxiliar para leer datos de cadena de un archivo
Parámetros | |
---|---|
sourceFile | File : el archivo para leer |
Devoluciones | |
---|---|
String |
Lanza | |
---|---|
| IOException |
| Excepción de archivo no encontrado |
copia recursiva
public static void recursiveCopy (File sourceDir, File destDir)
Copia recursivamente el contenido de la carpeta.
Solo admite la copia de archivos y directorios; los enlaces simbólicos no se copian. Si el directorio de destino no existe, se creará.Parámetros | |
---|---|
sourceDir | File : la carpeta que contiene los archivos para copiar |
destDir | File : la carpeta de destino |
Lanza | |
---|---|
| IOException |
recursivaEliminar
public static void recursiveDelete (File rootDir)
Elimine recursivamente un archivo o directorio dado y todo su contenido.
Parámetros | |
---|---|
rootDir | File : el directorio o archivo a eliminar; puede ser nulo |
recursivoHardlink
public static void recursiveHardlink (File sourceDir, File destDir)
Contenido de la carpeta de enlace permanente recursivamente.
Solo admite la copia de archivos y directorios; los enlaces simbólicos no se copian. Si el directorio de destino no existe, se creará.Parámetros | |
---|---|
sourceDir | File : la carpeta que contiene los archivos para copiar |
destDir | File : la carpeta de destino |
Lanza | |
---|---|
| IOException |
recursivoHardlink
public static void recursiveHardlink (File sourceDir, File destDir, boolean ignoreExistingFile,copyInsteadofHardlink)
Contenido de la carpeta de enlace permanente recursivamente.
Solo admite la copia de archivos y directorios; los enlaces simbólicos no se copian. Si el directorio de destino no existe, se creará.
Parámetros | |
---|---|
sourceDir | File : la carpeta que contiene los archivos para copiar |
destDir | File : la carpeta de destino |
ignoreExistingFile | boolean : si es verdadero y el archivo que se vincula ya existe, omita la excepción. |
copyInsteadofHardlink |
Lanza | |
---|---|
| IOException |
recursivoHardlink
public static void recursiveHardlink (File sourceDir, File destDir, boolean ignoreExistingFile)
Contenido de la carpeta de enlace permanente recursivamente.
Solo admite la copia de archivos y directorios; los enlaces simbólicos no se copian. Si el directorio de destino no existe, se creará.
Parámetros | |
---|---|
sourceDir | File : la carpeta que contiene los archivos para copiar |
destDir | File : la carpeta de destino |
ignoreExistingFile | boolean : si es verdadero y el archivo que se vincula ya existe, omita la excepción. |
Lanza | |
---|---|
| IOException |
enlace simbólico recursivo
public static void recursiveSymlink (File sourceDir, File destDir)
Contenido de la carpeta de enlace simbólico recursivamente.
Solo admite la copia de archivos y directorios; los enlaces simbólicos no se copian. Si el directorio de destino no existe, se creará.
Parámetros | |
---|---|
sourceDir | File : la carpeta que contiene los archivos para copiar |
destDir | File : la carpeta de destino |
Lanza | |
---|---|
| IOException |
guardarRecursoArchivo
public static File saveResourceFile (InputStream resourceStream, File destDir, String targetFileName)
Guarde un archivo de recursos en un directorio.
Parámetros | |
---|---|
resourceStream | InputStream : un objeto {link InputStream} al recurso que se va a guardar. |
destDir | File : un objeto ERROR(/File) de un directorio donde se guardará el archivo de recursos. |
targetFileName | String : una String para el nombre del archivo que se guardará. |
Devoluciones | |
---|---|
File | un objeto ERROR(/File) del archivo guardado. |
Lanza | |
---|---|
| si el archivo no se pudo guardar. |
setReadableRecursive
public static void setReadableRecursive (File file)
Establezca recursivamente los permisos de lectura y ejecución (si es una carpeta) para un archivo determinado.
Parámetros | |
---|---|
file | File |
tamañoDeDirectorio
public static Long sizeOfDirectory (File directory)
Devuelve el tamaño informado por el directorio.
Parámetros | |
---|---|
directory | File |
Devoluciones | |
---|---|
Long |
archivo de enlace simbólico
public static void symlinkFile (File origFile, File destFile)
Un método auxiliar que vincula un archivo a otro archivo
Parámetros | |
---|---|
origFile | File : el archivo original |
destFile | File : el archivo de destino |
Lanza | |
---|---|
| si no se pudo enlazar el archivo |
unixModeToPosix
public staticunixModeToPosix (int mode)
Convierte un número entero que representa el modo Unix en un conjunto de ERROR(/PosixFilePermission)
s
Parámetros | |
---|---|
mode | int |
Devoluciones | |
---|---|
escribir en el archivo
public static void writeToFile (String inputString, File destFile, boolean append)
Un método auxiliar para escribir o agregar datos de cadena al archivo
Parámetros | |
---|---|
inputString | String : la String de entrada |
destFile | File : el archivo de destino para escribir o agregar |
append | boolean : agregar al final del archivo si es verdadero, sobrescribir de lo contrario |
escribir en el archivo
public static void writeToFile (String inputString, File destFile)
Un método auxiliar para escribir datos de cadena en un archivo
Parámetros | |
---|---|
inputString | String : la String de entrada |
destFile | File : el archivo de destino para escribir |
escribir en el archivo
public static void writeToFile (InputStream input, File destFile, boolean append, long startOffset, long size)
Un método auxiliar para escribir datos de transmisión en un archivo
Parámetros | |
---|---|
input | InputStream : el flujo de entrada sin búfer |
destFile | File : el archivo de destino para escribir o agregar |
append | boolean : agregar al final del archivo si es verdadero, sobrescribir de lo contrario |
startOffset | long : el desplazamiento de inicio del flujo de entrada para recuperar datos |
size | long : número de bytes para recuperar del flujo de entrada, configúrelo en un valor negativo para recuperar todo el contenido a partir del desplazamiento dado. |
escribir en el archivo
public static void writeToFile (InputStream input, File destFile)
Un método auxiliar para escribir datos de transmisión en un archivo
Parámetros | |
---|---|
input | InputStream : el flujo de entrada sin búfer |
destFile | File : el archivo de destino para escribir |
escribir en el archivo
public static void writeToFile (InputStream input, File destFile, boolean append)
Un método auxiliar para escribir datos de transmisión en un archivo
Parámetros | |
---|---|
input | InputStream : el flujo de entrada sin búfer |
destFile | File : el archivo de destino para escribir o agregar |
append | boolean : agregar al final del archivo si es verdadero, sobrescribir de lo contrario |
Métodos protegidos
chmodExiste
protected static boolean chmodExists ()
Asistente interno para determinar si 'chmod' está disponible en el sistema operativo.
Devoluciones | |
---|---|
boolean |
setChmodBinario
protected static void setChmodBinary (String chmodName)
Expuesto para la prueba. Permite modificar el nombre binario de chmod que buscamos, para probar el sistema sin soporte para chmod.
Parámetros | |
---|---|
chmodName | String |
FileUtil
public class FileUtil
extends Object
java.lang.Objeto | |
↳ | com.android.tradefed.util.FileUtil |
Una clase auxiliar para operaciones relacionadas con archivos.
Resumen
Clases anidadas | |
---|---|
class | FileUtil.LowDiskSpaceException Se lanza si el espacio en disco utilizable está por debajo del umbral mínimo. |
constantes | |
---|---|
int | FILESYSTEM_FILENAME_MAX_LENGTH
|
Constructores públicos | |
---|---|
FileUtil () |
Métodos públicos | |
---|---|
static String | calculateBase64Md5 (File file) Método auxiliar para calcular base64 md5 para un archivo. |
static long | calculateCrc32 (File file) Método auxiliar para calcular CRC-32 para un archivo. |
static String | calculateMd5 (File file) Método auxiliar para calcular md5 para un archivo. |
static boolean | chmod (File file, String perms) |
static boolean | chmodGroupRW (File file) Realiza un mejor esfuerzo para hacer que el grupo de archivos dado sea legible y escribible. |
static boolean | chmodGroupRWX (File file) Realiza un mejor esfuerzo para hacer que el grupo de archivos sea ejecutable, legible y escribible. |
static boolean | chmodRWXRecursively (File file) |
static void | closeZip (ZipFile zipFile) Este método está en desuso. Movido a |
static | collectJars (File dir) Devuelve todos los archivos jar que se encuentran en el directorio dado |
static boolean | compareFileContents (File file1, File file2) Método de utilidad para realizar una comparación de contenido por bytes de dos archivos. |
static long | convertSizeToBytes (String sizeString) El inverso de |
static IOException | convertToDiskSpaceIfNeeded (IOException e) Envuelve el error en un error de espacio en disco si es necesario. |
static String | convertToReadableSize (long sizeLong) Convierta el tamaño de archivo dado en bytes a un formato más legible en formato XY [KMGT]. |
static void | copyFile (File origFile, File destFile) Un método auxiliar que copia el contenido de un archivo en un archivo local |
static File | createNamedTempDir (File parentDir, String name) Función auxiliar para crear un directorio con nombre dentro de una carpeta. |
static File | createNamedTempDir (String name) Función auxiliar para crear un directorio con nombre dentro de su carpeta temporal. |
static File | createTempDir (String prefix) Función auxiliar para crear un directorio temporal en el directorio de archivos temporales predeterminado del sistema. |
static File | createTempDir (String prefix, File parentDir) Función auxiliar para crear un directorio temporal. |
static File | createTempFile (String prefix, String suffix, File parentDir) Función de contenedor auxiliar alrededor |
static File | createTempFile (String prefix, String suffix) Función de contenedor auxiliar alrededor |
static File | createTempFileForRemote (String remoteFilePath, File parentDir) Método auxiliar que construye un archivo único en un disco temporal, cuyo nombre se corresponde lo más posible con el nombre de archivo dado por la ruta del archivo remoto |
static File | createZip (File dir) Este método está en desuso. Movido a |
static void | createZip (File dir, File zipFile) Este método está en desuso. Movido a |
static void | deleteFile (File file) Intente eliminar un archivo. |
static File | extractFileFromZip (ZipFile zipFile, String filePath) Este método está en desuso. Movido a |
static void | extractZip (ZipFile zipFile, File destDir) Este método está en desuso. Movido a |
static File | findDirectory (String dirName, File... dirs) Busque y devuelva el primer directorio |
static | findDirsUnder (File rootDir, File relativeParent) Encuentre recursivamente todos los directorios bajo el |
static File | findFile (String fileName, IAbi abi, File... dirs) Obtenga todas las rutas de archivo de los archivos en el directorio dado con un nombre que coincida con el filtro dado y también filtre el archivo encontrado por abi arch si abi no es nulo. |
static File | findFile (File dir, String fileName) Busque recursivamente en el directorio dado el primer archivo con el nombre dado |
static | findFiles (String fileName, IAbi abi, boolean includeDirectory, File... dirs) Obtenga todos los archivos en el directorio dado con un nombre que coincida con el filtro dado y también filtre los archivos encontrados por abi arch si abi no es nulo. |
static | findFiles (File dir, String filter) Obtenga todas las rutas de archivo de los archivos en el directorio dado con un nombre que coincida con el filtro dado |
static | findFilesObject (File dir, String filter) Obtenga todas las rutas de archivo de los archivos en el directorio dado con un nombre que coincida con el filtro dado |
static | findFilesObject (File dir, String filter, boolean includeDirectory) Obtenga todas las rutas de archivo de los archivos en el directorio dado con un nombre que coincida con el filtro dado |
static String | getBaseName (String fileName) Obtiene el nombre base, sin extensión, del nombre de archivo dado. |
static String | getContentType (String filePath) Obtenga el tipo de contenido del archivo según su extensión. |
static String | getExtension (String fileName) Obtiene la extensión para el nombre de archivo dado. |
static File | getFileForPath (File parentDir, String... pathSegments) Método auxiliar para crear un archivo dependiente del sistema |
static String | getPath (String... pathSegments) Método auxiliar para crear una ruta relativa dependiente del sistema |
static void | gzipFile (File file, File gzipFile) Este método está en desuso. Movido a |
static void | hardlinkFile (File origFile, File destFile) Un método auxiliar que vincula un archivo a otro archivo. |
static void | hardlinkFile (File origFile, File destFile, boolean ignoreExistingFile) Un método auxiliar que vincula un archivo a otro archivo. |
static boolean | isDiskSpaceError (String message) Devuelve verdadero si el mensaje es un error de espacio en disco. |
static boolean | mkdirsRWX (File file) Método para crear una cadena de directorios y configurarlos para que se ejecuten/lean/escriban en grupo a medida que se crean, llamando a |
static String | readStringFromFile (File sourceFile, long startOffset, long length) Un método auxiliar para leer datos de cadenas parciales de un archivo |
static String | readStringFromFile (File sourceFile) Un método auxiliar para leer datos de cadena de un archivo |
static void | recursiveCopy (File sourceDir, File destDir) Copia recursivamente el contenido de la carpeta. |
static void | recursiveDelete (File rootDir) Elimine recursivamente un archivo o directorio dado y todo su contenido. |
static void | recursiveHardlink (File sourceDir, File destDir) Contenido de la carpeta de enlace permanente recursivamente. |
static void | recursiveHardlink (File sourceDir, File destDir, boolean ignoreExistingFile, copyInsteadofHardlink) recursiveHardlink (File sourceDir, File destDir, boolean ignoreExistingFile, copyInsteadofHardlink) Contenido de la carpeta de enlace permanente recursivamente. |
static void | recursiveHardlink (File sourceDir, File destDir, boolean ignoreExistingFile) Contenido de la carpeta de enlace permanente recursivamente. |
static void | recursiveSymlink (File sourceDir, File destDir) Contenido de la carpeta de enlace simbólico recursivamente. |
static File | saveResourceFile (InputStream resourceStream, File destDir, String targetFileName) Guarde un archivo de recursos en un directorio. |
static void | setReadableRecursive (File file) Establezca recursivamente los permisos de lectura y ejecución (si es una carpeta) para un archivo determinado. |
static Long | sizeOfDirectory (File directory) Devuelve el tamaño informado por el directorio. |
static void | symlinkFile (File origFile, File destFile) Un método auxiliar que vincula un archivo a otro archivo |
static | unixModeToPosix (int mode) Convierte un número entero que representa el modo Unix en un conjunto de |
static void | writeToFile (String inputString, File destFile, boolean append) Un método auxiliar para escribir o agregar datos de cadena al archivo |
static void | writeToFile (String inputString, File destFile) Un método auxiliar para escribir datos de cadena en un archivo |
static void | writeToFile (InputStream input, File destFile, boolean append, long startOffset, long size) Un método auxiliar para escribir datos de transmisión en un archivo |
static void | writeToFile (InputStream input, File destFile) Un método auxiliar para escribir datos de transmisión en un archivo |
static void | writeToFile (InputStream input, File destFile, boolean append) Un método auxiliar para escribir datos de transmisión en un archivo |
Métodos protegidos | |
---|---|
static boolean | chmodExists () Asistente interno para determinar si 'chmod' está disponible en el sistema operativo. |
static void | setChmodBinary (String chmodName) Expuesto para la prueba. |
constantes
FILESYSTEM_FILENAME_MAX_LENGTH
public static final int FILESYSTEM_FILENAME_MAX_LENGTH
Valor constante: 255 (0x000000ff)
Constructores públicos
FileUtil
public FileUtil ()
Métodos públicos
calcularBase64Md5
public static String calculateBase64Md5 (File file)
Método auxiliar para calcular base64 md5 para un archivo.
Devoluciones | |
---|---|
String | md5 del archivo |
calcularCrc32
public static long calculateCrc32 (File file)
Método auxiliar para calcular CRC-32 para un archivo.
Devoluciones | |
---|---|
long | CRC-32 del expediente |
Lanza | |
---|---|
| IOException |
calcularMd5
public static String calculateMd5 (File file)
Método auxiliar para calcular md5 para un archivo.
Devoluciones | |
---|---|
String | md5 del archivo |
chmod
public static boolean chmod (File file, String perms)
Parámetros | |
---|---|
file | File |
perms | String |
Devoluciones | |
---|---|
boolean |
chmodGroupRW
public static boolean chmodGroupRW (File file)
Realiza un mejor esfuerzo para hacer que el grupo de archivos dado sea legible y escribible.
Tenga en cuenta que se requiere el permiso de ejecución para que los directorios sean accesibles. VerchmodGroupRWX(File)
. Si el sistema operativo subyacente no admite el comando del sistema 'chmod', configurará el archivo para que todos puedan escribirlo.Parámetros | |
---|---|
file | File : el ERROR(/File) para hacer que el propietario y el grupo puedan escribir |
Devoluciones | |
---|---|
boolean | true si el archivo se convirtió correctamente en grupo escribible, false de lo contrario |
chmodGroupRWX
public static boolean chmodGroupRWX (File file)
Realiza un mejor esfuerzo para hacer que el grupo de archivos sea ejecutable, legible y escribible.
Si el sistema operativo subyacente no admite el comando del sistema 'chmod', intentará establecer permisos para todos los usuarios.Parámetros | |
---|---|
file | File : el ERROR(/File) para hacer que el propietario y el grupo puedan escribir |
Devoluciones | |
---|---|
boolean | true si los permisos se establecieron con éxito, false de lo contrario |
chmodRWXRecursivamente
public static boolean chmodRWXRecursively (File file)
Parámetros | |
---|---|
file | File |
Devoluciones | |
---|---|
boolean |
closeZip
public static void closeZip (ZipFile zipFile)
Este método está en desuso.
Movido a ZipUtil#closeZip(ZipFile)
.
Cierra un ERROR(/ZipFile)
abierto, ignorando cualquier excepción.
Parámetros | |
---|---|
zipFile | ZipFile : el archivo para cerrar |
coleccionarfrascos
public staticcollectJars (File dir)
Devuelve todos los archivos jar que se encuentran en el directorio dado
Parámetros | |
---|---|
dir | File |
Devoluciones | |
---|---|
compararFileContents
public static boolean compareFileContents (File file1, File file2)
Método de utilidad para realizar una comparación de contenido por bytes de dos archivos.
Parámetros | |
---|---|
file1 | File |
file2 | File |
Devoluciones | |
---|---|
boolean | true si el contenido del archivo es idéntico |
convertSizeToBytes
public static long convertSizeToBytes (String sizeString)
El inverso de convertToReadableSize(long)
. Convierte el formato legible descrito en convertToReadableSize(long)
en un valor de byte.
Parámetros | |
---|---|
sizeString | String : la descripción de cadena del tamaño. |
Devoluciones | |
---|---|
long | el tamaño en bytes |
Lanza | |
---|---|
IllegalArgumentException | si no puede reconocer el tamaño |
convertToDiskSpaceIfNeeded
public static IOException convertToDiskSpaceIfNeeded (IOException e)
Envuelve el error en un error de espacio en disco si es necesario.
Parámetros | |
---|---|
e | IOException |
Devoluciones | |
---|---|
IOException |
convertToReadableSize
public static String convertToReadableSize (long sizeLong)
Convierta el tamaño de archivo dado en bytes a un formato más legible en formato XY [KMGT].
Parámetros | |
---|---|
sizeLong | long : tamaño del archivo en bytes |
Devoluciones | |
---|---|
String | cadena descriptiva del tamaño del archivo |
copiar archivo
public static void copyFile (File origFile, File destFile)
Un método auxiliar que copia el contenido de un archivo en un archivo local
Parámetros | |
---|---|
origFile | File : el archivo original que se va a copiar |
destFile | File : el archivo de destino |
Lanza | |
---|---|
| si no se pudo copiar el archivo |
createNamedTempDir
public static File createNamedTempDir (File parentDir, String name)
Función auxiliar para crear un directorio con nombre dentro de una carpeta.
Este directorio no tendrá su nombre aleatorio. Si el directorio ya existe, se devolverá.
Parámetros | |
---|---|
parentDir | File : el directorio donde crear el dir. Si es nulo, estará en /tmp |
name | String : el nombre del directorio para crear en la carpeta principal |
Devoluciones | |
---|---|
File | el directorio creado |
createNamedTempDir
public static File createNamedTempDir (String name)
Función auxiliar para crear un directorio con nombre dentro de su carpeta temporal.
Este directorio no tendrá su nombre aleatorio. Si el directorio ya existe, se devolverá.Parámetros | |
---|---|
name | String : el nombre del directorio para crear en su carpeta tmp. |
Devoluciones | |
---|---|
File | el directorio creado |
crearTempDir
public static File createTempDir (String prefix)
Función auxiliar para crear un directorio temporal en el directorio de archivos temporales predeterminado del sistema.
Parámetros | |
---|---|
prefix | String : la cadena de prefijo que se utilizará para generar el nombre del archivo; debe tener al menos tres caracteres |
Devoluciones | |
---|---|
File | el directorio creado |
Lanza | |
---|---|
| si no se pudo crear el archivo |
crearTempDir
public static File createTempDir (String prefix, File parentDir)
Función auxiliar para crear un directorio temporal.
Parámetros | |
---|---|
prefix | String : la cadena de prefijo que se utilizará para generar el nombre del archivo; debe tener al menos tres caracteres |
parentDir | File : el directorio principal en el que se creará el directorio. Si es null se utilizará el directorio temporal predeterminado del sistema. |
Devoluciones | |
---|---|
File | el directorio creado |
Lanza | |
---|---|
| si no se pudo crear el archivo |
crearTempFile
public static File createTempFile (String prefix, String suffix, File parentDir)
Función de contenedor auxiliar alrededor ERROR(/File#createTempFile(String, String, File))
que audita el posible escenario de falta de espacio en disco.
Parámetros | |
---|---|
prefix | String |
suffix | String |
parentDir | File |
Devoluciones | |
---|---|
File |
Lanza | |
---|---|
FileUtil.LowDiskSpaceException | si el espacio en disco en la partición es inferior al mínimo permitido |
Ver también:
crearTempFile
public static File createTempFile (String prefix, String suffix)
Función de contenedor auxiliar alrededor ERROR(/File#createTempFile(String, String))
que audita el posible escenario de falta de espacio en disco.
Parámetros | |
---|---|
prefix | String |
suffix | String |
Devoluciones | |
---|---|
File |
Lanza | |
---|---|
FileUtil.LowDiskSpaceException | si el espacio en disco en la partición temporal es inferior al mínimo permitido |
Ver también:
crearTempFileForRemote
public static File createTempFileForRemote (String remoteFilePath, File parentDir)
Método auxiliar que construye un archivo único en un disco temporal, cuyo nombre se corresponde lo más posible con el nombre de archivo dado por la ruta del archivo remoto
Parámetros | |
---|---|
remoteFilePath | String : la ruta remota separada por '/' para construir el nombre a partir de |
parentDir | File : el directorio principal para crear el archivo. null para usar el directorio temporal predeterminado |
Devoluciones | |
---|---|
File |
crearZip
public static File createZip (File dir)
Este método está en desuso.
Movido a ZipUtil#createZip(File)
.
Método de utilidad para crear un archivo zip temporal que contiene el directorio dado y todo su contenido.
Parámetros | |
---|---|
dir | File : el directorio para comprimir |
Devoluciones | |
---|---|
File | un ERROR(/File) que contiene el contenido del directorio |
Lanza | |
---|---|
| si no se pudo crear el archivo zip |
crearZip
public static void createZip (File dir, File zipFile)
Este método está en desuso.
Movido a ZipUtil#createZip(File, File)
.
Método de utilidad para crear un archivo zip que contiene el directorio dado y todo su contenido.
Parámetros | |
---|---|
dir | File : el directorio para comprimir |
zipFile | File : el archivo zip que se va a crear; no debería existir ya |
Lanza | |
---|---|
| si no se pudo crear el archivo zip |
borrar archivo
public static void deleteFile (File file)
Intente eliminar un archivo. Destinado a usarse al limpiar en estrofas finally
.
Parámetros | |
---|---|
file | File : puede ser nulo. |
extractFileFromZip
public static File extractFileFromZip (ZipFile zipFile, String filePath)
Este método está en desuso.
Movido a ZipUtil#extractFileFromZip(ZipFile, String)
.
Método de utilidad para extraer un archivo específico de un archivo zip a un archivo tmp
Parámetros | |
---|---|
zipFile | ZipFile : el ERROR(/ZipFile) para extraer |
filePath | String : la ruta del archivo a extraer |
Devoluciones | |
---|---|
File | el ERROR(/File) o nulo si no se encuentra |
Lanza | |
---|---|
| si no se pudo extraer el archivo |
extractZip
public static void extractZip (ZipFile zipFile, File destDir)
Este método está en desuso.
Movido a ZipUtil#extractZip(ZipFile, File)
.
Método de utilidad para extraer todo el contenido del archivo zip en el directorio dado
Parámetros | |
---|---|
zipFile | ZipFile : el ERROR(/ZipFile) para extraer |
destDir | File : el directorio local para extraer el archivo |
Lanza | |
---|---|
| si no se pudo extraer el archivo |
buscarDirectorio
public static File findDirectory (String dirName, File... dirs)
Busque y devuelva el primer directorio ERROR(/File)
entre otros directorios.
Parámetros | |
---|---|
dirName | String : El nombre del directorio que estamos buscando. |
dirs | File : La lista de directorios que estamos buscando. |
Devoluciones | |
---|---|
File | un ERROR(/File) con el directorio encontrado o Nulo si no se encuentra. |
Lanza | |
---|---|
| IOException |
encontrarDirsUnder
public staticfindDirsUnder (File rootDir, File relativeParent)
Encuentre recursivamente todos los directorios bajo el rootDir
dado
Parámetros | |
---|---|
rootDir | File : el directorio raíz para buscar en |
relativeParent | File : un padre opcional para todos ERROR(/File) s devueltos. Si no se especifica, todos ERROR(/File) s serán relativos a rootDir . |
Devoluciones | |
---|---|
Un conjunto de ERROR(/File) s, que representa todos los directorios bajo rootDir , incluido rootDir mismo. Si rootDir es nulo, se devuelve un conjunto vacío. |
encontrar archivo
public static File findFile (String fileName, IAbi abi, File... dirs)
Obtenga todas las rutas de archivo de los archivos en el directorio dado con un nombre que coincida con el filtro dado y también filtre el archivo encontrado por abi arch si abi no es nulo. Devuelve el primer archivo de coincidencia encontrado.
Parámetros | |
---|---|
fileName | String : String de la expresión regular para que coincida con la ruta del archivo |
abi | IAbi : objeto IAbi de la abi para que coincida con el objetivo |
dirs | File : una matriz varargs del objeto ERROR(/File) de los directorios para buscar archivos |
Devoluciones | |
---|---|
File | el ERROR(/File) o null si no se pudo encontrar |
encontrar archivo
public static File findFile (File dir, String fileName)
Busque recursivamente en el directorio dado el primer archivo con el nombre dado
Parámetros | |
---|---|
dir | File : el directorio para buscar |
fileName | String : el nombre del archivo a buscar |
Devoluciones | |
---|---|
File | el ERROR(/File) o null si no se pudo encontrar |
buscar archivos
public staticfindFiles (String fileName, IAbi abi, boolean includeDirectory, File... dirs)
Obtenga todos los archivos en el directorio dado con un nombre que coincida con el filtro dado y también filtre los archivos encontrados por abi arch si abi no es nulo.
Parámetros | |
---|---|
fileName | String : String de la expresión regular para que coincida con la ruta del archivo |
abi | IAbi : objeto IAbi de la abi para que coincida con el objetivo |
includeDirectory | boolean : si incluir directorios en el resultado de la búsqueda |
dirs | File : an array of ERROR(/File) object of the directories to search for files |
Returns | |
---|---|
a set of ERROR(/File) s or empty if it could not be found |
findFiles
public staticfindFiles (File dir, String filter)
Get all file paths of files in the given directory with name matching the given filter
Parameters | |
---|---|
dir | File : ERROR(/File) object of the directory to search for files recursively |
filter | String : String of the regex to match file names |
Returns | |
---|---|
a set of String of the file paths |
findFilesObject
public staticfindFilesObject (File dir, String filter)
Get all file paths of files in the given directory with name matching the given filter
Parameters | |
---|---|
dir | File : ERROR(/File) object of the directory to search for files recursively |
filter | String : String of the regex to match file names |
Returns | |
---|---|
a set of ERROR(/File) of the file objects. @See findFiles(File, String) |
findFilesObject
public staticfindFilesObject (File dir, String filter, boolean includeDirectory)
Get all file paths of files in the given directory with name matching the given filter
Parameters | |
---|---|
dir | File : ERROR(/File) object of the directory to search for files recursively |
filter | String : String of the regex to match file names |
includeDirectory | boolean : whether to include directories in the search result |
Returns | |
---|---|
a set of ERROR(/File) of the file objects. @See findFiles(File, String) |
getBaseName
public static String getBaseName (String fileName)
Gets the base name, without extension, of given file name.
eg getBaseName("file.txt") will return "file"Returns | |
---|---|
String | the base name |
getContentType
public static String getContentType (String filePath)
Get file's content type based it's extension.
Parameters | |
---|---|
filePath | String : the file path |
Returns | |
---|---|
String | content type |
getExtension
public static String getExtension (String fileName)
Gets the extension for given file name.
Returns | |
---|---|
String | the extension or empty String if file has no extension |
getFileForPath
public static File getFileForPath (File parentDir, String... pathSegments)
Helper method to build a system-dependent File
Parameters | |
---|---|
parentDir | File : the parent directory to use. |
pathSegments | String : the relative path segments to use |
Returns | |
---|---|
File | the ERROR(/File) representing given path, with each pathSegment separated by ERROR(/File#separatorChar) |
getPath
public static String getPath (String... pathSegments)
Helper method to build a system-dependent relative path
Parameters | |
---|---|
pathSegments | String : the relative path segments to use |
Returns | |
---|---|
String | the String representing given path, with each pathSegment separated by ERROR(/File#separatorChar) |
gzipFile
public static void gzipFile (File file, File gzipFile)
This method is deprecated.
Moved to ZipUtil#gzipFile(File, File)
.
Helper method to create a gzipped version of a single file.
Parameters | |
---|---|
file | File : the original file |
gzipFile | File : the file to place compressed contents in |
Throws | |
---|---|
| IOException |
hardlinkFile
public static void hardlinkFile (File origFile, File destFile)
A helper method that hardlinks a file to another file. Fallback to copy in case of cross partition linking.
Parameters | |
---|---|
origFile | File : the original file |
destFile | File : the destination file |
Throws | |
---|---|
| if failed to hardlink file |
hardlinkFile
public static void hardlinkFile (File origFile, File destFile, boolean ignoreExistingFile)
A helper method that hardlinks a file to another file. Fallback to copy in case of cross partition linking.
Parameters | |
---|---|
origFile | File : the original file |
destFile | File : the destination file |
ignoreExistingFile | boolean : If True and the file being linked already exists, skip the exception. |
Throws | |
---|---|
| if failed to hardlink file |
isDiskSpaceError
public static boolean isDiskSpaceError (String message)
Returns true if the message is an disk space error.
Parameters | |
---|---|
message | String |
Returns | |
---|---|
boolean |
mkdirsRWX
public static boolean mkdirsRWX (File file)
Method to create a chain of directories, and set them all group execute/read/writable as they are created, by calling chmodGroupRWX(File)
. Essentially a version of ERROR(/File#mkdirs())
that also runs chmod(File, String)
.
Parameters | |
---|---|
file | File : the name of the directory to create, possibly with containing directories that don't yet exist. |
Returns | |
---|---|
boolean | true if file exists and is a directory, false otherwise. |
readStringFromFile
public static String readStringFromFile (File sourceFile, long startOffset, long length)
A helper method for reading partial string data from a file
Parameters | |
---|---|
sourceFile | File : the file to read from |
startOffset | long : the start offset to read from the file. |
length | long : the number of bytes to read of the file. |
Returns | |
---|---|
String |
Throws | |
---|---|
| IOException |
| FileNotFoundException |
readStringFromFile
public static String readStringFromFile (File sourceFile)
A helper method for reading string data from a file
Parameters | |
---|---|
sourceFile | File : the file to read from |
Returns | |
---|---|
String |
Throws | |
---|---|
| IOException |
| FileNotFoundException |
recursiveCopy
public static void recursiveCopy (File sourceDir, File destDir)
Recursively copy folder contents.
Only supports copying of files and directories - symlinks are not copied. If the destination directory does not exist, it will be created.Parameters | |
---|---|
sourceDir | File : the folder that contains the files to copy |
destDir | File : the destination folder |
Throws | |
---|---|
| IOException |
recursiveDelete
public static void recursiveDelete (File rootDir)
Recursively delete given file or directory and all its contents.
Parameters | |
---|---|
rootDir | File : the directory or file to be deleted; can be null |
recursiveHardlink
public static void recursiveHardlink (File sourceDir, File destDir)
Recursively hardlink folder contents.
Only supports copying of files and directories - symlinks are not copied. If the destination directory does not exist, it will be created.Parameters | |
---|---|
sourceDir | File : the folder that contains the files to copy |
destDir | File : the destination folder |
Throws | |
---|---|
| IOException |
recursiveHardlink
public static void recursiveHardlink (File sourceDir, File destDir, boolean ignoreExistingFile,copyInsteadofHardlink)
Recursively hardlink folder contents.
Only supports copying of files and directories - symlinks are not copied. If the destination directory does not exist, it will be created.
Parameters | |
---|---|
sourceDir | File : the folder that contains the files to copy |
destDir | File : the destination folder |
ignoreExistingFile | boolean : If True and the file being linked already exists, skip the exception. |
copyInsteadofHardlink |
Throws | |
---|---|
| IOException |
recursiveHardlink
public static void recursiveHardlink (File sourceDir, File destDir, boolean ignoreExistingFile)
Recursively hardlink folder contents.
Only supports copying of files and directories - symlinks are not copied. If the destination directory does not exist, it will be created.
Parameters | |
---|---|
sourceDir | File : the folder that contains the files to copy |
destDir | File : the destination folder |
ignoreExistingFile | boolean : If True and the file being linked already exists, skip the exception. |
Throws | |
---|---|
| IOException |
recursiveSymlink
public static void recursiveSymlink (File sourceDir, File destDir)
Recursively symlink folder contents.
Only supports copying of files and directories - symlinks are not copied. If the destination directory does not exist, it will be created.
Parameters | |
---|---|
sourceDir | File : the folder that contains the files to copy |
destDir | File : the destination folder |
Throws | |
---|---|
| IOException |
saveResourceFile
public static File saveResourceFile (InputStream resourceStream, File destDir, String targetFileName)
Save a resource file to a directory.
Parameters | |
---|---|
resourceStream | InputStream : a {link InputStream} object to the resource to be saved. |
destDir | File : a ERROR(/File) object of a directory to where the resource file will be saved. |
targetFileName | String : a String for the name of the file to be saved to. |
Returns | |
---|---|
File | a ERROR(/File) object of the file saved. |
Throws | |
---|---|
| if the file failed to be saved. |
setReadableRecursive
public static void setReadableRecursive (File file)
Recursively set read and exec (if folder) permissions for given file.
Parameters | |
---|---|
file | File |
sizeOfDirectory
public static Long sizeOfDirectory (File directory)
Returns the size reported by the directory.
Parameters | |
---|---|
directory | File |
Returns | |
---|---|
Long |
symlinkFile
public static void symlinkFile (File origFile, File destFile)
A helper method that symlinks a file to another file
Parameters | |
---|---|
origFile | File : the original file |
destFile | File : the destination file |
Throws | |
---|---|
| if failed to symlink file |
unixModeToPosix
public staticunixModeToPosix (int mode)
Converts an integer representing unix mode to a set of ERROR(/PosixFilePermission)
s
Parameters | |
---|---|
mode | int |
Returns | |
---|---|
writeToFile
public static void writeToFile (String inputString, File destFile, boolean append)
A helper method for writing or appending string data to file
Parameters | |
---|---|
inputString | String : the input String |
destFile | File : the destination file to write or append to |
append | boolean : append to end of file if true, overwrite otherwise |
writeToFile
public static void writeToFile (String inputString, File destFile)
A helper method for writing string data to file
Parameters | |
---|---|
inputString | String : the input String |
destFile | File : the destination file to write to |
writeToFile
public static void writeToFile (InputStream input, File destFile, boolean append, long startOffset, long size)
A helper method for writing stream data to file
Parameters | |
---|---|
input | InputStream : the unbuffered input stream |
destFile | File : the destination file to write or append to |
append | boolean : append to end of file if true, overwrite otherwise |
startOffset | long : the start offset of the input stream to retrieve data |
size | long : number of bytes to retrieve from the input stream, set it to a negative value to retrieve all content starting at the given offset. |
writeToFile
public static void writeToFile (InputStream input, File destFile)
A helper method for writing stream data to file
Parameters | |
---|---|
input | InputStream : the unbuffered input stream |
destFile | File : the destination file to write to |
writeToFile
public static void writeToFile (InputStream input, File destFile, boolean append)
A helper method for writing stream data to file
Parameters | |
---|---|
input | InputStream : the unbuffered input stream |
destFile | File : the destination file to write or append to |
append | boolean : append to end of file if true, overwrite otherwise |
Protected methods
chmodExists
protected static boolean chmodExists ()
Internal helper to determine if 'chmod' is available on the system OS.
Returns | |
---|---|
boolean |
setChmodBinary
protected static void setChmodBinary (String chmodName)
Exposed for testing. Allows to modify the chmod binary name we look for, in order to tests system with no chmod support.
Parameters | |
---|---|
chmodName | String |
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2023-08-15 (UTC)