Unpacker

DEFLATE_HINT

static val DEFLATE_HINT: String

Property indicating that the unpacker should ignore all transmitted values for DEFLATE_HINT, replacing them by the given value, TRUE or FALSE. The default value is the special string KEEP, which asks the unpacker to preserve all transmitted deflation hints.

Value: "unpack.deflate.hint"

FALSE

static val FALSE: String

The string "false", a possible value for certain properties.

Value: "false"

KEEP

static val KEEP: String

The string "keep", a possible value for certain properties.

Value: "keep"

PROGRESS

static val PROGRESS: String

The unpacker's progress as a percentage, as periodically updated by the unpacker. Values of 0 - 100 are normal, and -1 indicates a stall. Progress can be monitored by polling the value of this property.

At a minimum, the unpacker must set progress to 0 at the beginning of a packing operation, and to 100 at the end.

Value: "unpack.progress"

TRUE

static val TRUE: String

The string "true", a possible value for certain properties.

Value: "true"

addPropertyChangeListener

open fun addPropertyChangeListener(listener: PropertyChangeListener!): Unit

Deprecated: The dependency on PropertyChangeListener creates a significant impediment to future modularization of the Java platform. This method will be removed in a future release. Applications that need to monitor progress of the unpacker can poll the value of the PROGRESS property instead.

Registers a listener for PropertyChange events on the properties map. This is typically used by applications to update a progress bar.

The default implementation of this method does nothing and has no side-effects.

WARNING: This method is omitted from the interface declaration in all subset Profiles of Java SE that do not include the java.beans package.

properties

abstract fun properties(): SortedMap<String!, String!>!

Get the set of this engine's properties. This set is a "live view", so that changing its contents immediately affects the Packer engine, and changes from the engine (such as progress indications) are immediately visible in the map.

The property map may contain pre-defined implementation specific and default properties. Users are encouraged to read the information and fully understand the implications, before modifying pre-existing properties.

Implementation specific properties are prefixed with a package name associated with the implementor, beginning with com. or a similar prefix. All property names beginning with pack. and unpack. are reserved for use by this API.

Unknown properties may be ignored or rejected with an unspecified error, and invalid entries may cause an unspecified error to be thrown.

removePropertyChangeListener

open fun removePropertyChangeListener(listener: PropertyChangeListener!): Unit

Deprecated: The dependency on PropertyChangeListener creates a significant impediment to future modularization of the Java platform. This method will be removed in a future release.

Remove a listener for PropertyChange events, added by the addPropertyChangeListener.

The default implementation of this method does nothing and has no side-effects.

WARNING: This method is omitted from the interface declaration in all subset Profiles of Java SE that do not include the java.beans package.

unpack

abstract fun unpack(
    in: File!, 
    out: JarOutputStream!
): Unit

Read a Pack200 archive, and write the encoded JAR to a JarOutputStream.

Does not close its output. (The output can accumulate more elements.)

unpack

abstract fun unpack(
    in: InputStream!, 
    out: JarOutputStream!
): Unit

Read a Pack200 archive, and write the encoded JAR to a JarOutputStream. The entire contents of the input stream will be read. It may be more efficient to read the Pack200 archive to a file and pass the File object, using the alternate method described below.

Closes its input but not its output. (The output can accumulate more elements.)