モジュール java.xml
パッケージ 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実装クラスを検索およびロードするために、次の順序付けられたルックアップ手順を使用します:
        1. システム・プロパティorg.xml.sax.driverに値がある場合は、それがXMLReaderクラス名として使用される。
        2. ServiceLoaderクラスで定義されたサービス・プロバイダ・ローディング機能を使用して、「現在のスレッド・コンテキスト・クラス・ローダー」を使用してサービスXMLReaderの実装を見つけてロードしようとします。 コンテキスト・クラス・ローダーがnullの場合、システム・クラス・ローダーが使用されます。
        3. 非推奨。 実行時に使用できるjarファイルのMETA-INF/services/org.xml.sax.driverファイルでクラス名を探します。
        4. それ以外の場合、システムのデフォルト実装が返される。

        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()