クラス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イベント・ハンドラのデフォルト基底クラスです。

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

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

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

導入されたバージョン:
1.4, SAX 2.0
関連 目:

  • コンストラクタの詳細

    • DefaultHandler

      public DefaultHandler()
      DefaultHandlerを構築します。

  • メソッドの詳細

    • 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例外。ほかの例外をラップしている可能性があります。
      関連 目:

    • notationDecl

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

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

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

    • unparsedEntityDecl

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

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

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

    • setDocumentLocator

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

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

      定義:
      setDocumentLocator、インタフェースContentHandler
      パラメータ:
      locator - すべてのSAX文書イベントのロケータ。
      関連 目:

    • startDocument

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

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

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

    • endDocument

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

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

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

    • startPrefixMapping

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

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

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

    • endPrefixMapping

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

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

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

    • 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例外。ほかの例外をラップしている可能性があります。
      関連 目:

    • endElement

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

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

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

    • characters

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

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

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

    • ignorableWhitespace

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

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

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

    • processingInstruction

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

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

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

    • skippedEntity

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

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

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

    • warning

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

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

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

    • error

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

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

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

    • fatalError

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

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

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