IPWorks ZIP 2020 ActiveX Edition

Questions / Feedback?

Jar Control

Properties   Methods   Events   Configuration Settings   Errors  

The Jar control may be used to create or decompress Java archives.




The operation of the control is similar to that of Zip. .class and other files may be added into a .jar file, and then may be imported into Java code or executed by a JVM.

To create a new archive, first set the ArchiveFile property to the name of the archive to be created. Then, specify the files to be compressed either by invoking IncludeFiles, or by adding a new object to the Files collection and setting the values of the FileDecompressedName and FileCompressedName. fields. Finally, call the Compress method to create the archive.

To decompress an existing archive, set ArchiveFile to the name of the archive to be decompressed. The ExtractToPath property may be set, and then calling the ExtractAll method will decompress all files in the archive to this path.

For finer control, the Scan method should be used to read the file information stored in the archive. This will fill out the information in the Files collection. The values of FileDecompressedName may then be changed if desired. Finally, ExtractAll may be used to decompress the entire archive, or Extract may be used for finer control.

Data may be streamed out by setting WriteToProgressEvent to true. Then, the Progress event may be trapped to retrieve the data.

All Java archives contain two special entries, a META-INF directory and a manifest. By default, the control will automatically generate a default manifest and add the special entries to the beginning of the archive. To instead add a custom manifest to the archive the ManifestFile property should be set.

During decompression, the archive is treated as an ordinary zip file.

Example (Creating a Jar File)

ZipControl.ArchiveFile = "c:\test.jar"
ZipControl.RecurseSubdirectories = false
ZipControl.ManifestFile = "c:\code\manifest.mf"
Example (Extracting from a Jar File)

ZipControl.ArchiveFile = "c:\test.jar"
ZipControl.ExtractToPath = "c:\extracted\"

Property List

The following is the full list of the properties of the control with short descriptions. Click on the links for further details.

ArchiveFileThe name of the zip, gzip, tar, or jar archive.
CompressionLevelThe compression level to use.
ExcludedFilesA list of files to exclude.
ExtractToPathA base path to decompress to.
FileCountThe number of records in the File arrays.
FileCompressedDateThe date and time of the entry, as stored within the archive.
FileCompressedNameThe file name of the current file, as stored inside of the archive.
FileCompressedSizeThe size of the compressed data, as compressed within the archive.
FileDecompressedNameThe name of the file in the archive, as stored on the file system, outside the archive.
FileDecompressedSizeThe size of the file, as decompressed outside the archive.
FileInputDataWhen This property is set, the control will read in the data from This property instead of reading from the file contained in the DecompressedName property.
JarData(Decompression only) The jar file contents as a byte array.
ManifestFileThe name of the manifest file.
OverwriteFilesWhether or not to overwrite files.
RecurseSubdirectoriesWhether or not to recurse into subdirectories.

Method List

The following is the full list of the methods of the control with short descriptions. Click on the links for further details.

AbortAborts the current operation.
AppendFilesAdds specified files to an existing archive.
CompressCreates the compressed archive.
ConfigSets or retrieves a configuration setting.
DeleteDeletes one or more files from an existing archive.
ExtractExtracts a single file, directory, or group of files, from the archive.
ExtractAllExtracts all files from the compressed archive.
IncludeFilesSpecifies that the indicated files should be added to the archive.
ResetResets the control.
ScanScans the compressed archive.

Event List

The following is the full list of the events fired by the control with short descriptions. Click on the links for further details.

BeginFileFired before each file is processed.
EndFileFired after each file is processed.
ErrorInformation about non-fatal errors.
OverwriteFired whenever a file exists and may be overwritten.
ProgressFired as progress is made.

Configuration Settings

The following is a list of configuration settings for the control with short descriptions. Click on the links for further details.

CheckForFileLocksIf true, the control requests an exclusive lock during initialization.
ExcludedAttributesAttributes of files to be excluded.
ExtractFilesOnlyWhether to only extract the files contained within the archive.
OverwriteReadonlyFilesWhether to overwrite readonly files.
WriteToProgressEventWhether or not to write data to the Progress Event.
CodePageThe system code page used for Unicode to Multibyte translations.
UseInternalSecurityAPITells the control whether or not to use the system security libraries or an internal implementation.

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks ZIP 2020 ActiveX Edition - Version 20.0 [Build 8172]