8.12.1 XMLReader オブジェクト

8.12.1 XMLReader オブジェクト

XMLReader は次のメソッドをサポートします。:

parse( source): 入力ソースを処理し、SAX イベントを発生させます。source オブジェクトにはシステム識別子(入力ソースを特定する文字列 - 一般にファイル名やURL)、ファイル風オブジェクト、または InputSource オブジェクトを指定できます。parse() から return された段階で、入力データの処理は完了、パーサ・オブジェクトは破棄ないしリセットされます。なお、現在の実装はバイト・ストリームのみをサポートしており、文字ストリームの処理は将来の課題になっています。

getContentHandler( ): 現在の ContentHandler を返します。

setContentHandler( handler): 現在の ContentHandler をセットします。ContentHandler がセットされていない場合、コンテント・イベントは破棄されます。

getDTDHandler( ): 現在の DTDHandler を返します。

setDTDHandler( handler): 現在の DTDHandler をセットします。DTDHandler がセットされていない場合、DTD イベントは破棄されます。

getEntityResolver( ): 現在の EntityResolver を返します。

setEntityResolver( handler): 現在の EntityResolver をセットします。EntityResolver がセットされていない場合、外部エンティティとして解決されるべきものが、システム識別子として解釈されてしまうため、該当するものがなければ結果的にエラーとなります。

getErrorHandler( ): 現在の ErrorHandler を返します。

setErrorHandler( handler): 現在のエラー・ハンドラをセットします。ErrorHandler がセットされていない場合、エラーは例外を発生し、警告が表示されます。

setLocale( locale): アプリケーションにエラーや警告のロカール設定を許可します。
SAX パーサにとって、エラーや警告の地域化は必須ではありません。しかし、パーサは要求されたロカールをサポートしていない場合、SAX 例外を発生させなければなりません。アプリケーションはパースの途中でロカールを変更することもできます。

getFeature( featurename): 機能 featurename の現在の設定を返します。その機能が認識できないときは、SAXNotRecognizedException を発生させます。広く使われている機能名の一覧はモジュール xml.sax.handler に書かれています。

setFeature( featurename, value): 機能名 featurename に値 value をセットします。その機能が認識できないときは、SAXNotRecognizedException を発生させます。また、パーサが指定された機能や設定をサポートしていないときは、SAXNotSupportedException を発生させます。

getProperty( propertyname): 属性名 propertyname の現在の値を返します。その属性が認識できないときは、 SAXNotRecognizedException を発生させます。広く使われている属性名の一覧はモジュール xml.sax.handler に書かれています。

setProperty( propertyname, value): 属性名 propertyname に値 value をセットします。その機能が認識できないときは、SAXNotRecognizedException を発生させます。また、パーサが指定された機能や設定をサポートしていないときは、 SAXNotSupportedException is raised を発生させます。

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。