モジュール java.xml

パッケージ 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を使う必要があります。

導入されたバージョン:

1.4

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
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, newDefaultInstance, 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を作成できない場合。