Java 2 Platform SE 1.3: クラス URL

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM 2 Platform
Std. Ed. v1.3

前のクラス 次のクラス

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

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

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

java.net
クラス URL

java.lang.Object
  |
  +--java.net.URL

すべての実装インタフェース:: Serializable

public final class URL
extends Object
implements Serializable

URL クラスは、World Wide Web 上の「リソース」を指すポインタである URL (Uniform Resource Locator) を表します。リソースは、ファイルやディレクトリのような単純なものであることも、もっと複雑なオブジェクト (データベースや検索エンジンへのクエリーなど) への参照であることもあります。URL のタイプとその形式についての詳細は、次の Web サイトで参照することができます。

     http://www.ncsa.uiuc.edu/demoweb/url-primer.html

一般に、URL はいくつかの部分に分かれています。上記の例の URL は、使用するプロトコルが http (HyperText Transfer Protocol) であることと、www.ncsa.uiuc.edu という名前のホスト上に情報があることを示しています。そして、ホストマシン上にある情報の名前は /demoweb/url-primer.html です。ホストマシン上にある情報の名前の正確な意味は、プロトコル、およびホストの両方に依存しています。一般的には情報はファイル内に保存されていますが、動的に生成される場合もあります。URL のこうした部分はパスコンポーネントと呼ばれます。

URL にはオプションで「ポート」を指定することができます。これは、TCP 接続を確立するリモートホストマシン上のポート番号を表します。ポート番号を指定しない場合は、そのプロトコルのデフォルトのポート番号が使用されます。たとえば、http のデフォルトのポート番号は 80 です。別のポートを使用する場合は、たとえば次のように指定します。

     http://www.ncsa.uiuc.edu:8080/demoweb/url-primer.html

URL には「フラグメント」(「ref」または「参照 (reference)」とも呼ぶ) を追加できます。フラグメントを指定するには、シャープ記号「#」のあとに文字列を指定します。次にフラグメントの例を示します。

     http://java.sun.com/index.html#chapter1

技術的には、このフラグメントは URL の一部ではありません。たとえば、上に示したフラグメントは、指定のリソースを取得したあと、そのドキュメントの中で chapter1 というタグが付いている部分をアプリケーションによる処理の対象とすることを示します。タグの意味はリソースによって異なります。

アプリケーションは「相対 URL」を指定することもできます。相対 URL は、別の URL を基準として相対的にリソースを検索するための情報だけを含んでいます。相対 URL は HTML ページ内でよく使われます。たとえば、次の URL があるとします。

     http://java.sun.com/index.html

この HTML ページの中に次の相対 URL が含まれているとします。

     FAQ.html

これは次の URL の短縮形と見なされます。

     http://java.sun.com/FAQ.html

相対 URL が URL の成分をすべて指定する必要はありません。プロトコルやホスト名、ポート番号を省略した場合には、すべての成分が指定されている URL から情報が継承されます。ただし、ファイル成分の指定は必須です。オプション指定のフラグメントは継承されません。

導入されたバージョン:: JDK1.0
関連項目:: 直列化された形式

コンストラクタの概要

URL(String spec)
          String 表現から URL オブジェクトを作成します。

URL(String protocol, String host, int port, String file)
          指定された protocol、host、port 番号、および file を使って、URL オブジェクトを作成します。

URL(String protocol, String host, int port, String file, URLStreamHandler handler)
          指定された protocol、host、port 番号、file、および handler を使って、URL オブジェクトを作成します。

URL(String protocol, String host, String file)
          指定された protocol 名、host 名、および file 名を使って、URL を作成します。

URL(URL context, String spec)
          指定されたコンテキスト内の指定された仕様で構文解析することによって、URL を生成します。

URL(URL context, String spec, URLStreamHandler handler)
          指定されたコンテキスト内の指定されたハンドラで、指定された仕様を構文解析して URL を生成します。

メソッドの概要

boolean equals(Object obj)
          2 つの URL を比較します。

String getAuthority()
          この URL の権限部分を返します。

Object getContent()
          この URL のコンテンツを返します。

Object getContent(Class[] classes)
          この URL のコンテンツを返します。

String getFile()
          この URL のファイル名を返します。

String getHost()
          該当する場合、この URL のホスト名を返します。

String getPath()
          この URL のパス部分を返します。

int getPort()
          URL のポート番号を返します。

String getProtocol()
          この URL のプロトコル名を返します。

String getQuery()
          この URL のクエリー部分を返します。

String getRef()
          この URL のアンカー (「参照」とも呼ばれる) を返します。

String getUserInfo()
          この URL のユーザ情報部分を返します。

int hashCode()
          ハッシュテーブルのインデックス付けに適した int 値を作成します。

URLConnection openConnection()
          URL が参照するリモートオブジェクトへの接続を表す URLConnection オブジェクトを返します。

InputStream openStream()
          この URL への接続を確立し、その接続から読み込みを行うための InputStream を返します。

boolean sameFile(URL other)
          2 つの URL の「参照」フィールド以外の部分を比較します。

protected void set(String protocol, String host, int port, String file, String ref)
          URL のフィールドを設定します。

protected void set(String protocol, String host, int port, String authority, String userInfo, String path, String query, String ref)
          指定された URL の 8 フィールドを設定します。

static void setURLStreamHandlerFactory(URLStreamHandlerFactory fac)
          アプリケーションの URLStreamHandlerFactory を設定します。

String toExternalForm()
          この URL の文字列表現を構築します。

String toString()
          この URL の文字列表現を構築します。

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

URL

public URL(String protocol,
           String host,
           int port,
           String file)
    throws MalformedURLException

指定された protocol、host、port 番号、および file を使って、URL オブジェクトを作成します。port 番号に -1 を指定すると、URL はプロトコルのデフォルトのポートを使うようになります。

指定されたプロトコルで最初に URL オブジェクトを作成するときには、そのプロトコルのためのストリームプロトコルハンドラオブジェクトが作成されます。このストリームプロトコルハンドラオブジェクトは、URLStreamHandler クラスのインスタンスです。

以前にアプリケーションが URLStreamHandlerFactory のインスタンスをストリームハンドラファクトリとして設定している場合は、そのインスタンスの createURLStreamHandler メソッドがプロトコル文字列を引数として呼び出されて、ストリームプロトコルハンドラを作成する
まだ URLStreamHandlerFactory が設定されていない場合、あるいはファクトリの createURLStreamHandler メソッドが null を返した場合は、コンストラクタが次のシステムプロパティの値を探す
```
         java.protocol.handler.pkgs
     
```
このシステムプロパティの値が null でなければ、値は、垂直スラッシュ文字 '|' で区切られた、パッケージのリストとして解釈される。コンストラクタは、次の名前のクラスをロードしようとする
```
         <package>.<protocol>.Handler
     
```
ここで、<package> にはパッケージの名前が入り、<protocol> にはプロトコルの名前が入る。このクラスが存在しない場合、あるいはクラスは存在してもそれが URLStreamHandler のサブクラスではない場合には、リストにある次のクラスを試すことになる
以上の手順でもプロトコルハンドラが見つからなかった場合、コンストラクタは次の名前のクラスをロードしようとする
```
         sun.net.www.protocol.<protocol>.Handler
     
```
このクラスが存在しない場合、あるいはクラスは存在してもそれが URLStreamHandler のサブクラスではない場合には、MalformedURLException がスローされる

パラメータ:: protocol - 使用するプロトコル名; host - ホスト名; port - ホスト上でのポート番号; file - ホスト上のファイル
例外:: MalformedURLException - 未知のプロトコルとして指定された場合
関連項目:: System.getProperty(java.lang.String), setURLStreamHandlerFactory(java.net.URLStreamHandlerFactory), URLStreamHandler, URLStreamHandlerFactory.createURLStreamHandler(java.lang.String)

URL

public URL(String protocol,
           String host,
           String file)
    throws MalformedURLException

指定された protocol 名、host 名、および file 名を使って、URL を作成します。指定されたプロトコルのデフォルトのポートを使用します。

このメソッドの機能は、引数に protocol、host、-1、file を指定して 4 つの引数を受け取るコンストラクタを呼び出すのと同じです。

パラメータ:: protocol - 使用するプロトコル名; host - ホスト名; file - ホスト上のファイル
例外:: MalformedURLException - 未知のプロトコルとして指定された場合
関連項目:: URL(java.lang.String, java.lang.String, int, java.lang.String)

URL

public URL(String protocol,
           String host,
           int port,
           String file,
           URLStreamHandler handler)
    throws MalformedURLException

指定された protocol、host、port 番号、file、および handler を使って、URL オブジェクトを作成します。port 番号に -1 を指定すると、URL ではプロトコルのデフォルトのポートが使われます。handler に null を指定すると、URL では次に示す、プロトコルのデフォルトのストリームハンドラが使われます。java.net.URL#URL(java.lang.String, java.lang.String,int, java.lang.String)。

ハンドラが null ではなく、セキュリティマネージャが存在する場合、NetPermission("specifyStreamHandler") アクセス権を指定してセキュリティマネージャの checkPermission メソッドが呼び出されます。この結果、SecurityException になることがあります。

パラメータ:: protocol - 使用するプロトコル名; host - ホスト名; port - ホスト上でのポート番号; file - ホスト上のファイル; handler - URL のストリームハンドラ
例外:: MalformedURLException - 未知のプロトコルとして指定された場合; SecurityException - セキュリティマネージャが存在し、セキュリティマネージャの checkPermission メソッドがストリームハンドラの明示的な指定を許可しない場合
関連項目:: System.getProperty(java.lang.String), setURLStreamHandlerFactory(java.net.URLStreamHandlerFactory), URLStreamHandler, URLStreamHandlerFactory.createURLStreamHandler(java.lang.String), SecurityManager.checkPermission(java.security.Permission), NetPermission

URL

public URL(String spec)
    throws MalformedURLException

String 表現から URL オブジェクトを作成します。

このコンストラクタは、1 番目の引数に null を指定して、引数が 2 つのコンストラクタを呼び出すことと同じです。

パラメータ:: spec - URL として解析される String
例外:: MalformedURLException - 文字列に指定されたプロトコルが未知である場合
関連項目:: URL(java.net.URL, java.lang.String)

URL

public URL(URL context,
           String spec)
    throws MalformedURLException

指定されたコンテキスト内の指定された仕様で構文解析することによって、URL を生成します。指定された URL と RFC2396 の「リソース識別子の統一: 一般構文」で述べられている仕様の引数で、新しい URL が生成されます。

          <scheme>://<authority><path>?<query>#<fragment>

参照はスキーマ、権限、パス、クエリー、およびフラグメントの各部分に構文解析されます。パス成分が空でスキーマ、権限、およびクエリーの各成分が未定義の場合、新しい URL が現在のドキュメントへの参照となります。それ以外の場合は、仕様のフラグメント部分とクエリー部分が新しい URL に使われます。指定された仕様でスキーマ成分が定義され、そのスキーマ成分がコンテキストのスキーマと一致しない場合、仕様だけに基づく絶対 URL として新しい URL が生成されます。そうでない場合は、スキーマ成分はコンテキスト URL を継承します。権限成分が仕様にある場合には、仕様は絶対的なものとして扱われ、仕様の権限とパスはコンテキストの権限とパスを置換します。仕様に権限成分がない場合、新しい URL の権限はコンテキストを継承します。仕様のパス成分がスラッシュ文字"/" で始まる場合、パスは絶対的なものとして扱われ、仕様のパスがコンテキストのパスを置換します。それ以外の場合、パスは相対パスとして扱われ、コンテキストパスに追加されます。".." および "." によって行われたディレクトリ変更を削除することで、パスは標準化されます。 URL 構文解析の詳細な説明については、RFC2396 を参照してください。

パラメータ:: context - 仕様を解析するコンテキスト; spec - URL として解析される String
例外:: MalformedURLException - プロトコルが指定されていないか、未知のプロトコルが見つかった場合
関連項目:: URL(java.lang.String, java.lang.String, int, java.lang.String), URLStreamHandler, URLStreamHandler.parseURL(java.net.URL, java.lang.String, int, int)

URL

public URL(URL context,
           String spec,
           URLStreamHandler handler)
    throws MalformedURLException

指定されたコンテキスト内の指定されたハンドラで、指定された仕様を構文解析して URL を生成します。

パラメータ:: context - 仕様を解析するコンテキスト; spec - URL として解析される String; handler - URL のストリームハンドラ
例外:: MalformedURLException - プロトコルが指定されていないか、未知のプロトコルが見つかった場合; SecurityException - セキュリティマネージャが存在し、セキュリティマネージャの checkPermission メソッドがストリームハンドラの指定を許可しない場合
関連項目:: URL(java.lang.String, java.lang.String, int, java.lang.String), URLStreamHandler, URLStreamHandler.parseURL(java.net.URL, java.lang.String, int, int)

メソッドの詳細

set

protected void set(String protocol,
                   String host,
                   int port,
                   String file,
                   String ref)

URL のフィールドを設定します。これは public メソッドではないので、URL フィールドを修正できるのは URLStreamHandlers だけです。それ以外の URL は定数です。

パラメータ:: protocol - 使用するプロトコル名; host - ホスト名; port - ホスト上でのポート番号; file - ホスト上のファイル; ref - URL の内部参照

set

protected void set(String protocol,
                   String host,
                   int port,
                   String authority,
                   String userInfo,
                   String path,
                   String query,
                   String ref)

指定された URL の 8 フィールドを設定します。これは public メソッドではないので、URL フィールドを修正できるのは URLStreamHandlers だけです。それ以外の URL は定数です。

パラメータ:: protocol - 使用するプロトコル名; host - ホスト名; port - ホスト上でのポート番号; authority - URL の権限部分; userInfo - ユーザ名およびパスワード; path - ホスト上のファイル; ref - URL の内部参照; query - この URL のクエリー部分

getQuery

public String getQuery()

この URL のクエリー部分を返します。

戻り値:: この URL のクエリー部分

getPath

public String getPath()

この URL のパス部分を返します。

戻り値:: この URL のパス部分

getUserInfo

public String getUserInfo()

この URL のユーザ情報部分を返します。

戻り値:: この URL のユーザ情報部分

getAuthority

public String getAuthority()

この URL の権限部分を返します。

戻り値:: この URL の権限部分

getPort

public int getPort()

URL のポート番号を返します。ポートが設定されていない場合は -1 を返します。

戻り値:: ポート番号

getProtocol

public String getProtocol()

この URL のプロトコル名を返します。

戻り値:: この URL のプロトコル

getHost

public String getHost()

該当する場合、この URL のホスト名を返します。

戻り値:: この URL のホスト名

getFile

public String getFile()

この URL のファイル名を返します。

戻り値:: この URL のファイル名

getRef

public String getRef()

この URL のアンカー (「参照」とも呼ばれる) を返します。

戻り値:: この URL のアンカー (「参照」とも呼ばれる)

equals

public boolean equals(Object obj)

2 つの URL を比較します。引数が null ではなく、このオブジェクトと同じ URL を表す URL オブジェクトである場合にだけ、結果が true になります。 2 つの URL オブジェクトが等しいと判断するための条件は、プロトコル、参照先ホスト、ホスト上のポート番号、およびホスト上のファイルとアンカーが等しいことです。

オーバーライド:: クラス Object 内の equals

パラメータ:: obj - 比較対象の URL
戻り値:: オブジェクトが同じである場合は true、そうでない場合は false

hashCode

public int hashCode()

ハッシュテーブルのインデックス付けに適した int 値を作成します。

オーバーライド:: クラス Object 内の hashCode

戻り値:: この URL に使うハッシュコード

sameFile

public boolean sameFile(URL other)

2 つの URL の「参照」フィールド以外の部分を比較します。この URL と other 引数がどちらも同じリソースを参照している場合は true を返します。2 つの URL は同じアンカーを含んでいない可能性があります。

パラメータ:: other - 比較対象の URL
戻り値:: 2 つの URL が参照するリモートオブジェクトが同じである場合は true、そうでない場合は false

toString

public String toString()

この URL の文字列表現を構築します。このオブジェクトのストリームプロトコルハンドラの toExternalForm メソッドを呼び出すことによって文字列が作成されます。

オーバーライド:: クラス Object 内の toString

戻り値:: このオブジェクトの文字列表現
関連項目:: URL(java.lang.String, java.lang.String, int, java.lang.String), URLStreamHandler.toExternalForm(java.net.URL)

toExternalForm

public String toExternalForm()

戻り値:: このオブジェクトの文字列表現
関連項目:: URL(java.lang.String, java.lang.String, int, java.lang.String), URLStreamHandler.toExternalForm(java.net.URL)

openConnection

public URLConnection openConnection()
                             throws IOException

URL が参照するリモートオブジェクトへの接続を表す URLConnection オブジェクトを返します。

この URL のプロトコルハンドラの openConnection メソッドを呼び出すたびに、新しい接続が開かれます。

HTTP や JAR などの、URL のプロトコルについては、java.lang、java.io、java.util、または java.net のパッケージ、あるいはそのサブパッケージに属する一般または特殊な URLConnection サブクラスがあります。返される接続は、そのサブクラスのものになります。たとえば、HTTP プロトコルに対しては HttpURLConnection が返され、JAR に対しては JarURLConnection が返されます。

戻り値:: URL への URLConnection
例外:: IOException - 入出力例外が発生した場合
関連項目:: URL(java.lang.String, java.lang.String, int, java.lang.String), URLConnection, URLStreamHandler.openConnection(java.net.URL)

openStream

public final InputStream openStream()
                             throws IOException

この URL への接続を確立し、その接続から読み込みを行うための InputStream を返します。このメソッドは次のメソッドの短縮形です。

     openConnection().getInputStream()

戻り値:: URL 接続から入力を読み込むための入力ストリーム
例外:: IOException - 入出力例外が発生した場合
関連項目:: openConnection(), URLConnection.getInputStream()

getContent

public final Object getContent()
                        throws IOException

この URL のコンテンツを返します。このメソッドは次のメソッドの短縮形です。

     openConnection().getContent()

戻り値:: この URL のコンテンツ
例外:: IOException - 入出力例外が発生した場合
関連項目:: URLConnection.getContent()

getContent

public final Object getContent(Class[] classes)
                        throws IOException

この URL のコンテンツを返します。このメソッドは次のメソッドの短縮形です。

     openConnection().getContent(Class[])

戻り値:: クラスの配列で指定されたタイプが最初に一致した、この URL のコンテンツオブジェクト。要求されたタイプがサポートされていない場合は null
例外:: IOException - 入出力例外が発生した場合
関連項目:: URLConnection.getContent(Class[])

setURLStreamHandlerFactory

public static void setURLStreamHandlerFactory(URLStreamHandlerFactory fac)

アプリケーションの URLStreamHandlerFactory を設定します。このメソッドは、使用する Java Virtual Machine で 1 回しか呼び出せません。

URLStreamHandlerFactory インスタンスは、プロトコル名からストリームプロトコルハンドラを構築するのに使用されます。

セキュリティマネージャが存在する場合、このメソッドは最初にセキュリティマネージャの checkSetFactory メソッドを呼び出すことにより、この操作が許可されていることを確認します。この結果、SecurityException になることがあります。

パラメータ:: fac - 目的のファクトリ
例外:: Error - アプリケーションでファクトリがすでに設定されている場合; SecurityException - セキュリティマネージャが存在し、セキュリティマネージャの checkSetFactory メソッドがこの操作を許可しない場合
関連項目:: URL(java.lang.String, java.lang.String, int, java.lang.String), URLStreamHandlerFactory, SecurityManager.checkSetFactory()

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM 2 Platform
Std. Ed. v1.3

前のクラス 次のクラス

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

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

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

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

コンストラクタの概要
`URL(String spec)` `String` 表現から `URL` オブジェクトを作成します。
`URL(String protocol, String host, int port, String file)` 指定された `protocol`、`host`、`port` 番号、および `file` を使って、`URL` オブジェクトを作成します。
`URL(String protocol, String host, int port, String file, URLStreamHandler handler)` 指定された `protocol`、`host`、`port` 番号、`file`、および `handler` を使って、`URL` オブジェクトを作成します。
`URL(String protocol, String host, String file)` 指定された `protocol` 名、`host` 名、および `file` 名を使って、URL を作成します。
`URL(URL context, String spec)` 指定されたコンテキスト内の指定された仕様で構文解析することによって、URL を生成します。
`URL(URL context, String spec, URLStreamHandler handler)` 指定されたコンテキスト内の指定されたハンドラで、指定された仕様を構文解析して URL を生成します。

メソッドの概要
`boolean`	`equals(Object obj)` 2 つの URL を比較します。
`String`	`getAuthority()` この `URL` の権限部分を返します。
`Object`	`getContent()` この URL のコンテンツを返します。
`Object`	`getContent(Class[] classes)` この URL のコンテンツを返します。
`String`	`getFile()` この `URL` のファイル名を返します。
`String`	`getHost()` 該当する場合、この `URL` のホスト名を返します。
`String`	`getPath()` この `URL` のパス部分を返します。
`int`	`getPort()` `URL` のポート番号を返します。
`String`	`getProtocol()` この `URL` のプロトコル名を返します。
`String`	`getQuery()` この `URL` のクエリー部分を返します。
`String`	`getRef()` この `URL` のアンカー (「参照」とも呼ばれる) を返します。
`String`	`getUserInfo()` この `URL` のユーザ情報部分を返します。
`int`	`hashCode()` ハッシュテーブルのインデックス付けに適した int 値を作成します。
`URLConnection`	`openConnection()` `URL` が参照するリモートオブジェクトへの接続を表す `URLConnection` オブジェクトを返します。
`InputStream`	`openStream()` この `URL` への接続を確立し、その接続から読み込みを行うための `InputStream` を返します。
`boolean`	`sameFile(URL other)` 2 つの URL の「参照」フィールド以外の部分を比較します。
`protected void`	`set(String protocol, String host, int port, String file, String ref)` URL のフィールドを設定します。
`protected void`	`set(String protocol, String host, int port, String authority, String userInfo, String path, String query, String ref)` 指定された URL の 8 フィールドを設定します。
`static void`	`setURLStreamHandlerFactory(URLStreamHandlerFactory fac)` アプリケーションの `URLStreamHandlerFactory` を設定します。
`String`	`toExternalForm()` この `URL` の文字列表現を構築します。
`String`	`toString()` この `URL` の文字列表現を構築します。

java.net クラス URL

URL

URL

URL

URL

URL

URL

set

set

getQuery

getPath

getUserInfo

getAuthority

getPort

getProtocol

getHost

getFile

getRef

equals

hashCode

sameFile

toString

toExternalForm

openConnection

openStream

getContent

getContent

setURLStreamHandlerFactory

java.net
クラス URL