java.util.zip
クラス ZipFile

java.lang.Object
  |
  +--java.util.zip.ZipFile

すべての実装インタフェース:

java.util.zip.ZipConstants

直系の既知のサブクラス:

JarFile

public class ZipFile

extends Object

implements java.util.zip.ZipConstants

このクラスは、ZIP ファイルからエントリを読み込むために使用します。

フィールドの概要

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)
File オブジェクトに指定された ZIP ファイルを、読み込み用に開きます。

ZipFile(File file, int mode)
指定された File オブジェクトから指定したモードで読み取るための、新しい ZipFile を開きます。

ZipFile(String name)
zip ファイルを読み込み用に開きます。

メソッドの概要

void	close() ZIP ファイルを閉じます。
Enumeration	entries() ZIP ファイルエントリの列挙を返します。
protected void	finalize() ZIP ファイルへの参照が存在しなくなったときに、この ZIP ファイルの close メソッドが確実に呼び出されるようにします。
ZipEntry	getEntry(String name) 指定された名前の ZIP ファイルエントリを返します。
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 ファイルを開いて、削除のマークを付けるモードフラグです。ファイルを開いてから閉じるまでにファイルが削除されますが、close メソッドが呼び出されるか、または virtual Machine が終了するまで、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 ファイルを読み込み用に開きます。

セキュリティマネージャが存在する場合は、まず、セキュリティマネージャの checkRead メソッドが引数として name を指定して呼び出され、読み込みが許可されるかどうかを確認します。

パラメータ:

name - ZIP ファイルの名前

例外:

ZipException - ZIP 形式エラーが発生した場合

IOException - 入出力エラーが発生した場合

SecurityException - セキュリティマネージャが存在する場合に、セキュリティマネージャの checkRead メソッドがファイルへの読み込みアクセスを許可しないとき

関連項目:

SecurityManager.checkRead(java.lang.String)

ZipFile

public ZipFile(File file,
               int mode)
        throws IOException

指定された File オブジェクトから指定したモードで読み取るための、新しい ZipFile を開きます。モード引数は、OPEN_READ または OPEN_READ | OPEN_DELETE である必要があります。

セキュリティマネージャが存在する場合は、まず、セキュリティマネージャの checkRead メソッドが引数として name を指定して呼び出され、読み込みが許可されるかどうかを確認します。

パラメータ:

file - 読み取りのために開く ZIP ファイル

mode - ファイルが開かれるモード

例外:

ZipException - ZIP 形式エラーが発生した場合

IOException - 入出力エラーが発生した場合

SecurityException - セキュリティマネージャが存在する場合に、セキュリティマネージャの checkRead メソッドがファイルへの読み込みアクセスを許可しないとき

IllegalArgumentException - mode 引数が無効な場合

関連項目:

SecurityManager.checkRead(java.lang.String)

ZipFile

public ZipFile(File file)
        throws ZipException,
               IOException

File オブジェクトに指定された ZIP ファイルを、読み込み用に開きます。

パラメータ:

file - 読み取りのために開く ZIP ファイル

例外:

ZipException - ZIP エラーが発生した場合

IOException - 入出力エラーが発生した場合

メソッドの詳細

getEntry

public ZipEntry getEntry(String name)

指定された名前の ZIP ファイルエントリを返します。見つからない場合は、null を返します。

パラメータ:

name - エントリの名前

戻り値:

ZIP ファイルエントリ。見つからない場合は null

例外:

IllegalStateException - ZIP ファイルが閉じられている場合

getInputStream

public InputStream getInputStream(ZipEntry entry)
                           throws IOException

指定された ZIP ファイルエントリの内容を読み込む入力ストリームを返します。

パラメータ:

entry - ZIP ファイルエントリ

戻り値:

指定された ZIP ファイルエントリの内容を読み込む入力ストリーム

例外:

ZipException - ZIP 形式エラーが発生した場合

IOException - 入出力エラーが発生した場合

IllegalStateException - ZIP ファイルが閉じられている場合

getName

public String getName()

ZIP ファイルのパス名を返します。

戻り値:

ZIP ファイルのパス名

entries

public Enumeration entries()

ZIP ファイルエントリの列挙を返します。

戻り値:

ZIP ファイルエントリの列挙

例外:

IllegalStateException - ZIP ファイルが閉じられている場合

size

public int size()

ZIP ファイル中のエントリの数を返します。

戻り値:

ZIP ファイル中のエントリの数

例外:

IllegalStateException - ZIP ファイルが閉じられている場合

close

public void close()
           throws IOException

ZIP ファイルを閉じます。

例外:

IOException - 入出力エラーが発生した場合

finalize

protected void finalize()
                 throws IOException

ZIP ファイルへの参照が存在しなくなったときに、この ZIP ファイルの close メソッドが確実に呼び出されるようにします。

GC でこのメソッドが呼び出される時間が決まっていないため、この ZipFile へのアクセスが完了した直後に、アプリケーションで close メソッドを呼び出すことを強くお勧めします。これにより、時間が定まらないままシステムリソースが保持されるのを防止できます。

オーバーライド:

クラス Object 内の finalize

例外:

IOException - 入出力エラーが発生した場合

関連項目:

close()