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()
|
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)
|
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)
バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2018, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。