ContentHandler
は、URLConnection
からObject
を読み込むすべてのクラスのスーパー・クラスです。
一般に、アプリケーションがこのクラスのgetContent
メソッドを直接呼び出すことはありません。 代わりにアプリケーションは、URL
またはURLConnection
クラスのgetContent
メソッドを呼び出します。 アプリケーション・コンテンツ・ハンドラ・ファクトリ(setContentHandlerFactory
のコールによって設定されるインタフェースContentHandlerFactory
を実装するクラスのインスタンス)は、String
を使用してコールされ、ソケットで受信されるオブジェクトのMIMEタイプを提供します。 このファクトリからContentHandler
のサブクラスのインスタンスが返され、そのgetContent
メソッドが呼び出されてオブジェクトが生成されます。
foundにできるコンテンツ・ハンドラがない場合、URLConnectionは、ユーザー定義可能な場所セット内のコンテンツ・ハンドラを検索します。 ユーザーは、java.content.handler.pkgs
システム・プロパティを定義することで、検索するクラス・プレフィクスの垂直バー区切りセットを定義できます。 クラス名の形式は次のとおりです。
{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が必要です。
- 導入されたバージョン:
- 1.0
- 関連項目:
-
コンストラクタのサマリー
コンストラクタ -
メソッドのサマリー
修飾子と型メソッド説明abstract Object
getContent
(URLConnection urlc) オブジェクト表現の先頭に位置付けられているURL接続ストリームを指定すると、このメソッドは、指定されたストリームを読み込み、ストリームからオブジェクトを生成します。getContent
(URLConnection urlc, Class[] classes) オブジェクト表現の先頭に位置付けられているURL接続ストリームを指定すると、このメソッドは、指定されたストリームを読み込み、指定した型に一致するオブジェクトを生成します。
-
コンストラクタの詳細
-
ContentHandler
public ContentHandler()サブクラスが呼び出すためのコンストラクタ。
-
-
メソッドの詳細
-
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(URLConnection)
を呼び出して、戻り値の型を調べて、指定された型の一致を調べる必要があります。- パラメータ:
urlc
- URL接続。classes
- 要求する型の配列- 戻り値:
- 推奨された型の最初の一致である
ContentHandler
によって読み取られるオブジェクト、またはリクエストされた型がサポートされていない場合はnull
。 - 例外:
IOException
- オブジェクトの読込み中に入出力エラーが発生した場合。- 導入されたバージョン:
- 1.3
-