モジュール 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 final short	MODE_ASYNCHRONOUS	非同期LSParserを作成します。
static final 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である新しい空の出力先オブジェクトを作成します。

戻り値:

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