JavaTM 2 Platform
Standard Ed. 6

java.util.zip
類別 ZipFile

java.lang.Object
  繼承者 java.util.zip.ZipFile
直接已知子類別:
JarFile

public class ZipFile
extends Object

此類別用於從 ZIP 檔案讀取條目。

除非另有說明,將 null 參數傳入此類別中的建構子或方法將導致拋出 NullPointerException


欄位摘要
static int CENATT
           
static int CENATX
           
static int CENCOM
           
static int CENCRC
           
static int CENDSK
           
static int CENEXT
           
static int CENFLG
           
static int CENHDR
           
static int CENHOW
           
static int CENLEN
           
static int CENNAM
           
static int CENOFF
           
static long CENSIG
           
static int CENSIZ
           
static int CENTIM
           
static int CENVEM
           
static int CENVER
           
static int ENDCOM
           
static int ENDHDR
           
static int ENDOFF
           
static long ENDSIG
           
static int ENDSIZ
           
static int ENDSUB
           
static int ENDTOT
           
static int EXTCRC
           
static int EXTHDR
           
static int EXTLEN
           
static long EXTSIG
           
static int EXTSIZ
           
static int LOCCRC
           
static int LOCEXT
           
static int LOCFLG
           
static int LOCHDR
           
static int LOCHOW
           
static int LOCLEN
           
static int LOCNAM
           
static long LOCSIG
           
static int LOCSIZ
           
static int LOCTIM
           
static int LOCVER
           
static int OPEN_DELETE
          打開 ZIP 檔案並將其標記為刪除的網要標誌。
static int OPEN_READ
          打開 ZIP 檔案進行閱讀的網要標誌。
 
建構子摘要
ZipFile(File file)
          打開供閱讀的 ZIP 檔案,由指定的 File 物件給出。
ZipFile(File file, int mode)
          打開新的 ZipFile 以使用指定網要從指定 File 物件讀取。
ZipFile(String name)
          打開 ZIP 檔案進行閱讀。
 
方法摘要
 void close()
          關閉 ZIP 檔案。
 Enumeration<? extends ZipEntry> entries()
          返回 ZIP 檔案條目的列舉。
protected  void finalize()
          確保不再參考此 ZIP 檔案時調用它的 close 方法。
 ZipEntry getEntry(String name)
          返回指定名稱的 ZIP 檔案條目;如果未找到,則返回 null。
 InputStream getInputStream(ZipEntry entry)
          返回輸入串流以讀取指定 ZIP 檔案條目的內容。
 String getName()
          返回 ZIP 檔案的路徑名。
 int size()
          返回 ZIP 檔案中的條目數。
 
從類別 java.lang.Object 繼承的方法
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

欄位詳細資訊

OPEN_READ

public static final int OPEN_READ
打開 ZIP 檔案進行閱讀的網要標誌。

另請參見:
常數欄位值

OPEN_DELETE

public static final int OPEN_DELETE
打開 ZIP 檔案並將其標記為刪除的網要標誌。在打開檔案和關閉檔案之間的某個時間,該檔案將被刪除,但是其內容仍可通過 ZipFile 物件存取,直到調用關閉方法或虛擬機器退出為止。

另請參見:
常數欄位值

LOCSIG

public static final long LOCSIG
另請參見:
常數欄位值

EXTSIG

public static final long EXTSIG
另請參見:
常數欄位值

CENSIG

public static final long CENSIG
另請參見:
常數欄位值

ENDSIG

public static final long ENDSIG
另請參見:
常數欄位值

LOCHDR

public static final int LOCHDR
另請參見:
常數欄位值

EXTHDR

public static final int EXTHDR
另請參見:
常數欄位值

CENHDR

public static final int CENHDR
另請參見:
常數欄位值

ENDHDR

public static final int ENDHDR
另請參見:
常數欄位值

LOCVER

public static final int LOCVER
另請參見:
常數欄位值

LOCFLG

public static final int LOCFLG
另請參見:
常數欄位值

LOCHOW

public static final int LOCHOW
另請參見:
常數欄位值

LOCTIM

public static final int LOCTIM
另請參見:
常數欄位值

LOCCRC

public static final int LOCCRC
另請參見:
常數欄位值

LOCSIZ

public static final int LOCSIZ
另請參見:
常數欄位值

LOCLEN

public static final int LOCLEN
另請參見:
常數欄位值

LOCNAM

public static final int LOCNAM
另請參見:
常數欄位值

LOCEXT

public static final int LOCEXT
另請參見:
常數欄位值

EXTCRC

public static final int EXTCRC
另請參見:
常數欄位值

EXTSIZ

public static final int EXTSIZ
另請參見:
常數欄位值

EXTLEN

public static final int EXTLEN
另請參見:
常數欄位值

CENVEM

public static final int CENVEM
另請參見:
常數欄位值

CENVER

public static final int CENVER
另請參見:
常數欄位值

CENFLG

public static final int CENFLG
另請參見:
常數欄位值

CENHOW

public static final int CENHOW
另請參見:
常數欄位值

CENTIM

public static final int CENTIM
另請參見:
常數欄位值

CENCRC

public static final int CENCRC
另請參見:
常數欄位值

CENSIZ

public static final int CENSIZ
另請參見:
常數欄位值

CENLEN

public static final int CENLEN
另請參見:
常數欄位值

CENNAM

public static final int CENNAM
另請參見:
常數欄位值

CENEXT

public static final int CENEXT
另請參見:
常數欄位值

CENCOM

public static final int CENCOM
另請參見:
常數欄位值

CENDSK

public static final int CENDSK
另請參見:
常數欄位值

CENATT

public static final int CENATT
另請參見:
常數欄位值

CENATX

public static final int CENATX
另請參見:
常數欄位值

CENOFF

public static final int CENOFF
另請參見:
常數欄位值

ENDSUB

public static final int ENDSUB
另請參見:
常數欄位值

ENDTOT

public static final int ENDTOT
另請參見:
常數欄位值

ENDSIZ

public static final int ENDSIZ
另請參見:
常數欄位值

ENDOFF

public static final int ENDOFF
另請參見:
常數欄位值

ENDCOM

public static final int ENDCOM
另請參見:
常數欄位值
建構子詳細資訊

ZipFile

public ZipFile(String name)
        throws IOException
打開 ZIP 檔案進行閱讀。

首先,如果存在安全管理器,則使用 name 作為其參數調用其 checkRead 方法,以確保允許閱讀。

參數:
name - ZIP 檔案的名稱
拋出:
ZipException - 如果發生 ZIP 格式錯誤
IOException - 如果發生 I/O 錯誤
SecurityException - 如果存在安全管理器,並且其 checkRead 方法不允許對該檔案進行閱讀存取。
另請參見:
SecurityManager.checkRead(java.lang.String)

ZipFile

public ZipFile(File file,
               int mode)
        throws IOException
打開新的 ZipFile 以使用指定網要從指定 File 物件讀取。網要參數必須為 OPEN_READOPEN_READ | OPEN_DELETE

首先,如果存在安全管理器,則使用 name 作為其參數調用其 checkRead 方法,以確保允許閱讀。

參數:
file - 要打開進行閱讀的 ZIP 檔案
mode - 要用於打開檔案的網要
拋出:
ZipException - 如果發生 ZIP 格式錯誤
IOException - 如果發生 I/O 錯誤
SecurityException - 如果存在安全管理器,並且其 checkRead 方法不允許對該檔案進行讀取存取,或者當設置了 OPEN_DELETE 標誌時,其 checkDelete 方法不允許刪除該檔案。
IllegalArgumentException - 如果 mode 參數無效
從以下版本開始:
1.3
另請參見:
SecurityManager.checkRead(java.lang.String)

ZipFile

public ZipFile(File file)
        throws ZipException,
               IOException
打開供閱讀的 ZIP 檔案,由指定的 File 物件給出。

參數:
file - 要打開供閱讀的 ZIP 檔案
拋出:
ZipException - 如果發生 ZIP 錯誤
IOException - 如果發生 I/O 錯誤
方法詳細資訊

getEntry

public ZipEntry getEntry(String name)
返回指定名稱的 ZIP 檔案條目;如果未找到,則返回 null。

參數:
name - 條目名稱
返回:
ZIP 檔案條目;如果未找到,則返回 null
拋出:
IllegalStateException - 如果已關閉該 ZIP

getInputStream

public InputStream getInputStream(ZipEntry entry)
                           throws IOException
返回輸入串流以讀取指定 ZIP 檔案條目的內容。

關閉此 ZIP 檔案將依次關閉調用此方法返回的所有輸入串流。

參數:
entry - ZIP 檔案條目
返回:
讀取指定 ZIP 檔案條目內容的輸入串流。
拋出:
ZipException - 如果發生 ZIP 格式錯誤
IOException - 如果發生 I/O 錯誤
IllegalStateException - 如果已關閉 ZIP 檔案

getName

public String getName()
返回 ZIP 檔案的路徑名。

返回:
ZIP 檔案的路徑名

entries

public Enumeration<? extends ZipEntry> entries()
返回 ZIP 檔案條目的列舉。

返回:
ZIP 檔案條目的列舉
拋出:
IllegalStateException - 如果已關閉 ZIP 檔案

size

public int size()
返回 ZIP 檔案中的條目數。

返回:
ZIP 檔案中的條目數
拋出:
IllegalStateException - 如果已關閉 ZIP 檔案

close

public void close()
           throws IOException
關閉 ZIP 檔案。

關閉此 ZIP 檔案將關閉以前調用 getInputStream 方法返回的所有輸入串流。

拋出:
IOException - 如果發生 I/O 錯誤

finalize

protected void finalize()
                 throws IOException
確保不再參考此 ZIP 檔案時調用它的 close 方法。

由於不確定 GC 何時調用此方法,因此強烈建議應用程序一完成存取此 ZipFile 就調用 close 方法。這可防止不定期地保持系統資源。

覆寫:
類別 Object 中的 finalize
拋出:
IOException - 如果發生 I/O 錯誤
另請參見:
close()

JavaTM 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only