クラスParserAdapter

java.lang.Object

org.xml.sax.helpers.ParserAdapter

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

DocumentHandler, XMLReader

public class ParserAdapter extends Object implements XMLReader, DocumentHandler

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

このクラスは、SAX1 Parserをラップして、機能、プロパティ、名前空間を利用できるSAX2 XMLReaderとして動作させます。 ただし、skippedEntityイベントの報告は行われません。これは、この情報がSAX1では提供されないためです。

名前空間修飾子付きの属性名が重複している環境におけるこのアダプタの動作は未検証です。

導入されたバージョン:

1.4, SAX 2.0

関連項目:

• XMLReaderAdapter
• XMLReader
• Parser

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

コンストラクタ

コンストラクタ	説明
ParserAdapter()	新しいパーサー・アダプタを構築します。
ParserAdapter(Parser parser)	新しいパーサー・アダプタを構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	characters(char[] ch, int start, int length)	アダプタ実装メソッドは呼び出しません。
void	endDocument()	アダプタ実装メソッドは呼び出しません。
void	endElement(String qName)	アダプタ実装メソッドは呼び出しません。
ContentHandler	getContentHandler()	現在のコンテンツ・ハンドラを返します。
DTDHandler	getDTDHandler()	現在のDTDハンドラを返します。
EntityResolver	getEntityResolver()	現在のエンティティ・リゾルバを返します。
ErrorHandler	getErrorHandler()	現在のエラー・ハンドラを返します。
boolean	getFeature(String name)	パーサー機能フラグをチェックします。
Object	getProperty(String name)	パーサー・プロパティを取得します。
void	ignorableWhitespace(char[] ch, int start, int length)	アダプタ実装メソッドは呼び出しません。
void	parse(String systemId)	XMLドキュメントを解析します。
void	parse(InputSource input)	XMLドキュメントを解析します。
void	processingInstruction(String target, String data)	アダプタ実装メソッドは呼び出しません。
void	setContentHandler(ContentHandler handler)	コンテンツ・ハンドラを設定します。
void	setDocumentLocator(Locator locator)	アダプタ実装メソッドは呼び出しません。
void	setDTDHandler(DTDHandler handler)	DTDハンドラを設定します。
void	setEntityResolver(EntityResolver resolver)	エンティティ・リゾルバを設定します。
void	setErrorHandler(ErrorHandler handler)	エラー・ハンドラを設定します。
void	setFeature(String name, boolean value)	パーサーの機能フラグを設定します。
void	setProperty(String name, Object value)	パーサー・プロパティを設定します。
void	startDocument()	アダプタ実装メソッドは呼び出しません。
void	startElement(String qName, AttributeList qAtts)	アダプタ実装メソッドは呼び出しません。

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

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であるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

コンストラクタの詳細

ParserAdapter

public ParserAdapter() throws SAXException

新しいパーサー・アダプタを構築します。

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

スロー:

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

ParserAdapter

public ParserAdapter(Parser parser)

新しいパーサー・アダプタを構築します。

アダプタの作成後は、組込みパーサーを変更できません。ほかのパーサーを組み込むには、新しいParserAdapterを割り当てます。

パラメータ:

parser - 組み込むSAX1パーサー。

スロー:

NullPointerException - parserパラメータがnullの場合。

メソッドの詳細

setFeature

public void setFeature(String name, boolean value) throws SAXNotRecognizedException, SAXNotSupportedException

パーサーの機能フラグを設定します。

認識されている機能は名前空間と名前空間接頭辞のみです。

定義:

setFeature、インタフェースXMLReader

パラメータ:

name - 機能名を示す完全なURI。

value - 要求された機能の値。

スロー:

SAXNotRecognizedException - 機能を割り当てられない、または取得できない場合。

SAXNotSupportedException - 機能にその値を割り当てられない場合。

関連項目:

• XMLReader.setFeature(String, boolean)

getFeature

public boolean getFeature(String name) throws SAXNotRecognizedException, SAXNotSupportedException

パーサー機能フラグをチェックします。

認識されている機能は名前空間と名前空間接頭辞のみです。

定義:

getFeature、インタフェースXMLReader

パラメータ:

name - 機能名を示す完全なURI。

戻り値:

現在の機能の値。

スロー:

SAXNotRecognizedException - 機能値を割り当てられない、または取得できない場合。

SAXNotSupportedException - 機能を現在読み取れない場合。

関連項目:

• XMLReader.setFeature(String, boolean)

setProperty

public void setProperty(String name, Object value) throws SAXNotRecognizedException, SAXNotSupportedException

パーサー・プロパティを設定します。

現在認識されるプロパティはありません。

定義:

setProperty、インタフェースXMLReader

パラメータ:

name - プロパティ名。

value - プロパティ値。

スロー:

SAXNotRecognizedException - プロパティ値を割り当てられない、または取得できない場合。

SAXNotSupportedException - プロパティにその値を割り当てられない場合。

関連項目:

• XMLReader.setProperty(String, Object)

getProperty

public Object getProperty(String name) throws SAXNotRecognizedException, SAXNotSupportedException

パーサー・プロパティを取得します。

現在認識されるプロパティはありません。

定義:

getProperty、インタフェースXMLReader

パラメータ:

name - プロパティ名。

戻り値:

プロパティの値。

スロー:

SAXNotRecognizedException - プロパティ値を割り当てられない、または取得できない場合。

SAXNotSupportedException - プロパティの値を現在読み取れない場合。

関連項目:

• XMLReader.getProperty(String)

setEntityResolver

public void setEntityResolver(EntityResolver resolver)

エンティティ・リゾルバを設定します。

定義:

setEntityResolver、インタフェースXMLReader

パラメータ:

resolver - 新しいエンティティ・リゾルバ。

関連項目:

• XMLReader.setEntityResolver(EntityResolver)

getEntityResolver

public EntityResolver getEntityResolver()

現在のエンティティ・リゾルバを返します。

定義:

getEntityResolver、インタフェースXMLReader

戻り値:

現在のエンティティ・リゾルバ。提供されなかった場合はnull。

関連項目:

• XMLReader.getEntityResolver()

setDTDHandler

public void setDTDHandler(DTDHandler handler)

DTDハンドラを設定します。

定義:

setDTDHandler、インタフェースXMLReader

パラメータ:

handler - 新しいDTDハンドラ

関連項目:

• XMLReader.setEntityResolver(EntityResolver)

getDTDHandler

public DTDHandler getDTDHandler()

現在のDTDハンドラを返します。

定義:

getDTDHandler、インタフェースXMLReader

戻り値:

現在のDTDハンドラ。提供されなかった場合はnull

関連項目:

• XMLReader.getEntityResolver()

setContentHandler

public void setContentHandler(ContentHandler handler)

コンテンツ・ハンドラを設定します。

定義:

setContentHandler、インタフェースXMLReader

パラメータ:

handler - 新しいコンテンツ・ハンドラ

関連項目:

• XMLReader.setEntityResolver(EntityResolver)

getContentHandler

public ContentHandler getContentHandler()

現在のコンテンツ・ハンドラを返します。

定義:

getContentHandler、インタフェースXMLReader

戻り値:

現在のコンテンツ・ハンドラ。提供されなかった場合はnull。

関連項目:

• XMLReader.getEntityResolver()

setErrorHandler

public void setErrorHandler(ErrorHandler handler)

エラー・ハンドラを設定します。

定義:

setErrorHandler、インタフェースXMLReader

パラメータ:

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

関連項目:

• XMLReader.setEntityResolver(EntityResolver)

getErrorHandler

public ErrorHandler getErrorHandler()

現在のエラー・ハンドラを返します。

定義:

getErrorHandler、インタフェースXMLReader

戻り値:

現在のエラー・ハンドラ。提供されなかった場合はnull。

関連項目:

• XMLReader.getEntityResolver()

parse

public void parse(String systemId) throws IOException, SAXException

XMLドキュメントを解析します。

定義:

parse、インタフェースXMLReader

パラメータ:

systemId - 文書の絶対URL。

スロー:

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

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

関連項目:

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

parse

public void parse(InputSource input) throws IOException, SAXException

XMLドキュメントを解析します。

定義:

parse、インタフェースXMLReader

パラメータ:

input - 文書の入力ソース。

スロー:

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

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

関連項目:

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

setDocumentLocator

public void setDocumentLocator(Locator locator)

アダプタ実装メソッドは呼び出しません。 SAX1の文書ロケータ・イベントを適応させます。

定義:

setDocumentLocator、インタフェースDocumentHandler

パラメータ:

locator - 文書ロケータ。

関連項目:

• ContentHandler.setDocumentLocator(Locator)

startDocument

public void startDocument() throws SAXException

アダプタ実装メソッドは呼び出しません。 SAX1の文書開始イベントを適応させます。

定義:

startDocument、インタフェースDocumentHandler

スロー:

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

関連項目:

• DocumentHandler.startDocument()

endDocument

public void endDocument() throws SAXException

アダプタ実装メソッドは呼び出しません。 SAX1の文書終了イベントを適応させます。

定義:

endDocument、インタフェースDocumentHandler

スロー:

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

関連項目:

• DocumentHandler.endDocument()

startElement

public void startElement(String qName, AttributeList qAtts) throws SAXException

アダプタ実装メソッドは呼び出しません。 SAX1の要素開始イベントを適応させます。

必要に応じて、名前空間処理を行います。

定義:

startElement、インタフェースDocumentHandler

パラメータ:

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

qAtts - XML属性リスト(修飾名付き)。

スロー:

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

関連項目:

• DocumentHandler.endElement(String)
• AttributeList

endElement

public void endElement(String qName) throws SAXException

アダプタ実装メソッドは呼び出しません。 SAX1の要素終了イベントを適応させます。

定義:

endElement、インタフェースDocumentHandler

パラメータ:

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

スロー:

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

関連項目:

• DocumentHandler.endElement(String)

characters

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

アダプタ実装メソッドは呼び出しません。 SAX1の文字イベントを適応させます。

定義:

characters、インタフェースDocumentHandler

パラメータ:

ch - 文字配列。

start - 配列内の開始位置。

length - 使用する文字数。

スロー:

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

関連項目:

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

ignorableWhitespace

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

アダプタ実装メソッドは呼び出しません。 SAX1の無視できる空白文字イベントを適応させます。

定義:

ignorableWhitespace、インタフェースDocumentHandler

パラメータ:

ch - 文字配列。

start - 配列内の開始位置。

length - 使用する文字数。

スロー:

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

関連項目:

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

processingInstruction

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

アダプタ実装メソッドは呼び出しません。 SAX1の処理命令イベントを適応させます。

定義:

processingInstruction、インタフェースDocumentHandler

パラメータ:

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

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

スロー:

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

関連項目:

• DocumentHandler.processingInstruction(String, String)