ColdBox Platform Version 3.7.0

coldbox.system.core.util
Class Zip

WEB-INF.cftags.component
        extended by coldbox.system.core.util.Zip
Direct Known Subclasses:
Zip

public class Zip
extends WEB-INF.cftags.component

A collections of functions that supports the Zip and GZip functionality by using the Java Zip file API.


Constructor Summary
init()
 
Method Summary
 boolean AddFiles(string zipFilePath, [string files=''], [string directory=''], [string filter=''], [boolean recurse='no'], [numeric compression='9'], [boolean savePaths='no'])
          Add files to a new or an existing Zip file archive
 boolean DeleteFiles(string zipFilePath, string files)
          Delete files from an existing Zip file archive
 boolean Extract(string zipFilePath, [string extractPath='[runtime expression]'], [string extractFiles], [boolean useFolderNames='yes'], [boolean overwriteFiles='no'])
          Extracts a specified Zip file into a specified directory
private array FilesList(string directory, [string filter=''], [boolean recurse='no'])
          Create an array with the file names of specified directory
 query List(string zipFilePath)
          List the content of a specified Zip file
private string PathFormat(string path)
          Convert path into Windows or Unix format
 Zip configure()
          Configure for operation
 boolean gzipAddFile(string gzipFilePath, string filePath)
          Create a new GZip file archive
 boolean gzipExtract(string gzipFilePath, [string extractPath='[runtime expression]'])
          Extracts a specified GZip file into a specified directory
 
Methods inherited from class WEB-INF.cftags.component
 

Constructor Detail

init

public init()

Method Detail

AddFiles

public boolean AddFiles(string zipFilePath, [string files=''], [string directory=''], [string filter=''], [boolean recurse='no'], [numeric compression='9'], [boolean savePaths='no'])
Add files to a new or an existing Zip file archive.

Parameters:
zipFilePath - Pathname of the Zip file to add files.
files - | (Chr(124)) delimited list of files to add to the Zip file. Required if argument 'directory' is not set.
directory - Absolute pathname of directory to add to the Zip file. Required if argument 'files' is not set.
filter - File extension filter. One filter can be applied. Only if argument 'directory' is set.
recurse - Get recursive files of subdirectories. Only if argument 'directory' is set.
compression - Compression level (0 through 9, 0=minimum, 9=maximum).
savePaths - Save full path info.

DeleteFiles

public boolean DeleteFiles(string zipFilePath, string files)
Delete files from an existing Zip file archive.

Parameters:
zipFilePath - Pathname of the Zip file to delete files from.
files - | (Chr(124)) delimited list of files to delete from Zip file.

Extract

public boolean Extract(string zipFilePath, [string extractPath='[runtime expression]'], [string extractFiles], [boolean useFolderNames='yes'], [boolean overwriteFiles='no'])
Extracts a specified Zip file into a specified directory.

Parameters:
zipFilePath - Pathname of the Zip file to extract.
extractPath - Pathname to extract the Zip file to.
extractFiles - | (Chr(124)) delimited list of files to extract.
useFolderNames - Create folders using the pathinfo stored in the Zip file.
overwriteFiles - Overwrite existing files.

FilesList

private array FilesList(string directory, [string filter=''], [boolean recurse='no'])
Create an array with the file names of specified directory.

Parameters:
directory - Absolute pathname of directory to get files list.
filter - File extension filter. One filter can be applied.
recurse - Get recursive files of subdirectories.

List

public query List(string zipFilePath)
List the content of a specified Zip file.

Parameters:
zipFilePath - Pathname of the Zip file to list the content.

PathFormat

private string PathFormat(string path)
Convert path into Windows or Unix format.

Parameters:
path - The path to convert.

configure

public Zip configure()
Configure for operation


gzipAddFile

public boolean gzipAddFile(string gzipFilePath, string filePath)
Create a new GZip file archive.

Parameters:
gzipFilePath - Pathname of the GZip file to create.
filePath - Pathname of a file to add to the GZip file archive.

gzipExtract

public boolean gzipExtract(string gzipFilePath, [string extractPath='[runtime expression]'])
Extracts a specified GZip file into a specified directory.

Parameters:
gzipFilePath - Pathname of the GZip file to extract.
extractPath - Pathname to extract the GZip file to.

ColdBox Platform Version 3.7.0