- java.lang.Object
-
- java.net.ContentHandler
-
public abstract class ContentHandler extends Object
抽象クラスContentHandler
は、URLConnection
からObject
を読み込むすべてのクラスのスーパー・クラスです。一般に、アプリケーションがこのクラスの
getContent
メソッドを直接呼び出すことはありません。 代わりにアプリケーションは、URL
またはURLConnection
クラスのgetContent
メソッドを呼び出します。 アプリケーションのコンテンツ・ハンドラ・ファクトリ(インタフェースContentHandlerFactory
を実装したクラスのインスタンス。setContentHandler
呼出しによって設定される)が、ソケット上で受信するオブジェクトのMIMEタイプを表すString
を指定して呼び出されます。 このファクトリからContentHandler
のサブクラスのインスタンスが返され、そのgetContent
メソッドが呼び出されてオブジェクトが生成されます。コンテンツ・ハンドラがfoundになることができない場合、URLConnectionはユーザー定義可能な場所のセットでコンテンツ・ハンドラを探します。 ユーザーは、
URLConnection.contentPathProp
プロパティを定義して検索するための、垂直線で区切られたクラス・プレフィクスのセットを定義することができます。 クラス名の形式は次のとおりです。{package-prefix}.{major}.{minor}
ユーザー定義のコンテンツ・ハンドラが見つからない場合、組み込みハンドラが存在する場合は、組み込みハンドラの1つから特定のcontent-typeハンドラをロードしようとします。ここで、{major}.{minor}はコンテンツ・タイプ文字列を取り、すべてのスラッシュ文字を
period
('.')に置き換え、その他の英数字以外の文字はアンダースコア文字'_
'で置き換えます。 アルファベット文字とは、26個の大文字のASCII文字(A
からZ
まで)、26個の小文字のASCII文字(a
からz
まで)、および10個のASCII数字(0
から9
まで)を表します。e.g. YoyoDyne.experimental.text.plain
コンテンツ・ハンドラ・クラスのロードを、呼出し側の委譲の連鎖外のクラス・ローダーで行う場合、JVMではRuntimePermissionのgetClassLoaderが必要です。
-
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 ContentHandler()
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド 具象メソッド 修飾子と型 メソッド 説明 abstract Object
getContent(URLConnection urlc)
オブジェクト表現の先頭に位置付けられているURL接続ストリームを指定すると、このメソッドは、指定されたストリームを読み込み、ストリームからオブジェクトを生成します。Object
getContent(URLConnection urlc, Class[] classes)
オブジェクト表現の先頭に位置付けられているURL接続ストリームを指定すると、このメソッドは、指定されたストリームを読み込み、指定した型に一致するオブジェクトを生成します。
-
-
-
メソッドの詳細
-
getContent
public abstract Object getContent(URLConnection urlc) throws IOException
オブジェクト表現の先頭に位置付けられているURL接続ストリームを指定すると、このメソッドは、指定されたストリームを読み込み、ストリームからオブジェクトを生成します。- パラメータ:
urlc
- URL接続。- 戻り値:
ContentHandler
が読み込んだオブジェクト。- 例外:
IOException
- オブジェクトの読込み中に入出力エラーが発生した場合。
-
getContent
public Object getContent(URLConnection urlc, Class[] classes) throws IOException
オブジェクト表現の先頭に位置付けられているURL接続ストリームを指定すると、このメソッドは、指定されたストリームを読み込み、指定した型に一致するオブジェクトを生成します。 このメソッドのデフォルトの実装では、getContent()を呼び出し、指定した型に一致する戻り値の型を表示します。- パラメータ:
urlc
- URL接続。classes
- 要求する型の配列- 戻り値:
ContentHandler
によって読み込まれたオブジェクトで、提案された型の最初の一致です。リクエストされていないものがサポートされていない場合は、null
です。- 例外:
IOException
- オブジェクトの読込み中に入出力エラーが発生した場合。- 導入されたバージョン:
- 1.3
-
-