HandlerBase (Java Platform SE 7)

java.lang.Object
- org.xml.sax.HandlerBase

すべての実装されたインタフェース:

DocumentHandler, DTDHandler, EntityResolver, ErrorHandler

非推奨。
このクラスは非推奨の DocumentHandler インタフェースで動作します。SAX2 では、このクラスは DefaultHandler クラスで置き換えられています。
```
public class HandlerBase
extends Object
implements EntityResolver, DTDHandler, DocumentHandler, ErrorHandler
```
ハンドラのデフォルトの基底クラスです。
このモジュールは、ソースコード、文書ともに公開ドメインに置かれています。したがって、内容に関する保証は一切提供されません。詳細については、http://www.saxproject.org を参照してください。

このクラスは、EntityResolver、DTDHandler、DocumentHandler、ErrorHandler の 4 つの SAX1 インタフェースのデフォルトの動作を実装します。このクラスは現在使用されていませんが、古い SAX1 アプリケーションをサポートするため、SAX2 に含められています。SAX2 アプリケーションでは、代わりに DefaultHandler クラスを使用する必要があります。

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

このクラスの使用はオプションです。

導入されたバージョン:

SAX 1.0

関連項目:
EntityResolver, DTDHandler, DocumentHandler, ErrorHandler

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明

HandlerBase()
非推奨。

コンストラクタ
コンストラクタと説明
`HandlerBase()` 非推奨。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`void`	`characters(char[] ch, int start, int length)` 非推奨。要素内の文字データの通知を受け取ります。
`void`	`endDocument()` 非推奨。文書の終了通知を受け取ります。
`void`	`endElement(String name)` 非推奨。要素の終了通知を受け取ります。
`void`	`error(SAXParseException e)` 非推奨。回復可能なパーサーエラーの通知を受け取ります。
`void`	`fatalError(SAXParseException e)` 非推奨。致命的な XML 構文解析エラーを報告します。
`void`	`ignorableWhitespace(char[] ch, int start, int length)` 非推奨。要素コンテンツに含まれる無視できる空白文字の通知を受け取ります。
`void`	`notationDecl(String name, String publicId, String systemId)` 非推奨。表記法宣言の通知を受け取ります。
`void`	`processingInstruction(String target, String data)` 非推奨。処理命令の通知を受け取ります。
`InputSource`	`resolveEntity(String publicId, String systemId)` 非推奨。外部エンティティーを解決します。
`void`	`setDocumentLocator(Locator locator)` 非推奨。文書イベントの Locator オブジェクトを受け取ります。
`void`	`startDocument()` 非推奨。文書の開始通知を受け取ります。
`void`	`startElement(String name, AttributeList attributes)` 非推奨。要素の開始通知を受け取ります。
`void`	`unparsedEntityDecl(String name, String publicId, String systemId, String notationName)` 非推奨。解析対象外エンティティー宣言の通知を受け取ります。
`void`	`warning(SAXParseException e)` 非推奨。パーサー警告の通知を受け取ります。

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - HandlerBase
```
public HandlerBase()
```
    非推奨。
- メソッドの詳細
  - resolveEntity
```
public InputSource resolveEntity(String publicId,
                        String systemId)
                          throws SAXException
```
    非推奨。
    
    外部エンティティーを解決します。
    常に null を返します。これは、パーサーに XML 文書内のシステム識別子を使用させるためです。このメソッドは SAX のデフォルトの動作を実装します。アプリケーションの作成者は、サブクラス内でこれをオーバーライドし、カタログ検索や URI リダイレクションのような特殊な変換を行います。
    
    定義:
    
    resolveEntity、インタフェース: EntityResolver
    
    パラメータ:
    publicId - 公開識別子。使用できない場合は null。
    systemId - XML 文書に含まれているシステム識別子。
    
    戻り値:
    新しい入力ソース。デフォルトの動作が必要な場合は null。
    
    例外:
    
    SAXException - 任意の SAX 例外。ほかの例外をラップしている可能性がある。
    関連項目:
    EntityResolver.resolveEntity(java.lang.String, java.lang.String)
  - notationDecl
```
public void notationDecl(String name,
                String publicId,
                String systemId)
```
    非推奨。
    
    表記法宣言の通知を受け取ります。
    デフォルトでは何も行いません。文書内に宣言された表記法を追跡する必要がある場合、アプリケーションの作成者は、サブクラス内でこのメソッドをオーバーライドします。
    
    定義:
    
    notationDecl、インタフェース: DTDHandler
    
    パラメータ:
    name - 表記法名。
    publicId - 表記法の公開識別子。使用できない場合は null。
    systemId - 表記法のシステム識別子。
    関連項目:
    DTDHandler.notationDecl(java.lang.String, java.lang.String, java.lang.String)
  - unparsedEntityDecl
```
public void unparsedEntityDecl(String name,
                      String publicId,
                      String systemId,
                      String notationName)
```
    非推奨。
    
    解析対象外エンティティー宣言の通知を受け取ります。
    デフォルトでは何も行いません。文書内に宣言された解析対象外エンティティーを追跡する必要がある場合、アプリケーションの作成者は、サブクラス内でこのメソッドをオーバーライドします。
    
    定義:
    
    unparsedEntityDecl、インタフェース: DTDHandler
    
    パラメータ:
    name - エンティティー名。
    publicId - エンティティーの公開識別子。使用できない場合は null。
    systemId - エンティティーのシステム識別子。
    notationName - 関連表記法名。
    関連項目:
    DTDHandler.unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)
  - setDocumentLocator
```
public void setDocumentLocator(Locator locator)
```
    非推奨。
    
    文書イベントの Locator オブジェクトを受け取ります。
    デフォルトでは何も行いません。その他の文書イベントで使用するためにロケータを格納しておく必要がある場合、アプリケーションの作成者は、サブクラス内でこのメソッドをオーバーライドします。
    
    定義:
    
    setDocumentLocator、インタフェース: DocumentHandler
    
    パラメータ:
    locator - すべての SAX 文書イベントのロケータ。
    関連項目:
    DocumentHandler.setDocumentLocator(org.xml.sax.Locator), Locator
  - startDocument
```
public void startDocument()
                   throws SAXException
```
    非推奨。
    
    文書の開始通知を受け取ります。
    デフォルトでは何も行いません。アプリケーションの作成者は、サブクラス内のこのメソッドをオーバーライドして、文書の先頭で特殊なアクション (ツリーのルートノードの割り当て、出力ファイルの作成など) を実行できます。
    
    定義:
    
    startDocument、インタフェース: DocumentHandler
    
    例外:
    
    SAXException - 任意の SAX 例外。ほかの例外をラップしている可能性がある。
    関連項目:
    DocumentHandler.startDocument()
  - endDocument
```
public void endDocument()
                 throws SAXException
```
    非推奨。
    
    文書の終了通知を受け取ります。
    デフォルトでは何も行いません。アプリケーションの作成者は、サブクラス内のこのメソッドをオーバーライドして、文書の終わりで特殊なアクション (ツリーのファイナライズ、出力ファイルの終了など) を実行できます。
    
    定義:
    
    endDocument、インタフェース: DocumentHandler
    
    例外:
    
    SAXException - 任意の SAX 例外。ほかの例外をラップしている可能性がある。
    関連項目:
    DocumentHandler.endDocument()
  - startElement
```
public void startElement(String name,
                AttributeList attributes)
                  throws SAXException
```
    非推奨。
    
    要素の開始通知を受け取ります。
    デフォルトでは何も行いません。アプリケーションの作成者は、サブクラス内のこのメソッドをオーバーライドして、各要素の先頭で特殊なアクション (新しいツリーノードの割り当て、出力内容のファイルへの書き込みなど) を実行できます。名前空間 URI。
    
    定義:
    
    startElement、インタフェース: DocumentHandler
    
    パラメータ:
    name - 要素型名。
    attributes - 指定された属性またはデフォルトの属性。
    
    例外:
    
    SAXException - 任意の SAX 例外。ほかの例外をラップしている可能性がある。
    関連項目:
    DocumentHandler.startElement(java.lang.String, org.xml.sax.AttributeList)
  - endElement
```
public void endElement(String name)
                throws SAXException
```
    非推奨。
    
    要素の終了通知を受け取ります。
    デフォルトでは何も行いません。アプリケーションの作成者は、サブクラス内のこのメソッドをオーバーライドして、各要素の終わりで特殊なアクション (ツリーノードのファイナライズ、出力内容のファイルへの書き込みなど) を実行できます。
    
    定義:
    
    endElement、インタフェース: DocumentHandler
    
    パラメータ:
    name - 要素名
    
    例外:
    
    SAXException - 任意の SAX 例外。ほかの例外をラップしている可能性がある。
    関連項目:
    DocumentHandler.endElement(java.lang.String)
  - characters
```
public void characters(char[] ch,
              int start,
              int length)
                throws SAXException
```
    非推奨。
    
    要素内の文字データの通知を受け取ります。
    デフォルトでは何も行いません。アプリケーションの作成者は、このメソッドをオーバーライドして、各文字データチャンクに対して特殊なアクション (ノードまたはバッファーへのデータの追加、データのファイルへの出力など) を実行できます。
    
    定義:
    
    characters、インタフェース: DocumentHandler
    
    パラメータ:
    ch - 文字。
    start - 文字配列内の開始位置。
    length - 文字配列から使用される文字数。
    
    例外:
    
    SAXException - 任意の SAX 例外。ほかの例外をラップしている可能性がある。
    関連項目:
    DocumentHandler.characters(char[], int, int)
  - ignorableWhitespace
```
public void ignorableWhitespace(char[] ch,
                       int start,
                       int length)
                         throws SAXException
```
    非推奨。
    
    要素コンテンツに含まれる無視できる空白文字の通知を受け取ります。
    デフォルトでは何も行いません。アプリケーションの作成者は、このメソッドをオーバーライドして、無視できる空白文字の各チャンクに対して特殊なアクション (ノードまたはバッファーへのデータの追加、データのファイルへの出力など) を実行できます。
    
    定義:
    
    ignorableWhitespace、インタフェース: DocumentHandler
    
    パラメータ:
    ch - 空白文字。
    start - 文字配列内の開始位置。
    length - 文字配列から使用される文字数。
    
    例外:
    
    SAXException - 任意の SAX 例外。ほかの例外をラップしている可能性がある。
    関連項目:
    DocumentHandler.ignorableWhitespace(char[], int, int)
  - processingInstruction
```
public void processingInstruction(String target,
                         String data)
                           throws SAXException
```
    非推奨。
    
    処理命令の通知を受け取ります。
    デフォルトでは何も行いません。アプリケーションの作成者は、サブクラス内のこのメソッドをオーバーライドして、各処理命令に対して特殊なアクション (ステータス変数の設定、その他のメソッドの呼び出しなど) を実行できます。
    
    定義:
    
    processingInstruction、インタフェース: DocumentHandler
    
    パラメータ:
    target - 処理命令のターゲット。
    data - 処理命令データ。データが提供されない場合は null。
    
    例外:
    
    SAXException - 任意の SAX 例外。ほかの例外をラップしている可能性がある。
    関連項目:
    DocumentHandler.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

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス HandlerBase

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Object から継承されたメソッド

コンストラクタの詳細

HandlerBase

メソッドの詳細

resolveEntity

notationDecl

unparsedEntityDecl

setDocumentLocator

startDocument

endDocument

startElement

endElement

characters

ignorableWhitespace

processingInstruction

warning

error

fatalError