- java.lang.Object
-
- org.xml.sax.helpers.XMLReaderFactory
-
@Deprecated(since="9") public final class XMLReaderFactory extends Object
非推奨。代わりにSAXParserFactory
を使用することをお勧めします。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
にバインドするものがないためにそれらの構成メカニズムに表示されない場合でも同じです。- 導入されたバージョン:
- 1.4, SAX 2.0
-
-
メソッドの詳細
-
createXMLReader
public static XMLReader createXMLReader() throws SAXException
非推奨。XMLReader
の新しいインスタンスを取得します。 このメソッドは、XMLReader
実装クラスを検索およびロードするために、次の順序付けられたルックアップ手順を使用します:- システム・プロパティ
org.xml.sax.driver
に値がある場合は、それがXMLReaderクラス名として使用される。 -
ServiceLoader
クラスで定義されたサービス・プロバイダ・ローディング機能を使用して、「現在のスレッド・コンテキスト・クラス・ローダー」を使用してサービスXMLReader
の実装を見つけてロードしようとします。 コンテキスト・クラス・ローダーがnullの場合、システム・クラス・ローダーが使用されます。 -
非推奨。 実行時に使用できるjarファイルの
META-INF/services/org.xml.sax.driver
ファイルでクラス名を探します。 -
それ以外の場合、システムのデフォルト実装が返される。
- APIの注:
- jarファイル内の
META-INF/services/org.xml.sax.driver
ファイル内のクラス名を検索するプロセスは、ServiceLoader
で定義されているサービス・プロバイダ・ロード機能の仕様に準拠していないため、モジュール化をサポートしていません。 Java SE 9以降では非推奨にされ、将来のリリースで削除される予定です。 - 戻り値:
- 新しいXMLReader。
- 例外:
SAXException
- デフォルトのXMLReaderクラスを識別およびインスタンス化できない場合。- 関連項目:
createXMLReader(java.lang.String)
- システム・プロパティ
-
createXMLReader
public static XMLReader createXMLReader(String className) throws SAXException
非推奨。クラス名からXMLリーダーの生成を試みます。このメソッドは、指定されたクラス名のクラスをXMLリーダーとしてロードおよびインスタンス化しようとします。
このメソッドは、呼出し側(たいていの場合はアプレット)がクラスを動的にロードできない環境では使用できません。
- 戻り値:
- 新しいXMLリーダー
- 例外:
SAXException
- クラスのロード、インスタンス化、XMLReaderへのキャストができない場合。- 関連項目:
createXMLReader()
-
-