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 として適応させます。

このモジュールは、ソースコード、文書ともに公開ドメインに置かれています。したがって、内容に関する保証は一切提供されません。

このクラスは、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) SAX1 の文字イベントを適応させます。
void	endDocument() SAX1 の文書終了イベントを適応させます。
void	endElement(String qName) SAX1 の要素終了イベントを適応させます。
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) SAX1 の無視できる空白文字イベントを適応させます。
void	parse(InputSource input) XML 文書を構文解析します。
void	parse(String systemId) XML 文書を構文解析します。
void	processingInstruction(String target, String data) SAX1 の処理命令イベントを適応させます。
void	setContentHandler(ContentHandler handler) コンテンツハンドラを設定します。
void	setDocumentLocator(Locator locator) SAX1 の文書ロケータイベントを適応させます。
void	setDTDHandler(DTDHandler handler) DTD ハンドラを設定します。
void	setEntityResolver(EntityResolver resolver) エンティティリゾルバを設定します。
void	setErrorHandler(ErrorHandler handler) エラーハンドラを設定します。
void	setFeature(String name, boolean state) パーサの機能を設定します。
void	setProperty(String name, Object value) パーサプロパティを設定します。
void	startDocument() SAX1 の文書開始イベントを適応させます。
void	startElement(String qName, AttributeList qAtts) SAX1 の要素開始イベントを適応させます。

クラス 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 state)
                throws SAXNotRecognizedException,
                       SAXNotSupportedException

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

サポートされている機能は名前空間と名前空間前置修飾子のみです。

定義:

インタフェース XMLReader 内の setFeature

パラメータ:

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

state - 要求された機能の状態

例外:

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 - 新しいエンティティリゾルバ

例外:

NullPointerException - エンティティリゾルバパラメータが null の場合

関連項目:

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 ハンドラ

例外:

NullPointerException - DTD ハンドラパラメータが null の場合

関連項目:

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 - コンテンツハンドラ

例外:

NullPointerException - コンテンツハンドラパラメータが null の場合

関連項目:

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

getContentHandler

public ContentHandler getContentHandler()

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

定義:

インタフェース XMLReader 内の getContentHandler

戻り値:

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

関連項目:

XMLReader.getEntityResolver()

setErrorHandler

public void setErrorHandler(ErrorHandler handler)

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

定義:

インタフェース XMLReader 内の setErrorHandler

パラメータ:

handler - エラーハンドラ

例外:

NullPointerException - エラーハンドラパラメータが null の場合

関連項目:

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 1.0 属性リスト (修飾名付き)

例外:

SAXException - SAX 例外。ほかの例外をラップしている可能性がある

関連項目:

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)