org.xml.sax.helpers

クラス XMLReaderFactory

java.lang.Object

org.xml.sax.helpers.XMLReaderFactory

public final class XMLReaderFactory
extends Object

XML リーダーを生成するためのファクトリクラスです。

このモジュールは、ソースコード、文書ともに公開ドメインに置かれています。したがって、内容に関する保証は一切提供されません。詳細については、http://www.saxproject.org を参照してください。

このクラスには、明示的なクラス名から、またはランタイムのデフォルトに基づいて XML リーダーを作成するための、static メソッドが含まれます。

 try {
   XMLReader myReader = XMLReaderFactory.createXMLReader();
 } catch (SAXException e) {
   System.err.println(e.getMessage());
 }
 

パーサーとバンドルされたディストリービューションについての注意: 外部の設定メカニズムが設定されていないケースを処理するためには、引数なしの createXMLReader 実装を変更する必要があります。そのメソッドの最適な動作は、クラスパス内にある場合にパーサーを返すことです。これは、そのクラス名を org.xml.sax.driver にバインドするものがないためにそれらの構成メカニズムに表示されない場合でも同じです。

導入されたバージョン:

SAX 2.0

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
static XMLReader	createXMLReader() システムデフォルトから XMLReader の生成を試みます。
static XMLReader	createXMLReader(String className) クラス名から XML リーダーの生成を試みます。

クラス java.lang.Object から継承されたメソッド

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

メソッドの詳細

createXMLReader

public static XMLReader createXMLReader()
                                 throws SAXException

システムデフォルトから XMLReader の生成を試みます。これをサポートできる環境では、XMLReader クラスの名前は、これらの各オプションを順番に入力し、最初に完了したオプションを使用することによって決定されます。

• システムプロパティー org.xml.sax.driver に値がある場合は、それが XMLReader クラス名として使用される。
• JAR の「Services API」を使用して、実行時に使用できる jar ファイル内の META-INF/services/org.xml.sax.driver ファイルからクラス名が検索される。
• SAX パーサーのディストリビューションでは、このリストの前のオプションが成功しなかった場合のみ有効になるデフォルトの XMLReader クラス名を提供することが強く推奨される。
• 最後に、ParserFactory.makeParser() がシステムデフォルトの SAX1 パーサーを返すことができる場合は、そのパーサーが ParserAdapter にラップされる。(これは、org.xml.sax.parser システムプロパティーを頻繁に使用できる SAX1 環境での移行に便利。)

埋め込まれたシステムが小さく、その柔軟性をサポートできないような環境では、デフォルトを決定するためのその他のメカニズムが使用されることがあります。

多くの Java 環境では、システムプロパティーをコマンド行で初期化できます。つまり、ほとんどの場合、そのプロパティーに適した値を設定すれば、セキュリティーポリシーが介在する場合以外は、このメソッドの呼び出しが成功することが保証されます。また、このメソッドが確実に実装されているとは限らない古い SAX 環境へのアプリケーションのポータビリティーも、最大限に活用できます。

戻り値:

新しい XMLReader。

例外:

SAXException - デフォルトの XMLReader クラスを識別およびインスタンス化できない場合。

関連項目:

createXMLReader(java.lang.String)

createXMLReader

public static XMLReader createXMLReader(String className)
                                 throws SAXException

クラス名から XML リーダーの生成を試みます。

このメソッドは、指定されたクラス名のクラスを XML リーダーとしてロードおよびインスタンス化しようとします。

このメソッドは、呼び出し側 (たいていの場合はアプレット) がクラスを動的にロードできない環境では使用できません。

戻り値:

新しい XML リーダー

例外:

SAXException - クラスのロード、インスタンス化、XMLReader へのキャストができない場合。

関連項目:

createXMLReader()