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

関連項目:

フィールドのサマリー

フィールド

修飾子と型

フィールド

説明

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オブジェクト

クラスJarInputStream

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

署名済JARファイル

フィールドのサマリー

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

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

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

メソッドのサマリー

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

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

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

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

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

ﾌｨｰﾙﾄﾞ詳細

LOCSIG

EXTSIG

CENSIG

ENDSIG

LOCHDR

EXTHDR

CENHDR

ENDHDR

LOCVER

LOCFLG

LOCHOW

LOCTIM

LOCCRC

LOCSIZ

LOCLEN

LOCNAM

LOCEXT

EXTCRC

EXTSIZ

EXTLEN

CENVEM

CENVER

CENFLG

CENHOW

CENTIM

CENCRC

CENSIZ

CENLEN

CENNAM

CENEXT

CENCOM

CENDSK

CENATT

CENATX

CENOFF

ENDSUB

ENDTOT

ENDSIZ

ENDOFF

ENDCOM

コンストラクタの詳細

JarInputStream

JarInputStream

メソッドの詳細

getManifest

getNextEntry

getNextJarEntry

read

createZipEntry