モジュール java.base

パッケージ java.util.jar

クラスJarInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

java.util.zip.InflaterInputStream

java.util.zip.ZipInputStream

java.util.jar.JarInputStream

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

Closeable, AutoCloseable

public class JarInputStream extends ZipInputStream

ZipInputStreamを拡張するJarInputStreamクラスは、入力ストリームからJARファイルの内容を読み取るために使用されます。 オプションの「マニフェスト」エントリの読取りをサポートします。 Manifestエントリは、JARファイルとそのエントリのメタ情報を格納するために使います。

マニフェストへのアクセス

getManifestメソッドは、ストリーム(または、ストリームの最初のエントリがMETA-INF/で、2番目のエントリがMETA-INF/MANIFEST.MFの場合の2番目のエントリ)の最初のエントリである場合に、エントリMETA-INF/MANIFEST.MFから「マニフェスト」を返すために使用されます。

getNextJarEntry()およびgetNextEntry()メソッドは、ストリームからJARファイル・エントリを読み取るために使用されます。 これらのメソッドは、ストリームの先頭にあるマニフェスト(META-INF/MANIFEST.MF)をスキップします。 つまり、マニフェストがストリームの最初のエントリである場合、これらのメソッドはマニフェストのエントリを返しません。 最初のエントリがMETA-INF/で、2番目のエントリがマニフェストの場合、これらのメソッドによって両方がスキップされます。 これらのメソッドが、ストリームの後半に出現したときにマニフェストをスキップするかどうかは指定されません。

署名済JARファイル

JarInputStreamは、次の場合に「署名済JARファイル」内のエントリのシグネチャを検証します:

• Manifestは、ストリーム(または、ストリームの最初のエントリがMETA-INF/で、2番目のエントリがMETA-INF/MANIFEST.MFの場合の2番目のエントリ)の最初のエントリです。
• すべてのシグネチャ関連エントリがManifestの直後に続く

エントリの入力ストリームが終了するまで読み取ることによってJarEntryが完全に検証されると、JarEntry.getCertificates()をコールしてこのエントリの証明書を取得し、JarEntry.getCodeSigners()をコールして署名者を取得できます。

検証プロセスには署名者の証明書の検証が含まれていないことに注意してください。 呼出し側で、JarEntry.getCodeSigners()の戻り値を検査し、署名が信頼できるかどうかをさらに判断してください。

APIのノート:

JARファイルの署名後にJarEntryが変更されると、エントリの読取り時にSecurityExceptionがスローされます。

導入されたバージョン:

1.2

関連項目:

• Manifest
• ZipInputStream

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
static final int	CENATT	中央ディレクトリの(CEN)ヘッダー内部ファイル属性のフィールド・オフセット。
static final int	CENATX	中央ディレクトリの(CEN)ヘッダー外部ファイル属性フィールド・オフセット。
static final int	CENCOM	中央ディレクトリの(CEN)ヘッダー・コメント長フィールド・オフセット。
static final int	CENCRC	中央ディレクトリの(CEN)ヘッダー非圧縮ファイルのcrc-32値フィールド・オフセット。
static final int	CENDSK	中央ディレクトリの(CEN)ヘッダー・ディスク番号の開始フィールド・オフセット。
static final int	CENEXT	中央ディレクトリの(CEN)ヘッダーの追加フィールド長フィールド・オフセット。
static final int	CENFLG	中央ディレクトリの(CEN)ヘッダー暗号化、復号化フラグのフィールド・オフセット。
static final int	CENHDR	中央ディレクトリの(CEN)ヘッダー・サイズ(バイト単位、(シグネチャを含む))。
static final int	CENHOW	中央ディレクトリの(CEN)ヘッダー圧縮メソッドのフィールド・オフセット。
static final int	CENLEN	中央ディレクトリの(CEN)ヘッダーの非圧縮サイズ・フィールド・オフセット。
static final int	CENNAM	中央ディレクトリの(CEN)ヘッダーのファイル名の長さフィールド・オフセット。
static final int	CENOFF	中央ディレクトリの(CEN)ヘッダーLOCヘッダーのオフセット・フィールドのオフセット。
static final long	CENSIG	中央ディレクトリの(CEN)ヘッダー・シグネチャ。
static final int	CENSIZ	中央ディレクトリの(CEN)ヘッダー圧縮サイズ・フィールド・オフセット。
static final int	CENTIM	中央ディレクトリの(CEN)ヘッダー変更時間フィールド・オフセット。
static final int	CENVEM	フィールド・オフセットによって作成される中央ディレクトリ(CEN)ヘッダー・バージョン。
static final int	CENVER	フィールド・オフセットの抽出に必要な中央ディレクトリ(CEN)ヘッダー・バージョン。
static final int	ENDCOM	中央ディレクトリの(END)ヘッダーzipファイルのコメント長フィールド・オフセットの終わり。
static final int	ENDHDR	中央ディレクトリの(END)ヘッダー・サイズの終了(バイト単位、(シグネチャを含む))。
static final int	ENDOFF	最初のCENヘッダー・フィールドのオフセットに対する中央ディレクトリ(END)ヘッダー・オフセットの終了。
static final long	ENDSIG	中央ディレクトリの(END)ヘッダー・シグネチャの終了。
static final int	ENDSIZ	中央ディレクトリの(END)ヘッダー中央ディレクトリ・サイズ(バイト単位)フィールド・オフセットの終了。
static final int	ENDSUB	このディスク・フィールド・オフセット上のエントリの中央ディレクトリ(END)ヘッダー番号の終わり。
static final int	ENDTOT	中央ディレクトリの(END)ヘッダーの入力フィールド・オフセットの合計数。
static final int	EXTCRC	圧縮されていない余分なローカル(EXT)ヘッダーのcrc-32値フィールド・オフセット。
static final int	EXTHDR	追加のローカル(EXT)ヘッダー・サイズ(バイト数(シグネチャを含む))。
static final int	EXTLEN	余分なローカル(EXT)ヘッダーの非圧縮サイズ・フィールド・オフセット。
static final long	EXTSIG	追加のローカル(EXT)ヘッダー・シグネチャ。
static final int	EXTSIZ	追加のローカル(EXT)ヘッダー圧縮サイズ・フィールド・オフセット。
static final int	LOCCRC	ローカル・ファイル(LOC)ヘッダー非圧縮ファイルcrc-32値フィールド・オフセット。
static final int	LOCEXT	ローカル・ファイル(LOC)ヘッダーの追加フィールド長フィールド・オフセット。
static final int	LOCFLG	ローカル・ファイル(LOC)ヘッダー汎用ビット・フラグ・フィールド・オフセット。
static final int	LOCHDR	ローカル・ファイルの(LOC)ヘッダー・サイズ(バイト単位、(シグネチャを含む))。
static final int	LOCHOW	ローカル・ファイル(LOC)ヘッダー圧縮メソッドのフィールド・オフセット。
static final int	LOCLEN	ローカル・ファイル(LOC)ヘッダーの非圧縮サイズ・フィールド・オフセット。
static final int	LOCNAM	ローカル・ファイル(LOC)ヘッダーのファイル名の長さフィールド・オフセット。
static final long	LOCSIG	ローカル・ファイル(LOC)ヘッダーのシグネチャ。
static final int	LOCSIZ	ローカル・ファイルの(LOC)ヘッダー圧縮サイズ・フィールドのオフセット。
static final int	LOCTIM	ローカル・ファイル(LOC)ヘッダー変更時間フィールド・オフセット。
static final int	LOCVER	フィールド・オフセットの抽出に必要なローカル・ファイル(LOC)ヘッダー・バージョン。

クラスjava.util.zip.InflaterInputStreamで宣言されたフィールド

buf, inf, len

クラスjava.io.FilterInputStreamで宣言されたフィールド

in

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
JarInputStream(InputStream in)	新しいJarInputStreamを作成して、オプションのマニフェストを読み込みます。
JarInputStream(InputStream in, boolean verify)	新しいJarInputStreamを作成して、オプションのマニフェストを読み込みます。

メソッドのサマリー

修飾子と型	メソッド	説明
protected ZipEntry	createZipEntry(String name)	指定されたJARファイルのエントリ名に新しいJarEntry (ZipEntry)を作成します。
Manifest	getManifest()	ストリーム(または、ストリームの最初のエントリがMETA-INF/で、2番目のエントリがMETA-INF/MANIFEST.MFの場合の2番目のエントリ)の最初のエントリの場合はこのJARファイルのManifestを返し、それ以外の場合はnullを返します。
ZipEntry	getNextEntry()	次のZIPファイル・エントリを読み取って、エントリ・データの先頭にストリームを配置します。
JarEntry	getNextJarEntry()	次のJARファイル・エントリを読み取って、エントリ・データの先頭にストリームを位置付けます。
int	read(byte[] b, int off, int len)	現在のJARエントリからバイトの配列に読み込まれ、膨張したバイト数を返します。

クラスjava.util.zip.ZipInputStreamで宣言されたメソッド

available, close, closeEntry, read, readAllBytes, readNBytes, readNBytes, skip, skipNBytes, transferTo

クラスjava.util.zip.InflaterInputStreamで宣言されたメソッド

fill, mark, markSupported, reset

クラスjava.io.FilterInputStreamで宣言されたメソッド

read

クラスjava.io.InputStreamで宣言されたメソッド

nullInputStream

クラスjava.lang.Objectで宣言されたメソッド

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

フィールド詳細

LOCSIG

static final long LOCSIG

ローカル・ファイル(LOC)ヘッダーのシグネチャ。

関連項目:

• 定数フィールド値

EXTSIG

static final long EXTSIG

追加のローカル(EXT)ヘッダー・シグネチャ。

関連項目:

• 定数フィールド値

CENSIG

static final long CENSIG

中央ディレクトリの(CEN)ヘッダー・シグネチャ。

関連項目:

• 定数フィールド値

ENDSIG

static final long ENDSIG

中央ディレクトリの(END)ヘッダー・シグネチャの終了。

関連項目:

• 定数フィールド値

LOCHDR

static final int LOCHDR

ローカル・ファイルの(LOC)ヘッダー・サイズ(バイト単位、(シグネチャを含む))。

関連項目:

• 定数フィールド値

EXTHDR

static final int EXTHDR

追加のローカル(EXT)ヘッダー・サイズ(バイト数(シグネチャを含む))。

関連項目:

• 定数フィールド値

CENHDR

static final int CENHDR

中央ディレクトリの(CEN)ヘッダー・サイズ(バイト単位、(シグネチャを含む))。

関連項目:

• 定数フィールド値

ENDHDR

static final int ENDHDR

中央ディレクトリの(END)ヘッダー・サイズの終了(バイト単位、(シグネチャを含む))。

関連項目:

• 定数フィールド値

LOCVER

static final int LOCVER

フィールド・オフセットの抽出に必要なローカル・ファイル(LOC)ヘッダー・バージョン。

関連項目:

• 定数フィールド値

LOCFLG

static final int LOCFLG

ローカル・ファイル(LOC)ヘッダー汎用ビット・フラグ・フィールド・オフセット。

関連項目:

• 定数フィールド値

LOCHOW

static final int LOCHOW

ローカル・ファイル(LOC)ヘッダー圧縮メソッドのフィールド・オフセット。

関連項目:

• 定数フィールド値

LOCTIM

static final int LOCTIM

ローカル・ファイル(LOC)ヘッダー変更時間フィールド・オフセット。

関連項目:

• 定数フィールド値

LOCCRC

static final int LOCCRC

ローカル・ファイル(LOC)ヘッダー非圧縮ファイルcrc-32値フィールド・オフセット。

関連項目:

• 定数フィールド値

LOCSIZ

static final int LOCSIZ

ローカル・ファイルの(LOC)ヘッダー圧縮サイズ・フィールドのオフセット。

関連項目:

• 定数フィールド値

LOCLEN

static final int LOCLEN

ローカル・ファイル(LOC)ヘッダーの非圧縮サイズ・フィールド・オフセット。

関連項目:

• 定数フィールド値

LOCNAM

static final int LOCNAM

ローカル・ファイル(LOC)ヘッダーのファイル名の長さフィールド・オフセット。

関連項目:

• 定数フィールド値

LOCEXT

static final int LOCEXT

ローカル・ファイル(LOC)ヘッダーの追加フィールド長フィールド・オフセット。

関連項目:

• 定数フィールド値

EXTCRC

static final int EXTCRC

圧縮されていない余分なローカル(EXT)ヘッダーのcrc-32値フィールド・オフセット。

関連項目:

• 定数フィールド値

EXTSIZ

static final int EXTSIZ

追加のローカル(EXT)ヘッダー圧縮サイズ・フィールド・オフセット。

関連項目:

• 定数フィールド値

EXTLEN

static final int EXTLEN

余分なローカル(EXT)ヘッダーの非圧縮サイズ・フィールド・オフセット。

関連項目:

• 定数フィールド値

CENVEM

static final int CENVEM

フィールド・オフセットによって作成される中央ディレクトリ(CEN)ヘッダー・バージョン。

関連項目:

• 定数フィールド値

CENVER

static final int CENVER

フィールド・オフセットの抽出に必要な中央ディレクトリ(CEN)ヘッダー・バージョン。

関連項目:

• 定数フィールド値

CENFLG

static final int CENFLG

中央ディレクトリの(CEN)ヘッダー暗号化、復号化フラグのフィールド・オフセット。

関連項目:

• 定数フィールド値

CENHOW

static final int CENHOW

中央ディレクトリの(CEN)ヘッダー圧縮メソッドのフィールド・オフセット。

関連項目:

• 定数フィールド値

CENTIM

static final int CENTIM

中央ディレクトリの(CEN)ヘッダー変更時間フィールド・オフセット。

関連項目:

• 定数フィールド値

CENCRC

static final int CENCRC

中央ディレクトリの(CEN)ヘッダー非圧縮ファイルのcrc-32値フィールド・オフセット。

関連項目:

• 定数フィールド値

CENSIZ

static final int CENSIZ

中央ディレクトリの(CEN)ヘッダー圧縮サイズ・フィールド・オフセット。

関連項目:

• 定数フィールド値

CENLEN

static final int CENLEN

中央ディレクトリの(CEN)ヘッダーの非圧縮サイズ・フィールド・オフセット。

関連項目:

• 定数フィールド値

CENNAM

static final int CENNAM

中央ディレクトリの(CEN)ヘッダーのファイル名の長さフィールド・オフセット。

関連項目:

• 定数フィールド値

CENEXT

static final int CENEXT

中央ディレクトリの(CEN)ヘッダーの追加フィールド長フィールド・オフセット。

関連項目:

• 定数フィールド値

CENCOM

static final int CENCOM

中央ディレクトリの(CEN)ヘッダー・コメント長フィールド・オフセット。

関連項目:

• 定数フィールド値

CENDSK

static final int CENDSK

中央ディレクトリの(CEN)ヘッダー・ディスク番号の開始フィールド・オフセット。

関連項目:

• 定数フィールド値

CENATT

static final int CENATT

中央ディレクトリの(CEN)ヘッダー内部ファイル属性のフィールド・オフセット。

関連項目:

• 定数フィールド値

CENATX

static final int CENATX

中央ディレクトリの(CEN)ヘッダー外部ファイル属性フィールド・オフセット。

関連項目:

• 定数フィールド値

CENOFF

static final int CENOFF

中央ディレクトリの(CEN)ヘッダーLOCヘッダーのオフセット・フィールドのオフセット。

関連項目:

• 定数フィールド値

ENDSUB

static final int ENDSUB

このディスク・フィールド・オフセット上のエントリの中央ディレクトリ(END)ヘッダー番号の終わり。

関連項目:

• 定数フィールド値

ENDTOT

static final int ENDTOT

中央ディレクトリの(END)ヘッダーの入力フィールド・オフセットの合計数。

関連項目:

• 定数フィールド値

ENDSIZ

static final int ENDSIZ

中央ディレクトリの(END)ヘッダー中央ディレクトリ・サイズ(バイト単位)フィールド・オフセットの終了。

関連項目:

• 定数フィールド値

ENDOFF

static final int ENDOFF

最初のCENヘッダー・フィールドのオフセットに対する中央ディレクトリ(END)ヘッダー・オフセットの終了。

関連項目:

• 定数フィールド値

ENDCOM

static final int ENDCOM

中央ディレクトリの(END)ヘッダーzipファイルのコメント長フィールド・オフセットの終わり。

関連項目:

• 定数フィールド値

コンストラクタの詳細

JarInputStream

public JarInputStream(InputStream in) throws IOException

新しいJarInputStreamを作成して、オプションのマニフェストを読み込みます。 マニフェストがあり、JarInputStreamが署名されている場合には、署名を確認します。

パラメータ:

in - 実際の入力ストリーム

例外:

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

JarInputStream

public JarInputStream(InputStream in, boolean verify) throws IOException

新しいJarInputStreamを作成して、オプションのマニフェストを読み込みます。 マニフェストがあり、verifyがtrueで、JarInputStreamが署名されている場合には、署名を確認します。

パラメータ:

in - 実際の入力ストリーム

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

例外:

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

メソッドの詳細

getManifest

public Manifest getManifest()

ストリーム(または、ストリームの最初のエントリがMETA-INF/で、2番目のエントリがMETA-INF/MANIFEST.MFの場合の2番目のエントリ)の最初のエントリの場合はこのJARファイルのManifestを返し、それ以外の場合はnullを返します。

戻り値:

このJARファイルのManifest、またはそれ以外の場合はnull。

getNextEntry

public ZipEntry getNextEntry() throws IOException

次のZIPファイル・エントリを読み取って、エントリ・データの先頭にストリームを配置します。 確認が有効になっている場合は、次のエントリのストリーム配置の結果が例外になる間に任意の不正な署名が検出されます。

オーバーライド:

getNextEntry、クラスZipInputStream

戻り値:

次のZIPファイル・エントリ。エントリがこれ以上存在しない場合はnull

例外:

ZipException - ZIPファイル・エラーが発生した場合

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

SecurityException - jarファイル・エントリが誤って署名された場合。

getNextJarEntry

public JarEntry getNextJarEntry() throws IOException

次のJARファイル・エントリを読み取って、エントリ・データの先頭にストリームを位置付けます。 確認が有効になっている場合は、次のエントリのストリーム配置の結果が例外になる間に任意の不正な署名が検出されます。

戻り値:

次のJARファイル・エントリ。エントリがこれ以上存在しない場合はnull

例外:

ZipException - ZIPファイル・エラーが発生した場合

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

SecurityException - jarファイル・エントリが誤って署名された場合。

read

public int read(byte[] b, int off, int len) throws IOException

現在のJARエントリからバイトの配列に読み込まれ、膨張したバイト数を返します。 lenが0でない場合、このメソッドは入力の一部が利用できるようになるまでブロックされます。それ以外の場合、バイトは読み込まれず、0が返されます。

現在のエントリが圧縮され、このメソッドがゼロ以外の整数nを返す場合、buf[off]からbuf[off+ n -1]には非圧縮データが含まれます。 要素buf[off+ n ]からbuf[off+ len -1]のコンテンツは、InputStreamスーパークラスの指定とは逆に未定義であるため、レート操作中に実装でこれらの要素を変更できます。 このメソッドが-1を返すか、例外をスローすると、buf[off]からbuf[off+ len -1]のコンテンツは未定義になります。

確認が有効になっている場合は、エントリの最後に達するまでのいずれかの時点で、現在エントリにあるすべての不正な署名が報告されます。

オーバーライド:

read、クラスZipInputStream

パラメータ:

b - データの読込み先のバッファ

off - 転送先配列の開始オフセットb

len - 読み込む最大バイト数

戻り値:

実際に読み込まれたバイト数。エントリの最後に達した場合は -1

例外:

NullPointerException - bがnullである場合。

IndexOutOfBoundsException - offが負の値の場合、lenが負の値の場合、あるいはlenがb.length - offより大きい場合

ZipException - ZIPファイル・エラーが発生した場合

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

SecurityException - jarファイル・エントリが誤って署名された場合。

関連項目:

• FilterInputStream.in

createZipEntry

protected ZipEntry createZipEntry(String name)

指定されたJARファイルのエントリ名に新しいJarEntry (ZipEntry)を作成します。 指定されたJARファイル・エントリ名のマニフェスト属性は、新規JarEntryにコピーされます。

オーバーライド:

createZipEntry、クラスZipInputStream

パラメータ:

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

戻り値:

作成されたJarEntryオブジェクト