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

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

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

メソッドの概要

void	close() ZIP ファイルを閉じます。
Enumeration<? extends ZipEntry>	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 メソッドが呼び出されるか、仮想マシンが終了するまで、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 メソッドがファイルへの読み取りアクセスを許可しないか、OPEN_DELETE フラグが設定されていて、その checkDelete メソッドがファイルの削除を許可しない場合

IllegalArgumentException - mode 引数が無効な場合

導入されたバージョン:

1.3

関連項目:

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 ファイルエントリの内容を読み込む入力ストリームを返します。

この ZIP ファイルを閉じると、このメソッドの呼び出しにより返されたすべての入力ストリームが閉じられます。

パラメータ:

entry - ZIP ファイルエントリ

戻り値:

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

例外:

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

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

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 - 入出力エラーが発生した場合

finalize

protected void finalize()
                 throws IOException

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

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

オーバーライド:

クラス Object 内の finalize

例外:

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

関連項目:

close()