モジュール java.xml
パッケージ org.xml.sax.ext

インタフェースDeclHandler

  • 既知のすべての実装クラス:
    DefaultHandler2
    public interface DeclHandler
    DTD宣言イベントのためのSAX2拡張ハンドラです。
    このモジュールは、ソース・コード、文書ともに公開ドメインに置かれています。したがって、内容に関する保証は一切提供されません。 詳細については、http://www.saxproject.orgを参照してください。

    XML文書中のDTD宣言に関するより完全な情報を提供するSAX2用のオプションの拡張ハンドラです。 このハンドラを認識するために、XMLリーダーは不要です。また、このハンドラは、SAX2のコアのみのディストリビューションには含まれていません。

    データ関連のDTD宣言(解析対象外のエンティティおよび表記法)は、すでにDTDHandlerインタフェースによって報告されています。

    宣言ハンドラと字句ハンドラを同時に使用する場合、すべてのイベントはstartDTDイベントからendDTDイベントまでの間に発生します。

    XMLリーダーのDeclHandlerを設定するには、プロパティ名としてhttp://xml.org/sax/properties/declaration-handler、その値としてこのインタフェースを実装するオブジェクト(またはnull)を指定して、setPropertyメソッドを使用します。 リーダーが宣言イベントを報告しない場合、ハンドラを登録しようとするとSAXNotRecognizedExceptionがスローされます。

    導入されたバージョン:
    1.4、SAX 2.0 (拡張機能1.0)

    • メソッドの詳細

      • elementDecl

        void elementDecl​(String name,
                 String model)
          throws SAXException
        要素型宣言を報告します。

        コンテンツ・モデルは、文字列「EMPTY」、文字列「ANY」またはカッコに入れられたグループ(オプションで出現インジケータを伴う)で構成されます。 このモデルは、すべてのパラメータ・エンティティが完全に解決され、すべての空白文字が削除されるように正規化されます。また、囲むカッコを含みます。 その他の正規化(重複したカッコの削除、出現インジケータの簡易化など)はパーサーによって随意行われます。

        パラメータ:
        name - 要素型名。
        model - コンテンツ・モデルを示す正規文字列。
        例外:
        SAXException - アプリケーションが例外を発生させる場合があります。

      • attributeDecl

        void attributeDecl​(String eName,
                   String aName,
                   String type,
                   String mode,
                   String value)
            throws SAXException
        属性型宣言を報告します。

        有効な(最初の)属性宣言だけが報告されます。 型は、「CDATA」、「ID」、「IDREF」、「IDREFS」、「NMTOKEN」、「NMTOKENS」、「ENTITY」、「ENTITIES」、区切り文字「|」と、削除されたすべての空白文字とともに括弧に入れられたトークン・グループ、または削除されたすべての空白文字とともに括弧に入れられたトークン・グループの直前にある空白文字の、直前の「NOTATION」という語のどれかの文字列になります。

        値はアプリケーションに報告され、適正に正規化されてエンティティ参照と文字列参照を拡張した値になります。

        パラメータ:
        eName - 関連要素名。
        aName - 属性の名前。
        type - 属性型を示す文字列。
        mode - 属性のデフォルト・モードを示す文字列(#IMPLIED、#REQUIRED、または#FIXED)。いずれにも当てはまらない場合はnull。
        value - 属性のデフォルト値を示す文字列。存在しない場合はnull。
        例外:
        SAXException - アプリケーションが例外を発生させる場合があります。