JavaTM 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)
          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()

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。