Java プラットフォーム 1.2 API 仕様: クラス JarURLConnection

概要

パッケージ

クラス

使用

階層ツリー

推奨されない

インデックス

ヘルプ

Java プラットフォーム 1.2

前のクラス 次のクラス

フレームあり フレームなし

概要: 内部クラス | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

java.net
クラス 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 エントリあるいは基底 URL への参照、あるいはコードベースとしての JAR ファイル、または相対 URL への参照のどちらにも使えます。上記に示した例は完全な JAR URL であり、JAR エントリを参照しています。エントリ名が省略された場合、URL は JAR ファイルの全体を参照します。 jar:http://www.foo.com/bar/baz.jar!/

JAR URL を作成するのが明白な場合、JAR 特有の機能が必要なときは、汎用 URLConnection を JarURLConnection にキャストしてください。次に例を示します。 URL url = new URL("jar:file:/home/duke/duke.jar!/"); JarURLConnection jarConnection = (JarURLConnection)url.openConnection(); Manifest manifest = jarConnection.getManifest();

例:

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/

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

JAR url の作成では、以下の規則が適用されます。

コンテキスト URL がなく、URL コンストラクタに渡された指定が区切り文字を含まない場合は、その URL は JarFile を参照していると見なされる
コンテキスト URL がある場合は、そのコンテキスト URL が JAR ファイルまたは Jar ディレクトリを参照していると見なされる
指定が「/」で始まっている場合は、その Jar ディレクトリを無視して、指定が Jar ファイルのルートであると見なされる
例:
コンテキスト: jar:http://www.foo.com/bar/jar.jar!/, spec:baz/entry.txt
url:jar:http://www.foo.com/bar/baz/jar.jar!/baz/entry.txt
コンテキスト: jar:http://www.foo.com/bar/jar.jar!/baz, spec:entry.txt
url:jar:http://www.foo.com/bar/baz/jar.jar!/baz/entry.txt
コンテキスト: jar:http://www.foo.com/bar/jar.jar!/baz, spec:/entry.txt
url:jar:http://www.foo.com/bar/baz/jar.jar!/entry.txt

導入されたバージョン:: JDK1.2
関連項目:: URL, URLConnection, JarFile, JarInputStream, Manifest, ZipEntry

フィールドの概要
`protected URLConnection`	`jarFileURLConnection` 接続が開始された場合の、JAR ファイル URL への接続です。

クラス java.net.URLConnection から継承したフィールド

allowUserInteraction,  
connected,  
doInput,  
doOutput,  
ifModifiedSince,  
url,  
useCaches

コンストラクタの概要
`protected`	`JarURLConnection(URL url)`

メソッドの概要
`Attributes`	`getAttributes()` 接続で使う URL が JAR ファイルエントリを指す場合、この接続用の Attributes オブジェクトを返します。
`Certificate[]`	`getCertificates()` 接続で使う URL が JAR ファイルエントリを指す場合に、この接続用の Certificate オブジェクトを返します。
`String`	`getEntryName()` この接続で使うエントリ名を返します。
`JarEntry`	`getJarEntry()` この接続で使う JAR エントリオブジェクトがあれば、それを返します。
`abstract JarFile`	`getJarFile()` この接続で使う JAR ファイルを返します。
`URL`	`getJarFileURL()` この接続で使う JAR ファイルの URL を返します。
`Attributes`	`getMainAttributes()` この接続で使う JAR ファイルの主要な Attributes を返します。
`Manifest`	`getManifest()` この接続で使うマニフェストがあればそれを返し、なければ null を返します。

クラス java.net.URLConnection から継承したメソッド

connect, 
getAllowUserInteraction, 
getContent, 
getContentEncoding, 
getContentLength, 
getContentType, 
getDate, 
getDefaultAllowUserInteraction, 
getDefaultRequestProperty, 
getDefaultUseCaches, 
getDoInput, 
getDoOutput, 
getExpiration, 
getFileNameMap, 
getHeaderField, 
getHeaderField, 
getHeaderFieldDate, 
getHeaderFieldInt, 
getHeaderFieldKey, 
getIfModifiedSince, 
getInputStream, 
getLastModified, 
getOutputStream, 
getPermission, 
getRequestProperty, 
getURL, 
getUseCaches, 
guessContentTypeFromName, 
guessContentTypeFromStream, 
setAllowUserInteraction, 
setContentHandlerFactory, 
setDefaultAllowUserInteraction, 
setDefaultRequestProperty, 
setDefaultUseCaches, 
setDoInput, 
setDoOutput, 
setFileNameMap, 
setIfModifiedSince, 
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

メソッドの詳細

getJarFileURL

public URL getJarFileURL()

この接続で使う JAR ファイルの URL を返します。

戻り値:: この接続で使う Jar ファイルの URL

getEntryName

public String getEntryName()

この接続で使うエントリ名を返します。この接続と対応する JAR file URL が JAR ファイルのエントリではなく JAR ファイルを指している場合、このメソッドは null を返します。

戻り値:: この接続で使うエントリ名 (エントリがある場合)

getJarFile

public abstract JarFile getJarFile()
                            throws IOException

この接続で使う JAR ファイルを返します。返されたオブジェクトは変更不可能であり、呼び出し側が変更を試みた場合は UnsupportedOperationException がスローされます。

戻り値:: この接続で使う JAR ファイル。接続が JAR ファイルのエントリへのものである場合は、JAR ファイルオブジェクト
例外:: IOException - この接続で使う JAR ファイルへの接続を試みているときに IOException が発生した場合
関連項目:: URLConnection.connect()

getManifest

public Manifest getManifest()
                     throws IOException

この接続で使うマニフェストがあればそれを返し、なければ null を返します。返されたオブジェクトは変更不可能であり、呼び出し側が変更を試みた場合は UnsupportedOperationException がスローされます。

戻り値:: この接続で使う JAR ファイルオブジェクトと対応するマニフェストオブジェクト
例外:: IOException - この接続で使う JAR ファイルの取得が原因で IOException がスローされた場合
関連項目:: getJarFile()

getJarEntry

public JarEntry getJarEntry()
                     throws IOException

この接続で使う JAR エントリオブジェクトがあれば、それを返します。この接続と対応する JAR ファイルの URL が JAR ファイルのエントリではなく JAR ファイルを指している場合、このメソッドは null を返します。返されたオブジェクトは変更不可能であり、呼び出し側が変更を試みた場合は UnsupportedOperationException がスローされます。

戻り値:: この接続で使う 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()

概要