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

クラスContentHandler

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

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

    検出可能なコンテンツ・ハンドラがない場合、URLConnectionはユーザー定義可能な場所セットでコンテンツ・ハンドラを検索します。 ユーザーは、URLConnection.contentPathPropプロパティを定義することで、検索対象となる垂直バー区切りのクラス接頭辞セットを定義できます。 クラス名の形式は次のとおりです。

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

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

    例: YoyoDyne.experimental.text.plain

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

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

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

    • コンストラクタの詳細

      • 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