|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--gnu.xml.dom.DomImpl
"DOMImplementation" implementation.
At this writing, the following features are supported: "XML" (L1, L2), "Events" (L2), "MutationEvents" (L2), "USER-Events" (a conformant extension), "HTMLEvents" (L2), "UIEvents" (L2), "Traversal" (L2). It is possible to compile the package so it doesn't support some of these features (notably, Traversal).
Constructor Summary | |
DomImpl()
Constructs a DOMImplementation object which supports "XML" and other DOM Level 2 features. |
Method Summary | |
Document |
createDocument(java.lang.String namespaceURI,
java.lang.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(java.lang.String rootName,
java.lang.String publicId,
java.lang.String systemId)
DOM L2 Creates and returns a DocumentType, associated with this implementation. |
boolean |
hasFeature(java.lang.String name,
java.lang.String version)
DOM L1 Returns true if the specified feature and version are supported. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public DomImpl()
Method Detail |
public boolean hasFeature(java.lang.String name, java.lang.String version)
hasFeature
in interface DOMImplementation
org.w3c.dom.DOMImplementation
featureThe
- name of the feature to test (case-insensitive). The
values used by DOM features are defined throughout the DOM Level 2
specifications and listed in the section. The name must be an XML
name. To avoid possible conflicts, as a convention, names referring
to features defined outside the DOM specification should be made
unique by reversing the name of the Internet domain name of the
person (or the organization that the person belongs to) who defines
the feature, component by component, and using this as a prefix.
For instance, the W3C SVG Working Group defines the feature
"org.w3c.dom.svg".versionThis
- is the version number of the feature to test. In
Level 2, the string can be either "2.0" or "1.0". If the version is
not specified, supporting any version of the feature causes the
method to return true
.true
if the feature is implemented in the
specified version, false
otherwise.public DocumentType createDocumentType(java.lang.String rootName, java.lang.String publicId, java.lang.String systemId)
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
org.w3c.dom.DOMImplementation
qualifiedNameThe
- qualified name of the document type to be
created.publicIdThe
- external subset public identifier.systemIdThe
- external subset system identifier.DocumentType
node with
Node.ownerDocument
set to null
.DOMException
- INVALID_CHARACTER_ERR: Raised if the specified qualified name
contains an illegal character.
qualifiedName
is
malformed.public Document createDocument(java.lang.String namespaceURI, java.lang.String rootName, DocumentType doctype)
createDocument
in interface DOMImplementation
org.w3c.dom.DOMImplementation
namespaceURIThe
- namespace URI of the document element to create.qualifiedNameThe
- qualified name of the document element to be
created.doctypeThe
- type of document to be created or null
.
When doctype
is not null
, its
Node.ownerDocument
attribute is set to the document
being created.Document
object.DOMException
- INVALID_CHARACTER_ERR: Raised if the specified qualified name
contains an illegal character.
qualifiedName
is
malformed, if the qualifiedName
has a prefix and the
namespaceURI
is null
, or if the
qualifiedName
has a prefix that is "xml" and the
namespaceURI
is different from "
http://www.w3.org/XML/1998/namespace" .
doctype
has already
been used with a different document or was created from a different
implementation.
|
Source code is GPL'd in the JAXP subproject at http://savannah.gnu.org/projects/classpathx |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |