compact3

パッケージ javax.xml.transform.sax

このパッケージはSAX2固有の変換APIを実装します。

参照: 説明

インタフェースのサマリー

インタフェース	説明
TemplatesHandler	SAX構文解析イベント(変換命令を構文解析する)を処理してTemplatesオブジェクトにするのに使用できるSAX ContentHandlerです。
TransformerHandler	TransformerHandlerはSAX ContentHandler構文解析イベントを待機し、それをResultに変換します。

クラスのサマリー

クラス	説明
SAXResult	変換Resultのホルダーとして動作します。
SAXSource	SAXスタイルのSourceのホルダーとして動作します。
SAXTransformerFactory	このクラスは、TransformerFactoryを拡張してSAX固有のファクトリ・メソッドを提供します。

パッケージjavax.xml.transform.saxの説明

このパッケージはSAX2固有の変換APIを実装します。ContentHandlerイベントを受け付けるクラス、およびorg.xml.sax.ContentHandlerイベントを発生させるクラスを提供します。また、入力ソースをXMLReaderとして設定するメソッド、またはInputSourceをソースとして使用するメソッドも提供します。このパッケージはXMLFilterの作成も可能にし、これによりほかの変換から変換を「プル」(開始)させ、TransformerをXMLReaderとして多形的に使用することができます。

SAXSourceクラスにより、XMLReaderの設定を、構文解析イベント、およびSAXソースを指定するのに使用できるInputSourceを「プル」(開始)ために使用することができます。

SAXResultクラスにより、ContentHandlerの設定を、変換からのSAX2イベントの受け取り側にすることができます。

SAXTransformerFactoryはTransformerFactoryを拡張して、TemplatesHandler、TransformerHandler、およびXMLReaderインスタンスを作成するためのファクトリ・メソッドを提供します。

SAXTransformerFactoryを取得するには、TransformerFactory.newInstance()から返されたTransformerFactoryインスタンスを呼び出し側でキャストする必要があります。

TransformerHandlerインタフェースにより、SAX2構文解析イベントから変換を作成できるようになります。SAX2構文解析イベントは、通常変換に対して発生する「プル」モデルでなく、「プッシュ」モデルです。通常の構文解析イベントはContentHandlerインタフェースを使用して受け取り、startCDATAやendCDATAなどの字句イベントはLexicalHandlerインタフェースを使用して受け取り、出力エスケープの無効化の開始または終了を示すイベントは、ContentHandler.processingInstruction(java.lang.String, java.lang.String)を介して、ターゲットパラメータにResult.PI_DISABLE_OUTPUT_ESCAPINGとResult.PI_ENABLE_OUTPUT_ESCAPINGを指定して受け取ります。パラメータ、出力プロパティ、その他の機能をTransformerハンドラに設定する必要がある場合は、TransformerHandler.getTransformer()からTransformer参照を取得する必要があり、またその参照から呼び出されるメソッドも取得する必要があります。

TemplatesHandlerインタフェースにより、SAX2構文解析イベントからTemplatesオブジェクトを作成できるようになります。ContentHandlerイベントが完了すると、TemplatesHandler.getTemplates()からTemplatesオブジェクトを取得することができます。相対URLを解決するための基本システム識別子を確立するために、通常はTemplatesHandler.setSystemId(java.lang.String)を呼び出す必要があります。

SAXTransformerFactory.newXMLFilter(javax.xml.transform.Source)メソッドにより、「プル」変換のSAX2概念をカプセル化するXMLFilterを作成することができます。次に、連結されたいくつかの変換を示します。各フィルタは親のXMLReaderを指し、最後の変換はチェーン内の最後のリーダーでXMLReader.parse(org.xml.sax.InputSource)を呼び出すことで起動されます。