共通 DOM API

org.w3c.dom.ls
インタフェース DOMImplementationLS


public interface DOMImplementationLS

DOMImplementationLS には、Load オブジェクトと Save オブジェクトを生成するためのファクトリメソッドがあります。

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.characterStreamLSInput.byteStreamLSInput.stringDataLSInput.systemIdLSInput.publicIdLSInput.baseURI、および LSInput.encoding が null であり、LSInput.certifiedText が false である新規の空の入力ソースオブジェクトを生成します。
 LSOutput createLSOutput()
          LSOutput.characterStreamLSOutput.byteStreamLSOutput.systemIdLSOutput.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 である。modeMODE_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.characterStreamLSInput.byteStreamLSInput.stringDataLSInput.systemIdLSInput.publicIdLSInput.baseURI、および LSInput.encoding が null であり、LSInput.certifiedText が false である新規の空の入力ソースオブジェクトを生成します。

戻り値:
新規生成された入力オブジェクト

createLSOutput

LSOutput createLSOutput()
LSOutput.characterStreamLSOutput.byteStreamLSOutput.systemIdLSOutput.encoding が null である新規の空の出力先オブジェクトを生成します。

戻り値:
新規生成された出力オブジェクト

共通 DOM API

バグや機能要求の報告
Java は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 2004 Sun Microsystems, Inc. 4150 Network Circle
Santa Clara, California, 95054, U.S.A. All Rights Reserved.