org.w3c.dom.ls
Interface DOMImplementationLS
- DomImpl
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.
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.
|
MODE_ASYNCHRONOUS
public static final short MODE_ASYNCHRONOUS
Create an asynchronous LSParser
.
- 2
MODE_SYNCHRONOUS
public static final short MODE_SYNCHRONOUS
Create a synchronous LSParser
.
- 1
createLSInput
public 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.
- The newly created input object.
createLSOutput
public LSOutput createLSOutput()
Create a new empty output destination object where
LSOutput.characterStream
,
LSOutput.byteStream
, LSOutput.systemId
,
LSOutput.encoding
are null.
- The newly created output object.
createLSParser
public LSParser createLSParser(short mode,
String schemaType)
throws DOMException
Create a new 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.
- The newly created
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.
createLSSerializer
public LSSerializer createLSSerializer()
Create a new LSSerializer
object.
- The newly created
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.