モジュール java.xml

パッケージ javax.xml.transform.sax

クラスSAXSource

java.lang.Object

javax.xml.transform.sax.SAXSource

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

Source

public class SAXSource extends Object implements Source

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

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

導入されたバージョン:

1.4

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
static final 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を取得します。
boolean	isEmpty()	SAXSourceオブジェクトが空かどうかを示します。
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は、リーダー(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。

isEmpty

public boolean isEmpty()

SAXSourceオブジェクトが空かどうかを示します。 空は次のように定義されます:

• システム識別子およびInputSourceがnullである場合、
• システム識別子がnullで、InputSourceが空の場合。

定義:

インタフェースSource内のisEmpty

戻り値:

SAXSourceオブジェクトが空の場合はtrue、それ以外の場合はfalse