compact2, compact3

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

バージョン:

2.0.1 (sax2r2)

メソッドのサマリー

修飾子と型	メソッドと説明
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()