compact2, compact3

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