javax.xml.transform.sax

クラス SAXSource

java.lang.Object

javax.xml.transform.sax.SAXSource

すべての実装されたインタフェース:

Source

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

JAXBSource

public class SAXSource
extends Object
implements Source

SAX スタイルの Source のホルダーとして動作します。

XSLT には、名前空間サポートが必要です。名前空間を認識するパーサーで生成されていない入力ソースを変換しようとするとエラーになります。SAXParserFactory.setNamespaceAware(boolean awareness) メソッドを呼び出して、パーサーが名前空間を認識するように設定できます。

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
static String	FEATURE この値を引数として渡したときに TransformerFactory.getFeature(java.lang.String) が true を返す場合、Transformer はこの型の Source 入力をサポートします。

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
SAXSource() デフォルトの引数なしのコンストラクタ。
SAXSource(InputSource inputSource) SAX InputSource を使用して SAXSource を作成します。
SAXSource(XMLReader reader, InputSource inputSource) XMLReader および SAX InputSource を使用して SAXSource を作成します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
InputSource	getInputSource() Source に対して使用される SAX InputSource を取得します。
String	getSystemId() URI を解決するベース識別子 (URI またはシステム識別子) を取得します。
XMLReader	getXMLReader() Source に対して使用される XMLReader を取得します。
void	setInputSource(InputSource inputSource) Source に対して使用される SAX InputSource を設定します。
void	setSystemId(String systemId) この Source のシステム識別子を設定します。
void	setXMLReader(XMLReader reader) Source に対して使用される XMLReader を設定します。
static InputSource	sourceToInputSource(Source source) Source オブジェクトから SAX InputSource オブジェクトを取得しようとします。

クラス 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 を返す場合、Transformer はこの型の Source 入力をサポートします。

関連項目:

定数フィールド値

コンストラクタの詳細

SAXSource

public SAXSource()

デフォルトの引数なしのコンストラクタ。このコンストラクタが使用されていて、setInputSource(InputSource inputSource) を使用して設定された SAX ソースがない場合、Transformer は new InputSource() を使用して空のソース InputSource を作成します。

関連項目:

Transformer.transform(Source xmlSource, Result outputTarget)

SAXSource

public SAXSource(XMLReader reader,
         InputSource inputSource)

XMLReader および SAX InputSource を使用して SAXSource を作成します。Transformer または SAXTransformerFactory は、それ自体をリーダーの ContentHandler として設定し、reader.parse(inputSource) を呼び出します。

パラメータ:

reader - 構文解析に使う XMLReader。

inputSource - SAX 入力ソース参照。null は不可で、リーダーの構文解析メソッドに渡される。

SAXSource

public SAXSource(InputSource inputSource)

SAX InputSource を使用して SAXSource を作成します。Transformer または SAXTransformerFactory は XMLReaderFactory を介してリーダーを作成して (setXMLReader が使用されない場合)、それ自体をリーダーの ContentHandler として設定し、reader.parse(inputSource) を呼び出します。

パラメータ:

inputSource - 入力ソース参照。null は不可で、リーダーの構文解析メソッドに渡される。

メソッドの詳細

setXMLReader

public void setXMLReader(XMLReader reader)

Source に対して使用される XMLReader を設定します。

パラメータ:

reader - 有効な XMLReader または XMLFilter 参照。

getXMLReader

public XMLReader getXMLReader()

Source に対して使用される XMLReader を取得します。

戻り値:

有効な XMLReader または XMLFilter 参照。あるいは null。

setInputSource

public void setInputSource(InputSource inputSource)

Source に対して使用される SAX InputSource を設定します。

パラメータ:

inputSource - 有効な InputSource 参照。

getInputSource

public InputSource getInputSource()

Source に対して使用される SAX InputSource を取得します。

戻り値:

有効な InputSource 参照、または null。

setSystemId

public void setSystemId(String systemId)

この Source のシステム識別子を設定します。入力ソースがすでに設定されている場合は、システム識別子またはその入力ソースを設定します。そうでない場合は、新しい入力ソースを作成します。

バイトストリームまたは文字ストリームがある場合、システム識別子は省略可能ですが、指定した方が便利です。アプリケーションはそれを使用して相対 URI を解決し、エラーメッセージや警告に含めることができるためです。パーサーは、バイトストリームまたは文字ストリームが指定されていない場合にかぎり、URI への接続を開こうとします。

定義:

setSystemId、インタフェース: Source

パラメータ:

systemId - URI 文字列としてのシステム識別子。

getSystemId

public String getSystemId()

URI を解決するベース識別子 (URI またはシステム識別子) を取得します。

定義:

getSystemId、インタフェース: Source

戻り値:

Source のベース URL、または null。

sourceToInputSource

public static InputSource sourceToInputSource(Source source)

Source オブジェクトから SAX InputSource オブジェクトを取得しようとします。

パラメータ:

source - null 以外の Source 参照でなければならない。

戻り値:

InputSource。Source を変換できない場合は null。