compact1、compact2、compact3

java.net

クラスContentHandler

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メソッドが呼び出されてオブジェクトが生成されます。

コンテンツ・ハンドラが見つからなかった場合、URLConnectionは、ユーザー定義可能な一連の場所でコンテンツ・ハンドラを検索します。それはデフォルトで、sun.net.www.content内で検索しますが、ユーザーはこれに加え、縦線で区切られた一連のクラス接頭辞を検索範囲として定義できます。それには、java.content.handler.pkgsプロパティを定義します。クラス名の形式は次のとおりです。

     {package-prefix}.{major}.{minor}
 e.g.
     YoyoDyne.experimental.text.plain
 

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

導入されたバージョン:

JDK1.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()を呼び出し、指定した型に一致する戻り値の型を表示します。

パラメータ:

urlc - URL接続。

classes - 要求する型の配列

戻り値:

ContentHandlerによって読み取られたオブジェクト。これは指定されたタイプに最初に一致したものである。要求されたどのタイプもサポートされていない場合はnull。

例外:

IOException - オブジェクトの読込み中に入出力エラーが発生した場合。

導入されたバージョン:

1.3