クラスXMLReaderAdapter

java.lang.Object

org.xml.sax.helpers.XMLReaderAdapter

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

ContentHandler, Parser

public class XMLReaderAdapter extends Object implements Parser, ContentHandler

SAX2 XMLReaderをSAX1 Parserとして適応させます。

このクラスは、SAX2 XMLReaderをラップして、SAX1 Parserとして動作させます。 XMLReaderは、http://xml.org/sax/features/namespace-prefixesプロパティの値がtrueであるときの条件をサポートしている必要があります。サポートしていない場合、SAXExceptionで構文解析に失敗します。XMLReaderがhttp://xml.org/sax/features/namespacesプロパティの値がfalseであるときの条件をサポートしている場合は、効率を改善するためにそれが使用されます。

導入されたバージョン:

1.4, SAX 2.0

関連項目:

• Parser
• XMLReader

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

コンストラクタ

コンストラクタ	説明
XMLReaderAdapter()	新しいアダプタを作成します。
XMLReaderAdapter(XMLReader xmlReader)	新しいアダプタを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	characters(char[] ch, int start, int length)	SAX2の文字イベントを適応させます。
void	endDocument()	文書イベントを終了します。
void	endElement(String uri, String localName, String qName)	SAX2の要素終了イベントを適応させます。
void	endPrefixMapping(String prefix)	SAX2の前置修飾子のマッピング終了イベントを適応させます。
void	ignorableWhitespace(char[] ch, int start, int length)	SAX2の無視できる空白文字イベントを適応させます。
void	parse(String systemId)	文書を構文解析します。
void	parse(InputSource input)	文書を構文解析します。
void	processingInstruction(String target, String data)	SAX2の処理命令イベントを適応させます。
void	setDocumentHandler(DocumentHandler handler)	SAX1文書イベント・ハンドラを登録します。
void	setDocumentLocator(Locator locator)	文書ロケータを設定します。
void	setDTDHandler(DTDHandler handler)	DTDイベント・ハンドラを登録します。
void	setEntityResolver(EntityResolver resolver)	エンティティ・リゾルバを登録します。
void	setErrorHandler(ErrorHandler handler)	エラー・イベント・ハンドラを登録します。
void	setLocale(Locale locale)	エラー報告のためのロケールを設定します。
void	skippedEntity(String name)	SAX2のスキップされたエンティティ・イベントを適応させます。
void	startDocument()	文書イベントを開始します。
void	startElement(String uri, String localName, String qName, Attributes atts)	SAX2の要素開始イベントを適応させます。
void	startPrefixMapping(String prefix, String uri)	SAX2の前置修飾子のマッピング開始イベントを適応させます。

クラスオブジェクトで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

修飾子と型	メソッド	説明
protected Object	clone()	このオブジェクトのコピーを作成して、返します。
boolean	equals(Object obj)	このオブジェクトと他のオブジェクトが等しいかどうかを示します。
protected void	finalize()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 最終決定は非推奨であり、将来のリリースで削除される可能性があります。
final Class<?>	getClass()	このObjectの実行時クラスを返します。
int	hashCode()	このオブジェクトに対するハッシュ・コード値を返します。
final void	notify()	このオブジェクトのモニターで待機中のスレッドを1つ再開します。
final void	notifyAll()	このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
String	toString()	オブジェクトの文字列表現を返します。
final void	wait()	現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
final void	wait(long timeoutMillis)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
final void	wait(long timeoutMillis, int nanos)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

インタフェースで宣言されたメソッド ContentHandler

declaration

修飾子と型	メソッド	説明
default void	declaration(String version, String encoding, String standalone)	XML宣言の通知を受け取ります。

コンストラクタの詳細

XMLReaderAdapter

public XMLReaderAdapter() throws SAXException

新しいアダプタを作成します。

「org.xml.sax.driver」プロパティを使用して、組み込むSAX2ドライバを特定します。

スロー:

SAXException - 組込みドライバをインスタンス化できない場合、またはorg.xml.sax.driverプロパティが指定されていない場合。

XMLReaderAdapter

public XMLReaderAdapter(XMLReader xmlReader)

新しいアダプタを作成します。

SAX2 XMLReaderをラップする新しいアダプタを作成します。 このアダプタは、XMLReaderをSAX1 Parserとして機能させます。

パラメータ:

xmlReader - ラップするSAX2 XMLReader。

スロー:

NullPointerException - 引数がnullの場合。

メソッドの詳細

setLocale

public void setLocale(Locale locale) throws SAXException

エラー報告のためのロケールを設定します。

このメソッドは、SAX2ではサポートされていません。このため、常に例外をスローします。

定義:

setLocale、インタフェースParser

パラメータ:

locale - エラー報告のロケール。

スロー:

SAXException - オーバーライドされない場合はスローされる。

関連項目:

• Parser.setLocale(Locale)

setEntityResolver

public void setEntityResolver(EntityResolver resolver)

エンティティ・リゾルバを登録します。

定義:

setEntityResolver、インタフェースParser

パラメータ:

resolver - 新しいリゾルバ。

関連項目:

• Parser.setEntityResolver(EntityResolver)

setDTDHandler

public void setDTDHandler(DTDHandler handler)

DTDイベント・ハンドラを登録します。

定義:

setDTDHandler、インタフェースParser

パラメータ:

handler - 新しいDTDイベント・ハンドラ。

関連項目:

• Parser.setDTDHandler(DTDHandler)

setDocumentHandler

public void setDocumentHandler(DocumentHandler handler)

SAX1文書イベント・ハンドラを登録します。

SAX1文書ハンドラは名前空間をサポートしません。

定義:

setDocumentHandler、インタフェースParser

パラメータ:

handler - 新しいSAX1文書イベント・ハンドラ。

関連項目:

• Parser.setDocumentHandler(DocumentHandler)

setErrorHandler

public void setErrorHandler(ErrorHandler handler)

エラー・イベント・ハンドラを登録します。

定義:

setErrorHandler、インタフェースParser

パラメータ:

handler - 新しいエラー・イベント・ハンドラ。

関連項目:

• Parser.setErrorHandler(ErrorHandler)

parse

public void parse(String systemId) throws IOException, SAXException

文書を構文解析します。

組み込みXMLReaderがhttp://xml.org/sax/features/namespace-prefixesプロパティをサポートしない場合、このメソッドは例外をスローします。

定義:

parse、インタフェースParser

パラメータ:

systemId - 文書の絶対URL。

スロー:

IOException - 文書のrawコンテンツの読取り時に問題が発生した場合。

SAXException - 文書処理時に問題が発生した場合。

関連項目:

• parse(org.xml.sax.InputSource)
• Parser.parse(java.lang.String)

parse

public void parse(InputSource input) throws IOException, SAXException

文書を構文解析します。

組み込みXMLReaderがhttp://xml.org/sax/features/namespace-prefixesプロパティをサポートしない場合、このメソッドは例外をスローします。

定義:

parse、インタフェースParser

パラメータ:

input - 文書の入力ソース。

スロー:

IOException - 文書のrawコンテンツの読取り時に問題が発生した場合。

SAXException - 文書処理時に問題が発生した場合。

関連項目:

• parse(java.lang.String)
• Parser.parse(org.xml.sax.InputSource)

setDocumentLocator

public void setDocumentLocator(Locator locator)

文書ロケータを設定します。

定義:

setDocumentLocator、インタフェースContentHandler

パラメータ:

locator - 文書ロケータ。

関連項目:

• ContentHandler.setDocumentLocator(Locator)

startDocument

public void startDocument() throws SAXException

文書イベントを開始します。

定義:

startDocument、インタフェースContentHandler

スロー:

SAXException - クライアントで処理例外が発生する場合があります。

関連項目:

• ContentHandler.startDocument()

endDocument

public void endDocument() throws SAXException

文書イベントを終了します。

定義:

endDocument、インタフェースContentHandler

スロー:

SAXException - クライアントで処理例外が発生する場合があります。

関連項目:

• ContentHandler.endDocument()

startPrefixMapping

public void startPrefixMapping(String prefix, String uri)

SAX2の前置修飾子のマッピング開始イベントを適応させます。

定義:

startPrefixMapping、インタフェースContentHandler

パラメータ:

prefix - マッピングされる接頭辞。

uri - マッピング先の名前空間URI。

関連項目:

• ContentHandler.startPrefixMapping(String, String)

endPrefixMapping

public void endPrefixMapping(String prefix)

SAX2の前置修飾子のマッピング終了イベントを適応させます。

定義:

endPrefixMapping、インタフェースContentHandler

パラメータ:

prefix - マッピングされる接頭辞。

関連項目:

• ContentHandler.endPrefixMapping(String)

startElement

public void startElement(String uri, String localName, String qName, Attributes atts) throws SAXException

SAX2の要素開始イベントを適応させます。

定義:

startElement、インタフェースContentHandler

パラメータ:

uri - 名前空間URI。

localName - 名前空間のローカル名。

qName - 接頭辞付きの修飾名。

atts - SAX2属性。

スロー:

SAXException - クライアントで処理例外が発生する場合があります。

関連項目:

• ContentHandler.endDocument()

endElement

public void endElement(String uri, String localName, String qName) throws SAXException

SAX2の要素終了イベントを適応させます。

定義:

endElement、インタフェースContentHandler

パラメータ:

uri - 名前空間URI。

localName - 名前空間のローカル名。

qName - 接頭辞付きの修飾名。

スロー:

SAXException - クライアントで処理例外が発生する場合があります。

関連項目:

• ContentHandler.endElement(String, String, String)

characters

public void characters(char[] ch, int start, int length) throws SAXException

SAX2の文字イベントを適応させます。

定義:

characters、インタフェースContentHandler

パラメータ:

ch - 文字配列。

start - 配列内の開始位置。

length - 使用する文字数。

スロー:

SAXException - クライアントで処理例外が発生する場合があります。

関連項目:

• ContentHandler.characters(char[], int, int)

ignorableWhitespace

public void ignorableWhitespace(char[] ch, int start, int length) throws SAXException

SAX2の無視できる空白文字イベントを適応させます。

定義:

ignorableWhitespace、インタフェースContentHandler

パラメータ:

ch - 文字配列。

start - 配列内の開始位置。

length - 使用する文字数。

スロー:

SAXException - クライアントで処理例外が発生する場合があります。

関連項目:

• ContentHandler.ignorableWhitespace(char[], int, int)

processingInstruction

public void processingInstruction(String target, String data) throws SAXException

SAX2の処理命令イベントを適応させます。

定義:

processingInstruction、インタフェースContentHandler

パラメータ:

target - 処理命令のターゲット。

data - 処理命令を受けるデータ

スロー:

SAXException - クライアントで処理例外が発生する場合があります。

関連項目:

• ContentHandler.processingInstruction(String, String)

skippedEntity

public void skippedEntity(String name) throws SAXException

SAX2のスキップされたエンティティ・イベントを適応させます。

定義:

skippedEntity、インタフェースContentHandler

パラメータ:

name - スキップされたエンティティの名前。

スロー:

SAXException - サブクラスによってスロー可能。

関連項目:

• ContentHandler.skippedEntity(String)