gnu.xml.dom
Class DomImpl
- DOMImplementation, DOMImplementationLS
"DOMImplementation" implementation.
At this writing, the following features are supported:
"XML" (L1, L2, L3),
"Events" (L2), "MutationEvents" (L2), "USER-Events" (a conformant extension),
"HTMLEvents" (L2), "UIEvents" (L2), "Traversal" (L2), "XPath" (L3),
"LS" (L3) "LS-Async" (L3).
It is possible to compile the package so it doesn't support some of these
features (notably, Traversal).
DomImpl() - Constructs a DOMImplementation object which supports
"XML" and other DOM Level 2 features.
|
protected Document | createDocument()
|
Document | createDocument(String namespaceURI, String rootName, DocumentType doctype) - DOM L2
Creates and returns a Document, populated only with a root element and
optionally a document type(if that was provided).
|
DocumentType | createDocumentType(String rootName, String publicId, String systemId) - DOM L2
Creates and returns a DocumentType, associated with this
implementation.
|
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.
|
Object | getFeature(String feature, String version)
|
boolean | hasFeature(String name, String version) - DOM L1
Returns true if the specified feature and version are
supported.
|
clone , equals , extends Object> getClass , finalize , hashCode , notify , notifyAll , toString , wait , wait , wait |
DomImpl
public DomImpl()
Constructs a DOMImplementation object which supports
"XML" and other DOM Level 2 features.
createDocumentType
public DocumentType createDocumentType(String rootName,
String publicId,
String systemId)
DOM L2
Creates and returns a DocumentType, associated with this
implementation. This DocumentType can have no associated
objects(notations, entities) until the DocumentType is
first associated with a document.
Note that there is no implication that this DTD will
be parsed by the DOM, or ever have contents. Moreover, the
DocumentType created here can only be added to a document by
the createDocument method(below).
That means that the only
portable way to create a Document object is to start parsing,
queue comment and processing instruction (PI) nodes, and then only
create a DOM Document after (a) it's known if a DocumentType
object is needed, and (b) the name and namespace of the root
element is known. Queued comment and PI nodes would then be
inserted appropriately in the document prologue, both before and
after the DTD node, and additional attributes assigned to the
root element.
(One hopes that the final DOM REC fixes this serious botch.)
- createDocumentType in interface DOMImplementation
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.
- createLSInput in interface DOMImplementationLS
- The newly created input 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.
- createLSParser in interface DOMImplementationLS
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.
- createLSSerializer in interface DOMImplementationLS
- 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.
DomImpl.java --
Copyright (C) 1999,2000,2001,2004 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version.