JarURLConnection (Java Platform SE 7)

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

関連項目:
URL, URLConnection, JarFile, JarInputStream, Manifest, ZipEntry

フィールドのサマリー

フィールド
修飾子と型フィールドと説明

protected URLConnection jarFileURLConnection
接続が開始された場合の JAR ファイル URL への接続。
- クラス java.net. URLConnection から継承されるフィールド
  allowUserInteraction, connected, doInput, doOutput, ifModifiedSince, url, useCaches

フィールド
修飾子と型	フィールドと説明
`protected URLConnection`	`jarFileURLConnection` 接続が開始された場合の JAR ファイル URL への接続。

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

コンストラクタ
修飾子コンストラクタと説明

protected JarURLConnection(URL url)
指定した URL に新しい JarURLConnection を作成します。

コンストラクタ
修飾子	コンストラクタと説明
`protected`	`JarURLConnection(URL url)` 指定した URL に新しい JarURLConnection を作成します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`Attributes`	`getAttributes()` 接続で使う URL が JAR ファイルエントリを指す場合、この接続用の Attributes オブジェクトを返します。そうでない場合は null を返します。
`Certificate[]`	`getCertificates()` 接続で使う URL が JAR ファイルエントリを指す場合はこの接続用の Certificate オブジェクト、そうでない場合は null を返します。
`String`	`getEntryName()` この接続のエントリ名を返します。
`JarEntry`	`getJarEntry()` この接続の JAR エントリオブジェクトが存在する場合にそれを返します。
`abstract JarFile`	`getJarFile()` この接続の JAR ファイルを返します。
`URL`	`getJarFileURL()` この接続で使う JAR ファイルの URL を返します。
`Attributes`	`getMainAttributes()` この接続で使う JAR ファイルの主要な Attributes を返します。
`Manifest`	`getManifest()` この接続の Manifest が存在する場合はそれを、存在しない場合は null を、それぞれ返します。

クラス java.net. URLConnection から継承されるメソッド
addRequestProperty, connect, getAllowUserInteraction, getConnectTimeout, getContent, getContent, getContentEncoding, getContentLength, getContentLengthLong, getContentType, getDate, getDefaultAllowUserInteraction, getDefaultRequestProperty, getDefaultUseCaches, getDoInput, getDoOutput, getExpiration, getFileNameMap, getHeaderField, getHeaderField, getHeaderFieldDate, getHeaderFieldInt, getHeaderFieldKey, getHeaderFieldLong, getHeaderFields, getIfModifiedSince, getInputStream, getLastModified, getOutputStream, getPermission, getReadTimeout, getRequestProperties, getRequestProperty, getURL, getUseCaches, guessContentTypeFromName, guessContentTypeFromStream, setAllowUserInteraction, setConnectTimeout, setContentHandlerFactory, setDefaultAllowUserInteraction, setDefaultRequestProperty, setDefaultUseCaches, setDoInput, setDoOutput, setFileNameMap, setIfModifiedSince, setReadTimeout, setRequestProperty, setUseCaches, toString

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- フィールドの詳細
  - 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 が発生した場合。
    関連項目:
    URLConnection.connect()
  - getManifest
```
public Manifest getManifest()
                     throws IOException
```
    この接続の Manifest が存在する場合はそれを、存在しない場合は null を、それぞれ返します。
    
    戻り値:
    この接続の JAR ファイルオブジェクトに対応するマニフェストオブジェクト。
    
    例外:
    
    IOException - この接続の JAR ファイルの取得時に IOException がスローされた場合。
    関連項目:
    getJarFile()
  - getJarEntry
```
public JarEntry getJarEntry()
                     throws IOException
```
    この接続の JAR エントリオブジェクトが存在する場合にそれを返します。この接続に対応する JAR ファイル URL が、JAR ファイルエントリではなく JAR ファイルを指している場合、このメソッドは null を返します。
    
    戻り値:
    この接続の JAR エントリオブジェクト。この接続の JAR URL が JAR ファイルを指している場合は null。
    
    例外:
    
    IOException - この接続の JAR ファイルの取得時に IOException がスローされた場合。
    関連項目:
    getJarFile(), getJarEntry()
  - getAttributes
```
public Attributes getAttributes()
                         throws IOException
```
    接続で使う URL が JAR ファイルエントリを指す場合、この接続用の Attributes オブジェクトを返します。そうでない場合は null を返します。
    
    戻り値:
    この接続の URL が JAR ファイルエントリを指している場合はこの接続の Attributes オブジェクト、そうでない場合は null。
    
    例外:
    
    IOException - JAR エントリの取得時に IOException がスローされた場合。
    関連項目:
    getJarEntry()
  - getMainAttributes
```
public Attributes getMainAttributes()
                             throws IOException
```
    この接続で使う JAR ファイルの主要な Attributes を返します。
    
    戻り値:
    この接続で使う JAR ファイルの主要な Attributes。
    
    例外:
    
    IOException − マニフェストの取得時に IOException がスローされた場合。
    関連項目:
    getJarFile(), getManifest()
  - getCertificates
```
public Certificate[] getCertificates()
                              throws IOException
```
    接続で使う URL が JAR ファイルエントリを指す場合はこの接続用の Certificate オブジェクト、そうでない場合は null を返します。このメソッドは、入力ストリームを最後まで読みとって、接続が完全に検証されないかぎり呼び出せません。そうでない場合は、このメソッドは null を返します
    
    戻り値:
    接続で使う URL が JAR ファイルエントリを指す場合、この接続用の Certificate オブジェクト、そうでない場合は null。
    
    例外:
    
    IOException - JAR エントリの取得時に IOException がスローされた場合。
    関連項目:
    getJarEntry()

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス JarURLConnection

フィールドのサマリー

クラス java.net. URLConnection から継承されるフィールド

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

メソッドのサマリー

クラス java.net. URLConnection から継承されるメソッド

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

フィールドの詳細

jarFileURLConnection

コンストラクタの詳細

JarURLConnection

メソッドの詳細

getJarFileURL

getEntryName

getJarFile

getManifest

getJarEntry

getAttributes

getMainAttributes

getCertificates