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 ZipUtil#closeZip(ZipFile) .

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 convertToReadableSize(long) .

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 ERROR(/File#createTempFile(String, String, File)) que audita el posible escenario de falta de espacio en disco.

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.

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 ZipUtil#createZip(File) .

static void createZip (File dir, File zipFile)

Este método está en desuso. Movido a ZipUtil#createZip(File, File) .

static void deleteFile (File file)

Intente eliminar un archivo.

static File extractFileFromZip (ZipFile zipFile, String filePath)

Este método está en desuso. Movido a ZipUtil#extractFileFromZip(ZipFile, String) .

static void extractZip (ZipFile zipFile, File destDir)

Este método está en desuso. Movido a ZipUtil#extractZip(ZipFile, File) .

static File findDirectory (String dirName, File... dirs)

Busque y devuelva el primer directorio ERROR(/File) entre otros directorios.

static findDirsUnder (File rootDir, File relativeParent)

Encuentre recursivamente todos los directorios bajo el rootDir dado

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 ZipUtil#gzipFile(File, File) .

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 chmodGroupRWX(File) .

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 ERROR(/PosixFilePermission) s

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. Ver chmodGroupRWX(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 static  collectJars (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

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

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 static  findDirsUnder (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 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.

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 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

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 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

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 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

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 : conjunto de archivos que deben copiarse en lugar de vincularse.

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 static  unixModeToPosix (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 ZipUtil#closeZip(ZipFile) .

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 convertToReadableSize(long) .

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 ERROR(/File#createTempFile(String, String, File)) que audita el posible escenario de falta de espacio en disco.

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.

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 ZipUtil#createZip(File) .

static void createZip (File dir, File zipFile)

Este método está en desuso. Movido a ZipUtil#createZip(File, File) .

static void deleteFile (File file)

Intente eliminar un archivo.

static File extractFileFromZip (ZipFile zipFile, String filePath)

Este método está en desuso. Movido a ZipUtil#extractFileFromZip(ZipFile, String) .

static void extractZip (ZipFile zipFile, File destDir)

Este método está en desuso. Movido a ZipUtil#extractZip(ZipFile, File) .

static File findDirectory (String dirName, File... dirs)

Busque y devuelva el primer directorio ERROR(/File) entre otros directorios.

static findDirsUnder (File rootDir, File relativeParent)

Encuentre recursivamente todos los directorios bajo el rootDir dado

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 ZipUtil#gzipFile(File, File) .

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 chmodGroupRWX(File) .

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 ERROR(/PosixFilePermission) s

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. Ver chmodGroupRWX(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 static  collectJars (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

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

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 static  findDirsUnder (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 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.

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 static  findFiles (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 static  findFilesObject (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 static  findFilesObject (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 : Set of files that needs to be copied instead of linked.

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 static  unixModeToPosix (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