org.w3c.dom.ls
Interface DOMImplementationLS


public interface DOMImplementationLS

DOM Level 3 WD Experimental: The DOM Level 3 specification is at the stage of Working Draft, which represents work in progress and thus may be updated, replaced, or obsoleted by other documents at any time.

DOMImplementationLS contains the factory methods for creating objects that implement the DOMBuilder (parser) and DOMWriter (serializer) interfaces.

An object that implements DOMImplementationLS is obtained by doing a binding specific cast from DOMImplementation to DOMImplementationLS. Implementations supporting the Load and Save feature must implement the DOMImplementationLS interface on whatever object implements the DOMImplementation interface.

See also the Document Object Model (DOM) Level 3 Abstract Schemas and Load and Save Specification.


Field Summary
static short MODE_ASYNCHRONOUS
          Create an asynchronous DOMBuilder.
static short MODE_SYNCHRONOUS
          Create a synchronous DOMBuilder.
 
Method Summary
 DOMBuilder createDOMBuilder(short mode, java.lang.String schemaType)
          Create a new DOMBuilder.
 DOMInputSource createDOMInputSource()
          Create a new "empty" DOMInputSource.
 DOMWriter createDOMWriter()
          Create a new DOMWriter object.
 

Field Detail

MODE_SYNCHRONOUS

public static final short MODE_SYNCHRONOUS
Create a synchronous DOMBuilder.

See Also:
Constant Field Values

MODE_ASYNCHRONOUS

public static final short MODE_ASYNCHRONOUS
Create an asynchronous DOMBuilder.

See Also:
Constant Field Values
Method Detail

createDOMBuilder

public DOMBuilder createDOMBuilder(short mode,
                                   java.lang.String schemaType)
                            throws DOMException
Create a new DOMBuilder. The newly constructed parser may then be configured by means of its setFeature method, and used to parse documents by means of its parse method.

Parameters:
mode - The mode argument is either MODE_SYNCHRONOUS or MODE_ASYNCHRONOUS, if mode is MODE_SYNCHRONOUS then the DOMBuilder that is created will operate in synchronous mode, if it's MODE_ASYNCHRONOUS then the DOMBuilder that is created will operate in asynchronous mode.
schemaType - An absolute URI representing the type of the schema language used during the load of a Document using the newly created DOMBuilder. Note that no lexical checking is done on the absolute URI. In order to create a DOMBuilder for any kind of schema types (i.e. the DOMBuilder will be free to use any schema found), use the value null. For W3C XML Schema , applications must use the value "http://www.w3.org/2001/XMLSchema". For XML DTD , applications must use the value "http://www.w3.org/TR/REC-xml". Other Schema languages are outside the scope of the W3C and therefore should recommend an absolute URI in order to use this method.
Returns:
The newly created DOMBuilder object. This DOMBuilder is either synchronous or asynchronous depending on the value of the mode argument.
Throws:
DOMException - NOT_SUPPORTED_ERR: Raised if the requested mode or schema type is not supported.

createDOMWriter

public DOMWriter createDOMWriter()
Create a new DOMWriter object. DOMWriters are used to serialize a DOM tree back into an XML document.

Returns:
The newly created DOMWriter object.

createDOMInputSource

public DOMInputSource createDOMInputSource()
Create a new "empty" DOMInputSource.

Returns:
The newly created DOMInputSource object.


Copyright © 1999-2002 Apache XML Project. All Rights Reserved.