javax.xml.transform.sax

クラス SAXTransformerFactory

java.lang.Object

javax.xml.transform.TransformerFactory

javax.xml.transform.sax.SAXTransformerFactory

public abstract class SAXTransformerFactory
extends TransformerFactory

このクラスは、TransformerFactory を拡張して SAX 固有のファクトリメソッドを提供します。2 つの型の ContentHandler を提供します。1 つは Transformers の作成用で、もう 1 つは Templates オブジェクトの作成用です。

変換時に使用される XMLReader 用の ErrorHandler または EntityResolver をアプリケーションで設定する場合は、(getXMLReader で) XMLReader への参照を提供する SAXSource を返すために URIResolver を使う必要があります。

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
static String	FEATURE この値を引数として渡したときに TransformerFactory.getFeature(java.lang.String) が true を返す場合、TransformerFactory.newInstance() から返された TransformerFactory は SAXTransformerFactory に安全にキャストできます。
static String	FEATURE_XMLFILTER この値を引数として渡したときに TransformerFactory.getFeature(java.lang.String) が true を返す場合は、newXMLFilter(Source src) および newXMLFilter(Templates templates) メソッドがサポートされます。

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタと説明
protected	SAXTransformerFactory() デフォルトのコンストラクタは意図的に保護されています。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
abstract TemplatesHandler	newTemplatesHandler() SAX ContentHandler イベントを処理して Templates オブジェクトにすることのできる TemplatesHandler オブジェクトを取得します。
abstract TransformerHandler	newTransformerHandler() SAX ContentHandler イベントを処理して Result にすることのできる TransformerHandler オブジェクトを取得します。
abstract TransformerHandler	newTransformerHandler(Source src) 引数で指定された変換命令に基づいて、SAX ContentHandler イベントを処理して Result にすることのできる TransformerHandler オブジェクトを取得します。
abstract TransformerHandler	newTransformerHandler(Templates templates) Templates 引数に基づいて、SAX ContentHandler イベントを処理して Result にすることのできる TransformerHandler オブジェクトを取得します。
abstract XMLFilter	newXMLFilter(Source src) 指定された Source を変換命令として使用する XMLFilter を作成します。
abstract XMLFilter	newXMLFilter(Templates templates) Templates 引数に基づいて XMLFilter を作成します。

クラス javax.xml.transform.TransformerFactory から継承されたメソッド

getAssociatedStylesheet, getAttribute, getErrorListener, getFeature, getURIResolver, newInstance, newInstance, newTemplates, newTransformer, newTransformer, setAttribute, setErrorListener, setFeature, setURIResolver

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

FEATURE

public static final String FEATURE

この値を引数として渡したときに TransformerFactory.getFeature(java.lang.String) が true を返す場合、TransformerFactory.newInstance() から返された TransformerFactory は SAXTransformerFactory に安全にキャストできます。

関連項目:

定数フィールド値

FEATURE_XMLFILTER

public static final String FEATURE_XMLFILTER

この値を引数として渡したときに TransformerFactory.getFeature(java.lang.String) が true を返す場合は、newXMLFilter(Source src) および newXMLFilter(Templates templates) メソッドがサポートされます。

関連項目:

定数フィールド値

コンストラクタの詳細

SAXTransformerFactory

protected SAXTransformerFactory()

デフォルトのコンストラクタは意図的に保護されています。

メソッドの詳細

newTransformerHandler

public abstract TransformerHandler newTransformerHandler(Source src)
                                                  throws TransformerConfigurationException

引数で指定された変換命令に基づいて、SAX ContentHandler イベントを処理して Result にすることのできる TransformerHandler オブジェクトを取得します。

パラメータ:

src - 変換命令の Source。

戻り値:

SAX イベントを変換する準備のできた TransformerHandler。

例外:

TransformerConfigurationException - 何らかの理由で TransformerHandler を作成できない場合。

newTransformerHandler

public abstract TransformerHandler newTransformerHandler(Templates templates)
                                                  throws TransformerConfigurationException

Templates 引数に基づいて、SAX ContentHandler イベントを処理して Result にすることのできる TransformerHandler オブジェクトを取得します。

パラメータ:

templates - コンパイルされた変換命令。

戻り値:

SAX イベントを変換する準備のできた TransformerHandler。

例外:

TransformerConfigurationException - 何らかの理由で TransformerHandler を作成できない場合。

newTransformerHandler

public abstract TransformerHandler newTransformerHandler()
                                                  throws TransformerConfigurationException

SAX ContentHandler イベントを処理して Result にすることのできる TransformerHandler オブジェクトを取得します。この変換は、恒等 (つまりコピー) 変換として定義されます。たとえば、一連の SAX 構文解析イベントから DOM ツリーへのコピーなどです。

戻り値:

TransformerHandler への null 以外の参照。 SAX 構文解析イベントの ContentHandler として使用される場合がある。

例外:

TransformerConfigurationException - 何らかの理由で TransformerHandler を作成できない場合。

newTemplatesHandler

public abstract TemplatesHandler newTemplatesHandler()
                                              throws TransformerConfigurationException

SAX ContentHandler イベントを処理して Templates オブジェクトにすることのできる TemplatesHandler オブジェクトを取得します。

戻り値:

TransformerHandler への null 以外の参照。 SAX 構文解析イベントの ContentHandler として使用される場合がある。

例外:

TransformerConfigurationException - 何らかの理由で TemplatesHandler を作成できない場合。

newXMLFilter

public abstract XMLFilter newXMLFilter(Source src)
                                throws TransformerConfigurationException

指定された Source を変換命令として使用する XMLFilter を作成します。

パラメータ:

src - 変換命令の Source。

戻り値:

XMLFilter オブジェクト。この機能がサポートされていない場合は null。

例外:

TransformerConfigurationException - 何らかの理由で TemplatesHandler を作成できない場合。

newXMLFilter

public abstract XMLFilter newXMLFilter(Templates templates)
                                throws TransformerConfigurationException

Templates 引数に基づいて XMLFilter を作成します。

パラメータ:

templates - コンパイルされた変換命令。

戻り値:

XMLFilter オブジェクト。この機能がサポートされていない場合は null。

例外:

TransformerConfigurationException - 何らかの理由で TemplatesHandler を作成できない場合。