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

クラスDefaultHandler

java.lang.Object
org.xml.sax.helpers.DefaultHandler
すべての実装されたインタフェース:
ContentHandler, DTDHandler, EntityResolver, ErrorHandler
直系の既知のサブクラス:
DefaultHandler2
public class DefaultHandler
extends Object
implements EntityResolver, DTDHandler, ContentHandler, ErrorHandler
SAX 2イベント・ハンドラのデフォルト基底クラスです。
このモジュールは、ソース・コード、文書ともに公開ドメインに置かれています。したがって、内容に関する保証は一切提供されません。 詳細については、http://www.saxproject.orgを参照してください。

このクラスは、SAX2アプリケーション用の簡易基底クラスです。SAX2の4つのコア・ハンドラ・クラスに含まれるすべてのコールバックのデフォルト実装を提供します。

アプリケーションの作成者は、インタフェースの一部だけを実装する必要があるとき、このクラスを拡張します。パーサーの作成者は、アプリケーション固有のデフォルト・ハンドラが提供されないとき、このクラスをインスタンス化してデフォルト・ハンドラを提供します。

このクラスは、非推奨に指定されているSAX1のHandlerBaseクラスに代わるクラスです。

導入されたバージョン:
1.4, SAX 2.0
関連項目:
EntityResolver, DTDHandler, ContentHandler, ErrorHandler

  • コンストラクタの詳細

  • メソッドの詳細

    • resolveEntity

      public InputSource resolveEntity​(String publicId, String systemId) throws IOException, SAXException
      外部エンティティを解決します。

      常にnullを返します。これは、パーサーにXML文書内のシステム識別子を使用させるためです。 このメソッドはSAXのデフォルトの動作を実装します。アプリケーションの作成者は、サブクラス内でこれをオーバーライドし、カタログ検索やURIリダイレクションのような特殊な変換を行います。

      定義:
      resolveEntity、インタフェース: EntityResolver
      パラメータ:
      publicId - 公開識別子。使用できない場合はnull。
      systemId - XML文書に含まれているシステム識別子。
      戻り値:
      新しい入力ソース。デフォルトの動作が必要な場合はnull。
      例外:
      IOException - 新しい入力ソースの設定中にエラーが発生した場合。
      SAXException - 任意のSAX例外。ほかの例外をラップしている可能性があります。
      関連項目:
      EntityResolver.resolveEntity(java.lang.String, java.lang.String)

    • notationDecl

      public void notationDecl​(String name, String publicId, String systemId) throws SAXException
      表記法宣言の通知を受け取ります。

      デフォルトでは何も行いません。 文書内に宣言された表記法を追跡する必要がある場合、アプリケーションの作成者は、サブクラス内でこのメソッドをオーバーライドします。

      定義:
      notationDecl、インタフェース: DTDHandler
      パラメータ:
      name - 表記法名。
      publicId - 表記法の公開識別子。使用できない場合はnull。
      systemId - 表記法のシステム識別子。
      例外:
      SAXException - 任意のSAX例外。ほかの例外をラップしている可能性があります。
      関連項目:
      DTDHandler.notationDecl(java.lang.String, java.lang.String, java.lang.String)

    • unparsedEntityDecl

      public void unparsedEntityDecl​(String name, String publicId, String systemId, String notationName) throws SAXException
      解析対象外エンティティ宣言の通知を受け取ります。

      デフォルトでは何も行いません。 文書内に宣言された解析対象外エンティティを追跡する必要がある場合、アプリケーションの作成者は、サブクラス内でこのメソッドをオーバーライドします。

      定義:
      unparsedEntityDecl、インタフェース: DTDHandler
      パラメータ:
      name - エンティティ名。
      publicId - エンティティの公開識別子。使用できない場合はnull。
      systemId - エンティティのシステム識別子。
      notationName - 関連表記法名。
      例外:
      SAXException - 任意のSAX例外。ほかの例外をラップしている可能性があります。
      関連項目:
      DTDHandler.unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)

    • setDocumentLocator

      public void setDocumentLocator​(Locator locator)
      文書イベントのLocatorオブジェクトを受け取ります。

      デフォルトでは何も行いません。 その他の文書イベントで使用するためにロケータを格納しておく必要がある場合、アプリケーションの作成者は、サブクラス内でこのメソッドをオーバーライドします。

      定義:
      setDocumentLocator、インタフェース: ContentHandler
      パラメータ:
      locator - すべてのSAX文書イベントのロケータ。
      関連項目:
      ContentHandler.setDocumentLocator(org.xml.sax.Locator), Locator

    • startDocument

      public void startDocument() throws SAXException
      文書の開始通知を受け取ります。

      デフォルトでは何も行いません。 アプリケーションの作成者は、サブクラス内のこのメソッドをオーバーライドして、文書の先頭で特殊なアクション(ツリーのルート・ノードの割り当て、出力ファイルの作成など)を実行できます。

      定義:
      startDocument、インタフェース: ContentHandler
      例外:
      SAXException - 任意のSAX例外。ほかの例外をラップしている可能性があります。
      関連項目:
      ContentHandler.startDocument()

    • endDocument

      public void endDocument() throws SAXException
      文書の終了通知を受け取ります。

      デフォルトでは何も行いません。 アプリケーションの作成者は、サブクラス内のこのメソッドをオーバーライドして、文書の終わりで特殊なアクション(ツリーのファイナライズ、出力ファイルの終了など)を実行できます。

      定義:
      endDocument、インタフェース: ContentHandler
      例外:
      SAXException - 任意のSAX例外。ほかの例外をラップしている可能性があります。
      関連項目:
      ContentHandler.endDocument()

    • startPrefixMapping

      public void startPrefixMapping​(String prefix, String uri) throws SAXException
      名前空間マッピングの開始通知を受け取ります。

      デフォルトでは何も行いません。 アプリケーションの作成者は、サブクラス内でこのメソッドをオーバーライドして、各名前空間接頭辞のスコープの開始位置で特定のアクション(接頭辞のマッピングの格納など)を実行できます。

      定義:
      startPrefixMapping、インタフェース: ContentHandler
      パラメータ:
      prefix - 宣言される名前空間接頭辞。
      uri - 接頭辞にマッピングされた名前空間URI。
      例外:
      SAXException - 任意のSAX例外。ほかの例外をラップしている可能性があります。
      関連項目:
      ContentHandler.startPrefixMapping(java.lang.String, java.lang.String)

    • endPrefixMapping

      public void endPrefixMapping​(String prefix) throws SAXException
      名前空間マッピングの終了通知を受け取ります。

      デフォルトでは何も行いません。 アプリケーションの作成者は、サブクラス内でこのメソッドをオーバーライドして、個々の接頭辞の終了位置で特定のアクションを実行できます。

      定義:
      endPrefixMapping、インタフェース: ContentHandler
      パラメータ:
      prefix - 宣言される名前空間接頭辞。
      例外:
      SAXException - 任意のSAX例外。ほかの例外をラップしている可能性があります。
      関連項目:
      ContentHandler.endPrefixMapping(java.lang.String)

    • startElement

      public void startElement​(String uri, String localName, String qName, Attributes attributes) throws SAXException
      要素の開始通知を受け取ります。

      デフォルトでは何も行いません。 アプリケーションの作成者は、サブクラス内のこのメソッドをオーバーライドして、各要素の先頭で特殊なアクション(新しいツリー・ノードの割当て、出力内容のファイルへの書込みなど)を実行できます。

      定義:
      startElement、インタフェース: ContentHandler
      パラメータ:
      uri - 名前空間URI。要素が名前空間URIを持たない場合、または名前空間処理が実行されない場合は空文字列。
      localName - 接頭辞なしのローカル名。名前空間処理が実行されない場合は空文字列。
      qName - 接頭辞付きの修飾名。修飾名を使用できない場合は空文字列。
      attributes - 要素に付加された属性。 属性が存在しない場合、空のAttributesオブジェクト。
      例外:
      SAXException - 任意のSAX例外。ほかの例外をラップしている可能性があります。
      関連項目:
      ContentHandler.startElement(java.lang.String, java.lang.String, java.lang.String, org.xml.sax.Attributes)

    • endElement

      public void endElement​(String uri, String localName, String qName) throws SAXException
      要素の終了通知を受け取ります。

      デフォルトでは何も行いません。 アプリケーションの作成者は、サブクラス内のこのメソッドをオーバーライドして、各要素の終わりで特殊なアクション(ツリー・ノードのファイナライズ、出力内容のファイルへの書き込みなど)を実行できます。

      定義:
      endElement、インタフェース: ContentHandler
      パラメータ:
      uri - 名前空間URI。要素が名前空間URIを持たない場合、または名前空間処理が実行されない場合は空文字列。
      localName - 接頭辞なしのローカル名。名前空間処理が実行されない場合は空文字列。
      qName - 接頭辞付きの修飾名。修飾名を使用できない場合は空文字列。
      例外:
      SAXException - 任意のSAX例外。ほかの例外をラップしている可能性があります。
      関連項目:
      ContentHandler.endElement(java.lang.String, java.lang.String, java.lang.String)

    • characters

      public void characters​(char[] ch, int start, int length) throws SAXException
      要素内の文字データの通知を受け取ります。

      デフォルトでは何も行いません。 アプリケーションの作成者は、このメソッドをオーバーライドして、各文字データ・チャンクに対して特殊なアクション(ノードまたはバッファへのデータの追加、データのファイルへの出力など)を実行できます。

      定義:
      characters、インタフェース: ContentHandler
      パラメータ:
      ch - 文字。
      start - 文字配列内の開始位置。
      length - 文字配列から使用される文字数。
      例外:
      SAXException - 任意のSAX例外。ほかの例外をラップしている可能性があります。
      関連項目:
      ContentHandler.characters(char[], int, int)

    • ignorableWhitespace

      public void ignorableWhitespace​(char[] ch, int start, int length) throws SAXException
      要素コンテンツに含まれる無視できる空白文字の通知を受け取ります。

      デフォルトでは何も行いません。 アプリケーションの作成者は、このメソッドをオーバーライドして、無視できる空白文字の各チャンクに対して特殊なアクション(ノードまたはバッファへのデータの追加、データのファイルへの出力など)を実行できます。

      定義:
      ignorableWhitespace、インタフェース: ContentHandler
      パラメータ:
      ch - 空白文字。
      start - 文字配列内の開始位置。
      length - 文字配列から使用される文字数。
      例外:
      SAXException - 任意のSAX例外。ほかの例外をラップしている可能性があります。
      関連項目:
      ContentHandler.ignorableWhitespace(char[], int, int)

    • processingInstruction

      public void processingInstruction​(String target, String data) throws SAXException
      処理命令の通知を受け取ります。

      デフォルトでは何も行いません。 アプリケーションの作成者は、サブクラス内のこのメソッドをオーバーライドして、各処理命令に対して特殊なアクション(ステータス変数の設定、その他のメソッドの呼び出しなど)を実行できます。

      定義:
      processingInstruction、インタフェース: ContentHandler
      パラメータ:
      target - 処理命令のターゲット。
      data - 処理命令データ。データが提供されない場合はnull。
      例外:
      SAXException - 任意のSAX例外。ほかの例外をラップしている可能性があります。
      関連項目:
      ContentHandler.processingInstruction(java.lang.String, java.lang.String)

    • skippedEntity

      public void skippedEntity​(String name) throws SAXException
      スキップされたエンティティの通知を受け取ります。

      デフォルトでは何も行いません。 アプリケーションの作成者は、サブクラス内のこのメソッドをオーバーライドして、各処理命令に対して特殊なアクション(ステータス変数の設定、その他のメソッドの呼び出しなど)を実行できます。

      定義:
      skippedEntity、インタフェース: ContentHandler
      パラメータ:
      name - スキップされたエンティティの名前。
      例外:
      SAXException - 任意のSAX例外。ほかの例外をラップしている可能性があります。
      関連項目:
      ContentHandler.processingInstruction(java.lang.String, java.lang.String)

    • warning

      public void warning​(SAXParseException e) throws SAXException
      パーサー警告の通知を受け取ります。

      デフォルト実装は何も実行しません。 アプリケーションの作成者は、サブクラス内のこのメソッドをオーバーライドして、各警告に対して特殊なアクション(ログ・ファイルへのメッセージの挿入、メッセージのコンソールへの出力など)を実行できます。

      定義:
      warning、インタフェース: ErrorHandler
      パラメータ:
      e - 例外としてエンコードされた警告情報。
      例外:
      SAXException - 任意のSAX例外。ほかの例外をラップしている可能性があります。
      関連項目:
      ErrorHandler.warning(org.xml.sax.SAXParseException), SAXParseException

    • error

      public void error​(SAXParseException e) throws SAXException
      回復可能なパーサー・エラーの通知を受け取ります。

      デフォルト実装は何も実行しません。 アプリケーションの作成者は、サブクラス内のこのメソッドをオーバーライドして、各エラーに対して特殊なアクション(ログ・ファイルへのメッセージの挿入、メッセージのコンソールへの出力など)を実行できます。

      定義:
      error、インタフェース: ErrorHandler
      パラメータ:
      e - 例外としてエンコードされたエラー情報。
      例外:
      SAXException - 任意のSAX例外。ほかの例外をラップしている可能性があります。
      関連項目:
      ErrorHandler.warning(org.xml.sax.SAXParseException), SAXParseException

    • fatalError

      public void fatalError​(SAXParseException e) throws SAXException
      致命的なXML構文解析エラーを報告します。

      デフォルトの実装ではSAXParseExceptionをスローします。 アプリケーションの作成者は、個々の致命的なエラーに対して特殊なアクションをとる(すべてのエラーを単一の報告にまとめるなど)必要がある場合、サブクラス内のこのメソッドをオーバーライドできます。このメソッドが呼び出されると、文書の信頼性が低くなり、パーサーも構文解析イベントを報告しなくなるので、アプリケーションの通常処理はすべて終了される必要があります。

      定義:
      fatalError、インタフェース: ErrorHandler
      パラメータ:
      e - 例外としてエンコードされたエラー情報。
      例外:
      SAXException - 任意のSAX例外。ほかの例外をラップしている可能性があります。
      関連項目:
      ErrorHandler.fatalError(org.xml.sax.SAXParseException), SAXParseException