contentbox.models.util

Class ZipUtil

lucee.Component
    extended by contentbox.models.util.ZipUtil

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

Class Attributes:
  • cache : false
  •  
  • output : false
  •  
  • synchronized : false
  •  
  • accessors : false
  •  
  • persistent : false
  •  
    Constructor Summary
    init()
    Method Summary
    boolean AddFiles(string zipFilePath, [string files=''], [string directory=''], [string filter=''], [boolean recurse='false'], [numeric compression='9'], [boolean savePaths='false'])
         Add files to a new or an existing Zip file archive.
    ZipUtil configure()
         Configure for operation.
    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='true'], [boolean overwriteFiles='false'])
         Extracts a specified Zip file into a specified directory.
    private array FilesList(string directory, [string filter=''], [boolean recurse='false'])
         Create an array with the file names of specified directory.
    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.
    query List(string zipFilePath)
         List the content of a specified Zip file.
    private string PathFormat(string path)
         Convert path into Windows or Unix format.
     
    Methods inherited from class lucee.Component
    None

    Constructor Detail

    init

    public init()


    Method Detail

    AddFiles

    public boolean AddFiles(string zipFilePath, [string files=''], [string directory=''], [string filter=''], [boolean recurse='false'], [numeric compression='9'], [boolean savePaths='false'])

    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.

    configure

    public ZipUtil configure()

    Configure for operation


    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='true'], [boolean overwriteFiles='false'])

    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='false'])

    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.

    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.

    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.