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 の要素開始イベントを適応させます。

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

定義:

インタフェース 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)