モジュール java.base
パッケージ java.net

クラスContentHandler

java.lang.Object
java.net.ContentHandler
public abstract class ContentHandler
extends Object
抽象クラスContentHandlerは、URLConnectionからObjectを読み込むすべてのクラスのスーパー・クラスです。

一般に、アプリケーションがこのクラスのgetContentメソッドを直接呼び出すことはありません。 代わりにアプリケーションは、URLまたはURLConnectionクラスのgetContentメソッドを呼び出します。 アプリケーション・コンテンツ・ハンドラ・ファクトリ(ContentHandlerFactoryを呼び出すことによって設定されたインタフェースContentHandlerFactoryを実装するクラスのインスタンスは、ソケット上で受信されているオブジェクトのMIMEタイプを示すStringで呼び出されます。 このファクトリからContentHandlerのサブクラスのインスタンスが返され、そのgetContentメソッドが呼び出されてオブジェクトが生成されます。

コンテンツ・ハンドラがfoundになることができない場合、URLConnectionはユーザー定義可能な場所のセットでコンテンツ・ハンドラを探します。 ユーザーは、"java.content.handler.pkgs"プロパティを定義して検索するクラス・プレフィクスの垂直方向のデリミタ付きセットを定義できます。 クラス名の形式は次のとおりです。

{package-prefix}.{major}.{minor}

ここで、{major}.{minor}はコンテンツ・タイプ文字列を取り、すべてのスラッシュ文字をperiod ('.')に置き換え、その他の英数字以外の文字はアンダースコア文字'_'で置き換えます。 アルファベット文字とは、26個の大文字のASCII文字(「A」から「Z」まで)、26個の小文字のASCII文字(「a」から「z」まで)、および10個のASCII数字(「0」から「9」まで)を表します。

e.g. YoyoDyne.experimental.text.plain

ユーザー定義のコンテンツ・ハンドラが見つからない場合、組み込みハンドラが存在する場合は、組み込みハンドラの1つから特定のcontent-typeハンドラをロードしようとします。

コンテンツ・ハンドラ・クラスのロードを、呼出し側の委譲の連鎖外のクラス・ローダーで行う場合、JVMではRuntimePermissionのgetClassLoaderが必要です。

導入されたバージョン:
1.0
関連項目:
getContent(java.net.URLConnection), ContentHandlerFactory, URL.getContent(), URLConnection, URLConnection.getContent(), URLConnection.setContentHandlerFactory(java.net.ContentHandlerFactory)

  • コンストラクタのサマリー

    コンストラクタ
    コンストラクタ 説明
    ContentHandler()  

  • メソッドのサマリー

    修飾子と型 メソッド 説明
    abstract Object getContent​(URLConnection urlc)
    オブジェクト表現の先頭に位置付けられているURL接続ストリームを指定すると、このメソッドは、指定されたストリームを読み込み、ストリームからオブジェクトを生成します。
    Object getContent​(URLConnection urlc, Class[] classes)
    オブジェクト表現の先頭に位置付けられているURL接続ストリームを指定すると、このメソッドは、指定されたストリームを読み込み、指定した型に一致するオブジェクトを生成します。

    クラス java.lang.Objectで宣言されたメソッド

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

  • コンストラクタの詳細

    • 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