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.
Modifier and Type | Field and Description |
---|---|
static short |
MODE_ASYNCHRONOUS
Create an asynchronous
LSParser . |
static short |
MODE_SYNCHRONOUS
Create a synchronous
LSParser . |
Modifier and Type | Method and Description |
---|---|
LSInput |
createLSInput()
Create a new empty input source object where
LSInput.characterStream , LSInput.byteStream
, LSInput.stringData LSInput.systemId ,
LSInput.publicId , LSInput.baseURI , and
LSInput.encoding are null, and
LSInput.certifiedText is false. |
LSOutput |
createLSOutput()
Create a new empty output destination object where
LSOutput.characterStream ,
LSOutput.byteStream , LSOutput.systemId ,
LSOutput.encoding are null. |
LSParser |
createLSParser(short mode,
String schemaType)
Create a new
LSParser . |
LSSerializer |
createLSSerializer()
Create a new
LSSerializer object. |
static final short MODE_SYNCHRONOUS
LSParser
.static final short MODE_ASYNCHRONOUS
LSParser
.LSParser createLSParser(short mode, String schemaType) throws DOMException
LSParser
. 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.mode
- The mode
argument is either
MODE_SYNCHRONOUS
or MODE_ASYNCHRONOUS
, if
mode
is MODE_SYNCHRONOUS
then the
LSParser
that is created will operate in synchronous
mode, if it's MODE_ASYNCHRONOUS
then the
LSParser
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 LSParser
. Note that no lexical checking
is done on the absolute URI. In order to create a
LSParser
for any kind of schema types (i.e. the
LSParser 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.
LSParser
object. This
LSParser
is either synchronous or asynchronous
depending on the value of the mode
argument.
Note: By default, the newly created LSParser
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 LSParser
object contains a
reference to the default error handler.
DOMException
- NOT_SUPPORTED_ERR: Raised if the requested mode or schema type is
not supported.LSSerializer createLSSerializer()
LSSerializer
object.LSSerializer
object.
Note: By default, the newly created
LSSerializer
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 LSSerializer
object contains a
reference to the default error handler.
LSInput createLSInput()
LSInput.characterStream
, LSInput.byteStream
, LSInput.stringData
LSInput.systemId
,
LSInput.publicId
, LSInput.baseURI
, and
LSInput.encoding
are null, and
LSInput.certifiedText
is false.LSOutput createLSOutput()
LSOutput.characterStream
,
LSOutput.byteStream
, LSOutput.systemId
,
LSOutput.encoding
are null. Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2021, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.