pack200.packer.html

来自「j2se5-api-zh,java文档的中文版本」· HTML 代码 · 共 840 行 · 第 1/3 页

<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>方法摘要</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="Pack200.Packer.html#addPropertyChangeListener(java.beans.PropertyChangeListener)">addPropertyChangeListener</A></B>(java.beans.PropertyChangeListener&nbsp;listener)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;为属性映射上的 PropertyChange 事件注册一个侦听器。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="Pack200.Packer.html#pack(java.util.jar.JarFile, java.io.OutputStream)">pack</A></B>(<A HREF="JarFile.html" title="java.util.jar 中的类">JarFile</A>&nbsp;in,
     java.io.OutputStream&nbsp;out)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;接收 JarFile 并将其转换为 Pack200 存档。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="Pack200.Packer.html#pack(java.util.jar.JarInputStream, java.io.OutputStream)">pack</A></B>(<A HREF="JarInputStream.html" title="java.util.jar 中的类">JarInputStream</A>&nbsp;in,
     java.io.OutputStream&nbsp;out)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;接收 JarInputStream 并将其转换成 Pack200 存档。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="../SortedMap.html" title="java.util 中的接口">SortedMap</A>&lt;<A HREF="../../lang/String.html" title="java.lang 中的类">String</A>,<A HREF="../../lang/String.html" title="java.lang 中的类">String</A>&gt;</CODE></FONT></TD>
<TD><CODE><B><A HREF="Pack200.Packer.html#properties()">properties</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;获取此引擎属性的集合。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="Pack200.Packer.html#removePropertyChangeListener(java.beans.PropertyChangeListener)">removePropertyChangeListener</A></B>(java.beans.PropertyChangeListener&nbsp;listener)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;移除由 <A HREF="Pack200.Packer.html#addPropertyChangeListener(java.beans.PropertyChangeListener)"><CODE>addPropertyChangeListener(java.beans.PropertyChangeListener)</CODE></A> 所添加的 PropertyChange 事件侦听器。</TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ============ FIELD DETAIL =========== -->

<A NAME="field_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>字段详细信息</B></FONT></TH>
</TR>
</TABLE>

<A NAME="SEGMENT_LIMIT"><!-- --></A><H3>
SEGMENT_LIMIT</H3>
<PRE>
static final <A HREF="../../lang/String.html" title="java.lang 中的类">String</A> <B>SEGMENT_LIMIT</B></PRE>
<DL>
<DD>此属性是一个数字，给出了每个存档段的估计目标大小 N（以字节为单位）。如果单个输入文件要求超过 N 字节，那么将给出它自己的存档段。
 <p>
作为特殊情况，值 -1 将生成使用所有输入文件的单个大段，而值 0 将为每个类生成一个段。较大的存档段将带来较少的碎片和更好的压缩，但处理它们要求更多的内存。
 <p>
每个段的大小是通过计算段中要传输的每个输入文件的大小，以及它的名称和其他要传输的属性的大小来估算的。
 <p>
默认为 1000000（1 百万字节）。这允许在一个段中传输中等大小的输入 JAR 文件。它也限制了打包器和解包器的内存要求。
 <p>
如果没有此限制，打包一个 10 Mb 的 JAR 通常要小 10%，但打包器可能要求较大的 Java 堆（大约是段范围的 10 倍）。
<P>
<DL>
<DT><B>另请参见：</B><DD><A HREF="../../../constant-values.html#java.util.jar.Pack200.Packer.SEGMENT_LIMIT">常量字段值</A></DL>
</DL>
<HR>

<A NAME="KEEP_FILE_ORDER"><!-- --></A><H3>
KEEP_FILE_ORDER</H3>
<PRE>
static final <A HREF="../../lang/String.html" title="java.lang 中的类">String</A> <B>KEEP_FILE_ORDER</B></PRE>
<DL>
<DD>如果将此属性设置为 <A HREF="Pack200.Packer.html#TRUE"><CODE>TRUE</CODE></A>，则打包器将按它们在源存档中的原始顺序传输所有元素。
 <p>
如果将其设置为 <A HREF="Pack200.Packer.html#FALSE"><CODE>FALSE</CODE></A>，则打包器可能重新排序元素，并且移除携带无用信息（针对 Java 应用程序来说）的 JAR 目录条目。（通常这支持更好的压缩。）
 <p>
默认为 <A HREF="Pack200.Packer.html#TRUE"><CODE>TRUE</CODE></A>，这保存了输入信息，但可能不必要地增大了所传输的存档。
<P>
<DL>
<DT><B>另请参见：</B><DD><A HREF="../../../constant-values.html#java.util.jar.Pack200.Packer.KEEP_FILE_ORDER">常量字段值</A></DL>
</DL>
<HR>

<A NAME="EFFORT"><!-- --></A><H3>
EFFORT</H3>
<PRE>
static final <A HREF="../../lang/String.html" title="java.lang 中的类">String</A> <B>EFFORT</B></PRE>
<DL>
<DD>如果将此属性设置为单个十进制数字，则打包器将在压缩存档时使用指定压缩级别。1 级可能生成较大的尺寸但压缩速度较快，而 9 级将花费较长的时间，但可能生成更好的压缩。
 <p>
特殊值 0 指示打包器直接复制原始的 JAR 文件（无压缩）。JSR 200 标准要求任何解包器将此特殊情况作为直接传输整个存档来理解。
 <p>
默认为 5，花费适量的时间来生成合理的压缩。
<P>
<DL>
<DT><B>另请参见：</B><DD><A HREF="../../../constant-values.html#java.util.jar.Pack200.Packer.EFFORT">常量字段值</A></DL>
</DL>
<HR>

<A NAME="DEFLATE_HINT"><!-- --></A><H3>
DEFLATE_HINT</H3>
<PRE>
static final <A HREF="../../lang/String.html" title="java.lang 中的类">String</A> <B>DEFLATE_HINT</B></PRE>
<DL>
<DD>如果将此属性设置为 <A HREF="Pack200.Packer.html#TRUE"><CODE>TRUE</CODE></A> 或 <A HREF="Pack200.Packer.html#FALSE"><CODE>FALSE</CODE></A>，则打包器将在输出存档中设置相应的压缩提示，并且不传输存档元素的单个压缩提示。
 <p>
如果将此属性设置为特殊字符串 <A HREF="Pack200.Packer.html#KEEP"><CODE>KEEP</CODE></A>，则打包器将尝试确定输入存档中每个可用元素的单个压缩提示，并单独传输此提示。
 <p>
默认为 <A HREF="Pack200.Packer.html#KEEP"><CODE>KEEP</CODE></A>，这保存了输入信息，但可能不必要地增大了所传输的存档。
 <p>
这取决于解包器实现在提示上采取的行动，以便合适地压缩得到的未打包 jar 的元素。
 <p>
ZIP 或 JAR 元素的压缩提示指出元素是压缩的还是直接存储的。
<P>
<DL>
<DT><B>另请参见：</B><DD><A HREF="../../../constant-values.html#java.util.jar.Pack200.Packer.DEFLATE_HINT">常量字段值</A></DL>
</DL>
<HR>

<A NAME="MODIFICATION_TIME"><!-- --></A><H3>
MODIFICATION_TIME</H3>
<PRE>
static final <A HREF="../../lang/String.html" title="java.lang 中的类">String</A> <B>MODIFICATION_TIME</B></PRE>
<DL>
<DD>如果将此属性设置为特殊的字符串 <A HREF="Pack200.Packer.html#LATEST"><CODE>LATEST</CODE></A>，则打包器将尝试在原始存档中的所有可用条目中确定最后修改时间，或者确定每个段中所有可用条目的最后修改时间。此单值将作为段的一部分传输，并应用到每个段 (<A HREF="Pack200.Packer.html#SEGMENT_LIMIT"><CODE>SEGMENT_LIMIT</CODE></A>) 的所有条目。
 <p>
这或多或少可以减少存档的传输大小，其代价是将所有已安装文件设置为单一日期。
 <p>
如果将此属性设置为特殊字符串 <A HREF="Pack200.Packer.html#KEEP"><CODE>KEEP</CODE></A>，则打包器传输每个输入元素的单独修改时间。
 <p>
默认为 <A HREF="Pack200.Packer.html#KEEP"><CODE>KEEP</CODE></A>，这保存了输入信息，但可能不必要地增大了所传输的存档。
 <p>
这取决于解包器实现所采取的行动，以便合适地设置其输出文件中每个元素的修改时间。
<P>
<DL>
<DT><B>另请参见：</B><DD><A HREF="Pack200.Packer.html#SEGMENT_LIMIT"><CODE>SEGMENT_LIMIT</CODE></A>, 
<A HREF="../../../constant-values.html#java.util.jar.Pack200.Packer.MODIFICATION_TIME">常量字段值</A></DL>
</DL>
<HR>

<A NAME="PASS_FILE_PFX"><!-- --></A><H3>
PASS_FILE_PFX</H3>
<PRE>
static final <A HREF="../../lang/String.html" title="java.lang 中的类">String</A> <B>PASS_FILE_PFX</B></PRE>
<DL>
<DD>指出文件应该按字节传递（无压缩）。通过指定追加有不同字符串的其他属性，以生成具有公共前缀的属性系列，可以指定多个文件。
 <p>
除了用 JAR 文件分隔符 '/' 替代系统文件分隔符以外，无任何路径名转换。
 <p>
得到的文件名必须正好匹配其在 JAR 文件中出现的字符串。
 <p>
如果属性值是一个目录名称，那么还将传递该目录下的所有文件。
 <p>
示例：
 <pre><code>
     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/");
 </pre></code>.
<P>
<DL>
<DT><B>另请参见：</B><DD><A HREF="../../../constant-values.html#java.util.jar.Pack200.Packer.PASS_FILE_PFX">常量字段值</A></DL>
</DL>
<HR>

<A NAME="UNKNOWN_ATTRIBUTE"><!-- --></A><H3>
UNKNOWN_ATTRIBUTE</H3>
<PRE>
static final <A HREF="../../lang/String.html" title="java.lang 中的类">String</A> <B>UNKNOWN_ATTRIBUTE</B></PRE>
<DL>
<DD>指出遇到包含有未知属性的类文件时所采取的行动。可能值为字符串 <A HREF="Pack200.Packer.html#ERROR"><CODE>ERROR</CODE></A>、<A HREF="Pack200.Packer.html#STRIP"><CODE>STRIP</CODE></A> 和 <A HREF="Pack200.Packer.html#PASS"><CODE>PASS</CODE></A>。
 <p>
字符串 <A HREF="Pack200.Packer.html#ERROR"><CODE>ERROR</CODE></A> 意味着整体打包操作将失败，并有一个合适的解释。字符串 <A HREF="Pack200.Packer.html#STRIP"><CODE>STRIP</CODE></A> 意味着该属性将被删除。字符串 <A HREF="Pack200.Packer.html#PASS"><CODE>PASS</CODE></A> 意味着整个类文件将在无压缩下通过（就像它是一个资源文件一样），并有合适的警告。这是此属性的默认值。
 <p>
示例：
 <pre><code>
     Map p = pack200.getProperties();
     p.put(UNKNOWN_ATTRIBUTE, ERROR);
     p.put(UNKNOWN_ATTRIBUTE, STRIP);
     p.put(UNKNOWN_ATTRIBUTE, PASS);
 </pre></code>
<P>
<DL>
<DT><B>另请参见：</B><DD><A HREF="../../../constant-values.html#java.util.jar.Pack200.Packer.UNKNOWN_ATTRIBUTE">常量字段值</A></DL>
</DL>
<HR>

<A NAME="CLASS_ATTRIBUTE_PFX"><!-- --></A><H3>
CLASS_ATTRIBUTE_PFX</H3>
<PRE>
static final <A HREF="../../lang/String.html" title="java.lang 中的类">String</A> <B>CLASS_ATTRIBUTE_PFX</B></PRE>
<DL>
<DD>当与类属性名称连在一起时，使用 JSR 200 规范中指定的布局语言指出该属性的格式。
 <p>
例如，此选项的效果内置于：<code>pack.class.attribute.SourceFile=RUH</code>。
 <p>
还允许特殊字符串 <A HREF="Pack200.Packer.html#ERROR"><CODE>ERROR</CODE></A>、<A HREF="Pack200.Packer.html#STRIP"><CODE>STRIP</CODE></A> 和 <A HREF="Pack200.Packer.html#PASS"><CODE>PASS</CODE></A>，与 <A HREF="Pack200.Packer.html#UNKNOWN_ATTRIBUTE"><CODE>UNKNOWN_ATTRIBUTE</CODE></A> 具有相同的含义。这提供了一种方式，让用户可以请求按位拒绝、清除或传递特定的属性（不进行类压缩）。
 <p>
下面的代码可用于支持 JCOV 属性：
 <pre><code>
     Map p = packer.properties();
     p.put(CODE_ATTRIBUTE_PFX+&quot;CoverageTable&quot;,       &quot;NH[PHHII]&quot;);
     p.put(CODE_ATTRIBUTE_PFX+&quot;CharacterRangeTable&quot;, &quot;NH[PHPOHIIH]&quot;);
     p.put(CLASS_ATTRIBUTE_PFX+&quot;SourceID&quot;,           &quot;RUH&quot;);
     p.put(CLASS_ATTRIBUTE_PFX+&quot;CompilationID&quot;,      &quot;RUH&quot;);
 </code></pre>
 <p>
下面的代码可用于清除调试属性：
 <pre><code>
     Map p = packer.properties();
     p.put(CODE_ATTRIBUTE_PFX+&quot;LineNumberTable&quot;,    STRIP);
     p.put(CODE_ATTRIBUTE_PFX+&quot;LocalVariableTable&quot;, STRIP);
     p.put(CLASS_ATTRIBUTE_PFX+&quot;SourceFile&quot;,        STRIP);
 </code></pre>
<P>
<DL>
<DT><B>另请参见：</B><DD><A HREF="../../../constant-values.html#java.util.jar.Pack200.Packer.CLASS_ATTRIBUTE_PFX">常量字段值</A></DL>
</DL>
<HR>

<A NAME="FIELD_ATTRIBUTE_PFX"><!-- --></A><H3>
FIELD_ATTRIBUTE_PFX</H3>
<PRE>
static final <A HREF="../../lang/String.html" title="java.lang 中的类">String</A> <B>FIELD_ATTRIBUTE_PFX</B></PRE>
<DL>
<DD>当与字段属性名称连在一起时，指出该属性的格式。例如，此选项的效果内置于：<code>pack.field.attribute.Deprecated=</code>。还允许特殊字符串 <A HREF="Pack200.Packer.html#ERROR"><CODE>ERROR</CODE></A>、<A HREF="Pack200.Packer.html#STRIP"><CODE>STRIP</CODE></A> 和 <A HREF="Pack200.Packer.html#PASS"><CODE>PASS</CODE></A>。
<P>
<DL>
<DT><B>另请参见：</B><DD><A HREF="Pack200.Packer.html#CLASS_ATTRIBUTE_PFX"><CODE>CLASS_ATTRIBUTE_PFX</CODE></A>, 
<A HREF="../../../constant-values.html#java.util.jar.Pack200.Packer.FIELD_ATTRIBUTE_PFX">常量字段值</A></DL>
</DL>
<HR>

<A NAME="METHOD_ATTRIBUTE_PFX"><!-- --></A><H3>
METHOD_ATTRIBUTE_PFX</H3>
<PRE>
static final <A HREF="../../lang/String.html" title="java.lang 中的类">String</A> <B>METHOD_ATTRIBUTE_PFX</B></PRE>
<DL>
<DD>当与方法属性名称连在一起时，指出该属性的格式。例如，此选项的效果内置于：<code>pack.method.attribute.Exceptions=NH[RCH]</code>。还允许特殊字符串 <A HREF="Pack200.Packer.html#ERROR"><CODE>ERROR</CODE></A>、<A HREF="Pack200.Packer.html#STRIP"><CODE>STRIP</CODE></A> 和 <A HREF="Pack200.Packer.html#PASS"><CODE>PASS</CODE></A>。
<P>
<DL>
<DT><B>另请参见：</B><DD><A HREF="Pack200.Packer.html#CLASS_ATTRIBUTE_PFX"><CODE>CLASS_ATTRIBUTE_PFX</CODE></A>, 
<A HREF="../../../constant-values.html#java.util.jar.Pack200.Packer.METHOD_ATTRIBUTE_PFX">常量字段值</A></DL>
</DL>
<HR>

<A NAME="CODE_ATTRIBUTE_PFX"><!-- --></A><H3>
CODE_ATTRIBUTE_PFX</H3>
<PRE>
static final <A HREF="../../lang/String.html" title="java.lang 中的类">String</A> <B>CODE_ATTRIBUTE_PFX</B></PRE>
<DL>
<DD>当与代码属性名称连在一起时，指出该属性的格式。例如，此选项的效果内置于：<code>pack.code.attribute.LocalVariableTable=NH[PHOHRUHRSHH]</code>。还允许特殊字符串 <A HREF="Pack200.Packer.html#ERROR"><CODE>ERROR</CODE></A>、<A HREF="Pack200.Packer.html#STRIP"><CODE>STRIP</CODE></A> 和 <A HREF="Pack200.Packer.html#PASS"><CODE>PASS</CODE></A>。
<P>
<DL>
<DT><B>另请参见：</B><DD><A HREF="Pack200.Packer.html#CLASS_ATTRIBUTE_PFX"><CODE>CLASS_ATTRIBUTE_PFX</CODE></A>, 
<A HREF="../../../constant-values.html#java.util.jar.Pack200.Packer.CODE_ATTRIBUTE_PFX">常量字段值</A></DL>
</DL>
<HR>

<A NAME="PROGRESS"><!-- --></A><H3>
PROGRESS</H3>
<PRE>
static final <A HREF="../../lang/String.html" title="java.lang 中的类">String</A> <B>PROGRESS</B></PRE>