FileUtil
public
class
FileUtil
extends Object
| java.lang.Object | |
| ↳ | com.android.tradefed.util.FileUtil |
Clase auxiliar para operaciones relacionadas con archivos
Resumen
Clases anidadas | |
|---|---|
class |
FileUtil.LowDiskSpaceException
Se arroja 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 el MD5 en Base64 de un archivo. |
static
long
|
calculateCrc32(File file)
Método auxiliar para calcular el CRC-32 de un archivo. |
static
String
|
calculateMd5(File file)
Método auxiliar para calcular el MD5 de un archivo. |
static
boolean
|
chmod(File file, String perms)
|
static
boolean
|
chmodGroupRW(File file)
Realiza un intento de mejor esfuerzo para que el grupo de archivos determinado sea legible y se pueda escribir en él. |
static
boolean
|
chmodGroupRWX(File file)
Realiza el mejor intento posible para que el grupo de archivos determinado sea ejecutable, legible y grabable. |
static
boolean
|
chmodRWXRecursively(File file)
|
static
void
|
closeZip(ZipFile zipFile)
Este método dejó de estar disponible.
Se movió a |
static
List<File>
|
collectJars(File dir)
Devuelve todos los archivos .jar que se encuentran en el directorio determinado. |
static
boolean
|
compareFileContents(File file1, File file2)
Método de utilidad para realizar una comparación de contenido byte por byte de dos archivos. |
static
long
|
convertSizeToBytes(String sizeString)
Es la inversa de |
static
IOException
|
convertToDiskSpaceIfNeeded(IOException e)
Si es necesario, ajusta el error en un error de espacio en el disco. |
static
String
|
convertToReadableSize(long sizeLong)
Convierte el tamaño de archivo determinado en bytes a un formato más legible en formato X.Y[KMGT]. |
static
void
|
copyFile(File origFile, File destFile)
Un método de ayuda 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 tu 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 auxiliar de wrapper alrededor de |
static
File
|
createTempFile(String prefix, String suffix)
Función auxiliar de wrapper alrededor de |
static
File
|
createTempFileForRemote(String remoteFilePath, File parentDir)
Método auxiliar que construye un archivo único en el disco temporal, cuyo nombre corresponde lo más cerca posible al nombre de archivo proporcionado por la ruta de acceso al archivo remoto |
static
File
|
createZip(File dir)
Este método dejó de estar disponible.
Se movió a |
static
void
|
createZip(File dir, File zipFile)
Este método dejó de estar disponible.
Se movió a |
static
void
|
deleteFile(File file)
Intenta borrar un archivo. |
static
boolean
|
ensureGroupRWX(File file)
Realiza un intento de mejor esfuerzo para garantizar que el grupo de archivos determinado sea ejecutable, legible y grabable. |
static
File
|
extractFileFromZip(ZipFile zipFile, String filePath)
Este método dejó de estar disponible.
Se movió a |
static
void
|
extractZip(ZipFile zipFile, File destDir)
Este método dejó de estar disponible.
Se movió a |
static
File
|
findDirectory(String dirName, File... dirs)
Busca y devuelve el primer directorio |
static
Set<File>
|
findDirsUnder(File rootDir, File relativeParent)
Busca de forma recursiva todos los directorios en el |
static
File
|
findFile(File dir, String fileName)
Busca de forma recursiva en el directorio determinado el primer archivo con el nombre determinado. |
static
File
|
findFile(String fileName, IAbi abi, File... dirs)
Obtiene todas las rutas de acceso de los archivos en el directorio determinado con un nombre que coincide con el filtro determinado y también filtra el archivo encontrado por la arquitectura de ABI si la ABI no es nula. |
static
Set<File>
|
findFiles(String fileName, IAbi abi, boolean includeDirectory, File... dirs)
Obtiene todos los archivos del directorio determinado con un nombre que coincide con el filtro determinado y también filtra los archivos encontrados por la arquitectura de ABI si la ABI no es nula. |
static
Set<String>
|
findFiles(File dir, String filter)
Obtiene todas las rutas de acceso de los archivos en el directorio determinado con un nombre que coincide con el filtro determinado. |
static
Set<File>
|
findFilesObject(File dir, String filter, boolean includeDirectory)
Obtiene todas las rutas de acceso de los archivos en el directorio determinado con un nombre que coincide con el filtro determinado. |
static
Set<File>
|
findFilesObject(File dir, String filter)
Obtiene todas las rutas de acceso de los archivos en el directorio determinado con un nombre que coincide con el filtro determinado. |
static
String
|
getBaseName(String fileName)
Obtiene el nombre base, sin extensión, del nombre de archivo determinado. |
static
String
|
getContentType(String filePath)
Obtiene el tipo de contenido del archivo según su extensión. |
static
String
|
getExtension(String fileName)
Obtiene la extensión del nombre de archivo proporcionado. |
static
File
|
getFileForPath(File parentDir, String... pathSegments)
Método auxiliar para compilar un archivo dependiente del sistema |
static
String
|
getPath(String... pathSegments)
Método auxiliar para compilar una ruta relativa dependiente del sistema |
static
void
|
gzipFile(File file, File gzipFile)
Este método dejó de estar disponible.
Se movió a |
static
void
|
hardlinkFile(File origFile, File destFile)
Es un método auxiliar que crea un vínculo físico de un archivo a otro. |
static
void
|
hardlinkFile(File origFile, File destFile, boolean ignoreExistingFile)
Es un método auxiliar que crea un vínculo físico de un archivo a otro. |
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 establecerlos todos como ejecutables/legibles/grabables para el grupo a medida que se crean, llamando a |
static
String
|
readStringFromFile(File sourceFile, long startOffset, long length)
Método auxiliar para leer datos de cadenas parciales de un archivo |
static
String
|
readStringFromFile(File sourceFile)
Método auxiliar para leer datos de cadenas de un archivo |
static
void
|
recursiveCopy(File sourceDir, File destDir)
Copia de forma recursiva el contenido de la carpeta. |
static
void
|
recursiveDelete(File rootDir)
Borra de forma recursiva el archivo o directorio determinado y todo su contenido. |
static
void
|
recursiveHardlink(File sourceDir, File destDir)
Crea vínculos físicos de forma recursiva al contenido de la carpeta. |
static
void
|
recursiveHardlink(File sourceDir, File destDir, boolean ignoreExistingFile)
Crea vínculos físicos de forma recursiva al contenido de la carpeta. |
static
void
|
recursiveSymlink(File sourceDir, File destDir)
Crea vínculos simbólicos de forma recursiva al contenido de la carpeta. |
static
File
|
saveResourceFile(InputStream resourceStream, File destDir, String targetFileName)
Guarda un archivo de recursos en un directorio. |
static
void
|
setReadableRecursive(File file)
Establece de forma recursiva los permisos de lectura y ejecución (si es una carpeta) para el archivo determinado. |
static
Long
|
sizeOfDirectory(File directory)
Devuelve el tamaño que informa el directorio. |
static
void
|
symlinkFile(File origFile, File destFile)
Método auxiliar que crea un vínculo simbólico de un archivo a otro |
static
Set<PosixFilePermission>
|
unixModeToPosix(int mode)
Convierte un número entero que representa el modo de Unix en un conjunto de |
static
void
|
writeToFile(String inputString, File destFile)
Método auxiliar para escribir datos de cadena en un archivo |
static
void
|
writeToFile(InputStream input, File destFile, boolean append)
Método auxiliar para escribir datos de transmisión en un archivo |
static
void
|
writeToFile(InputStream input, File destFile)
Método auxiliar para escribir datos de transmisión en un archivo |
static
void
|
writeToFile(String inputString, File destFile, boolean append)
Método auxiliar para escribir o agregar datos de cadena a un archivo |
static
void
|
writeToFile(InputStream input, File destFile, boolean append, long startOffset, long size)
Método auxiliar para escribir datos de transmisión en un archivo |
Métodos protegidos | |
|---|---|
static
boolean
|
chmodExists()
Es un asistente interno para determinar si "chmod" está disponible en el SO del sistema. |
static
void
|
setChmodBinary(String chmodName)
Se expone para pruebas. |
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
calculateBase64Md5
public static String calculateBase64Md5 (File file)
Método auxiliar para calcular el MD5 en Base64 de un archivo.
| Muestra | |
|---|---|
String |
MD5 del archivo |
calculateCrc32
public static long calculateCrc32 (File file)
Método auxiliar para calcular el CRC-32 de un archivo.
| Muestra | |
|---|---|
long |
CRC-32 del archivo |
| Arroja | |
|---|---|
|
java.io.IOException |
IOException |
|
calculateMd5
public static String calculateMd5 (File file)
Método auxiliar para calcular el MD5 de un archivo.
| Muestra | |
|---|---|
String |
MD5 del archivo |
chmod
public static boolean chmod (File file,
String perms)| Parámetros | |
|---|---|
file |
File |
perms |
String |
| Muestra | |
|---|---|
boolean |
|
chmodGroupRW
public static boolean chmodGroupRW (File file)
Realiza un intento de mejor esfuerzo para que el grupo de archivos determinado sea legible y se pueda escribir en él.
Ten en cuenta que se requiere el permiso de ejecución para que los directorios sean accesibles. Consulta chmodGroupRWX(File).
Si el SO subyacente no admite el comando del sistema "chmod", se establecerá el archivo como escribible para todos.
| Parámetros | |
|---|---|
file |
File: Es el File que se debe hacer propietario y grupo con permiso de escritura. |
| Muestra | |
|---|---|
boolean |
true si el archivo se configuró correctamente para que el grupo pueda escribir en él; de lo contrario, false |
chmodGroupRWX
public static boolean chmodGroupRWX (File file)
Realiza el mejor intento posible para que el grupo de archivos determinado sea ejecutable, legible y grabable.
Si el SO subyacente no admite el comando del sistema "chmod", se intentará establecer permisos para todos los usuarios.
| Parámetros | |
|---|---|
file |
File: Es el File que se debe hacer propietario y grupo con permiso de escritura. |
| Muestra | |
|---|---|
boolean |
true si los permisos se establecieron correctamente; de lo contrario, false |
chmodRWXRecursively
public static boolean chmodRWXRecursively (File file)
| Parámetros | |
|---|---|
file |
File |
| Muestra | |
|---|---|
boolean |
|
closeZip
public static void closeZip (ZipFile zipFile)
Este método dejó de estar disponible.
Se movió a ZipUtil.closeZip(ZipFile).
Cierra un ZipFile abierto, ignorando cualquier excepción.
| Parámetros | |
|---|---|
zipFile |
ZipFile: El archivo que se cerrará |
collectJars
public static List<File> collectJars (File dir)
Devuelve todos los archivos .jar que se encuentran en el directorio determinado.
| Parámetros | |
|---|---|
dir |
File |
| Muestra | |
|---|---|
List<File> |
|
compareFileContents
public static boolean compareFileContents (File file1,
File file2)Método de utilidad para realizar una comparación de contenido byte por byte de dos archivos.
| Parámetros | |
|---|---|
file1 |
File |
file2 |
File |
| Muestra | |
|---|---|
boolean |
true si el contenido del archivo es idéntico |
| Arroja | |
|---|---|
IOException |
|
convertSizeToBytes
public static long convertSizeToBytes (String sizeString)
Es la inversa de convertToReadableSize(long). Convierte el formato legible que se describe en convertToReadableSize(long) en un valor de byte.
| Parámetros | |
|---|---|
sizeString |
String: Es la descripción de cadena del tamaño. |
| Muestra | |
|---|---|
long |
El tamaño en bytes |
| Arroja | |
|---|---|
IllegalArgumentException |
Si no se puede reconocer el tamaño |
convertToDiskSpaceIfNeeded
public static IOException convertToDiskSpaceIfNeeded (IOException e)
Si es necesario, ajusta el error en un error de espacio en el disco.
| Parámetros | |
|---|---|
e |
IOException |
| Muestra | |
|---|---|
IOException |
|
convertToReadableSize
public static String convertToReadableSize (long sizeLong)
Convierte el tamaño de archivo determinado en bytes a un formato más legible en formato X.Y[KMGT].
| Parámetros | |
|---|---|
sizeLong |
long: Tamaño del archivo en bytes |
| Muestra | |
|---|---|
String |
cadena descriptiva del tamaño del archivo |
copyFile
public static void copyFile (File origFile,
File destFile)Un método de ayuda que copia el contenido de un archivo en un archivo local
| Parámetros | |
|---|---|
origFile |
File: Es el archivo original que se copiará. |
destFile |
File: el archivo de destino |
| Arroja | |
|---|---|
IOException |
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.
El nombre de este directorio no se aleatorizará. Si el directorio ya existe, se devolverá.
| Parámetros | |
|---|---|
parentDir |
File: Es el directorio en el que se creará el directorio. Si es nulo, se creará en /tmp. |
name |
String: Nombre del directorio que se creará en la carpeta principal |
| Muestra | |
|---|---|
File |
El directorio creado |
| Arroja | |
|---|---|
IOException |
|
createNamedTempDir
public static File createNamedTempDir (String name)
Función auxiliar para crear un directorio con nombre dentro de tu carpeta temporal.
El nombre de este directorio no se aleatorizará. Si el directorio ya existe, se devolverá.
| Parámetros | |
|---|---|
name |
String: Es el nombre del directorio que se creará en tu carpeta tmp. |
| Muestra | |
|---|---|
File |
El directorio creado |
| Arroja | |
|---|---|
IOException |
|
createTempDir
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: Es la cadena de prefijo que se usará para generar el nombre del archivo. Debe tener al menos tres caracteres. |
| Muestra | |
|---|---|
File |
El directorio creado |
| Arroja | |
|---|---|
IOException |
Si no se pudo crear el archivo |
createTempDir
public static File createTempDir (String prefix,
File parentDir)Función auxiliar para crear un directorio temporal.
| Parámetros | |
|---|---|
prefix |
String: Es la cadena de prefijo que se usará para generar el nombre del archivo. Debe tener al menos tres caracteres. |
parentDir |
File: Es el directorio principal en el que se creará el directorio. Si null, se usará el directorio temporal predeterminado del sistema. |
| Muestra | |
|---|---|
File |
El directorio creado |
| Arroja | |
|---|---|
IOException |
Si no se pudo crear el archivo |
createTempFile
public static File createTempFile (String prefix,
String suffix,
File parentDir)Función auxiliar de wrapper alrededor de File.createTempFile(String,String,File) que audita posibles situaciones de falta de espacio en el disco.
| Parámetros | |
|---|---|
prefix |
String |
suffix |
String |
parentDir |
File |
| Muestra | |
|---|---|
File |
|
| Arroja | |
|---|---|
FileUtil.LowDiskSpaceException |
Si el espacio en disco de la partición es inferior al mínimo permitido |
IOException |
|
createTempFile
public static File createTempFile (String prefix,
String suffix)Función auxiliar de wrapper alrededor de File.createTempFile(String,String) que audita posibles situaciones de falta de espacio en el disco.
| Parámetros | |
|---|---|
prefix |
String |
suffix |
String |
| Muestra | |
|---|---|
File |
|
| Arroja | |
|---|---|
FileUtil.LowDiskSpaceException |
Si el espacio en disco de la partición temporal es inferior al mínimo permitido |
IOException |
|
También:
createTempFileForRemote
public static File createTempFileForRemote (String remoteFilePath,
File parentDir)Método auxiliar que construye un archivo único en el disco temporal, cuyo nombre corresponde lo más cerca posible al nombre de archivo proporcionado por la ruta de acceso al archivo remoto
| Parámetros | |
|---|---|
remoteFilePath |
String: Es la ruta de acceso remota separada por "/" desde la que se construirá el nombre. |
parentDir |
File: Es el directorio principal en el que se creará el archivo. null para usar el directorio temporal predeterminado |
| Muestra | |
|---|---|
File |
|
| Arroja | |
|---|---|
IOException |
|
createZip
public static File createZip (File dir)
Este método dejó de estar disponible.
Se movió a ZipUtil.createZip(File).
Método de utilidad para crear un archivo ZIP temporal que contenga el directorio determinado y todo su contenido.
| Parámetros | |
|---|---|
dir |
File: El directorio que se comprimirá |
| Muestra | |
|---|---|
File |
Un archivo zip temporal File que contiene el contenido del directorio |
| Arroja | |
|---|---|
IOException |
Si no se pudo crear el archivo ZIP |
createZip
public static void createZip (File dir,
File zipFile)
Este método dejó de estar disponible.
Se movió a ZipUtil.createZip(File,File).
Método de utilidad para crear un archivo ZIP que contenga el directorio determinado y todo su contenido.
| Parámetros | |
|---|---|
dir |
File: El directorio que se comprimirá |
zipFile |
File: Es el archivo ZIP que se creará. No debe existir aún. |
| Arroja | |
|---|---|
IOException |
Si no se pudo crear el archivo ZIP |
deleteFile
public static void deleteFile (File file)
Intenta borrar un archivo. Se usa cuando se limpia en estrofas de finally.
| Parámetros | |
|---|---|
file |
File: Puede ser nulo. |
ensureGroupRWX
public static boolean ensureGroupRWX (File file)
Realiza un intento de mejor esfuerzo para garantizar que el grupo de archivos determinado sea ejecutable, legible y grabable.
Si el SO subyacente no admite el comando del sistema "chmod", se intentará establecer permisos para todos los usuarios. La operación se sincroniza para evitar la condición de carrera que se produce al acceder a los archivos desde una caché, p.ej., GCSFileDownloader.
| Parámetros | |
|---|---|
file |
File: Es el File que se debe hacer propietario y grupo con permiso de escritura. |
| Muestra | |
|---|---|
boolean |
true si los permisos se establecieron correctamente; de lo contrario, false |
extractFileFromZip
public static File extractFileFromZip (ZipFile zipFile,
String filePath)
Este método dejó de estar disponible.
Se movió a ZipUtil.extractFileFromZip(ZipFile,String).
Método de utilidad para extraer un archivo específico del archivo zip en un archivo temporal
| Parámetros | |
|---|---|
zipFile |
ZipFile: El ZipFile que se extraerá |
filePath |
String: Es la ruta de acceso del archivo que se extraerá. |
| Muestra | |
|---|---|
File |
File o null si no se encuentra |
| Arroja | |
|---|---|
IOException |
Si no se pudo extraer el archivo |
extractZip
public static void extractZip (ZipFile zipFile,
File destDir)
Este método dejó de estar disponible.
Se movió a ZipUtil.extractZip(ZipFile,File).
Método de utilidad para extraer todo el contenido del archivo ZIP en el directorio determinado
| Parámetros | |
|---|---|
zipFile |
ZipFile: El ZipFile que se extraerá |
destDir |
File: Es el directorio local en el que se extraerá el archivo. |
| Arroja | |
|---|---|
IOException |
Si no se pudo extraer el archivo |
findDirectory
public static File findDirectory (String dirName,
File... dirs)Busca y devuelve el primer directorio File entre otros directorios.
| Parámetros | |
|---|---|
dirName |
String: Es el nombre del directorio que buscamos. |
dirs |
File: Es la lista de directorios en los que se realiza la búsqueda. |
| Muestra | |
|---|---|
File |
Un File con el directorio encontrado o Null si no se encontró. |
| Arroja | |
|---|---|
|
java.io.IOException |
IOException |
|
findDirsUnder
public static Set<File> findDirsUnder (File rootDir,
File relativeParent)Busca de forma recursiva todos los directorios en el rootDir determinado.
| Parámetros | |
|---|---|
rootDir |
File: Es el directorio raíz en el que se realizará la búsqueda. |
relativeParent |
File: Es un elemento superior opcional para todos los File que se muestran. Si no se especifica, todos los File serán relativos a rootDir. |
| Muestra | |
|---|---|
Set<File> |
Es un conjunto de Files que representan todos los directorios en rootDir, incluido rootDir. Si rootDir es nulo, se devuelve un conjunto vacío. |
findFile
public static File findFile (File dir,
String fileName)Busca de forma recursiva en el directorio determinado el primer archivo con el nombre determinado.
| Parámetros | |
|---|---|
dir |
File: Es el directorio en el que se realizará la búsqueda. |
fileName |
String: El nombre del archivo que se buscará |
| Muestra | |
|---|---|
File |
File o null si no se pudo encontrar |
findFile
public static File findFile (String fileName,
IAbi abi,
File... dirs)Obtiene todas las rutas de acceso de los archivos en el directorio determinado con un nombre que coincide con el filtro determinado y también filtra el archivo encontrado por la arquitectura de ABI si la ABI no es nula. Devuelve el primer archivo de coincidencia que se encontró.
| Parámetros | |
|---|---|
fileName |
String: String de la regex para que coincida con la ruta de acceso al archivo |
abi |
IAbi: Objeto IAbi de la ABI que coincide con el destino |
dirs |
File: Es un array de argumentos variables de objetos File de los directorios en los que se buscarán archivos. |
| Muestra | |
|---|---|
File |
File o null si no se pudo encontrar |
| Arroja | |
|---|---|
IOException |
|
findFiles
public static Set<File> findFiles (String fileName,
IAbi abi,
boolean includeDirectory,
File... dirs)Obtiene todos los archivos del directorio determinado con un nombre que coincide con el filtro determinado y también filtra los archivos encontrados por la arquitectura de ABI si la ABI no es nula.
| Parámetros | |
|---|---|
fileName |
String: String de la regex para que coincida con la ruta de acceso al archivo |
abi |
IAbi: Objeto IAbi de la ABI que coincide con el destino |
includeDirectory |
boolean: Indica si se deben incluir directorios en el resultado de la búsqueda. |
dirs |
File: Es un array de objetos File de los directorios en los que se buscarán archivos. |
| Muestra | |
|---|---|
Set<File> |
Es un conjunto de Files o está vacío si no se pudo encontrar. |
| Arroja | |
|---|---|
IOException |
|
findFiles
public static Set<String> findFiles (File dir,
String filter)Obtiene todas las rutas de acceso de los archivos en el directorio determinado con un nombre que coincide con el filtro determinado.
| Parámetros | |
|---|---|
dir |
File: Objeto File del directorio en el que se buscarán archivos de forma recursiva |
filter |
String: String de la expresión regular para que coincida con los nombres de archivo |
| Muestra | |
|---|---|
Set<String> |
Un conjunto de String de las rutas de acceso a los archivos |
| Arroja | |
|---|---|
IOException |
|
findFilesObject
public static Set<File> findFilesObject (File dir,
String filter,
boolean includeDirectory)Obtiene todas las rutas de acceso de los archivos en el directorio determinado con un nombre que coincide con el filtro determinado.
| Parámetros | |
|---|---|
dir |
File: Objeto File del directorio en el que se buscarán archivos de forma recursiva |
filter |
String: String de la expresión regular para que coincida con los nombres de archivo |
includeDirectory |
boolean: Indica si se deben incluir directorios en el resultado de la búsqueda. |
| Muestra | |
|---|---|
Set<File> |
Es un conjunto de File de los objetos de archivo. @See findFiles(File,String) |
| Arroja | |
|---|---|
IOException |
|
findFilesObject
public static Set<File> findFilesObject (File dir,
String filter)Obtiene todas las rutas de acceso de los archivos en el directorio determinado con un nombre que coincide con el filtro determinado.
| Parámetros | |
|---|---|
dir |
File: Objeto File del directorio en el que se buscarán archivos de forma recursiva |
filter |
String: String de la expresión regular para que coincida con los nombres de archivo |
| Muestra | |
|---|---|
Set<File> |
Es un conjunto de File de los objetos de archivo. @See findFiles(File,String) |
| Arroja | |
|---|---|
IOException |
|
getBaseName
public static String getBaseName (String fileName)
Obtiene el nombre base, sin extensión, del nombre de archivo determinado.
p. ej., getBaseName("file.txt") devolverá "file".
| Muestra | |
|---|---|
String |
el nombre base |
getContentType
public static String getContentType (String filePath)
Obtiene el tipo de contenido del archivo según su extensión.
| Parámetros | |
|---|---|
filePath |
String: Es la ruta de acceso al archivo. |
| Muestra | |
|---|---|
String |
Tipo de contenido |
getExtension
public static String getExtension (String fileName)
Obtiene la extensión del nombre de archivo proporcionado.
| Muestra | |
|---|---|
String |
La extensión o una cadena vacía si el archivo no tiene extensión |
getFileForPath
public static File getFileForPath (File parentDir,
String... pathSegments)Método auxiliar para compilar un archivo dependiente del sistema
| Parámetros | |
|---|---|
parentDir |
File: Es el directorio principal que se usará. |
pathSegments |
String: Son los segmentos de ruta de acceso relativos que se usarán. |
| Muestra | |
|---|---|
File |
el File que representa la ruta de acceso determinada, con cada pathSegment separado por File.separatorChar |
getPath
public static String getPath (String... pathSegments)
Método auxiliar para compilar una ruta relativa dependiente del sistema
| Parámetros | |
|---|---|
pathSegments |
String: Son los segmentos de ruta de acceso relativos que se usarán. |
| Muestra | |
|---|---|
String |
el String que representa la ruta de acceso determinada, con cada pathSegment separado por File.separatorChar |
gzipFile
public static void gzipFile (File file,
File gzipFile)
Este método dejó de estar disponible.
Se movió a ZipUtil.gzipFile(File,File).
Método auxiliar para crear una versión comprimida con gzip de un solo archivo.
| Parámetros | |
|---|---|
file |
File: El archivo original |
gzipFile |
File: El archivo en el que se colocará el contenido comprimido |
| Arroja | |
|---|---|
|
java.io.IOException |
IOException |
|
hardlinkFile
public static void hardlinkFile (File origFile,
File destFile)Es un método auxiliar que crea un vínculo físico de un archivo a otro. Se recurre a la copia de seguridad en caso de vinculación entre particiones.
| Parámetros | |
|---|---|
origFile |
File: El archivo original |
destFile |
File: el archivo de destino |
| Arroja | |
|---|---|
IOException |
Si no se pudo vincular el archivo de forma rígida |
hardlinkFile
public static void hardlinkFile (File origFile,
File destFile,
boolean ignoreExistingFile)Es un método auxiliar que crea un vínculo físico de un archivo a otro. Se recurre a la copia de seguridad en caso de vinculación entre particiones.
| Parámetros | |
|---|---|
origFile |
File: El archivo original |
destFile |
File: el archivo de destino |
ignoreExistingFile |
boolean: Si es True y el archivo que se vincula ya existe, se omite la excepción. |
| Arroja | |
|---|---|
IOException |
Si no se pudo vincular el archivo de forma rígida |
isDiskSpaceError
public static boolean isDiskSpaceError (String message)
Devuelve verdadero si el mensaje es un error de espacio en disco.
| Parámetros | |
|---|---|
message |
String |
| Muestra | |
|---|---|
boolean |
|
mkdirsRWX
public static boolean mkdirsRWX (File file)
Método para crear una cadena de directorios y establecerlos todos como ejecutables/legibles/grabables para el grupo a medida que se crean, llamando a chmodGroupRWX(File). Básicamente, es una versión de File.mkdirs() que también ejecuta chmod(File,String).
| Parámetros | |
|---|---|
file |
File: Es el nombre del directorio que se creará, posiblemente con directorios contenedores que aún no existen. |
| Muestra | |
|---|---|
boolean |
true si file existe y es un directorio; de lo contrario, false. |
readStringFromFile
public static String readStringFromFile (File sourceFile,
long startOffset,
long length)Método auxiliar para leer datos de cadenas parciales de un archivo
| Parámetros | |
|---|---|
sourceFile |
File: Es el archivo desde el que se leerá. |
startOffset |
long: Es el desplazamiento inicial para leer el archivo. |
length |
long: Es la cantidad de bytes que se leerán del archivo. |
| Muestra | |
|---|---|
String |
|
| Arroja | |
|---|---|
|
FileNotFoundException |
|
java.io.IOException |
IOException |
|
readStringFromFile
public static String readStringFromFile (File sourceFile)
Método auxiliar para leer datos de cadenas de un archivo
| Parámetros | |
|---|---|
sourceFile |
File: Es el archivo desde el que se leerá. |
| Muestra | |
|---|---|
String |
|
| Arroja | |
|---|---|
|
FileNotFoundException |
|
java.io.IOException |
IOException |
|
recursiveCopy
public static void recursiveCopy (File sourceDir,
File destDir)Copia de forma recursiva el contenido de la carpeta.
Solo admite la copia de archivos y directorios. No se copian los vínculos simbólicos. Si el directorio de destino no existe, se creará.
| Parámetros | |
|---|---|
sourceDir |
File: Es la carpeta que contiene los archivos que se copiarán. |
destDir |
File: Es la carpeta de destino. |
| Arroja | |
|---|---|
|
java.io.IOException |
IOException |
|
recursiveDelete
public static void recursiveDelete (File rootDir)
Borra de forma recursiva el archivo o directorio determinado y todo su contenido.
| Parámetros | |
|---|---|
rootDir |
File: Es el directorio o archivo que se borrará. Puede ser nulo. |
recursiveHardlink
public static void recursiveHardlink (File sourceDir,
File destDir)Crea vínculos físicos de forma recursiva al contenido de la carpeta.
Solo admite la copia de archivos y directorios. No se copian los vínculos simbólicos. Si el directorio de destino no existe, se creará.
| Parámetros | |
|---|---|
sourceDir |
File: Es la carpeta que contiene los archivos que se copiarán. |
destDir |
File: Es la carpeta de destino. |
| Arroja | |
|---|---|
|
java.io.IOException |
IOException |
|
recursiveHardlink
public static void recursiveHardlink (File sourceDir,
File destDir,
boolean ignoreExistingFile)Crea vínculos físicos de forma recursiva al contenido de la carpeta.
Solo admite la copia de archivos y directorios. No se copian los vínculos simbólicos. Si el directorio de destino no existe, se creará.
| Parámetros | |
|---|---|
sourceDir |
File: Es la carpeta que contiene los archivos que se copiarán. |
destDir |
File: Es la carpeta de destino. |
ignoreExistingFile |
boolean: Si es True y el archivo que se vincula ya existe, se omite la excepción. |
| Arroja | |
|---|---|
|
java.io.IOException |
IOException |
|
recursiveSymlink
public static void recursiveSymlink (File sourceDir,
File destDir)Crea vínculos simbólicos de forma recursiva al contenido de la carpeta.
Solo admite la copia de archivos y directorios. No se copian los vínculos simbólicos. Si el directorio de destino no existe, se creará.
| Parámetros | |
|---|---|
sourceDir |
File: Es la carpeta que contiene los archivos que se copiarán. |
destDir |
File: Es la carpeta de destino. |
| Arroja | |
|---|---|
|
java.io.IOException |
IOException |
|
saveResourceFile
public static File saveResourceFile (InputStream resourceStream,
File destDir,
String targetFileName)Guarda un archivo de recursos en un directorio.
| Parámetros | |
|---|---|
resourceStream |
InputStream: Es un objeto {link InputStream} para el recurso que se guardará. |
destDir |
File: Es un objeto File de un directorio en el que se guardará el archivo de recursos. |
targetFileName |
String: Un String para el nombre del archivo en el que se guardará. |
| Muestra | |
|---|---|
File |
Es un objeto File del archivo guardado. |
| Arroja | |
|---|---|
IOException |
Si no se pudo guardar el archivo |
setReadableRecursive
public static void setReadableRecursive (File file)
Establece de forma recursiva los permisos de lectura y ejecución (si es una carpeta) para el archivo determinado.
| Parámetros | |
|---|---|
file |
File |
sizeOfDirectory
public static Long sizeOfDirectory (File directory)
Devuelve el tamaño que informa el directorio.
| Parámetros | |
|---|---|
directory |
File |
| Muestra | |
|---|---|
Long |
|
symlinkFile
public static void symlinkFile (File origFile,
File destFile)Método auxiliar que crea un vínculo simbólico de un archivo a otro
| Parámetros | |
|---|---|
origFile |
File: El archivo original |
destFile |
File: el archivo de destino |
| Arroja | |
|---|---|
IOException |
Si no se pudo crear el vínculo simbólico del archivo |
unixModeToPosix
public static Set<PosixFilePermission> unixModeToPosix (int mode)
Convierte un número entero que representa el modo de Unix en un conjunto de PosixFilePermissions.
| Parámetros | |
|---|---|
mode |
int |
| Muestra | |
|---|---|
Set<PosixFilePermission> |
|
writeToFile
public static void writeToFile (String inputString,
File destFile)Método auxiliar para escribir datos de cadena en un archivo
| Parámetros | |
|---|---|
inputString |
String: Es el String de entrada. |
destFile |
File: Es el archivo de destino en el que se escribirá. |
| Arroja | |
|---|---|
IOException |
|
writeToFile
public static void writeToFile (InputStream input,
File destFile,
boolean append)Método auxiliar para escribir datos de transmisión en un archivo
| Parámetros | |
|---|---|
input |
InputStream: Es el flujo de entrada sin búfer. |
destFile |
File: Es el archivo de destino en el que se escribirá o al que se agregará contenido. |
append |
boolean: Agrega al final del archivo si es verdadero; de lo contrario, sobrescribe. |
| Arroja | |
|---|---|
IOException |
|
writeToFile
public static void writeToFile (InputStream input,
File destFile)Método auxiliar para escribir datos de transmisión en un archivo
| Parámetros | |
|---|---|
input |
InputStream: Es el flujo de entrada sin búfer. |
destFile |
File: Es el archivo de destino en el que se escribirá. |
| Arroja | |
|---|---|
IOException |
|
writeToFile
public static void writeToFile (String inputString,
File destFile,
boolean append)Método auxiliar para escribir o agregar datos de cadena a un archivo
| Parámetros | |
|---|---|
inputString |
String: Es el String de entrada. |
destFile |
File: Es el archivo de destino en el que se escribirá o al que se agregará contenido. |
append |
boolean: Agrega al final del archivo si es verdadero; de lo contrario, sobrescribe. |
| Arroja | |
|---|---|
IOException |
|
writeToFile
public static void writeToFile (InputStream input,
File destFile,
boolean append,
long startOffset,
long size)Método auxiliar para escribir datos de transmisión en un archivo
| Parámetros | |
|---|---|
input |
InputStream: Es el flujo de entrada sin búfer. |
destFile |
File: Es el archivo de destino en el que se escribirá o al que se agregará contenido. |
append |
boolean: Agrega al final del archivo si es verdadero; de lo contrario, sobrescribe. |
startOffset |
long: Es el desplazamiento inicial del flujo de entrada para recuperar datos. |
size |
long: Cantidad de bytes que se recuperarán del flujo de entrada. Se debe establecer en un valor negativo para recuperar todo el contenido a partir del desplazamiento determinado. |
| Arroja | |
|---|---|
IOException |
|
Métodos protegidos
chmodExists
protected static boolean chmodExists ()
Es un asistente interno para determinar si "chmod" está disponible en el SO del sistema.
| Muestra | |
|---|---|
boolean |
|
setChmodBinary
protected static void setChmodBinary (String chmodName)
Se expone para pruebas. Permite modificar el nombre binario de chmod que buscamos, para probar el sistema sin compatibilidad con chmod.
| Parámetros | |
|---|---|
chmodName |
String |