ZipUtil

public class ZipUtil
extends Object

java.lang.Object
↳	com.android.tradefed.util.ZipUtil

---

Une classe d'assistance pour les opérations liées à la compression

Résumé

Constructeurs publics
ZipUtil()

Méthodes publiques
static void	addToZip(ZipOutputStream out, File file, relativePathSegs) Ajoute de manière récursive le fichier donné et son contenu à ZipOutputStream
static void	applyPermission(File targetFile, CentralDirectoryInfo zipEntry) Appliquez l'autorisation de fichier configurée dans l'entrée de répertoire central.
static void	closeZip(ZipFile zipFile) Fermez une ERROR(/ZipFile) ouverte, en ignorant les exceptions.
static File	createZip(File dir) Méthode utilitaire permettant de créer un fichier ZIP temporaire contenant le répertoire donné et tout son contenu.
static File	createZip( files, String name) Méthode utilitaire permettant de créer un fichier ZIP temporaire contenant les fichiers indiqués
static File	createZip(File dir, String name) Méthode utilitaire permettant de créer un fichier ZIP temporaire contenant le répertoire donné et tout son contenu.
static File	createZip( files) Méthode utilitaire permettant de créer un fichier ZIP temporaire contenant les fichiers indiqués
static void	createZip(File dir, File zipFile) Méthode utilitaire permettant de créer un fichier ZIP contenant le répertoire donné et tout son contenu.
static void	createZip( files, File zipFile) Méthode utilitaire permettant de créer un fichier ZIP contenant les fichiers indiqués
static File	extractFileFromZip(ZipFile zipFile, String filePath) Méthode utilitaire pour extraire un fichier spécifique d'un fichier zip dans un fichier tmp
static void	extractZip(ZipFile zipFile, File destDir) Méthode utilitaire permettant d'extraire l'intégralité du contenu d'un fichier ZIP dans un répertoire donné
static void	extractZip(ZipFile zipFile, File destDir, shouldExtract) Méthode utilitaire permettant d'extraire le contenu du fichier ZIP dans un répertoire donné
static File	extractZipToTemp(File zipFile, String nameHint) Extrayez un fichier ZIP dans un répertoire temporaire, précédé d'une chaîne
static	getZipCentralDirectoryInfos(File partialZipFile, EndCentralDirectoryInfo endCentralDirInfo, boolean useZip64) Obtenez une liste de {link CentralDirectoryInfo} pour les fichiers contenus dans un fichier ZIP.
static	getZipCentralDirectoryInfos(File partialZipFile, EndCentralDirectoryInfo endCentralDirInfo, long offset) Obtenez une liste de {link CentralDirectoryInfo} pour les fichiers contenus dans un fichier ZIP.
static	getZipCentralDirectoryInfos(File partialZipFile, EndCentralDirectoryInfo endCentralDirInfo) Obtenez une liste de {link CentralDirectoryInfo} pour les fichiers contenus dans un fichier ZIP.
static	getZipCentralDirectoryInfos(File partialZipFile, EndCentralDirectoryInfo endCentralDirInfo, long offset, boolean useZip64) Obtenez une liste de {link CentralDirectoryInfo} pour les fichiers contenus dans un fichier ZIP.
static void	gzipFile(File file, File gzipFile) Méthode d'assistance permettant de créer une version compressée avec gzip d'un seul fichier.
static boolean	isZipFileValid(File zipFile, boolean thorough) Méthode utilitaire permettant de vérifier qu'un fichier ZIP n'est pas corrompu.
static void	unzipPartialZipFile(File partialZip, File targetFile, CentralDirectoryInfo zipEntry, LocalFileHeader localFileHeader, long startOffset) Extrayez un seul fichier demandé à partir d'un fichier ZIP partiel.
static void	unzipPartialZipFolder(File targetFile, CentralDirectoryInfo zipEntry) Extrayez le dossier demandé d'un fichier ZIP partiel et appliquez les autorisations appropriées.

Méthodes protégées
static void	validateDestinationDir(File destDir, String filename)

Constructeurs publics

ZipUtil

public ZipUtil ()

Méthodes publiques

addToZip

public static void addToZip (ZipOutputStream out, 
                File file, 
                 relativePathSegs)

Ajoute de manière récursive le fichier donné et son contenu à ZipOutputStream

Paramètres
out	ZipOutputStream: ERROR(/ZipOutputStream)
file	File: ERROR(/File) à ajouter au flux
relativePathSegs	: chemin relatif du fichier, y compris les séparateurs

Génère
	si l'ajout du fichier au ZIP n'a pas abouti

applyPermission

public static void applyPermission (File targetFile, 
                CentralDirectoryInfo zipEntry)

Appliquez l'autorisation de fichier configurée dans l'entrée de répertoire central.

Paramètres
targetFile	File: ERROR(/File) sur lequel définir l'autorisation.
zipEntry	CentralDirectoryInfo: objet CentralDirectoryInfo contenant les autorisations de fichiers.

Génère
	si vous n'arrivez pas à accéder au fichier.

fermerZip

public static void closeZip (ZipFile zipFile)

Fermez une ERROR(/ZipFile) ouverte, en ignorant les exceptions.

Paramètres
zipFile	ZipFile: fichier à fermer.

createZip

public static File createZip (File dir)

Méthode utilitaire permettant de créer un fichier ZIP temporaire contenant le répertoire donné et tout son contenu.

Paramètres
dir	File: répertoire à compresser

Renvoie
File	Un fichier ZIP temporaire ERROR(/File) contenant le contenu du répertoire

Génère
	si la création du fichier zip n'a pas abouti

createZip

public static File createZip ( files, 
                String name)

Méthode utilitaire permettant de créer un fichier ZIP temporaire contenant les fichiers indiqués

Paramètres
files	: liste des fichiers à compresser.
name	String: nom de base du fichier ZIP créé sans l'extension.

Renvoie
File	Un fichier ZIP temporaire ERROR(/File) contenant le contenu du répertoire

Génère
	si la création du fichier zip n'a pas abouti

createZip

public static File createZip (File dir, 
                String name)

Méthode utilitaire permettant de créer un fichier ZIP temporaire contenant le répertoire donné et tout son contenu.

Paramètres
dir	File: répertoire à compresser
name	String: nom de base du fichier ZIP créé sans l'extension.

Renvoie
File	Un fichier ZIP temporaire ERROR(/File) contenant le contenu du répertoire

Génère
	si la création du fichier zip n'a pas abouti

createZip

public static File createZip ( files)

Méthode utilitaire permettant de créer un fichier ZIP temporaire contenant les fichiers indiqués

Paramètres
files	: liste des fichiers à compresser.

Renvoie
File	Un fichier ZIP temporaire ERROR(/File) contenant le contenu du répertoire

Génère
	si la création du fichier zip n'a pas abouti

createZip

public static void createZip (File dir, 
                File zipFile)

Méthode utilitaire permettant de créer un fichier ZIP contenant le répertoire donné et tout son contenu.

Paramètres
dir	File: répertoire à compresser
zipFile	File: fichier ZIP à créer (il ne doit pas déjà exister)

Génère
	si la création du fichier zip n'a pas abouti

createZip

public static void createZip ( files, 
                File zipFile)

Méthode utilitaire permettant de créer un fichier ZIP contenant les fichiers indiqués

Paramètres
files	: liste des fichiers à compresser.
zipFile	File: fichier ZIP à créer (il ne doit pas déjà exister)

Génère
	si la création du fichier zip n'a pas abouti

extractFileFromZip

public static File extractFileFromZip (ZipFile zipFile, 
                String filePath)

Méthode utilitaire pour extraire un fichier spécifique d'un fichier zip dans un fichier tmp

Paramètres
zipFile	ZipFile: ERROR(/ZipFile) à extraire
filePath	String: chemin d'accès au fichier à extraire

Renvoie
File	La valeur ERROR(/File) ou la valeur "null" si elle est introuvable

Génère
	si l'extraction du fichier a échoué

extractZip

public static void extractZip (ZipFile zipFile, 
                File destDir)

Méthode utilitaire permettant d'extraire l'intégralité du contenu d'un fichier ZIP dans un répertoire donné

Paramètres
zipFile	ZipFile: ERROR(/ZipFile) à extraire
destDir	File: répertoire local dans lequel extraire le fichier

Génère
	si l'extraction du fichier a échoué

extractZip

public static void extractZip (ZipFile zipFile, 
                File destDir, 
                 shouldExtract)

Méthode utilitaire permettant d'extraire le contenu du fichier ZIP dans un répertoire donné

Paramètres
zipFile	ZipFile: ERROR(/ZipFile) à extraire
destDir	File: répertoire local dans lequel extraire le fichier
shouldExtract	: prédicat à dermine si une entrée ZipEntry doit être extraite

Génère
	si l'extraction du fichier a échoué

extractZipToTemp

public static File extractZipToTemp (File zipFile, 
                String nameHint)

Extrayez un fichier ZIP dans un répertoire temporaire, précédé d'une chaîne

Paramètres
zipFile	File: fichier ZIP à extraire
nameHint	String: préfixe du répertoire temporaire

Renvoie
File	Un ERROR(/File) pointant vers le répertoire temporaire

getZipCentralDirectoryInfos

public static  getZipCentralDirectoryInfos (File partialZipFile, 
                EndCentralDirectoryInfo endCentralDirInfo, 
                boolean useZip64)

Obtenez une liste de {link CentralDirectoryInfo} pour les fichiers contenus dans un fichier ZIP.

Paramètres
partialZipFile	File: objet ERROR(/File) du fichier ZIP partiel contenant les entrées du répertoire central.
endCentralDirInfo	EndCentralDirectoryInfo: objet EndCentralDirectoryInfo du fichier ZIP.
useZip64	boolean: valeur booléenne permettant d'accepter le format ZIP64 pour les téléchargements partiels.

Renvoie
	Liste des CentralDirectoryInfo du fichier ZIP

Génère
	IOException

getZipCentralDirectoryInfos

public static  getZipCentralDirectoryInfos (File partialZipFile, 
                EndCentralDirectoryInfo endCentralDirInfo, 
                long offset)

Obtenez une liste de {link CentralDirectoryInfo} pour les fichiers contenus dans un fichier ZIP.

Paramètres
partialZipFile	File: objet ERROR(/File) du fichier ZIP partiel contenant les entrées du répertoire central.
endCentralDirInfo	EndCentralDirectoryInfo: objet EndCentralDirectoryInfo du fichier ZIP.
offset	long: décalage dans le fichier ZIP partiel où commence le contenu des entrées du répertoire central.

Renvoie
	Liste des CentralDirectoryInfo du fichier ZIP

Génère
	IOException

getZipCentralDirectoryInfos

public static  getZipCentralDirectoryInfos (File partialZipFile, 
                EndCentralDirectoryInfo endCentralDirInfo)

Obtenez une liste de {link CentralDirectoryInfo} pour les fichiers contenus dans un fichier ZIP.

Paramètres
partialZipFile	File: objet ERROR(/File) du fichier ZIP partiel contenant les entrées du répertoire central.
endCentralDirInfo	EndCentralDirectoryInfo: objet EndCentralDirectoryInfo du fichier ZIP.

Renvoie
	Liste des CentralDirectoryInfo du fichier ZIP

Génère
	IOException

getZipCentralDirectoryInfos

public static  getZipCentralDirectoryInfos (File partialZipFile, 
                EndCentralDirectoryInfo endCentralDirInfo, 
                long offset, 
                boolean useZip64)

Obtenez une liste de {link CentralDirectoryInfo} pour les fichiers contenus dans un fichier ZIP.

Paramètres
partialZipFile	File: objet ERROR(/File) du fichier ZIP partiel contenant les entrées du répertoire central.
endCentralDirInfo	EndCentralDirectoryInfo: objet EndCentralDirectoryInfo du fichier ZIP.
offset	long: décalage dans le fichier ZIP partiel où commence le contenu des entrées du répertoire central.
useZip64	boolean: valeur booléenne permettant d'accepter le format ZIP64 pour les téléchargements partiels.

Renvoie
	Liste des CentralDirectoryInfo du fichier ZIP

Génère
	IOException

Fichier gzip

public static void gzipFile (File file, 
                File gzipFile)

Méthode d'assistance permettant de créer une version compressée avec gzip d'un seul fichier.

Paramètres
file	File: fichier d'origine
gzipFile	File: fichier dans lequel placer le contenu compressé

Génère
	IOException

isZipFileValide

public static boolean isZipFileValid (File zipFile, 
                boolean thorough)

Méthode utilitaire permettant de vérifier qu'un fichier ZIP n'est pas corrompu.

Paramètres
zipFile	File: ERROR(/File) à vérifier
thorough	boolean: indique si l'extraction complète de l'archive doit être effectuée. Si la valeur est false, cette méthode ne parviendra pas à détecter les erreurs CRC dans une archive bien formée.

Renvoie
boolean	false si le fichier semble être corrompu ; true dans le cas contraire

Génère
	si le fichier n'a pas pu être ouvert ou lu

unzipPartialZipFile

public static void unzipPartialZipFile (File partialZip, 
                File targetFile, 
                CentralDirectoryInfo zipEntry, 
                LocalFileHeader localFileHeader, 
                long startOffset)

Extrayez un seul fichier demandé à partir d'un fichier ZIP partiel.

Cette méthode suppose que tous les fichiers sont compressés sur le même disque.

Si ERROR(/targetFile) est un répertoire, un répertoire vide sera créé sans son contenu.

Si ERROR(/targetFile) est un lien symbolique, un lien symbolique sera créé, mais pas résolu.

Il n'est pas encore compatible avec les fonctionnalités suivantes:

Fichier ZIP de plus de 4 Go

ZIP64(nécessite la mise à jour de ZipLocalFileHeader en cas de taille compressée)

Fichier ZIP chiffré

Paramètres
partialZip	File: ERROR(/File) qui n'est qu'une partie du fichier ZIP.
targetFile	File: ERROR(/File) dans lequel enregistrer le fichier extrait.
zipEntry	CentralDirectoryInfo: objet CentralDirectoryInfo du fichier à extraire du fichier ZIP partiel.
localFileHeader	LocalFileHeader: objet LocalFileHeader du fichier à extraire du fichier ZIP partiel.
startOffset	long: décalage de début du fichier à extraire.

Génère
	IOException

unzipPartialZipFolder

public static void unzipPartialZipFolder (File targetFile, 
                CentralDirectoryInfo zipEntry)

Extrayez le dossier demandé d'un fichier ZIP partiel et appliquez les autorisations appropriées.

Paramètres
targetFile	File: ERROR(/File) dans lequel enregistrer le fichier extrait.
zipEntry	CentralDirectoryInfo: objet CentralDirectoryInfo du fichier à extraire du fichier ZIP partiel.

Génère
	IOException

Méthodes protégées

ValidDestinationDir

protected static void validateDestinationDir (File destDir, 
                String filename)

Paramètres
destDir	File
filename	String