JavaTM 2
Platform
Std. Ed. v1.4.0

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 をアプリケーションで設定する場合は、URIResolver を使用して、getXMLReader で XMLReader への参照を提供する SAXSource を返す必要があります。


フィールドの概要
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, 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 を作成できない場合

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.