|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object java.net.URLStreamHandler
public abstract class URLStreamHandler
abstract クラス URLStreamHandler
は、すべてのストリームプロトコルハンドラに共通のスーパークラスです。ストリームプロトコルハンドラは、http
、ftp
、gopher
など、特定のプロトコルタイプでの接続の確立方法を知っています。
ほとんどの場合、URLStreamHandler
サブクラスのインスタンスがアプリケーションによって直接作成されることはありません。そうではなく、URL
構築時にプロトコル名が初めて検出された際に、適切なストリームプロトコルハンドラが自動的にロードされます。
URL.URL(java.lang.String, java.lang.String, int, java.lang.String)
コンストラクタの概要 | |
---|---|
URLStreamHandler()
|
メソッドの概要 | |
---|---|
protected boolean |
equals(URL u1,
URL u2)
デフォルトの等価計算を提供します。 |
protected int |
getDefaultPort()
このハンドラが構文解析する URL のデフォルトのポートを返します。 |
protected InetAddress |
getHostAddress(URL u)
ホストの IP アドレスを取得します。 |
protected int |
hashCode(URL u)
デフォルトのハッシュ計算を提供します。 |
protected boolean |
hostsEqual(URL u1,
URL u2)
2 つの URL のホストコンポーネントを比較します。 |
protected abstract URLConnection |
openConnection(URL u)
URL 引数によって参照されるオブジェクトへの接続をオープンします。 |
protected URLConnection |
openConnection(URL u,
Proxy p)
openConnection(URL) とほぼ同じですが、接続の確立が指定されたプロキシ経由で行われる点が異なります。 |
protected void |
parseURL(URL u,
String spec,
int start,
int limit)
URL の文字列表現を構文解析し、URL オブジェクトに変換します。 |
protected boolean |
sameFile(URL u1,
URL u2)
2 つの URL を比較し、両者が同じファイルを参照しているかどうか、つまり同じプロトコル、ホスト、ポート、およびパスを持つかどうかを確認します。 |
protected void |
setURL(URL u,
String protocol,
String host,
int port,
String file,
String ref)
推奨されていません。 setURL(URL、String、int、String、String、String、String) を使用してください。 |
protected void |
setURL(URL u,
String protocol,
String host,
int port,
String authority,
String userInfo,
String path,
String query,
String ref)
URL 引数の各フィールドを指定された値に設定します。 |
protected String |
toExternalForm(URL u)
特定のプロトコルの URL を String に変換します。 |
クラス java.lang.Object から継承されたメソッド |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
コンストラクタの詳細 |
---|
public URLStreamHandler()
メソッドの詳細 |
---|
protected abstract URLConnection openConnection(URL u) throws IOException
URL
引数によって参照されるオブジェクトへの接続をオープンします。サブクラスはこのメソッドをオーバーライドする必要があります。
HTTP や JAR といったハンドラのプロトコルごとに一般または特殊な URLConnection サブクラスが存在しており、そのサブクラスは次のパッケージまたはそのサブパッケージのいずれかに属します。java.lang、java.io、java.util, java.net。返される接続の型は、そのサブクラスになります。たとえば、HTTP の場合は HttpURLConnection が返され、JAR の場合は JarURLConnection が返されます。
u
- 接続先の URL
URL
への URLConnection
オブジェクト
IOException
- 接続のオープン中に入出力エラーが発生した場合protected URLConnection openConnection(URL u, Proxy p) throws IOException
u
- 接続先の URLp
- 接続の確立に使用されるプロキシ。直接接続を行いたい場合は Proxy.NO_PROXY を指定すべきである
URL
への URLConnection
オブジェクト
IOException
- 接続のオープン中に入出力エラーが発生した場合
IllegalArgumentException
- u、p のいずれかが null であるか、p の型が正しくない場合
UnsupportedOperationException
- プロトコルを実装するサブクラスがこのメソッドをサポートしない場合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
- 構文解析を終了すべき文字位置。これは文字列の末尾になる。ただし、「#
」文字が存在する場合はその位置になる。シャープ記号の後にある情報はすべて、アンカーを示すprotected int getDefaultPort()
URL
のデフォルトのポートprotected boolean equals(URL u1, URL u2)
u1
- URL オブジェクトu2
- URL オブジェクト
protected int hashCode(URL u)
u
- URL オブジェクト
protected boolean sameFile(URL u1, URL u2)
u1
- URL オブジェクトu2
- URL オブジェクト
protected InetAddress getHostAddress(URL u)
u
- URL オブジェクト
InetAddress
protected boolean hostsEqual(URL u1, URL u2)
u1
- 比較する最初のホストの URLu2
- 比較する第 2 のホストの URL
protected String toExternalForm(URL u)
URL
を String
に変換します。
u
- URL
URL
引数の文字列表現protected void setURL(URL u, String protocol, String host, int port, String authority, String userInfo, String path, String query, String ref)
URL
引数の各フィールドを指定された値に設定します。URL の set メソッドを呼び出せるのは URLStreamHandler の派生クラスだけです。
u
- 修正する URLprotocol
- プロトコル名host
- URL のリモートホスト値port
- リモートマシン上のポートauthority
- URL の権限部分userInfo
- URL のユーザー情報部分path
- URL のパスコンポーネントquery
- URL のクエリー部分ref
- 参照
SecurityException
- この URL のプロトコルハンドラがこのハンドラとは異なる場合URL.set(java.lang.String, java.lang.String, int, java.lang.String, java.lang.String)
@Deprecated protected void setURL(URL u, String protocol, String host, int port, String file, String ref)
URL
引数の各フィールドを指定された値に設定します。URL の set メソッドを呼び出せるのは URLStreamHandler の派生クラスだけです。
u
- 修正する URLprotocol
- プロトコル名1.2 以降、この値は無視されるhost
- URL のリモートホスト値port
- リモートマシン上のポートfile
- ファイルref
- 参照
SecurityException
- この URL のプロトコルハンドラがこのハンドラとは異なる場合
|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。