モジュール java.xml
パッケージ org.w3c.dom.ls

インタフェースDOMImplementationLS

public interface DOMImplementationLS
DOMImplementationLSは、ロードおよび保存オブジェクトを作成するためのファクトリ・メソッドを備えています。

DOMImplementationLSインタフェースのインスタンスは、DOMImplementationインタフェースのインスタンスに対してバインディング固有のキャスト・メソッドを使用して、またはDocumentが「DOM Level 3 Core」で定義されている"Core"バージョン"3.0"機能をサポートしている場合は、それぞれパラメータ値"LS" (または"LS-Async")と"3.0"でDOMImplementation.getFeatureメソッドを使用して取得できることが期待されています。

「 Document Object Model (DOM) Level 3 Load and Save Specification」も参照してください。

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

  • フィールドのサマリー

    フィールド
    修飾子と型 フィールド 説明
    static short MODE_ASYNCHRONOUS
    非同期LSParserを作成します。
    static short MODE_SYNCHRONOUS
    同期LSParserを作成します。

  • メソッドのサマリー

    修飾子と型 メソッド 説明
    LSInput createLSInput()
    LSInput.characterStream、LSInput.byteStream、LSInput.stringData LSInput.systemId、LSInput.publicId、LSInput.baseURI、およびLSInput.encodingがnullであり、LSInput.certifiedTextがfalseである新しい空の入力ソース・オブジェクトを作成します。
    LSOutput createLSOutput()
    LSOutput.characterStream、LSOutput.byteStream、LSOutput.systemId、およびLSOutput.encodingがnullである新しい空の出力先オブジェクトを作成します。
    LSParser createLSParser​(short mode, String schemaType)
    新しいLSParserを作成します。
    LSSerializer createLSSerializer()
    新しいLSSerializerオブジェクトを作成します。

  • フィールド詳細

    • MODE_SYNCHRONOUS

      static final short MODE_SYNCHRONOUS
      同期LSParserを作成します。
      関連項目:
      定数フィールド値

    • MODE_ASYNCHRONOUS

      static final short MODE_ASYNCHRONOUS
      非同期LSParserを作成します。
      関連項目:
      定数フィールド値

  • メソッドの詳細

    • createLSParser

      LSParser createLSParser​(short mode, String schemaType) throws DOMException
      新しいLSParserを作成します。 その後、新しく構築されたパーサーを、そのDOMConfigurationオブジェクトを使用して構成したり、そのparseメソッドを使用して文書を解析するために使用したりできます。
      パラメータ:
      mode - mode引数はMODE_SYNCHRONOUSまたはMODE_ASYNCHRONOUSのどちらか。modeがMODE_SYNCHRONOUSの場合、作成されるLSParserは同期モードで動作し、MODE_ASYNCHRONOUSの場合、作成されるLSParserは非同期モードで動作する。
      schemaType - 新しく作成されたLSParserを使用したDocumentのロード中に使用されるスキーマ言語の型を表す絶対URI。 絶対URIで、字句チェックは行われないことに注意。 任意の種類のスキーマ型に対応するLSParserを作成する(つまり、検出された任意のスキーマをLSParserが自由に使用できるようにする)には、値nullを使用する。

      ノート: W3C XMLスキーマ「XML Schema Part 1」の場合、アプリケーションは値"http://www.w3.org/2001/XMLSchema"を使用する必要があります。 XML DTD「XML 1.0」の場合は、アプリケーションで値"http://www.w3.org/TR/REC-xml"を使用する必要があります。 ほかのスキーマ言語はW3Cの範囲外であるため、このメソッドを使用するには、絶対URIを使用することをお勧めします。

      戻り値:
      新しく作成されたLSParserオブジェクト。 このLSParserは、mode引数の値に応じて、同期または非同期のどちらかである。

      ノート: デフォルトでは、新しく作成されたLSParserにはDOMErrorHandlerが含まれていません。つまり、error-handler構成パラメータの値はnullです。 ただし、実装では生成時にデフォルトのエラー・ハンドラが提供される場合がある。 この場合、新規LSParserオブジェクトの"error-handler"構成パラメータの初期値には、デフォルトのエラー・ハンドラへの参照が含まれます。

      例外:
      DOMException - NOT_SUPPORTED_ERR: 要求されたモードまたはスキーマ型がサポートされていない場合に発生します。

    • createLSSerializer

      LSSerializer createLSSerializer()
      新しいLSSerializerオブジェクトを作成します。
      戻り値:
      新しく作成されたLSSerializerオブジェクト。

      ノート: デフォルトでは、新しく作成されたLSSerializerにはDOMErrorHandlerが含まれません。つまり、「error-handler」構成パラメータの値はnullです。 ただし、実装では生成時にデフォルトのエラー・ハンドラが提供される場合がある。 この場合、新規LSSerializerオブジェクトの"error-handler"構成パラメータの初期値には、デフォルトのエラー・ハンドラへの参照が含まれます。

    • createLSInput

      LSInput createLSInput()
      LSInput.characterStream、LSInput.byteStream、LSInput.stringData LSInput.systemId、LSInput.publicId、LSInput.baseURI、およびLSInput.encodingがnullであり、LSInput.certifiedTextがfalseである新しい空の入力ソース・オブジェクトを作成します。
      戻り値:
      新しく作成された入力オブジェクト。

    • createLSOutput

      LSOutput createLSOutput()
      LSOutput.characterStream、LSOutput.byteStream、LSOutput.systemId、およびLSOutput.encodingがnullである新しい空の出力先オブジェクトを作成します。
      戻り値:
      新しく作成された出力オブジェクト。