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, 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 を作成できない場合