クラスJarURLConnection

java.lang.Object
java.net.URLConnection
java.net.JarURLConnection
public abstract class JarURLConnection extends URLConnection
JAR (Java ARchive)ファイル、またはJARファイル内にあるエントリへのURL接続です。

JAR URLの構文は、次のとおりです。 

jar:<url>!/{entry}

たとえば:

jar:http://www.foo.com/bar/baz.jar!/COM/foo/Quux.class

JAR URLは、あるJARファイルを参照するか、あるJARファイル内のエントリを参照する場合に使用するようにしてください。 上記の例は、JARのエントリを参照するJAR URLです。 次のようにエントリ名が省略された場合、そのURLはJARファイルの全体を参照します。jar:http://www.foo.com/bar/baz.jar!/

作成したURLがJAR URLであることがわかっていて、JARに固有の機能が必要である場合には、ジェネリックURLConnectionをJarURLConnectionにキャストするようにしてください。 たとえば、 

URL url = new URL("jar:file:/home/duke/duke.jar!/");
JarURLConnection jarConnection = (JarURLConnection)url.openConnection();
Manifest manifest = jarConnection.getManifest();

JarURLConnectionインスタンスは、JARファイルからの読取り時にしか使用できません。 このクラスでOutputStreamを取得して対象のJARファイルを変更したりデータを書き込んだりすることはできません。

例:

Jarエントリ
jar:http://www.foo.com/bar/baz.jar!/COM/foo/Quux.class
Jarファイル
jar:http://www.foo.com/bar/baz.jar!/
Jarディレクトリ
jar:http://www.foo.com/bar/baz.jar!/COM/foo/

!/は、区切り文字です。

new URL(context, spec)を使ったJAR urlの作成では、次のルールが適用されます。

  • コンテキストURLがなく、URLコンストラクタに渡された指定が区切り文字を含まない場合は、そのURLはJarFileを参照していると見なされる。
  • コンテキストURLがある場合は、そのコンテキストURLがJARファイルまたはJarディレクトリを参照していると見なされる。
  • 指定が「/」で始まっている場合は、そのJarディレクトリを無視して、Jarファイルのルートを指定していると見なされる。

    例:

    コンテキスト: jar:http://www.foo.com/bar/jar.jar!/、指定:baz/entry.txt
    url:jar:http://www.foo.com/bar/jar.jar!/baz/entry.txt
    コンテキスト: jar:http://www.foo.com/bar/jar.jar!/baz、指定:entry.txt
    url:jar:http://www.foo.com/bar/jar.jar!/baz/entry.txt
    コンテキスト: jar:http://www.foo.com/bar/jar.jar!/baz、指定:/entry.txt
    url:jar:http://www.foo.com/bar/jar.jar!/entry.txt

導入されたバージョン:
1.2
関連項目:

  • フィールド詳細

    • jarFileURLConnection

      protected URLConnection jarFileURLConnection
      接続が開始された場合のJARファイルURLへの接続。 これはconnectによって設定されるべきです。

  • コンストラクタの詳細

    • JarURLConnection

      protected JarURLConnection(URL url) throws MalformedURLException
      指定したURLに新しいJarURLConnectionを作成します。
      パラメータ:
      url - URL
      スロー:
      MalformedURLException−指定文字列に有効なプロトコルが見つからない場合、または文字列を解析できない場合。

  • メソッドの詳細

    • getJarFileURL

      public URL getJarFileURL()
      この接続で使うJARファイルのURLを返します。
      戻り値:
      この接続で使うJARファイルのURL。

    • getEntryName

      public String getEntryName()
      この接続のエントリ名を返します。 この接続に対応するJARファイルURLが、JARファイル・エントリではなくJARファイルを指している場合、このメソッドはnullを返します。
      戻り値:
      この接続で使うエントリ名(エントリがある場合)。

    • getJarFile

      public abstract JarFile getJarFile() throws IOException
      この接続のJARファイルを返します。
      戻り値:
      この接続のJARファイル。 この接続がJARファイルのエントリへの接続である場合には、JARファイル・オブジェクトが返される
      スロー:
      IOException−この接続のJARファイルへの接続試行中にIOExceptionが発生した場合。
      関連項目:

    • getManifest

      public Manifest getManifest() throws IOException
      この接続のManifestが存在する場合はそれを、存在しない場合はnullを、それぞれ返します。
      戻り値:
      この接続のJARファイル・オブジェクトに対応するマニフェスト・オブジェクト。
      スロー:
      IOException - この接続のJARファイルの取得時にIOExceptionがスローされた場合。
      関連項目:

    • getJarEntry

      public JarEntry getJarEntry() throws IOException
      この接続のJARエントリ・オブジェクトが存在する場合にそれを返します。 この接続に対応するJARファイルURLが、JARファイル・エントリではなくJARファイルを指している場合、このメソッドはnullを返します。
      戻り値:
      この接続のJARエントリ・オブジェクト。この接続のJAR URLがJARファイルを指している場合はnull。
      スロー:
      IOException - この接続のJARファイルの取得時にIOExceptionがスローされた場合。
      関連項目:

    • getAttributes

      public Attributes getAttributes() throws IOException
      接続で使うURLがJARファイル・エントリを指す場合、この接続用のAttributesオブジェクトを返します。そうでない場合はnullを返します。
      戻り値:
      この接続のURLがJARファイル・エントリを指している場合はこの接続のAttributesオブジェクト、そうでない場合はnull。
      スロー:
      IOException - JARエントリの取得時にIOExceptionがスローされた場合。
      関連項目:

    • getMainAttributes

      public Attributes getMainAttributes() throws IOException
      この接続で使うJARファイルの主要なAttributesを返します。
      戻り値:
      この接続で使うJARファイルの主要なAttributes。
      スロー:
      IOException−マニフェストの取得時にIOExceptionがスローされた場合。
      関連項目:

    • getCertificates

      public Certificate[] getCertificates() throws IOException
      この接続のURLがJARファイル・エントリを指す場合は証明書オブジェクトを返し、それ以外の場合はnullを返します。 このメソッドは、入力ストリームを最後まで読みとって、接続が完全に検証されないかぎり呼び出せません。 そうでない場合は、このメソッドはnullを返します。

      返される証明書の配列は、このエントリを証明するために使用されたすべての署名者証明書から構成されます。 各署名者証明書のあとにはそれをサポートする証明書チェーンが続きます(空である可能性もある)。 それぞれの署名者証明書およびその証明書がサポートする証明書チェーンは、下位から上位の順に並べられます(つまり、署名者の証明書が最初で、(ルートの)証明書発行局が最後)。

      APIのノート:
      検証プロセスには、コード署名者の検証または信頼の確立は含まれません。 コール元は、CertPathValidatorを使用して各署名者の証明書チェーンを検証したり、署名者が署名したエントリを信頼するかどうかを決定するなど、追加のチェックを実行する必要があります。
      戻り値:
      この接続のURLがJARファイル・エントリを指している場合は、この接続の証明書オブジェクト。それ以外の場合はnull。
      スロー:
      IOException - JARエントリの取得時にIOExceptionがスローされた場合。
      関連項目: