Pack200.Packer

CLASS_ATTRIBUTE_PFX

String CLASS_ATTRIBUTE_PFX

与类属性名称连接时，使用JSR 200规范中指定的布局语言指示该属性的格式。

例如，此选项的效果内置于： pack.class.attribute.SourceFile=RUH 。

特殊字符串ERROR ， STRIP ，并PASS也可以，用相同的含义UNKNOWN_ATTRIBUTE 。 这为用户请求特定属性被拒绝，剥离或按位传递提供了一种方式（无类压缩）。

这样的代码可能被用来支持JCOV的属性：

     Map p = packer.properties();
     p.put(CODE_ATTRIBUTE_PFX+"CoverageTable",       "NH[PHHII]");
     p.put(CODE_ATTRIBUTE_PFX+"CharacterRangeTable", "NH[PHPOHIIH]");
     p.put(CLASS_ATTRIBUTE_PFX+"SourceID",           "RUH");
     p.put(CLASS_ATTRIBUTE_PFX+"CompilationID",      "RUH");
 

这样的代码可能被用来去除调试属性：

     Map p = packer.properties();
     p.put(CODE_ATTRIBUTE_PFX+"LineNumberTable",    STRIP);
     p.put(CODE_ATTRIBUTE_PFX+"LocalVariableTable", STRIP);
     p.put(CLASS_ATTRIBUTE_PFX+"SourceFile",        STRIP);
 

常量值：“pack.class.attribute。”

CODE_ATTRIBUTE_PFX

String CODE_ATTRIBUTE_PFX

与代码属性名称连接时，表示该属性的格式。 例如，此选项的效果内置于： pack.code.attribute.LocalVariableTable=NH[PHOHRUHRSHH] 。 特殊字符串ERROR ， STRIP ，并PASS也是允许的。

常量值：“pack.code.attribute。”

DEFLATE_HINT

String DEFLATE_HINT

如果此属性设置为 TRUE或 FALSE ，那么 FALSE将相应地在输出存档中设置 FALSE提示，并且不会传送存档元素的个别缩小提示。

如果此属性设置为特殊字符串 KEEP ，则 KEEP器将尝试为输入存档的每个可用元素确定独立的 KEEP提示，并分别传送此提示。

缺省值是 KEEP ，它保留输入信息，但可能导致发送的归档大于所需值。

取决于解包装的实施，根据提示采取行动以适当压缩最终解包的罐子的元素。

ZIP或JAR元素的通货紧缩提示指示元素是否放气或直接存储。

常量值：“pack.deflate.hint”

EFFORT

String EFFORT

如果此属性设置为单个十进制数字，则打包器将使用指定的精力压缩存档。 级别1可能产生更大的尺寸和更快的压缩速度，而级别9会花费更长的时间，但可能产生更好的压缩。

特殊值0指示打包器直接复制原始JAR文件，不进行压缩。 JSR 200标准要求任何解包器理解这个特殊情况作为整个存档的传递。

默认值是5，投入适量的时间来产生合理的压缩。

常量值：“pack.effort”

ERROR

String ERROR

字符串“error”，某些属性的可能值。

常量值：“错误”

FALSE

String FALSE

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

常量值：“false”

FIELD_ATTRIBUTE_PFX

String FIELD_ATTRIBUTE_PFX

与字段属性名称连接时，表示该属性的格式。 例如，此选项的效果内置于： pack.field.attribute.Deprecated= 。 特殊字符串ERROR ， STRIP ，并PASS也是允许的。

常量值：“pack.field.attribute。”

KEEP

String KEEP

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

常数值：“保持”

KEEP_FILE_ORDER

String KEEP_FILE_ORDER

如果此属性设置为 TRUE ，则 TRUE将在源存档中以原始顺序传输所有元素。

如果设置为FALSE ，那么FALSE可能会对元素重新排序，并删除JAR目录项，这些项不包含Java应用程序的有用信息。 （通常这可以实现更好的压缩。）

缺省值是 TRUE ，它保留输入信息，但可能导致发送的归档大于所需值。

常量值：“pack.keep.file.order”

LATEST

String LATEST

字符串“latest”，某些属性的可能值。

常数值：“最新”

METHOD_ATTRIBUTE_PFX

String METHOD_ATTRIBUTE_PFX

与方法属性名称连接时，指示该属性的格式。 例如，此选项的效果内置于： pack.method.attribute.Exceptions=NH[RCH] 。 特殊字符串ERROR ， STRIP ，并PASS也是允许的。

常量值：“pack.method.attribute。”

MODIFICATION_TIME

String MODIFICATION_TIME

如果此属性设置为特殊字符串LATEST ， LATEST器将尝试确定原始归档中所有可用条目中的最新修改时间或每个段中所有可用条目的最新修改时间。 该单个值将作为分段的一部分进行传输，并应用于每个分段SEGMENT_LIMIT所有条目。

这可以稍微减少存档的传输大小，但将所有安装的文件设置为单一日期。

如果此属性设置为特殊字符串 KEEP ，则 KEEP器会为每个输入元素发送单独的修改时间。

缺省值为 KEEP ，它保留输入信息，但可能导致传输的归档大于所需值。

取决于解包器的实现，可以采取措施适当地设置其输出文件的每个元素的修改时间。

常量值：“pack.modification.time”

PASS

String PASS

字符串“传递”，某些属性的可能值。

常数值：“通过”

PASS_FILE_PFX

String PASS_FILE_PFX

指示文件应该按字节传递，不进行压缩。 可以通过指定附加不同字符串的附加属性来指定多个文件，以制作具有通用前缀的属性族。

没有路径名转换，除了系统文件分隔符被JAR文件分隔符'/'替换。

生成的文件名必须与JAR文件中出现的字符串完全匹配。

如果属性值是目录名称，则该目录下的所有文件也将被传递。

例子：

     Map p = packer.properties();
     p.put(PASS_FILE_PFX+0, "mutants/Rogue.class");
     p.put(PASS_FILE_PFX+1, "mutants/Wolverine.class");
     p.put(PASS_FILE_PFX+2, "mutants/Storm.class");
     # Pass all files in an entire directory hierarchy:
     p.put(PASS_FILE_PFX+3, "police/");
 

常量值：“pack.pass.file”。

PROGRESS

String PROGRESS

解包器的进度百分比，由解包器定期更新。 0 - 100的值正常，-1表示失速。 使用PropertyChangeListener观察此属性。

打包机必须至少在包装操作开始时将进度设置为0，最后设置为100。

常量值：“pack.progress”

SEGMENT_LIMIT

String SEGMENT_LIMIT

该属性是一个数字，给出每个归档段的估计目标大小N（以字节为单位）。 如果单个输入文件需要多于N个字节，则会给它自己的归档段。

作为一种特殊情况，值为-1会产生一个包含所有输入文件的大型段，而值0会为每个类产生一个段。 较大的归档段导致较少的碎片和较好的压缩，但处理它们需要更多的内存。

每个片段的大小通过计算片段中要传输的每个输入文件的大小以及其名称和其他传输属性的大小来估计。

默认值为-1，这意味着打包器将始终创建单个段输出文件。 在生成极大输出文件的情况下，强烈建议用户使用分段或将输入文件分解为较小的JAR。

没有这个限制的10Mb JAR包装通常会减小约10％，但是打包者可能需要更大的Java堆（约为段限制的十倍）。

常量值：“pack.segment.limit”

STRIP

String STRIP

字符串“strip”，某些属性的可能值。

常数值：“strip”

TRUE

String TRUE

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

常量值：“true”

UNKNOWN_ATTRIBUTE

String UNKNOWN_ATTRIBUTE

指示遇到包含未知属性的类文件时要执行的操作。 可能的值是字符串ERROR ， STRIP ，并PASS 。

字符串ERROR意味着整个包装操作将失败，但类型IOException 。 字符串STRIP表示属性将被删除。 字符串PASS意味着整个类文件将被传递（如同它是一个资源文件一样）而不压缩，并带有适当的警告。 这是此属性的默认值。

例子：

     Map p = pack200.getProperties();
     p.put(UNKNOWN_ATTRIBUTE, ERROR);
     p.put(UNKNOWN_ATTRIBUTE, STRIP);
     p.put(UNKNOWN_ATTRIBUTE, PASS);
 

常量值：“pack.unknown.attribute”

addPropertyChangeListener

void addPropertyChangeListener (PropertyChangeListener listener)

在属性图上注册PropertyChange事件的侦听器。 这通常由应用程序用来更新进度栏。

pack

void pack (JarInputStream in, 
                OutputStream out)

接收JarInputStream并将其转换为Pack200存档。

关闭输入，但不输出。 （Pack200档案是可追加的。）

对于JAR清单文件及其包含的目录，修改时间和通货紧缩提示属性不可用。

pack

void pack (JarFile in, 
                OutputStream out)

接收JarFile并将其转换为Pack200存档。

关闭输入，但不输出。 （Pack200档案是可追加的。）

properties

SortedMap<String, String> properties ()

获取该引擎的属性集。 该集合是一个“实时视图”，因此更改其内容将立即影响Packer引擎，并且引擎中的更改（例如进度指示）会立即在地图中可见。

属性图可能包含预定义的实现特定属性和默认属性。 鼓励用户在修改预先存在的属性之前阅读信息并充分理解其含义。

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

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

返回的地图实现所有可选的 SortedMap操作

removePropertyChangeListener

void removePropertyChangeListener (PropertyChangeListener listener)

移除PropertyChange事件的监听器，由 addPropertyChangeListener(PropertyChangeListener)添加。