org.xml.sax.helpers
クラス ParserAdapter

java.lang.Object
  org.xml.sax.helpers.ParserAdapter

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

DocumentHandler, XMLReader

public class ParserAdapter
extends Object
implements XMLReader, DocumentHandler

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

このモジュールは、ソースコード、文書ともに公開ドメインに置かれています。したがって、内容に関する保証は一切提供されません。詳細は、http://www.saxproject.org を参照してください。

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

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

導入されたバージョン:

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(InputSource input) XML 文書を構文解析します。
void	parse(String systemId) 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) アダプタ実装メソッドは呼び出しません。

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

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

コンストラクタの詳細

ParserAdapter

public ParserAdapter()
              throws SAXException

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

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

例外:

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

ParserAdapter

public ParserAdapter(Parser parser)

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

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

パラメータ:

parser - 組み込む SAX1 パーサ

例外:

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

メソッドの詳細

setFeature

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

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

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

定義:

インタフェース XMLReader 内の setFeature

パラメータ:

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

value - 要求された機能の値

例外:

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

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

関連項目:

XMLReader.setFeature(java.lang.String, boolean)

getFeature

public boolean getFeature(String name)
                   throws SAXNotRecognizedException,
                          SAXNotSupportedException

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

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

定義:

インタフェース XMLReader 内の getFeature

パラメータ:

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

戻り値:

現在の機能の値

例外:

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

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

関連項目:

XMLReader.setFeature(java.lang.String, boolean)

setProperty

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

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

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

定義:

インタフェース XMLReader 内の setProperty

パラメータ:

name - プロパティ名

value - プロパティの値

例外:

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

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

関連項目:

XMLReader.setProperty(java.lang.String, java.lang.Object)

getProperty

public Object getProperty(String name)
                   throws SAXNotRecognizedException,
                          SAXNotSupportedException

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

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

定義:

インタフェース XMLReader 内の getProperty

パラメータ:

name - プロパティ名

戻り値:

プロパティの値

例外:

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

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

関連項目:

XMLReader.getProperty(java.lang.String)

setEntityResolver

public void setEntityResolver(EntityResolver resolver)

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

定義:

インタフェース XMLReader 内の setEntityResolver

パラメータ:

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

関連項目:

XMLReader.setEntityResolver(org.xml.sax.EntityResolver)

getEntityResolver

public EntityResolver getEntityResolver()

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

定義:

インタフェース XMLReader 内の getEntityResolver

戻り値:

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

関連項目:

XMLReader.getEntityResolver()

setDTDHandler

public void setDTDHandler(DTDHandler handler)

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

定義:

インタフェース XMLReader 内の setDTDHandler

パラメータ:

handler - 新しい DTD ハンドラ

関連項目:

XMLReader.setEntityResolver(org.xml.sax.EntityResolver)

getDTDHandler

public DTDHandler getDTDHandler()

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

定義:

インタフェース XMLReader 内の getDTDHandler

戻り値:

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

関連項目:

XMLReader.getEntityResolver()

setContentHandler

public void setContentHandler(ContentHandler handler)

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

定義:

インタフェース XMLReader 内の setContentHandler

パラメータ:

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

関連項目:

XMLReader.setEntityResolver(org.xml.sax.EntityResolver)

getContentHandler

public ContentHandler getContentHandler()

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

定義:

インタフェース XMLReader 内の getContentHandler

戻り値:

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

関連項目:

XMLReader.getEntityResolver()

setErrorHandler

public void setErrorHandler(ErrorHandler handler)

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

定義:

インタフェース XMLReader 内の setErrorHandler

パラメータ:

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

関連項目:

XMLReader.setEntityResolver(org.xml.sax.EntityResolver)

getErrorHandler

public ErrorHandler getErrorHandler()

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

定義:

インタフェース XMLReader 内の getErrorHandler

戻り値:

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

関連項目:

XMLReader.getEntityResolver()

parse

public void parse(String systemId)
           throws IOException,
                  SAXException

XML 文書を構文解析します。

定義:

インタフェース XMLReader 内の parse

パラメータ:

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 文書を構文解析します。

定義:

インタフェース XMLReader 内の parse

パラメータ:

input - 文書の入力ソース

例外:

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

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

関連項目:

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

setDocumentLocator

public void setDocumentLocator(Locator locator)

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

定義:

インタフェース DocumentHandler 内の setDocumentLocator

パラメータ:

locator - 文書ロケータ

関連項目:

ContentHandler.setDocumentLocator(org.xml.sax.Locator)

startDocument

public void startDocument()
                   throws SAXException

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

定義:

インタフェース DocumentHandler 内の startDocument

例外:

SAXException - クライアントで処理例外が発生する可能性がある

関連項目:

DocumentHandler.startDocument()

endDocument

public void endDocument()
                 throws SAXException

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

定義:

インタフェース DocumentHandler 内の endDocument

例外:

SAXException - クライアントで処理例外が発生する可能性がある

関連項目:

DocumentHandler.endDocument()

startElement

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

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

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

定義:

インタフェース DocumentHandler 内の startElement

パラメータ:

qName - 接頭辞付きの修飾名

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

例外:

SAXException - クライアントで処理例外が発生する可能性がある

関連項目:

DocumentHandler.endElement(java.lang.String), AttributeList

endElement

public void endElement(String qName)
                throws SAXException

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

定義:

インタフェース DocumentHandler 内の endElement

パラメータ:

qName - 接頭辞付きの修飾名

例外:

SAXException - クライアントで処理例外が発生する可能性がある

関連項目:

DocumentHandler.endElement(java.lang.String)

characters

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

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

定義:

インタフェース DocumentHandler 内の characters

パラメータ:

ch - 文字配列

start - 配列内の開始位置

length - 使用する文字数

例外:

SAXException - クライアントで処理例外が発生する可能性がある

関連項目:

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

ignorableWhitespace

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

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

定義:

インタフェース DocumentHandler 内の ignorableWhitespace

パラメータ:

ch - 文字配列

start - 配列内の開始位置

length - 使用する文字数

例外:

SAXException - クライアントで処理例外が発生する可能性がある

関連項目:

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

processingInstruction

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

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

定義:

インタフェース DocumentHandler 内の processingInstruction

パラメータ:

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

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

例外:

SAXException - クライアントで処理例外が発生する可能性がある

関連項目:

DocumentHandler.processingInstruction(java.lang.String, java.lang.String)