java.net
クラス URLStreamHandler

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

public abstract class URLStreamHandler

extends Object

抽象クラス URLStreamHandler は、すべてのストリームプロトコルハンドラに共通のスーパークラスです。ストリームプロトコルハンドラは、プロトコルの種類 (http、ftp、gopher など) ごとに接続を確立します。

アプリケーションでは、URLStreamHandler サブクラスのインスタンスを直接生成することはほとんどありません。URL の構築中に初めてプロトコル名が見つかったときに、適切なストリームプロトコルハンドラが自動的にロードされます。

導入されたバージョン:

JDK1.0

関連項目:

URL.URL(java.lang.String, java.lang.String, int, java.lang.String)

コンストラクタの概要

URLStreamHandler()

メソッドの概要

protected abstract URLConnection	openConnection(URL u) URL 引数で参照するオブジェクトへの接続を確立します。
protected void	parseURL(URL u, String spec, int start, int limit) URL の文字列表現を解析し、URL オブジェクトに変換します。
protected void	setURL(URL u, String protocol, String host, int port, String file, String ref) URL 引数フィールド値を、指定された値に設定します。
protected String	toExternalForm(URL u) 特定のプロトコルの URL を String に変換します。

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

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

コンストラクタの詳細

URLStreamHandler

public URLStreamHandler()

メソッドの詳細

openConnection

protected abstract URLConnection openConnection(URL u)
                                         throws IOException

URL 引数で参照するオブジェクトへの接続を確立します。サブクラスではこのメソッドをオーバーライドしてください。

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

パラメータ:

u - 接続先の URL

戻り値:

URL への URLConnection オブジェクト

例外:

IOException - 接続の確立中に入出力エラーが発生した場合

parseURL

protected void parseURL(URL u,
                        String spec,
                        int start,
                        int limit)

URL の文字列表現を解析し、URL オブジェクトに変換します。

継承されるパスがある場合は、URL 引数にすでにコピーされています。

URLStreamHandler の parseURL は文字列表現を http として解析します。大部分の URL プロトコルファミリは、解析処理が似ています。構文の異なるプロトコルのストリームプロトコルハンドラでは、このルーチンをオーバーライドする必要があります。

パラメータ:

u - 解析結果を受け取る URL

spec - 解析を行う URL を表す String

start - 解析の開始位置を表す文字インデックス。これはプロトコル名の確定を表す「:」(存在する場合) の直後である

limit - 解析の終了位置を表す文字の位置。これは文字列の終わりか、「#」文字 (存在する場合) の位置である。シャープ記号よりもあとの情報はすべてアンカーを表す

toExternalForm

protected String toExternalForm(URL u)

特定のプロトコルの URL を String に変換します。

パラメータ:

u - URL

戻り値:

URL 引数の文字列表現

setURL

protected void setURL(URL u,
                      String protocol,
                      String host,
                      int port,
                      String file,
                      String ref)

URL 引数フィールド値を、指定された値に設定します。URL の設定メソッドを呼び出すことができるのは、URLStreamHandler の派生クラスだけです。

パラメータ:

u - 修正する URL

protocol - プロトコル名

host - URL のリモートホスト値

port - リモートマシン上のポート

file - ファイル

ref - 参照

関連項目:

URL.set(java.lang.String, java.lang.String, int, java.lang.String, java.lang.String)