DefaultHandler2 (Java Platform SE 8)

java.lang.Object
- org.xml.sax.helpers.DefaultHandler
- - org.xml.sax.ext.DefaultHandler2

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

ContentHandler, DTDHandler, EntityResolver, ErrorHandler, DeclHandler, EntityResolver2, LexicalHandler
```
public class DefaultHandler2
extends DefaultHandler
implements LexicalHandler, DeclHandler, EntityResolver2
```
このクラスはSAX2の基本となるハンドラ・クラスを拡張して、SAX2のLexicalHandler、DeclHandler、およびEntityResolver2拡張をサポートします。元のSAX1 resolveEntity()メソッドをオーバーライドする以外は、追加されたハンドラ・メソッドは戻るだけです。サブクラサーはメソッドごとにすべてをオーバーライドできます。
このモジュールは、ソース・コード、文書ともに公開ドメインに置かれています。したがって、内容に関する保証は一切提供されません。

ノート: このクラスは、ContentHandler.setDocumentLocator()呼出しにLocator2オブジェクトが渡され、またContentHandler.startElement()呼出しにAttributes2オブジェクトが渡されたことをすでに認識している可能性があります。

導入されたバージョン:

SAX 2.0 (extensions 1.1 alpha)

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

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

DefaultHandler2()
すべての構文解析イベントを無視するハンドラを構築します。

コンストラクタ
コンストラクタ	説明
`DefaultHandler2()`	すべての構文解析イベントを無視するハンドラを構築します。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッド	説明
`void`	`attributeDecl(String eName, String aName, String type, String mode, String value)`	属性型宣言を報告します。
`void`	`comment(char[] ch, int start, int length)`	文書内の任意の位置にあるXMLコメントを報告します。
`void`	`elementDecl(String name, String model)`	要素型宣言を報告します。
`void`	`endCDATA()`	CDATAセクションの終わりを報告します。
`void`	`endDTD()`	DTD宣言の終わりを報告します。
`void`	`endEntity(String name)`	エンティティの終わりを報告します。
`void`	`externalEntityDecl(String name, String publicId, String systemId)`	構文解析済みの外部エンティティ宣言を報告します。
`InputSource`	`getExternalSubset(String name, String baseURI)`	外部サブセットが文書テキストに宣言されなかった場合、何も使用されないことをパーサーに通知します。
`void`	`internalEntityDecl(String name, String value)`	内部エンティティ宣言を報告します。
`InputSource`	`resolveEntity(String publicId, String systemId)`	nullのエンティティ名とベースURIを使用して`EntityResolver2.resolveEntity()`を呼び出します。
`InputSource`	`resolveEntity(String name, String publicId, String baseURI, String systemId)`	基底URIに対してsystemIdを解釈処理して結果が絶対URIとなったエンティティ・テキストを読み取るようパーサーに通知します。
`void`	`startCDATA()`	CDATAセクションの開始を報告します。
`void`	`startDTD(String name, String publicId, String systemId)`	DTD宣言がある場合、その開始を報告します。
`void`	`startEntity(String name)`	内部および外部のXMLエンティティの一部の開始を報告します。

クラス org.xml.sax.helpers.DefaultHandlerから継承されたメソッド
characters, endDocument, endElement, endPrefixMapping, error, fatalError, ignorableWhitespace, notationDecl, processingInstruction, setDocumentLocator, skippedEntity, startDocument, startElement, startPrefixMapping, unparsedEntityDecl, warning

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

- コンストラクタの詳細
  - DefaultHandler2
```
public DefaultHandler2()
```
    すべての構文解析イベントを無視するハンドラを構築します。
- メソッドの詳細
  - startCDATA
```
public void startCDATA()
                throws SAXException
```
    インタフェースからコピーされた説明: LexicalHandler
    
    CDATAセクションの開始を報告します。
    CDATAセクションのコンテンツは、正規のcharactersイベントを介して報告されます。このイベントは境界の報告だけに使用されます。
    
    定義:
    
    startCDATA、インタフェースLexicalHandler
    
    例外:
    
    SAXException - アプリケーションが例外を発生させる場合があります。
    
    関連項目:
    
    LexicalHandler.endCDATA()
  - endCDATA
```
public void endCDATA()
              throws SAXException
```
    インタフェースからコピーされた説明: LexicalHandler
    
    CDATAセクションの終わりを報告します。
    
    定義:
    
    endCDATA、インタフェースLexicalHandler
    
    例外:
    
    SAXException - アプリケーションが例外を発生させる場合があります。
    
    関連項目:
    
    LexicalHandler.startCDATA()
  - startDTD
```
public void startDTD(String name,
                     String publicId,
                     String systemId)
              throws SAXException
```
    インタフェースからコピーされた説明: LexicalHandler
    
    DTD宣言がある場合、その開始を報告します。
    このメソッドは、DOCTYPE宣言の開始を報告するメソッドです。文書にDOCTYPE宣言が含まれていない場合は呼び出されません。
    
    DTDHandlerイベントまたはDeclHandlerイベントを介して報告されるすべての宣言は、startDTDイベントからendDTDイベントまでの間に出現することになっています。宣言は、startEntityイベントからendEntityイベントまでの間に出現しないと、内部DTDサブセットに所属するものと見なされます。 DTDのコメントおよび処理命令も、startDTDイベントからendDTDイベントまでの間に、元の(論理的な)発生順で報告されることになっています。ただし、DTDHandlerイベントやDeclHandlerイベントに対する正確な相対位置に出現する必要はありません。
    
    startDTD/endDTDイベントは、ContentHandlerからのstartDocumentイベントとendDocumentイベントの間で、最初のstartElementイベントの前に出現します。
    
    定義:
    
    startDTD、インタフェースLexicalHandler
    
    パラメータ:
    
    name - 文書型名。
    
    publicId - 宣言された外部DTDサブセットの公開識別子。宣言されていない場合はnull。
    
    systemId - 宣言された外部DTDサブセットのシステム識別子。宣言されていない場合はnull。 (文書のベースURIに対しては解決されません)
    
    例外:
    
    SAXException - アプリケーションが例外を発生させる場合があります。
    
    関連項目:
    
    LexicalHandler.endDTD(), LexicalHandler.startEntity(java.lang.String)
  - endDTD
```
public void endDTD()
            throws SAXException
```
    インタフェースからコピーされた説明: LexicalHandler
    
    DTD宣言の終わりを報告します。
    このメソッドは、DOCTYPE宣言の終わりを報告するメソッドです。文書にDOCTYPE宣言が含まれていない場合は呼び出されません。
    
    定義:
    
    endDTD、インタフェースLexicalHandler
    
    例外:
    
    SAXException - アプリケーションが例外を発生させる場合があります。
    
    関連項目:
    
    LexicalHandler.startDTD(java.lang.String, java.lang.String, java.lang.String)
  - startEntity
```
public void startEntity(String name)
                 throws SAXException
```
    インタフェースからコピーされた説明: LexicalHandler
    内部および外部のXMLエンティティの一部の開始を報告します。
    パラメータ・エンティティ(外部DTDサブセットを含む)の報告機能はオプションです。LexicalHandlerイベントを報告するSAX2のドライバの中には、この機能を実装しないものもあります。http://xml.org/sax/features/lexical-handler/parameter-entities機能を使って、パラメータ・エンティティの報告を照会または制御できます。
    
    一般的なエンティティは、正規名で報告されます。パラメータ・エンティティ名の前には「%」が付けられています。外部DTDサブセットは「[dtd]」という擬似エンティティ名を持っています。
    
    SAX2ドライバがこれらのイベントを提供しているときは、その他のすべてのイベントをstart/endエンティティ・イベント内に正しく入れ子にする必要があります。 DeclHandlerまたはDTDHandlerのイベントを正しい順序で並べる必要はありません。
    
    スキップされたエンティティは、ContentHandlerインタフェースの一部であるskippedEntityイベントを介して報告されます。
    
    SAXが採用しているストリーミング・イベント・モデルの制約により、次の状況では一部のエンティティ境界を報告することができません。
    - 属性値に含まれている一般的なエンティティ
    - 宣言に含まれているパラメータ・エンティティ
    これらは通知なく拡張されます。元のエンティティ境界の位置は示されません。
    
    文字参照の境界(実際にはエンティティではない)も報告されません。
    
    すべてのstart/endEntityイベントを正しく入れ子にする必要があります。
    定義:
    
    startEntity、インタフェースLexicalHandler
    
    パラメータ:
    
    name - エンティティの名前。パラメータ・エンティティの場合、この名前は「%」で始まります。外部DTDサブセットの場合は「[dtd]」となります。
    
    例外:
    
    SAXException - アプリケーションが例外を発生させる場合があります。
    
    関連項目:
    
    LexicalHandler.endEntity(java.lang.String), DeclHandler.internalEntityDecl(java.lang.String, java.lang.String), DeclHandler.externalEntityDecl(java.lang.String, java.lang.String, java.lang.String)
  - endEntity
```
public void endEntity(String name)
               throws SAXException
```
    インタフェースからコピーされた説明: LexicalHandler
    
    エンティティの終わりを報告します。
    
    定義:
    
    endEntity、インタフェースLexicalHandler
    
    パラメータ:
    
    name - 終了するエンティティの名前。
    
    例外:
    
    SAXException - アプリケーションが例外を発生させる場合があります。
    
    関連項目:
    
    LexicalHandler.startEntity(java.lang.String)
  - comment
```
public void comment(char[] ch,
                    int start,
                    int length)
             throws SAXException
```
    インタフェースからコピーされた説明: LexicalHandler
    
    文書内の任意の位置にあるXMLコメントを報告します。
    このコールバックは、文書要素の内外に存在するコメント(外部DTDサブセット内のコメントも含む)に対して使用されます。 DTD内のコメントは、start/endDTDイベントとstart/endEntityイベント(使用されている場合)の内部に正しく入れ子にする必要があります。
    
    定義:
    
    comment、インタフェースLexicalHandler
    
    パラメータ:
    
    ch - コメントに含まれる文字を格納する配列。
    
    start - 配列内の開始位置。
    
    length - 配列から使用される文字数。
    
    例外:
    
    SAXException - アプリケーションが例外を発生させる場合があります。
  - attributeDecl
```
public void attributeDecl(String eName,
                          String aName,
                          String type,
                          String mode,
                          String value)
                   throws SAXException
```
    インタフェースからコピーされた説明: DeclHandler
    
    属性型宣言を報告します。
    有効な(最初の)属性宣言だけが報告されます。型は、「CDATA」、「ID」、「IDREF」、「IDREFS」、「NMTOKEN」、「NMTOKENS」、「ENTITY」、「ENTITIES」、区切り文字「|」と、削除されたすべての空白文字とともに括弧に入れられたトークン・グループ、または削除されたすべての空白文字とともに括弧に入れられたトークン・グループの直前にある空白文字の、直前の「NOTATION」という語のどれかの文字列になります。
    
    値はアプリケーションに報告され、適正に正規化されてエンティティ参照と文字列参照を拡張した値になります。
    
    定義:
    
    attributeDecl、インタフェースDeclHandler
    
    パラメータ:
    
    eName - 関連要素名。
    
    aName - 属性の名前。
    
    type - 属性型を示す文字列。
    
    mode - 属性のデフォルト・モードを示す文字列(#IMPLIED、#REQUIRED、または#FIXED)。いずれにも当てはまらない場合はnull。
    
    value - 属性のデフォルト値を示す文字列。存在しない場合はnull。
    
    例外:
    
    SAXException - アプリケーションが例外を発生させる場合があります。
  - elementDecl
```
public void elementDecl(String name,
                        String model)
                 throws SAXException
```
    インタフェースからコピーされた説明: DeclHandler
    
    要素型宣言を報告します。
    コンテンツ・モデルは、文字列「EMPTY」、文字列「ANY」またはカッコに入れられたグループ(オプションで出現インジケータを伴う)で構成されます。このモデルは、すべてのパラメータ・エンティティが完全に解決され、すべての空白文字が削除されるように正規化されます。また、囲むカッコを含みます。その他の正規化(重複したカッコの削除、出現インジケータの簡易化など)はパーサーによって随意行われます。
    
    定義:
    
    elementDecl、インタフェースDeclHandler
    
    パラメータ:
    
    name - 要素型名。
    
    model - コンテンツ・モデルを示す正規文字列。
    
    例外:
    
    SAXException - アプリケーションが例外を発生させる場合があります。
  - externalEntityDecl
```
public void externalEntityDecl(String name,
                               String publicId,
                               String systemId)
                        throws SAXException
```
    インタフェースからコピーされた説明: DeclHandler
    
    構文解析済みの外部エンティティ宣言を報告します。
    有効な(最初の)エンティティ宣言だけが報告されます。
    
    システム識別子がURLの場合、パーサーはこれをアプリケーションに渡す前に完全に解決する必要があります。
    
    定義:
    
    externalEntityDecl、インタフェースDeclHandler
    
    パラメータ:
    
    name - エンティティの名前。パラメータ・エンティティの場合、名前は「%」で始まる。
    
    publicId - エンティティの公開識別子。指定されなかった場合はnull。
    
    systemId - エンティティのシステム識別子。
    
    例外:
    
    SAXException - アプリケーションが例外を発生させる場合があります。
    
    関連項目:
    
    DeclHandler.internalEntityDecl(java.lang.String, java.lang.String), DTDHandler.unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)
  - internalEntityDecl
```
public void internalEntityDecl(String name,
                               String value)
                        throws SAXException
```
    インタフェースからコピーされた説明: DeclHandler
    
    内部エンティティ宣言を報告します。
    有効な(最初の)エンティティ宣言だけが報告されます。通常のエンティティとは異なり、値に含まれるすべてのパラメータ・エンティティは拡張されます。
    
    定義:
    
    internalEntityDecl、インタフェースDeclHandler
    
    パラメータ:
    
    name - エンティティの名前。パラメータ・エンティティの場合、名前は「%」で始まる。
    
    value - エンティティの置換テキスト。
    
    例外:
    
    SAXException - アプリケーションが例外を発生させる場合があります。
    
    関連項目:
    
    DeclHandler.externalEntityDecl(java.lang.String, java.lang.String, java.lang.String), DTDHandler.unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)
  - getExternalSubset
```
public InputSource getExternalSubset(String name,
                                     String baseURI)
                              throws SAXException,
                                     IOException
```
    外部サブセットが文書テキストに宣言されなかった場合、何も使用されないことをパーサーに通知します。
    
    定義:
    
    getExternalSubset、インタフェースEntityResolver2
    
    パラメータ:
    
    name - 文書のルート要素の識別。利用可能なDOCTYPE宣言または実際のルート要素からの名前。
    
    baseURI - 文書のベースURI。外部サブセットを選択する追加ヒントとして機能する。 XMLReaderにInputSourceしか提供されなかったためにnullとなる場合を除き、常に絶対URIである。
    
    戻り値:
    
    パーサーによって使用される新しい外部サブセットを記述するInputSourceオブジェクト。外部サブセットが提供されない場合はnullが示される。
    
    例外:
    
    SAXException - 任意のSAX例外。ほかの例外をラップしている可能性があります。
    
    IOException - 新しいInputStreamやReaderの作成失敗、または不正なURLを示している可能性があります。
  - resolveEntity
```
public InputSource resolveEntity(String name,
                                 String publicId,
                                 String baseURI,
                                 String systemId)
                          throws SAXException,
                                 IOException
```
    基底URIに対してsystemIdを解釈処理して結果が絶対URIとなったエンティティ・テキストを読み取るようパーサーに通知します。古いDefaultHandler.resolveEntity()メソッドはこのメソッドを呼び出すようにオーバーライドされるので、このメソッドはnullのnameとbaseURI、およびすでに絶対化されているsystemIdで呼び出されることがあります。
    
    定義:
    
    resolveEntity、インタフェースEntityResolver2
    
    パラメータ:
    
    name - 解決される外部エンティティの識別。外部サブセットの「[dtd]」やパラメータ・エンティティを示す「%」で開始される名前、またはそれ以外の一般エンティティの名前。 SAX2パーサーによって呼び出される場合nullにはなりません。
    
    publicId - 参照される外部エンティティの公開識別子(XML仕様で要求されるように正規化されている)。提供されなかった場合はnull。
    
    baseURI - 相対的なsystemIDを解釈するときに基準にするURI。 XMLReaderはInputSourceに指定された可能性があるので、nullでないかぎり常に絶対URI。このURIは、関連する宣言を開始する「<」に関連付けられているXML仕様によって定義されます。
    
    systemId - 参照される外部エンティティのシステム識別子。相対URIまたは絶対URI。 SAX2パーサーによって呼び出される場合nullにはなりません。宣言されたエンティティと外部サブセットのみが、そうしたパーサーによって解決されます。
    
    戻り値:
    
    パーサーによって使用される新しい入力ソースを記述するInputSourceオブジェクト。 nullを返すことによって、基底URIに対するシステムIDを解決し、結果として得られるURIにつなげるようにパーサーに指示する。
    
    例外:
    
    SAXException - 任意のSAX例外。ほかの例外をラップしている可能性があります。
    
    IOException - 新しいInputStreamやReaderの作成失敗、または不正なURLを示している可能性があります。
  - resolveEntity
```
public InputSource resolveEntity(String publicId,
                                 String systemId)
                          throws SAXException,
                                 IOException
```
    nullのエンティティ名とベースURIを使用してEntityResolver2.resolveEntity()を呼び出します。このクラスを使用するには、そのメソッドをオーバーライドするだけでかまいません。
    
    定義:
    
    resolveEntity、インタフェースEntityResolver
    
    オーバーライド:
    
    resolveEntity、クラスDefaultHandler
    
    パラメータ:
    
    publicId - 公開識別子。使用できない場合はnull。
    
    systemId - XML文書に含まれているシステム識別子。
    
    戻り値:
    
    新しい入力ソース。デフォルトの動作が必要な場合はnull。
    
    例外:
    
    SAXException - 任意のSAX例外。ほかの例外をラップしている可能性があります。
    
    IOException - Java固有の入出力例外。InputSourceの新しいInputStreamまたはReaderの作成の結果として発生する可能性があります。
    
    関連項目:
    
    EntityResolver.resolveEntity(java.lang.String, java.lang.String)

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

クラスDefaultHandler2

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

メソッドのサマリー

クラス org.xml.sax.helpers.DefaultHandlerから継承されたメソッド

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

コンストラクタの詳細

DefaultHandler2

メソッドの詳細

startCDATA

endCDATA

startDTD

endDTD

startEntity

endEntity

comment

attributeDecl

elementDecl

externalEntityDecl

internalEntityDecl

getExternalSubset

resolveEntity

resolveEntity