ナビゲーション・リンクをスキップ
Java(tm) Platform
Standard Edition 8

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

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

参照: 説明

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

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

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

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

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

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

TransformerHandlerインタフェースにより、SAX2構文解析イベントから変換を作成できるようになります。SAX2構文解析イベントは、通常変換に対して発生する「プル」モデルでなく、「プッシュ」モデルです。通常の構文解析イベントはContentHandlerインタフェースを使用して受け取り、startCDATAやendCDATAなどの字句イベントはLexicalHandlerインタフェースを使用して受け取り、出力エスケープの無効化の開始または終了を示すイベントは、ContentHandler.processingInstruction(java.lang.String, java.lang.String)を介して、ターゲットパラメータにResult.PI_DISABLE_OUTPUT_ESCAPINGResult.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)を呼び出すことで起動されます。

ナビゲーション・リンクをスキップ
Java(tm) Platform
Standard Edition 8

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.