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.
- Since:
- 1.5
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final shortCreate an asynchronousLSParser.static final shortCreate a synchronousLSParser. -
Method Summary
Modifier and TypeMethodDescriptionCreate a new empty input source object whereLSInput.characterStream,LSInput.byteStream,LSInput.stringDataLSInput.systemId,LSInput.publicId,LSInput.baseURI, andLSInput.encodingare null, andLSInput.certifiedTextis false.Create a new empty output destination object whereLSOutput.characterStream,LSOutput.byteStream,LSOutput.systemId,LSOutput.encodingare null.createLSParser(short mode, String schemaType) Create a newLSParser.Create a newLSSerializerobject.
-
Field Details
-
MODE_SYNCHRONOUS
static final short MODE_SYNCHRONOUSCreate a synchronousLSParser.- See Also:
-
MODE_ASYNCHRONOUS
static final short MODE_ASYNCHRONOUSCreate an asynchronousLSParser.- See Also:
-
-
Method Details
-
createLSParser
Create a newLSParser. The newly constructed parser may then be configured by means of itsDOMConfigurationobject, and used to parse documents by means of itsparsemethod.- Parameters:
mode- Themodeargument is eitherMODE_SYNCHRONOUSorMODE_ASYNCHRONOUS, ifmodeisMODE_SYNCHRONOUSthen theLSParserthat is created will operate in synchronous mode, if it'sMODE_ASYNCHRONOUSthen theLSParserthat is created will operate in asynchronous mode.schemaType- An absolute URI representing the type of the schema language used during the load of aDocumentusing the newly createdLSParser. Note that no lexical checking is done on the absolute URI. In order to create aLSParserfor any kind of schema types (i.e. the LSParser will be free to use any schema found), use the valuenull.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
LSParserobject. ThisLSParseris either synchronous or asynchronous depending on the value of themodeargument.Note: By default, the newly created
LSParserdoes not contain aDOMErrorHandler, i.e. the value of the "error-handler" configuration parameter isnull. 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 newLSParserobject contains a reference to the default error handler. - Throws:
DOMException- NOT_SUPPORTED_ERR: Raised if the requested mode or schema type is not supported.
-
createLSSerializer
LSSerializer createLSSerializer()Create a newLSSerializerobject.- Returns:
- The newly created
LSSerializerobject.Note: By default, the newly created
LSSerializerhas noDOMErrorHandler, i.e. the value of the"error-handler"configuration parameter isnull. 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 newLSSerializerobject contains a reference to the default error handler.
-
createLSInput
LSInput createLSInput()Create a new empty input source object whereLSInput.characterStream,LSInput.byteStream,LSInput.stringDataLSInput.systemId,LSInput.publicId,LSInput.baseURI, andLSInput.encodingare null, andLSInput.certifiedTextis false.- Returns:
- The newly created input object.
-
createLSOutput
LSOutput createLSOutput()Create a new empty output destination object whereLSOutput.characterStream,LSOutput.byteStream,LSOutput.systemId,LSOutput.encodingare null.- Returns:
- The newly created output object.
-