|
共通 DOM API | |||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
public interface LSInput
このインタフェースは、データの入力ソースを表します。
このインタフェースを使用すると、アプリケーションで、入力ソースに関する情報を単一オブジェクト内にカプセル化できます。カプセル化できる情報には、公開識別子、システム識別子、バイトストリーム (指定されたエンコーディングを含むことも可能)、基底 URI、および文字ストリームなどがあります。
バイトストリームと文字ストリームの正確な定義はバインディングによって異なります。
アプリケーションは、このインタフェースを実装するオブジェクトが必要な場合はいつでもこのようなオブジェクトを提供することが期待されます。アプリケーションは、このインタフェースを実装する独自のオブジェクトを提供するか、あるいは DOMImplementationLS.createLSInput() 汎用ファクトリメソッドを使って、このインタフェースを実装するオブジェクトを生成できます。
LSParser は LSInput オブジェクトを使ってデータを読み取る方法を判定します。LSParser は、LSInput で指定された複数の入力を次の順序で検索し、どのデータを読み取るかを判定します。次に、null ではなく、空の文字列でもない最初のデータが使用されます。
LSInput.characterStream LSInput.byteStream LSInput.stringData LSInput.systemId LSInput.publicId すべての入力が null の場合、LSParser は、DOMError.type を「no-input-specified」に設定し、DOMError.severity を DOMError.SEVERITY_FATAL_ERROR に設定して DOMError を報告します。
アプリケーションに属する LSInput オブジェクト。DOM 実装がこれらのオブジェクトを変更することはありません (必要に応じてコピーを作成し、作成したコピーを変更することは可能)。
「Document Object Model (DOM) Level 3 Load and Save Specification」も参照してください。
| メソッドの概要 | |
|---|---|
String |
getBaseURI()
相対 systemId を絶対 URI に解決するために使用される基底 URI ([IETF RFC 2396] の 5.1.4 項を参照)。 |
InputStream |
getByteStream()
言語の属性、およびバイトのストリームを表すバインディング依存の型。 |
boolean |
getCertifiedText()
true に設定した場合、[XML 1.1] の解析時に入力は認定されていると仮定します ([XML 1.1] の 2.13 項を参照)。 |
Reader |
getCharacterStream()
言語の属性、および 16 ビット単位のストリームを表すバインディング依存の型。 |
String |
getEncoding()
既知の場合、文字列エンコーディング。 |
String |
getPublicId()
この入力ソースの公開識別子。 |
String |
getStringData()
解析対象の文字列データ。 |
String |
getSystemId()
この入力ソースのシステム識別子として使用する URI 参照 [IETF RFC 2396]。 |
void |
setBaseURI(String baseURI)
相対 systemId を絶対 URI に解決するために使用される基底 URI ([IETF RFC 2396] の 5.1.4 項を参照)。 |
void |
setByteStream(InputStream byteStream)
言語の属性、およびバイトのストリームを表すバインディング依存の型。 |
void |
setCertifiedText(boolean certifiedText)
true に設定した場合、[XML 1.1] の解析時に入力は認定されていると仮定します ([XML 1.1] の 2.13 項を参照)。 |
void |
setCharacterStream(Reader characterStream)
言語の属性、および 16 ビット単位のストリームを表すバインディング依存の型。 |
void |
setEncoding(String encoding)
既知の場合、文字列エンコーディング。 |
void |
setPublicId(String publicId)
この入力ソースの公開識別子。 |
void |
setStringData(String stringData)
解析対象の文字列データ。 |
void |
setSystemId(String systemId)
この入力ソースのシステム識別子として使用する URI 参照 [IETF RFC 2396]。 |
| メソッドの詳細 |
|---|
Reader getCharacterStream()
void setCharacterStream(Reader characterStream)
InputStream getByteStream()
void setByteStream(InputStream byteStream)
String getStringData()
stringData を使用するとき、XML 宣言は必要ありません。XML 宣言が存在する場合、エンコーディング属性の値は無視されます。
void setStringData(String stringData)
stringData を使用するとき、XML 宣言は必要ありません。XML 宣言が存在する場合、エンコーディング属性の値は無視されます。
String getSystemId()
encoding 属性を使ってエンコーディングを設定できます。baseURI を使って相対 URI を解決しようとします。これが失敗した場合の動作は実装に依存します。
void setSystemId(String systemId)
encoding 属性を使ってエンコーディングを設定できます。baseURI を使って相対 URI を解決しようとします。これが失敗した場合の動作は実装に依存します。
String getPublicId()
void setPublicId(String publicId)
String getBaseURI()
systemId を絶対 URI に解決するために使用される基底 URI ([IETF RFC 2396] の 5.1.4 項を参照)。
void setBaseURI(String baseURI)
systemId を絶対 URI に解決するために使用される基底 URI ([IETF RFC 2396] の 5.1.4 項を参照)。
String getEncoding()
void setEncoding(String encoding)
boolean getCertifiedText()
void setCertifiedText(boolean certifiedText)
|
共通 DOM API | |||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||