java.util.jar
接口 Pack200.Unpacker

正在封闭类：

Pack200

public static interface Pack200.Unpacker

解包器引擎将打包的流转换为 JAR 文件。可使用 Pack200.newUnpacker() 获得该引擎的实例。

此引擎所生成的每个 JAR 文件将包括字符串 "PACK200" 作为 zip 文件注释。这允许部署者检测 JAR 存档是否被打包或解包。

解包器的此版本与以前所有版本兼容。

从以下版本开始：

1.5

字段摘要

static String	DEFLATE_HINT 此属性指示解包器应该忽略 DEFLATE_HINT 的所有已传输的值，并用给定值 TRUE 或 FALSE 替换它们。
static String	FALSE 字符串 "false"，某些属性的可能值。
static String	KEEP 字符串 "keep"，某些属性的可能值。
static String	PROGRESS 解包器的百分比进度，由解包器定期更新。
static String	TRUE 字符串 "true"，某些属性的可能值。

方法摘要

void	addPropertyChangeListener(PropertyChangeListener listener) 为属性映射上的 PropertyChange 事件注册一个侦听器。
SortedMap<String,String>	properties() 获取此引擎属性集。
void	removePropertyChangeListener(PropertyChangeListener listener) 移除由 addPropertyChangeListener(java.beans.PropertyChangeListener) 所添加的 PropertyChange 事件侦听器。
void	unpack(File in, JarOutputStream out) 读取 Pack200 存档，并将已编码的 JAR 写入 JarOutputStream。
void	unpack(InputStream in, JarOutputStream out) 读取 Pack200 存档，并将已编码的 JAR 写入 JarOutputStream。

字段详细信息

KEEP

static final String KEEP

字符串 "keep"，某些属性的可能值。

另请参见：

DEFLATE_HINT, 常量字段值

TRUE

static final String TRUE

字符串 "true"，某些属性的可能值。

另请参见：

DEFLATE_HINT, 常量字段值

FALSE

static final String FALSE

字符串 "false"，某些属性的可能值。

另请参见：

DEFLATE_HINT, 常量字段值

DEFLATE_HINT

static final String DEFLATE_HINT

此属性指示解包器应该忽略 DEFLATE_HINT 的所有已传输的值，并用给定值 TRUE 或 FALSE 替换它们。默认值为特殊字符串 KEEP，要求解包器保留所有已传输的压缩提示。

另请参见：

常量字段值

PROGRESS

static final String PROGRESS

解包器的百分比进度，由解包器定期更新。值 0 - 100 是正常的，-1 指示停止。用 PropertyChangeListener 观察此属性。

至少，解包器必须在打包操作开始时把进度设置为 0，在结束时把进度设置为 100。

另请参见：

addPropertyChangeListener(java.beans.PropertyChangeListener), 常量字段值

方法详细信息

properties

SortedMap<String,String> properties()

获取此引擎属性集。此集合是“实时视图”，所以更改其内容可立即影响 Packer 引擎，并且在映射中可立即见到引擎中的变化（如进度指示）。

属性映射可能包含指定和默认属性的预定义实现。鼓励用户在修改已存在的属性前阅读该信息，并完全理解其含意。

特定实现的属性是用与实现者相关的包名称作前缀的，以 com. 或类似前缀开头。以 pack. 和 unpack. 开头的所有属性名称保留给此 API 使用。

未知的属性可以用未指定的错误忽略或拒绝，并且无效的条目可能导致抛出未指定的错误。

返回：

选项键字符串到选项值的有序关联。

unpack

void unpack(InputStream in,
            JarOutputStream out)
            throws IOException

读取 Pack200 存档，并将已编码的 JAR 写入 JarOutputStream。将读取输入流的全部内容。使用下面描述的替代方法将 Pack200 存档读取到文件中并传递 File 对象可能更加高效。

关闭其输入，但并不关闭其输出。（输出可以累积更多元素。）

参数：

in - 一个 InputStream。

out - 一个 JarOutputStream。

抛出：

IOException - 如果遇到错误。

unpack

void unpack(File in,
            JarOutputStream out)
            throws IOException

读取 Pack200 存档，并将已编码的 JAR 写入 JarOutputStream。

不关闭其输出。（输出可以累积更多元素。）

参数：

in - 一个 File。

out - 一个 JarOutputStream。

抛出：

IOException - 如果遇到错误。

addPropertyChangeListener

void addPropertyChangeListener(PropertyChangeListener listener)

为属性映射上的 PropertyChange 事件注册一个侦听器。通常应用程序使用它来更新进度条。

参数：

listener - 更改属性时要调用的对象。

另请参见：

properties(), PROGRESS

removePropertyChangeListener

void removePropertyChangeListener(PropertyChangeListener listener)

移除由 addPropertyChangeListener(java.beans.PropertyChangeListener) 所添加的 PropertyChange 事件侦听器。

参数：

listener - 要移除的 PropertyChange 侦听器。

另请参见：

addPropertyChangeListener(java.beans.PropertyChangeListener)