org.w3c.dom.ls
Interface DOMImplementationLS

public interface DOMImplementationLS

DOMImplementationLS contains the factory methods for creating Load and Save objects.

The expectation is that an instance of the DOMImplementationLS interface can be obtained by using binding-specific casting methods on an instance of the DOMImplementation interface or, if the Document supports the feature "Core" version "3.0" defined in [DOM Level 3 Core] , by using the method DOMImplementation.getFeature with parameter values "LS" (or "LS-Async") and "3.0" (respectively).

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

Field Summary

static short	MODE_ASYNCHRONOUS Create an asynchronous DOMParser.
static short	MODE_SYNCHRONOUS Create a synchronous DOMParser.

Method Summary

DOMInput	createDOMInput()
DOMParser	createDOMParser(short mode, java.lang.String schemaType) Create a new DOMParser.
DOMSerializer	createDOMSerializer() Create a new DOMSerializer object.

Field Detail

MODE_SYNCHRONOUS

public static final short MODE_SYNCHRONOUS

Create a synchronous DOMParser.

MODE_ASYNCHRONOUS

public static final short MODE_ASYNCHRONOUS

Create an asynchronous DOMParser.

Method Detail

createDOMParser

public DOMParser createDOMParser(short mode,
                                 java.lang.String schemaType)
                          throws DOMException

Create a new DOMParser. The newly constructed parser may then be configured by means of its DOMConfiguration object, 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 DOMParser that is created will operate in synchronous mode, if it's MODE_ASYNCHRONOUS then the DOMParser 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 DOMParser. Note that no lexical checking is done on the absolute URI. In order to create a DOMParser for any kind of schema types (i.e. the DOMParser will be free to use any schema found), use the value null.

Note: For W3C XML Schema [XML Schema Part 1] , applications must use the value "http://www.w3.org/2001/XMLSchema". For XML DTD [XML 1.0], 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 DOMParser object. This DOMParser is either synchronous or asynchronous depending on the value of the mode argument.

Note: By default, the newly created DOMParser does not contain a DOMErrorHandler, i.e. the value of the " error-handler" configuration parameter is null. However, implementations may provide a default error handler at creation time. In that case, the initial value of the "error-handler" configuration parameter on the new created DOMParser contains a reference to the default error handler.

Throws:

DOMException - NOT_SUPPORTED_ERR: Raised if the requested mode or schema type is not supported.

createDOMSerializer

public DOMSerializer createDOMSerializer()

Create a new DOMSerializer object.

Returns:

The newly created DOMSerializer object.

Note: By default, the newly created DOMSerializer has no DOMErrorHandler, i.e. the value of the "error-handler" configuration parameter is null. However, implementations may provide a default error handler at creation time. In that case, the initial value of the "error-handler" configuration parameter on the new created DOMSerializer contains a reference to the default error handler.

createDOMInput

public DOMInput createDOMInput()