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」も参照してください。

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
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 である新しい空の出力先オブジェクトを作成します。

戻り値:

新しく作成された出力オブジェクト。