com.nttdocomo.util
クラス JarInflater

Object
  com.nttdocomo.util.JarInflater

public class JarInflater

extends Object

Jar 形式のファイルイメージからそのエントリを伸長して取り出すためのクラスです。

JarInflater オブジェクトを得るためには、 Jar 形式のファイルイメージを保持する InputStream またはバイト配列を指定して、コンストラクタを呼び出します。 エントリ(圧縮または無圧縮で格納されたされたファイル) の内容を伸長して取得するためには、そのエントリ名を指定して getInputStream(String) メソッドを呼び出します。

なお、 コンストラクタの引数に指定するストリームやバイト配列からは 1 つの JAR ファイルが過不足なく読み出せる必要があります。 一部が欠落していたり、 また末尾などに余分なデータが付加されて読み出されるような場合は、 フォーマット違反とみなされ例外が発生することがあります。
特に、 スクラッチパッドに結び付けられたストリームをコンストラクタに指定する場合、 そのスクラッチパッドをオープンする際には URL に pos オプションと length オプションを付加し、適切なデータが読み出せるようにしなければなりません。

Jarファイルが署名されていても、署名は確認されません。

ミニマムスペック:

ミニマムスペックでは、ASCII文字で構成され、 ディレクトリの区切りに'/'を使用したエントリの名前のみサポートします。

導入されたバージョン:

DoJa-3.0 (505i)

コンストラクタの概要

JarInflater(byte[] data)
バイト配列から新しいJarInflaterを生成します。

JarInflater(java.io.InputStream in)
入力ストリームから新しいJarInflaterを生成します。

メソッドの概要

void	close() このJarInflaterをクローズします。
java.io.InputStream	getInputStream(String name) エントリ名を指定して、エントリを読むための入力ストリームを返します。
long	getSize(String name) エントリ名を指定して、エントリ伸長時のサイズを返します。

クラス Object から継承したメソッド

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

コンストラクタの詳細

JarInflater

public JarInflater(java.io.InputStream in)
            throws JarFormatException,
                   java.io.IOException

入力ストリームから新しいJarInflaterを生成します。 指定された入力ストリームからは、 有効なJar形式のファイルイメージが取得できなければなりません。

入力ストリームからは、 有効なJar形式のファイルイメージが1つ分読み込まれます。 すなわち、 有効なJar形式のファイルイメージが取得できる入力ストリームを指定した場合、 このコンストラクタの終了後、 その入力ストリームの読み込み位置は、 Jar形式のファイルイメージの直後になります。 したがって、Jar形式のファイルイメージのみを持つ入力ストリームの場合、 ストリームの終端に達しており、 その次のreadメソッド呼び出しは -1 を返します。 有効なJar形式のファイルイメージが取得できなかった場合、 このコンストラクタの終了後の入力ストリームの読み込み位置は機種依存です。

コンストラクタの終了後、入力ストリームへの参照を保持しません。 また、このコンストラクタは、入力ストリームをクローズしません。 入力ストリームのクローズはコンストラクタの呼び出し側で行ってください。

Jar の形式に違反しているようなデータを与えた場合には、 コンストラクタ呼び出し時、 そのオブジェクトに対する getSize(String) や getInputStream(String) 呼び出し時のいずれかで JarFormatException が発生します。

パラメータ:

in - Jar形式のファイルイメージを保持する入力ストリームを指定します。

例外:

NullPointerException - 引数 in が null の場合に発生します。

JarFormatException - Jar形式エラーが発生した場合にスローされます。

java.io.IOException - I/O エラーが発生した場合に発生します。

JarInflater

public JarInflater(byte[] data)
            throws JarFormatException

バイト配列から新しいJarInflaterを生成します。 指定されたバイト配列からは、 有効なJar形式のファイルイメージが取得できなければなりません。

バイト配列の先頭から、 有効なJar形式のファイルイメージ1つ分のデータが読み込まれます。

コンストラクタの終了後、バイト配列への参照を保持しません。

Jar の形式に違反しているようなデータを与えた場合には、 コンストラクタ呼び出し時、 そのオブジェクトに対する getSize(String) や getInputStream(String) 呼び出し時のいずれかで JarFormatException が発生します。

パラメータ:

data - Jar形式のファイルイメージを保持するバイト配列を指定します。

例外:

NullPointerException - 引数 data が null の場合に発生します。

JarFormatException - Jar形式エラーが発生した場合にスローされます。

メソッドの詳細

close

public void close()

このJarInflaterをクローズします。

すでにこのJarInflaterから取得された入力ストリームからの読み込みは 保証されません。

getSize

public long getSize(String name)
             throws JarFormatException

エントリ名を指定して、エントリ伸長時のサイズを返します。

パラメータ:

name - エントリ名を指定します。

戻り値:

見つかったエントリ伸長時のサイズを返します。 見つかったエントリがディレクトリ( エントリ名の最後が'/'であるエントリ)である場合には、 0を返します。 エントリが見つからない場合には、-1 を返します。
ただし、指定された名前のエントリが見つからず、 名前が name+"/" のディレクトリが見つかった場合、 name+"/" が引数に指定されたときと同様に動作し、 0を返します。

例外:

IllegalStateException - JarInflaterがクローズされている場合に発生します。

NullPointerException - 引数 name が null の場合に発生します。

JarFormatException - Jar形式エラーが発生した場合にスローされます。

getInputStream

public java.io.InputStream getInputStream(String name)
                                   throws JarFormatException

エントリ名を指定して、エントリを読むための入力ストリームを返します。 入力ストリームから得られるデータは伸長時のデータです。

このメソッドの呼び出し毎に、異なるInputStreamオブジェクトを返します。

パラメータ:

name - エントリ名を指定します。

戻り値:

エントリ伸長時のデータを読むための入力ストリームを返します。 指定されたエントリがディレクトリである場合 (エントリ名の最後が'/'であるエントリ)、 およびエントリが見つからない場合には、null を返します。 ディレクトリでない、サイズが0であるエントリに対しては 有効なInputStreamを返しますが、そのreadメソッドは -1 を返します。 指定された名前のエントリが見つからず、 名前が name+"/" のディレクトリが見つかった場合、 name+"/" が引数に指定されたときと同様に動作し、 nullを返します。

例外:

IllegalStateException - JarInflaterがクローズされている場合に発生します。

NullPointerException - 引数 name が null の場合に発生します。

IllegalArgumentException - [DoJa-4.1 (902i) 以降] 引数 name に "/./", "/../" が含まれる場合に発生します。

JarFormatException - Jar形式エラーが発生した場合にスローされます。