java.util.zip.ZipOutputStream翻译

来源：互联网发布：侠客风云传修改数据编辑：程序博客网时间：2024/05/03 07:25

java.util.zip
Class ZipOutputStream

java.lang.Object  java.io.OutputStream      java.io.FilterOutputStream          java.util.zip.DeflaterOutputStream              java.util.zip.ZipOutputStream

All Implemented Interfaces:: java.util.zip.ZipConstants

Direct Known Subclasses:: JarOutputStream

public class ZipOutputStream
extends DeflaterOutputStream
implements java.util.zip.ZipConstants

This class implements an output stream filter for writing files in the ZIP file format. Includes support for both compressed and uncompressed entries. 该类实现了针对写入ZIP文件格式的文件的输出流过滤，包括支持压缩和解压项。

Field Summarystatic intCENATT
           static intCENATX
           static intCENCOM
           static intCENCRC
           static intCENDSK
           static intCENEXT
           static intCENFLG
           static intCENHDR
           static intCENHOW
           static intCENLEN
           static intCENNAM
           static intCENOFF
           static longCENSIG
           static intCENSIZ
           static intCENTIM
           static intCENVEM
           static intCENVER
           static intDEFLATED
          Compression method for compressed (DEFLATED) entries. 压缩项（DEFLATED）的压缩方法。static intENDCOM
           static intENDHDR
           static intENDOFF
           static longENDSIG
           static intENDSIZ
           static intENDSUB
           static intENDTOT
           static intEXTCRC
           static intEXTHDR
           static intEXTLEN
           static longEXTSIG
           static intEXTSIZ
           static intLOCCRC
           static intLOCEXT
           static intLOCFLG
           static intLOCHDR
           static intLOCHOW
           static intLOCLEN
           static intLOCNAM
           static longLOCSIG
           static intLOCSIZ
           static intLOCTIM
           static intLOCVER
           static intSTORED
          Compression method for uncompressed (STORED) entries. 解压项（STORED）的压缩方法。 Fields inherited from class java.util.zip.DeflaterOutputStreambuf, def Fields inherited from class java.io.FilterOutputStreamout Constructor SummaryZipOutputStream(OutputStream out)
          Creates a new ZIP output stream. 创建一个ZIP输出流。 Method Summary voidclose()
          Closes the ZIP output stream as well as the stream being filtered. 关闭ZIP输出流，同时过滤。 voidcloseEntry()
          Closes the current ZIP entry and positions the stream for writing the next entry. 关闭当前ZIP项，并将定位流以便写入下一项。 voidfinish()
          Finishes writing the contents of the ZIP output stream without closing the underlying stream.完成ZIP输出流内容的写入，不关闭底层流。 voidputNextEntry(ZipEntry e)
          Begins writing a new ZIP file entry and positions the stream to the start of the entry data. 开始写入一个新的ZIP文件项，并将流定位在项数据的开始。 voidsetComment(String comment)
          Sets the ZIP file comment. 设置ZIP文件注释。 voidsetLevel(int level)
          Sets the compression level for subsequent entries which are DEFLATED. 设置后续DEFLATED项的压缩级别。 voidsetMethod(int method)
          Sets the default compression method for subsequent entries. 设置后续项的默认压缩方法。 voidwrite(byte[] b, int off, int len)
          Writes an array of bytes to the current ZIP entry data. 将字节数组写入当前ZIP项数据。 Methods inherited from class java.util.zip.DeflaterOutputStreamdeflate, write Methods inherited from class java.io.FilterOutputStreamflush, write Methods inherited from class java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

STORED

public static final int STORED

Compression method for uncompressed (STORED) entries. 解压项（STORED）的压缩方法。

See Also:: Constant Field Values

DEFLATED

public static final int DEFLATED

Compression method for compressed (DEFLATED) entries. 压缩项（DEFLATED）的压缩方法。

See Also:: Constant Field Values

LOCSIG

public static final long LOCSIG

See Also:: Constant Field Values

EXTSIG

public static final long EXTSIG

See Also:: Constant Field Values

CENSIG

public static final long CENSIG

See Also:: Constant Field Values

ENDSIG

public static final long ENDSIG

See Also:: Constant Field Values

LOCHDR

public static final int LOCHDR

See Also:: Constant Field Values

EXTHDR

public static final int EXTHDR

See Also:: Constant Field Values

CENHDR

public static final int CENHDR

See Also:: Constant Field Values

ENDHDR

public static final int ENDHDR

See Also:: Constant Field Values

LOCVER

public static final int LOCVER

See Also:: Constant Field Values

LOCFLG

public static final int LOCFLG

See Also:: Constant Field Values

LOCHOW

public static final int LOCHOW

See Also:: Constant Field Values

LOCTIM

public static final int LOCTIM

See Also:: Constant Field Values

LOCCRC

public static final int LOCCRC

See Also:: Constant Field Values

LOCSIZ

public static final int LOCSIZ

See Also:: Constant Field Values

LOCLEN

public static final int LOCLEN

See Also:: Constant Field Values

LOCNAM

public static final int LOCNAM

See Also:: Constant Field Values

LOCEXT

public static final int LOCEXT

See Also:: Constant Field Values

EXTCRC

public static final int EXTCRC

See Also:: Constant Field Values

EXTSIZ

public static final int EXTSIZ

See Also:: Constant Field Values

EXTLEN

public static final int EXTLEN

See Also:: Constant Field Values

CENVEM

public static final int CENVEM

See Also:: Constant Field Values

CENVER

public static final int CENVER

See Also:: Constant Field Values

CENFLG

public static final int CENFLG

See Also:: Constant Field Values

CENHOW

public static final int CENHOW

See Also:: Constant Field Values

CENTIM

public static final int CENTIM

See Also:: Constant Field Values

CENCRC

public static final int CENCRC

See Also:: Constant Field Values

CENSIZ

public static final int CENSIZ

See Also:: Constant Field Values

CENLEN

public static final int CENLEN

See Also:: Constant Field Values

CENNAM

public static final int CENNAM

See Also:: Constant Field Values

CENEXT

public static final int CENEXT

See Also:: Constant Field Values

CENCOM

public static final int CENCOM

See Also:: Constant Field Values

CENDSK

public static final int CENDSK

See Also:: Constant Field Values

CENATT

public static final int CENATT

See Also:: Constant Field Values

CENATX

public static final int CENATX

See Also:: Constant Field Values

CENOFF

public static final int CENOFF

See Also:: Constant Field Values

ENDSUB

public static final int ENDSUB

See Also:: Constant Field Values

ENDTOT

public static final int ENDTOT

See Also:: Constant Field Values

ENDSIZ

public static final int ENDSIZ

See Also:: Constant Field Values

ENDOFF

public static final int ENDOFF

See Also:: Constant Field Values

ENDCOM

public static final int ENDCOM

See Also:: Constant Field Values

Constructor Detail

ZipOutputStream

public ZipOutputStream(OutputStream out)

Creates a new ZIP output stream. 创建一个ZIP输出流。
Parameters:: out - the actual output stream 实际输出流

Method Detail

setComment

public void setComment(String comment)

Sets the ZIP file comment. 设置ZIP文件注释。

Parameters:: comment - the comment string 注释字符串
Throws:: IllegalArgumentException - if the length of the specified ZIP file comment is greater than 0xFFFF bytes 如果指定的ZIP文件注释长度大于0xFFFF字节抛出

setMethod

public void setMethod(int method)

Sets the default compression method for subsequent entries. This default will be used whenever the compression method is not specified for an individual ZIP file entry, and is initially set to DEFLATED. 设置后续项的默认压缩方法。在未指定单个ZIP文件项的压缩方法时使用默认设置，初始设为DEFLATED。

Parameters:: method - the default compression method 默认压缩方法
Throws:: IllegalArgumentException - if the specified compression method is invalid 如果指定的压缩方法无效抛出

setLevel

public void setLevel(int level)

Sets the compression level for subsequent entries which are DEFLATED. The default setting is DEFAULT_COMPRESSION. 设置后续DEFLATED项的压缩级别。默认设置为DEFAULT_COMPRESSION。

Parameters:: level - the compression level (0-9) 压缩级别（0-9）
Throws:: IllegalArgumentException - if the compression level is invalid 如果压缩级别无效抛出

putNextEntry

public void putNextEntry(ZipEntry e)                  throws IOException

Begins writing a new ZIP file entry and positions the stream to the start of the entry data. Closes the current entry if still active. The default compression method will be used if no compression method was specified for the entry, and the current time will be used if the entry has no set modification time. 开始写入一个新的ZIP文件项，并将流定位在项数据的开始。如果仍然处于活动状态，关闭当前项。如果未指定项的压缩方法，使用默认的压缩方法。如果项没有设置修改时间，则使用当前时间。

Parameters:: e - the ZIP entry to be written 要写入的ZIP项
Throws:: ZipException - if a ZIP format error has occurred 如果发生ZIP格式错误抛出; IOException - if an I/O error has occurred 如果发生I/O错误抛出

closeEntry

public void closeEntry()                throws IOException

Closes the current ZIP entry and positions the stream for writing the next entry. 关闭当前ZIP项，并将定位流以便写入下一项。

Throws:: ZipException - if a ZIP format error has occurred 如果发生ZIP格式错误抛出; IOException - if an I/O error has occurred 如果发生I/O错误抛出

write

public void write(byte[] b,                  int off,                  int len)           throws IOException

Writes an array of bytes to the current ZIP entry data. This method will block until all the bytes are written. 将字节数组写入当前ZIP项数据。方法将阻塞直到所有字节写入。

Overrides:: write in class DeflaterOutputStream

Parameters:: b - the data to be written 要写入的数据; off - the start offset in the data 数据的起始偏移; len - the number of bytes that are written 要写入的字节数
Throws:: ZipException - if a ZIP file error has occurred 如果发生ZIP文件错误抛出; IOException - if an I/O error has occurred 如果发生I/O错误抛出

finish

public void finish()            throws IOException

Finishes writing the contents of the ZIP output stream without closing the underlying stream. Use this method when applying multiple filters in succession to the same output stream. 完成ZIP输出流内容的写入，不关闭底层流。当在同一个输出流上连续应用多个过滤器时使用此方法。

Overrides:: finish in class DeflaterOutputStream

Throws:: ZipException - if a ZIP file error has occurred 如果发生ZIP文件错误抛出; IOException - if an I/O exception has occurred 如果发生I/O错误抛出

close

public void close()           throws IOException

Closes the ZIP output stream as well as the stream being filtered. 关闭ZIP输出流，同时过滤。

Overrides:: close in class DeflaterOutputStream

Throws:: ZipException - if a ZIP file error has occurred 如果发生ZIP文件错误抛出; IOException - if an I/O error has occurred 如果发生I/O错误抛出

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.