javax.xml.transform
クラス TransformerFactory

java.lang.Object
  javax.xml.transform.TransformerFactory

直系の既知のサブクラス:

SAXTransformerFactory

public abstract class TransformerFactory
extends Object

TransformerFactory インスタンスを使用して、Transformer および Templates オブジェクトを作成することができます。

どのファクトリ実装を作成するかを決めるシステムプロパティの名前は javax.xml.transform.TransformerFactory です。このプロパティは、TransformerFactory 抽象クラスの具象サブクラスを命名します。このプロパティが定義されていない場合は、プラットフォームのデフォルトが使用されます。

コンストラクタの概要

protected

TransformerFactory() デフォルトのコンストラクタが意図的に保護されます。

メソッドの概要

abstract Source	getAssociatedStylesheet(Source source, String media, String title, String charset) 「The xml-stylesheet processing instruction」から、指定された基準に一致する XML Source ドキュメントに関連付けられたスタイルシート仕様を取得します。
abstract Object	getAttribute(String name) ユーザが基本となる実装に特定の属性を取り出すことができるようにします。
abstract ErrorListener	getErrorListener() TransformerFactory のエラーイベントハンドラを取得します。
abstract boolean	getFeature(String name) 機能の値を検索します。
abstract URIResolver	getURIResolver() document()、xsl:import、または xsl:include で使用される URI を解決するために変換時にデフォルトで使用されるオブジェクトを取得します。
static TransformerFactory	newInstance() TransformerFactory の新しいインスタンスを取得します。
abstract Templates	newTemplates(Source source) Source を処理して、ソースのコンパイル表現である Templates オブジェクトにします。
abstract Transformer	newTransformer() Source から Result へのコピーを実行する新しい Transformer。
abstract Transformer	newTransformer(Source source) Source を Transformer Object に処理します。
abstract void	setAttribute(String name, Object value) ユーザが基本となる実装に特定の属性を設定できるようにします。
abstract void	setErrorListener(ErrorListener listener) TransformerFactory のエラーイベントリスナーを設定します。
abstract void	setFeature(String name, boolean value) このファクトリによって生成された TransformerFactory および Transformer または Template の機能を設定します。
abstract void	setURIResolver(URIResolver resolver) document()、xsl:import、または xsl:include で使用される URI を解決するために変換時にデフォルトで使用されるオブジェクトを設定します。

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

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

コンストラクタの詳細

TransformerFactory

protected TransformerFactory()

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

メソッドの詳細

newInstance

public static TransformerFactory newInstance()
                                      throws TransformerFactoryConfigurationError

TransformerFactory の新しいインスタンスを取得します。この static メソッドは新しいファクトリインスタンスを作成します。このメソッドは次の順序のルックアップ手順で、ロードする TransformerFactory 実装クラスを判定します。

• javax.xml.transform.TransformerFactory システムプロパティを使用する
• JRE ディレクトリ内のプロパティファイル lib/jaxp.properties を使用する。この構成ファイルは標準の java.util.Properties 形式であり、上記のように定義されたシステムプロパティであるキーを持つ実装クラスの完全指定の名前を含む。jaxp.properties ファイルは JAXP 実装によって 1 回だけ読み込まれ、その値がその後の使用のためキャッシュされる。最初の読み込み時にファイルが存在しないと、その後にその存在がチェックされることはない。最初に読み込まれたあと、jaxp.properties のプロパティの値を変更することはできない。
• 可能であれば、JAR 仕様で詳細に説明されているサービス API を使用して、クラス名を判定する。サービス API は、実行時に使用できる jar 内の META-INF/services/javax.xml.transform.TransformerFactory ファイルからクラス名を検索する
• プラットフォームのデフォルトの TransformerFactory インスタンス

アプリケーションが TransformerFactory への参照を取得すると、ファクトリを使用してパーサのインスタンスを設定および取得することができます。

戻り値:

新しい TransformerFactory インスタンス。null は不可

例外:

TransformerFactoryConfigurationError - 実装が使用できないかインスタンス化できない場合、スローされる

newTransformer

public abstract Transformer newTransformer(Source source)
                                    throws TransformerConfigurationException

Source を Transformer Object に処理します。Source は「XSL Transformations (XSLT) Version 1.0」に適合する XSLT ドキュメントです。この Transformer は同時に動作する複数の Thread で使用することはできません。異なる Thread では同時に使用される TransformerFactories も異なります。

パラメータ:

source - Transformer の作成に使用される XSLT ドキュメントの Source。XML Source の例は DOMSource、SAXSource、および StreamSource

戻り値:

1 つの Thread で変換を実行するために使用される Transformer オブジェクト。null は不可

例外:

TransformerConfigurationException - Source の構文解析時にエラーが発生するか、または Transformer インスタンスを作成できない場合にスローされる

関連項目:

「XSL Transformations (XSLT) Version 1.0」

newTransformer

public abstract Transformer newTransformer()
                                    throws TransformerConfigurationException

Source から Result へのコピーを実行する新しい Transformer。つまり「恒等変換」

戻り値:

1 つのスレッドで変換を実行するために使用される Transformer オブジェクト。null は不可

例外:

TransformerConfigurationException - Transformer インスタンスを作成できない場合にスローされる

newTemplates

public abstract Templates newTemplates(Source source)
                                throws TransformerConfigurationException

Source を処理して、ソースのコンパイル表現である Templates オブジェクトにします。この Templates オブジェクトは、複数のスレッドで同時に使用することができます。Templates オブジェクトを作成することにより、TransformerFactory は変換命令のパフォーマンスの最適化を詳細に行うことができ、実行時変換が低下することはありません。

パラメータ:

source - URL、入力ストリームなどを保持するオブジェクト

戻り値:

変換のために使用できる Templates オブジェクト。null は不可

例外:

TransformerConfigurationException - Templates オブジェクトの構築で失敗した場合に構文解析時にスローされる場合がある

getAssociatedStylesheet

public abstract Source getAssociatedStylesheet(Source source,
                                               String media,
                                               String title,
                                               String charset)
                                        throws TransformerConfigurationException

「The xml-stylesheet processing instruction」から、指定された基準に一致する XML Source ドキュメントに関連付けられたスタイルシート仕様を取得します。いくつかのスタイルシートを返すことができます。その場合、それらのスタイルシートは、1 つのスタイルシート内のインポートまたはカスケードのリストであるかのように適用されます。

パラメータ:

source - XML ソースドキュメント

media - 一致するメディア属性。null の場合があり、その場合は、設定されているテンプレートが使用される (つまり alternate = no)

title - 一致するタイトル属性の値。null の場合あり

charset - 一致する文字セット属性の値。null の場合あり

戻り値:

TransformerFactory に渡すのに適した Source Object

例外:

TransformerConfigurationException - source の構文解析時にエラーが発生した場合 Exception がスローされる

関連項目:

「Associating Style Sheets with XML documents Version 1.0」

setURIResolver

public abstract void setURIResolver(URIResolver resolver)

document()、xsl:import、または xsl:include で使用される URI を解決するために変換時にデフォルトで使用されるオブジェクトを設定します。

パラメータ:

resolver - URIResolver インタフェースを実装するオブジェクト、または null

getURIResolver

public abstract URIResolver getURIResolver()

document()、xsl:import、または xsl:include で使用される URI を解決するために変換時にデフォルトで使用されるオブジェクトを取得します。

戻り値:

setURIResolver を使用して設定された URIResolver

setFeature

public abstract void setFeature(String name,
                                boolean value)
                         throws TransformerConfigurationException

このファクトリによって生成された TransformerFactory および Transformer または Template の機能を設定します。

機能名は完全修飾 URI です。実装が独自の機能を定義することもできます。生成する TransformerFactory、Transformer、または Template がその機能をサポートできない場合は、TransformerConfigurationException がスローされます。TransformerFactory は機能の値を表示できますが、その状態を変更することはできません。

実装はすべて XMLConstants.FEATURE_SECURE_PROCESSING 機能をサポートする必要があります。

• 機能が true の場合、実装は実装限界に準拠する XML 処理を制限し、実装で定義されたとおりのセキュリティ保護された方式で動作する。例は、ユーザ定義スタイルシートおよび関数の解決など。セキュリティ上の理由から XML 処理が制限される場合は、登録済みの ErrorListener.fatalError(TransformerException exception) へ呼び出しを介して報告される。setErrorListener(ErrorListener listener) を参照
• 機能が false の場合、実装は、実装限界にかまわず、XML 仕様に従って XML を処理する

パラメータ:

name - 機能名

value - 機能の状態が true か false か

例外:

TransformerConfigurationException - 作成する TransformerFactory 、 Transformer 、または Template がこの機能をサポートできない場合

NullPointerException - name パラメータが null の場合

getFeature

public abstract boolean getFeature(String name)

機能の値を検索します。

機能名は完全修飾 URI です。実装が独自の機能を定義することもできます。生成する TransformerFactory、Transformer、または Template がその機能をサポートできない場合は、false が返されます。TransformerFactory は機能の値を表示できますが、その状態を変更することはできません。

パラメータ:

name - 機能名

戻り値:

機能の現在の状態。true または false

例外:

NullPointerException - name パラメータが null の場合

setAttribute

public abstract void setAttribute(String name,
                                  Object value)

ユーザが基本となる実装に特定の属性を設定できるようにします。このコンテキストの属性は、実装が提供するオプションとして定義されます。基本となる実装が属性を認識しない場合に IllegalArgumentException がスローされます。

パラメータ:

name - 属性の名前

value - 属性の値

getAttribute

public abstract Object getAttribute(String name)

ユーザが基本となる実装に特定の属性を取り出すことができるようにします。基本となる実装が属性を認識しない場合に IllegalArgumentException がスローされます。

パラメータ:

name - 属性の名前

戻り値:

属性の値

setErrorListener

public abstract void setErrorListener(ErrorListener listener)

TransformerFactory のエラーイベントリスナーを設定します。TransformerFactory は、変換自体のためではなく、変換命令を処理するために使用されます。ErrorListener リスナーが null の場合、IllegalArgumentException がスローされます。

パラメータ:

listener - 新しいエラーリスナー

getErrorListener

public abstract ErrorListener getErrorListener()

TransformerFactory のエラーイベントハンドラを取得します。

戻り値:

現在のエラーハンドラ。null は不可