java.util.jar
クラス JarFile

java.lang.Object
  java.util.zip.ZipFile
      java.util.jar.JarFile

public class JarFile
extends ZipFile

JarFile クラスは、java.io.RandomAccessFile で開くことができる任意のファイルから JAR ファイルの内容を読み取るために使います。注: java.io.RandomAccessFile は、J2ME Foundation Profile などの J2ME CDC プロファイルに入っています。このクラスは、java.util.zip.ZipFile クラスを拡張し、任意の Manifest エントリの読み込みをサポートします。Manifest エントリは、JAR ファイルとそのエントリのメタ情報を指定するために使います。

導入されたバージョン:

1.2

関連項目:

Manifest, ZipFile, JarEntry

フィールドの概要

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 String	MANIFEST_NAME JAR マニフェストファイルの名前です。

クラス java.util.zip.ZipFile から継承されたフィールド

OPEN_DELETE, OPEN_READ

コンストラクタの概要

JarFile(File file)
指定された File オブジェクトから読み取るための、新しい JarFile を作成します。

JarFile(File file, boolean verify)
指定された File オブジェクトから読み取るための、新しい JarFile を作成します。

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

JarFile(String name)
指定されたファイル name から読み取るための、新しい JarFile を作成します。

JarFile(String name, boolean verify)
指定されたファイル name から読み取るための、新しい JarFile を作成します。

メソッドの概要

Enumeration	entries() ZIP ファイルエントリの列挙を返します。
ZipEntry	getEntry(String name) 指定されたエントリ名の ZipEntry を返します。
InputStream	getInputStream(ZipEntry ze) 指定された ZIP ファイルエントリの内容を読み取るための、入力ストリームを返します。
JarEntry	getJarEntry(String name) 指定されたエントリ名の JarEntry を返します。
Manifest	getManifest() JAR ファイルのマニフェストを返します。

クラス java.util.zip.ZipFile から継承されたメソッド

close, finalize, getName, size

クラス java.lang.Object から継承されたメソッド

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

MANIFEST_NAME

public static final String MANIFEST_NAME

JAR マニフェストファイルの名前です。

関連項目:

定数フィールド値

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

関連項目:

定数フィールド値

コンストラクタの詳細

JarFile

public JarFile(String name)
        throws IOException

指定されたファイル name から読み取るための、新しい JarFile を作成します。JarFile が署名されているかどうかが確認されます。

***注: 設計上、J2ME CDC に証明書のサポートはありません。CDC 自体または CDC 上に構築された J2ME プロファイルが java.security.Signature クラス (およびそのすべての依存関係) を追加しない場合、署名されていれば JarFile は検証される必要はありません。

パラメータ:

name - 読み取りのために開く JAR ファイルの名前

例外:

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

SecurityException - ファイルへのアクセスが SecurityManager によって拒否された場合

JarFile

public JarFile(String name,
               boolean verify)
        throws IOException

指定されたファイル name から読み取るための、新しい JarFile を作成します。

***注: 設計上、J2ME CDC に証明書のサポートはありません。CDC 自体または CDC 上に構築された J2ME プロファイルが java.security.Signature クラス (およびそのすべての依存関係) を追加しない場合、署名されていれば JarFile は検証される必要はありません。

パラメータ:

name - 読み取りのために開く JAR ファイルの名前

verify - JarFile が署名されていることを確認するかどうか

例外:

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

SecurityException - ファイルへのアクセスが SecurityManager によって拒否された場合

JarFile

public JarFile(File file)
        throws IOException

指定された File オブジェクトから読み取るための、新しい JarFile を作成します。JarFile が署名されているかどうかが確認されます。

***注: 設計上、J2ME CDC に証明書のサポートはありません。CDC 自体または CDC 上に構築された J2ME プロファイルが java.security.Signature クラス (およびそのすべての依存関係) を追加しない場合、署名されていれば JarFile は検証される必要はありません。

パラメータ:

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

例外:

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

SecurityException - ファイルへのアクセスが SecurityManager によって拒否された場合

JarFile

public JarFile(File file,
               boolean verify)
        throws IOException

指定された File オブジェクトから読み取るための、新しい JarFile を作成します。

***注: 設計上、J2ME CDC に証明書のサポートはありません。CDC 自体または CDC 上に構築された J2ME プロファイルが java.security.Signature クラス (およびそのすべての依存関係) を追加しない場合、署名されていれば JarFile は検証される必要はありません。

パラメータ:

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

verify - JarFile が署名されていることを確認するかどうか

例外:

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

SecurityException - ファイルへのアクセスが SecurityManager によって拒否された場合

JarFile

public JarFile(File file,
               boolean verify,
               int mode)
        throws IOException

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

***注: 設計上、J2ME CDC に証明書のサポートはありません。CDC 自体または CDC 上に構築された J2ME プロファイルが java.security.Signature クラス (およびそのすべての依存関係) を追加しない場合、署名されていれば JarFile は検証される必要はありません。

パラメータ:

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

verify - JarFile が署名されていることを確認するかどうか

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

例外:

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

IllegalArgumentException - mode 引数が無効な場合

SecurityException - ファイルへのアクセスが SecurityManager によって拒否された場合

メソッドの詳細

getManifest

public Manifest getManifest()
                     throws IOException

JAR ファイルのマニフェストを返します。マニフェストがない場合は null を返します。

戻り値:

JAR ファイルのマニフェスト。マニフェストがない場合は null

例外:

IOException

getJarEntry

public JarEntry getJarEntry(String name)

指定されたエントリ名の JarEntry を返します。見つからない場合は null を返します。

パラメータ:

name - JAR ファイルのエントリの名前

戻り値:

指定されたエントリ名の JarEntry。見つからない場合は null

関連項目:

JarEntry

getEntry

public ZipEntry getEntry(String name)

指定されたエントリ名の ZipEntry を返します。見つからない場合は null を返します。

オーバーライド:

クラス ZipFile 内の getEntry

パラメータ:

name - JAR ファイルのエントリの名前

戻り値:

指定されたエントリ名の ZipEntry。見つからない場合は null

関連項目:

ZipEntry

entries

public Enumeration entries()

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

オーバーライド:

クラス ZipFile 内の entries

戻り値:

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

getInputStream

public InputStream getInputStream(ZipEntry ze)
                           throws IOException

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

オーバーライド:

クラス ZipFile 内の getInputStream

パラメータ:

ze - ZIP ファイルエントリ

戻り値:

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

例外:

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

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

注: J2ME CDC にはコード署名がないため、このメソッドからは SecurityException はスローされません。つまり、セキュリティー例外は発生しません。この例外は、J2ME CDC をスーパーセット化するプロファイルに追加できます。