インタフェースLSInput

public interface LSInput
このインタフェースはデータの入力ソースを表します。

このインタフェースを使用すると、アプリケーションで、入力ソースに関する情 を単一のオブジェクトにカプセル化できます。このオブジェクトには、公開識別子、システ 識別子、バイト・ストリー (エンコーディングが指定されている 合もある)、ベースURI、あるいは文字ストリー などが含まれます。

バイト・ストリー と文字ストリー の正確な定義は、バインディングによって異なります。

アプリケーションは、前述のようなオブジェクトが必要なときはいつでも、このインタフェースを実装するオブジェクトを持つことが求められます。 アプリケーションでは、このインタフェースを実装する独自のオブジェクトを提供したり、ジェネリックなファクトリ・メソッドのDOMImplementationLS.createLSInput()を使用してこのインタフェースを実装するオブジェクトを作成したりできます。

LSParserは、LSInputオブジェクトを使用して、データを読み取る方法を決定します。 LSParserは、LSInputで指定された異なる入力を次の 序で検索して、読取り元を認識します。nullではなく、空の文字列でもない最初の入力が使用されます。

  1. LSInput.characterStream
  2. LSInput.byteStream
  3. LSInput.stringData
  4. LSInput.systemId
  5. 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」も参照してく さい。

導入されたバージョン:
1.5

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    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」です。

  • メソッドの詳細

    • getCharacterStream

      Reader getCharacterStream()
      言語の属性および16ビット単位のストリー を表すバインディング依存の型です。 アプリケーションは、UTF-16 (「Unicode」、「ISO/IEC 10646」で定義されている)を使用するストリー をエンコードする必要があります。 文字ストリー を使用する 合、XML宣言は必要ありません。 XML宣言が存在する 合、エンコーディング属性の値は無視されます。

    • setCharacterStream

      void setCharacterStream(Reader characterStream)
      言語の属性および16ビット単位のストリー を表すバインディング依存の型です。 アプリケーションは、UTF-16 (「Unicode」、「ISO/IEC 10646」で定義されている)を使用するストリー をエンコードする必要があります。 文字ストリー を使用する 合、XML宣言は必要ありません。 XML宣言が存在する 合、エンコーディング属性の値は無視されます。

    • getByteStream

      InputStream getByteStream()
      言語の属性およびバイトのストリー を表すバインディング依存の型です。
      アプリケーションは、バイト・ストリー の文字エンコーディングを認識している 合、エンコーディング属性を設定する必要があります。       データのXML宣言で指定されているエンコーディングは、この方法によるエンコーディングの設定によりオーバーライドされます。

    • setByteStream

      void setByteStream(InputStream byteStream)
      言語の属性およびバイトのストリー を表すバインディング依存の型です。
      アプリケーションは、バイト・ストリー の文字エンコーディングを認識している 合、エンコーディング属性を設定する必要があります。       データのXML宣言で指定されているエンコーディングは、この方法によるエンコーディングの設定によりオーバーライドされます。

    • getStringData

      String getStringData()
      構文解析する文字列データです。 提供されている 合は、常に16ビット単位のシーケンス(UTF-16でエンコードされた文字列)として処理されます。 stringDataを使用する 合、XML宣言は必要ありません。 XML宣言が存在する 合、エンコーディング属性の値は無視されます。

    • setStringData

      void setStringData(String stringData)
      構文解析する文字列データです。 提供されている 合は、常に16ビット単位のシーケンス(UTF-16でエンコードされた文字列)として処理されます。 stringDataを使用する 合、XML宣言は必要ありません。 XML宣言が存在する 合、エンコーディング属性の値は無視されます。

    • getSystemId

      String getSystemId()
      この入力ソースのシステ 識別子、URI参照「IETF RFC 2396」です。 バイト・ストリー 、文字ストリー または文字列データがある 合、システ 識別子はオプションです。 アプリケーションでシステ 識別子を使用して相対URIを解決したり、エラー・メッセージや警告に追 したりできるので、システ 識別子を指定すると役に立ちます。 LSParserは、入力ソースで他の入力が利用できない 合のみ、URI参照により識別したリソースを取得しようとします。
      アプリケーションは、システ 識別子でポイントされたオブジェクトの文字エンコーディングを認識している 合、encoding属性を使用してエンコーディングを設定できます。
      指定されたシステ IDが相対URI参照(「IETF RFC 2396」のセクション5を参照)である 合、DOM実装は、ベースとしてbaseURIを使用して相対URIを解決しようとします。これが失敗した 合、動作は実装依存です。

    • setSystemId

      void setSystemId(String systemId)
      この入力ソースのシステ 識別子、URI参照「IETF RFC 2396」です。 バイト・ストリー 、文字ストリー または文字列データがある 合、システ 識別子はオプションです。 アプリケーションでシステ 識別子を使用して相対URIを解決したり、エラー・メッセージや警告に追 したりできるので、システ 識別子を指定すると役に立ちます。 LSParserは、入力ソースで他の入力が利用できない 合のみ、URI参照により識別したリソースを取得しようとします。
      アプリケーションは、システ 識別子でポイントされたオブジェクトの文字エンコーディングを認識している 合、encoding属性を使用してエンコーディングを設定できます。
      指定されたシステ IDが相対URI参照(「IETF RFC 2396」のセクション5を参照)である 合、DOM実装は、ベースとしてbaseURIを使用して相対URIを解決しようとします。これが失敗した 合、動作は実装依存です。

    • getPublicId

      String getPublicId()
      この入力ソースの公開識別子です。 この識別子は、実装依存のメカニズ (カタログやほかのマッピングなど)を使用して入力ソースにマップできます。 指定された 合、エラー 告時の位置情 の一部として公開識別子を 告することもできます。

    • setPublicId

      void setPublicId(String publicId)
      この入力ソースの公開識別子です。 この識別子は、実装依存のメカニズ (カタログやほかのマッピングなど)を使用して入力ソースにマップできます。 指定された 合、エラー 告時の位置情 の一部として公開識別子を 告することもできます。

    • getBaseURI

      String getBaseURI()
      相対systemIdを絶対URIに解決するときに使用されるベースURIです(「IETF RFC 2396」のセクション5.1.4を参照)。
      使用したときに、ベースURIが相対URI、空の文字列、またはnullである 合、動作は実装依存です。

    • setBaseURI

      void setBaseURI(String baseURI)
      相対systemIdを絶対URIに解決するときに使用されるベースURIです(「IETF RFC 2396」のセクション5.1.4を参照)。
      使用したときに、ベースURIが相対URI、空の文字列、またはnullである 合、動作は実装依存です。

    • getEncoding

      String getEncoding()
      既知の 合は、文字エンコーディングです。 エンコーディングは、XMLエンコーディング宣言(「XML 1.0」セクション4.3.3「エンティティの文字エンコーディング」)で受け入れ可能な文字列にする必要があります。
      この属性は、アプリケーションが文字ストリー や文字列データを提供する 合、何も影響を与えません。       ほかの入力ソースの 合、XML宣言やテキスト宣言、あるいはHTTP「IETF RFC 2616」といった高位レベルのプロトコルから取得されたエンコーディングは、この属性を使用して指定されたエンコーディングによりオーバーライドされます。

    • setEncoding

      void setEncoding(String encoding)
      既知の 合は、文字エンコーディングです。 エンコーディングは、XMLエンコーディング宣言(「XML 1.0」セクション4.3.3「エンティティの文字エンコーディング」)で受け入れ可能な文字列にする必要があります。
      この属性は、アプリケーションが文字ストリー や文字列データを提供する 合、何も影響を与えません。       ほかの入力ソースの 合、XML宣言やテキスト宣言、あるいはHTTP「IETF RFC 2616」といった高位レベルのプロトコルから取得されたエンコーディングは、この属性を使用して指定されたエンコーディングによりオーバーライドされます。

    • getCertifiedText

      boolean getCertifiedText()
      trueに設定する 合、入力は解析時(「XML 1.1」)に認証されることを前提とします(「XML 1.1」のセクション2.13を参照)。

    • setCertifiedText

      void setCertifiedText(boolean certifiedText)
      trueに設定する 合、入力は解析時(「XML 1.1」)に認証されることを前提とします(「XML 1.1」のセクション2.13を参照)。