Bommels05/commons-xml
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Still trying to get the Javadoc synched up. No functional changes.

Browse Source 
DOM Level 2 Errata:
http://www.w3.org/2001/06/DOM-Level-2-Core-java-binding-20010621.zip
http://www.w3.org/2001/06/DOM-Level-2-Traversal-Range-java-binding-20010621.zip
http://www.w3.org/2001/06/DOM-Level-2-Views-java-binding-20010621.zip
http://www.w3.org/2001/06/DOM-Level-2-Events-java-binding-20010621.zip
http://www.w3.org/2001/06/DOM-Level-2-Style-java-binding-20010621.zip

DOM HTML Level 1 Second Edition, extracted from
http://www.w3.org/TR/2000/WD-DOM-Level-1-20000929/java-binding.zip


git-svn-id: https://svn.apache.org/repos/asf/xml/commons/trunk@225969 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
jkesselm 2002-05-10 20:32:51 +00:00
parent 4ff561bf31
commit 3ad12ecf26
35 changed files with 1459 additions and 206 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
java/external/src/org/w3c/dom/Attr.java vendored
View File

@ -13,7 +13,7 @@
package org.w3c.dom; package org.w3c.dom;
/** /**
* The <code>Attr</code> interface represents an attribute in an * The <code>Attr</code> interface represents an attribute in an
* <code>Element</code> object. Typically the allowable values for the * <code>Element</code> object. Typically the allowable values for the
* attribute are defined in a document type definition. * attribute are defined in a document type definition.
* <p><code>Attr</code> objects inherit the <code>Node</code> interface, but * <p><code>Attr</code> objects inherit the <code>Node</code> interface, but
@ -33,7 +33,7 @@ package org.w3c.dom;
* DOM need to be aware that <code>Attr</code> nodes have some things in * DOM need to be aware that <code>Attr</code> nodes have some things in
* common with other objects inheriting the <code>Node</code> interface, but * common with other objects inheriting the <code>Node</code> interface, but
* they also are quite distinct. * they also are quite distinct.
* <p> The attribute's effective value is determined as follows: if this * <p>The attribute's effective value is determined as follows: if this
* attribute has been explicitly assigned any value, that value is the * attribute has been explicitly assigned any value, that value is the
* attribute's effective value; otherwise, if there is a declaration for * attribute's effective value; otherwise, if there is a declaration for
* this attribute, and that declaration includes a default value, then that * this attribute, and that declaration includes a default value, then that
@ -41,19 +41,19 @@ package org.w3c.dom;
* attribute does not exist on this element in the structure model until it * attribute does not exist on this element in the structure model until it
* has been explicitly added. Note that the <code>nodeValue</code> attribute * has been explicitly added. Note that the <code>nodeValue</code> attribute
* on the <code>Attr</code> instance can also be used to retrieve the string * on the <code>Attr</code> instance can also be used to retrieve the string
* version of the attribute's value(s). * version of the attribute's value(s).
* <p>In XML, where the value of an attribute can contain entity references, * <p>In XML, where the value of an attribute can contain entity references,
* the child nodes of the <code>Attr</code> node may be either * the child nodes of the <code>Attr</code> node may be either
* <code>Text</code> or <code>EntityReference</code> nodes (when these are * <code>Text</code> or <code>EntityReference</code> nodes (when these are
* in use; see the description of <code>EntityReference</code> for * in use; see the description of <code>EntityReference</code> for
* discussion). Because the DOM Core is not aware of attribute types, it * discussion). Because the DOM Core is not aware of attribute types, it
* treats all attribute values as simple strings, even if the DTD or schema * treats all attribute values as simple strings, even if the DTD or schema
* declares them as having tokenized types. * declares them as having tokenized types.
* <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113'>Document Object Model (DOM) Level 2 Core Specification</a>. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113'>Document Object Model (DOM) Level 2 Core Specification</a>.
*/ */
public interface Attr extends Node { public interface Attr extends Node {
/** /**
* Returns the name of this attribute. * Returns the name of this attribute.
*/ */
public String getName(); public String getName();
@ -69,14 +69,14 @@ public interface Attr extends Node {
* implementation will then make a new attribute available with * implementation will then make a new attribute available with
* <code>specified</code> set to <code>false</code> and the default * <code>specified</code> set to <code>false</code> and the default
* value (if one exists). * value (if one exists).
* <br>In summary: If the attribute has an assigned value in the document * <br>In summary: If the attribute has an assigned value in the document
* then <code>specified</code> is <code>true</code>, and the value is * then <code>specified</code> is <code>true</code>, and the value is
* the assigned value. If the attribute has no assigned value in the * the assigned value.If the attribute has no assigned value in the
* document and has a default value in the DTD, then * document and has a default value in the DTD, then
* <code>specified</code> is <code>false</code>, and the value is the * <code>specified</code> is <code>false</code>, and the value is the
* default value in the DTD. If the attribute has no assigned value in * default value in the DTD.If the attribute has no assigned value in
* the document and has a value of #IMPLIED in the DTD, then the * the document and has a value of #IMPLIED in the DTD, then the
* attribute does not appear in the structure model of the document. If * attribute does not appear in the structure model of the document.If
* the <code>ownerElement</code> attribute is <code>null</code> (i.e. * the <code>ownerElement</code> attribute is <code>null</code> (i.e.
* because it was just created or was set to <code>null</code> by the * because it was just created or was set to <code>null</code> by the
* various removal and cloning operations) <code>specified</code> is * various removal and cloning operations) <code>specified</code> is
@ -98,6 +98,19 @@ public interface Attr extends Node {
* NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly. * NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.
*/ */
public String getValue(); public String getValue();
/**
* On retrieval, the value of the attribute is returned as a string.
* Character and general entity references are replaced with their
* values. See also the method <code>getAttribute</code> on the
* <code>Element</code> interface.
* <br>On setting, this creates a <code>Text</code> node with the unparsed
* contents of the string. I.e. any characters that an XML processor
* would recognize as markup are instead treated as literal text. See
* also the method <code>setAttribute</code> on the <code>Element</code>
* interface.
* @exception DOMException
* NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.
*/
public void setValue(String value) public void setValue(String value)
throws DOMException; throws DOMException;

4
java/external/src/org/w3c/dom/CDATASection.java vendored
View File

@ -24,8 +24,8 @@ package org.w3c.dom;
* contain characters that need to be escaped outside of CDATA sections and * contain characters that need to be escaped outside of CDATA sections and
* that, depending on the character encoding ("charset") chosen for * that, depending on the character encoding ("charset") chosen for
* serialization, it may be impossible to write out some characters as part * serialization, it may be impossible to write out some characters as part
* of a CDATA section. * of a CDATA section.
* <p> The <code>CDATASection</code> interface inherits from the * <p>The <code>CDATASection</code> interface inherits from the
* <code>CharacterData</code> interface through the <code>Text</code> * <code>CharacterData</code> interface through the <code>Text</code>
* interface. Adjacent <code>CDATASection</code> nodes are not merged by use * interface. Adjacent <code>CDATASection</code> nodes are not merged by use
* of the <code>normalize</code> method of the <code>Node</code> interface. * of the <code>normalize</code> method of the <code>Node</code> interface.

15
java/external/src/org/w3c/dom/CharacterData.java vendored
View File

@ -44,6 +44,21 @@ public interface CharacterData extends Node {
*/ */
public String getData() public String getData()
throws DOMException; throws DOMException;
/**
* The character data of the node that implements this interface. The DOM
* implementation may not put arbitrary limits on the amount of data
* that may be stored in a <code>CharacterData</code> node. However,
* implementation limits may mean that the entirety of a node's data may
* not fit into a single <code>DOMString</code>. In such cases, the user
* may call <code>substringData</code> to retrieve the data in
* appropriately sized pieces.
* @exception DOMException
* NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.
* @exception DOMException
* DOMSTRING_SIZE_ERR: Raised when it would return more characters than
* fit in a <code>DOMString</code> variable on the implementation
* platform.
*/
public void setData(String data) public void setData(String data)
throws DOMException; throws DOMException;

4
java/external/src/org/w3c/dom/DOMException.java vendored
View File

@ -18,10 +18,10 @@ package org.w3c.dom;
* because data is lost, or because the implementation has become unstable). * because data is lost, or because the implementation has become unstable).
* In general, DOM methods return specific error values in ordinary * In general, DOM methods return specific error values in ordinary
* processing situations, such as out-of-bound errors when using * processing situations, such as out-of-bound errors when using
* <code>NodeList</code>. * <code>NodeList</code>.
* <p>Implementations should raise other exceptions under other circumstances. * <p>Implementations should raise other exceptions under other circumstances.
* For example, implementations should raise an implementation-dependent * For example, implementations should raise an implementation-dependent
* exception if a <code>null</code> argument is passed. * exception if a <code>null</code> argument is passed.
* <p>Some languages and object systems do not support the concept of * <p>Some languages and object systems do not support the concept of
* exceptions. For such systems, error conditions may be indicated using * exceptions. For such systems, error conditions may be indicated using
* native error reporting mechanisms. For some bindings, for example, * native error reporting mechanisms. For some bindings, for example,

34
java/external/src/org/w3c/dom/DOMImplementation.java vendored
View File

@ -26,11 +26,7 @@ public interface DOMImplementation {
* specifications and listed in the section. The name must be an XML * specifications and listed in the section. The name must be an XML
* name. To avoid possible conflicts, as a convention, names referring * name. To avoid possible conflicts, as a convention, names referring
* to features defined outside the DOM specification should be made * to features defined outside the DOM specification should be made
* unique by reversing the name of the Internet domain name of the * unique.
* 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".
* @param version This is the version number of the feature to test. In * @param version This 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 * 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 * not specified, supporting any version of the feature causes the
@ -47,9 +43,8 @@ public interface DOMImplementation {
* default attribute additions do not occur. It is expected that a * default attribute additions do not occur. It is expected that a
* future version of the DOM will provide a way for populating a * future version of the DOM will provide a way for populating a
* <code>DocumentType</code>. * <code>DocumentType</code>.
* <br>HTML-only DOM implementations do not need to implement this method.
* @param qualifiedName The qualified name of the document type to be * @param qualifiedName The qualified name of the document type to be
* created. * created.
* @param publicId The external subset public identifier. * @param publicId The external subset public identifier.
* @param systemId The external subset system identifier. * @param systemId The external subset system identifier.
* @return A new <code>DocumentType</code> node with * @return A new <code>DocumentType</code> node with
@ -59,6 +54,12 @@ public interface DOMImplementation {
* contains an illegal character. * contains an illegal character.
* <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is * <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is
* malformed. * malformed.
* <br>NOT_SUPPORTED_ERR: May be raised by DOM implementations which do
* not support the <code>"XML"</code> feature, if they choose not to
* support this method. Other features introduced in the future, by
* the DOM WG or in extensions defined by other groups, may also
* demand support for this method; please consult the definition of
* the feature to see if it requires this method.
* @since DOM Level 2 * @since DOM Level 2
*/ */
public DocumentType createDocumentType(String qualifiedName, public DocumentType createDocumentType(String qualifiedName,
@ -67,10 +68,10 @@ public interface DOMImplementation {
throws DOMException; throws DOMException;
/** /**
* Creates an XML <code>Document</code> object of the specified type with * Creates a DOM Document object of the specified type with its document
* its document element. HTML-only DOM implementations do not need to * element.
* implement this method. * @param namespaceURI The namespace URI of the document element to
* @param namespaceURI The namespace URI of the document element to create. * create.
* @param qualifiedName The qualified name of the document element to be * @param qualifiedName The qualified name of the document element to be
* created. * created.
* @param doctype The type of document to be created or <code>null</code>. * @param doctype The type of document to be created or <code>null</code>.
@ -86,10 +87,19 @@ public interface DOMImplementation {
* <code>namespaceURI</code> is <code>null</code>, or if the * <code>namespaceURI</code> is <code>null</code>, or if the
* <code>qualifiedName</code> has a prefix that is "xml" and the * <code>qualifiedName</code> has a prefix that is "xml" and the
* <code>namespaceURI</code> is different from " * <code>namespaceURI</code> is different from "
* http://www.w3.org/XML/1998/namespace" . * http://www.w3.org/XML/1998/namespace" , or if the DOM
* implementation does not support the <code>"XML"</code> feature but
* a non-null namespace URI was provided, since namespaces were
* defined by XML.
* <br>WRONG_DOCUMENT_ERR: Raised if <code>doctype</code> has already * <br>WRONG_DOCUMENT_ERR: Raised if <code>doctype</code> has already
* been used with a different document or was created from a different * been used with a different document or was created from a different
* implementation. * implementation.
* <br>NOT_SUPPORTED_ERR: May be raised by DOM implementations which do
* not support the "XML" feature, if they choose not to support this
* method. Other features introduced in the future, by the DOM WG or
* in extensions defined by other groups, may also demand support for
* this method; please consult the definition of the feature to see if
* it requires this method.
* @since DOM Level 2 * @since DOM Level 2
*/ */
public Document createDocument(String namespaceURI, public Document createDocument(String namespaceURI,

121
java/external/src/org/w3c/dom/Document.java vendored
View File

@ -62,7 +62,7 @@ public interface Document extends Node {
* @param tagName The name of the element type to instantiate. For XML, * @param tagName The name of the element type to instantiate. For XML,
* this is case-sensitive. For HTML, the <code>tagName</code> * this is case-sensitive. For HTML, the <code>tagName</code>
* parameter may be provided in any case, but it must be mapped to the * parameter may be provided in any case, but it must be mapped to the
* canonical uppercase form by the DOM implementation. * canonical uppercase form by the DOM implementation.
* @return A new <code>Element</code> object with the * @return A new <code>Element</code> object with the
* <code>nodeName</code> attribute set to <code>tagName</code>, and * <code>nodeName</code> attribute set to <code>tagName</code>, and
* <code>localName</code>, <code>prefix</code>, and * <code>localName</code>, <code>prefix</code>, and
@ -75,7 +75,7 @@ public interface Document extends Node {
throws DOMException; throws DOMException;
/** /**
* Creates an empty <code>DocumentFragment</code> object. * Creates an empty <code>DocumentFragment</code> object.
* @return A new <code>DocumentFragment</code>. * @return A new <code>DocumentFragment</code>.
*/ */
public DocumentFragment createDocumentFragment(); public DocumentFragment createDocumentFragment();
@ -148,7 +148,7 @@ public interface Document extends Node {
* node is also unbound; (its <code>namespaceURI</code> is * node is also unbound; (its <code>namespaceURI</code> is
* <code>null</code>). The DOM Level 2 does not support any mechanism to * <code>null</code>). The DOM Level 2 does not support any mechanism to
* resolve namespace prefixes. * resolve namespace prefixes.
* @param name The name of the entity to reference. * @param name The name of the entity to reference.
* @return The new <code>EntityReference</code> object. * @return The new <code>EntityReference</code> object.
* @exception DOMException * @exception DOMException
* INVALID_CHARACTER_ERR: Raised if the specified name contains an * INVALID_CHARACTER_ERR: Raised if the specified name contains an
@ -161,7 +161,7 @@ public interface Document extends Node {
/** /**
* Returns a <code>NodeList</code> of all the <code>Elements</code> with a * Returns a <code>NodeList</code> of all the <code>Elements</code> with a
* given tag name in the order in which they are encountered in a * given tag name in the order in which they are encountered in a
* preorder traversal of the <code>Document</code> tree. * preorder traversal of the <code>Document</code> tree.
* @param tagname The name of the tag to match on. The special value "*" * @param tagname The name of the tag to match on. The special value "*"
* matches all tags. * matches all tags.
* @return A new <code>NodeList</code> object containing all the matched * @return A new <code>NodeList</code> object containing all the matched
@ -255,7 +255,7 @@ public interface Document extends Node {
* types of nodes inheriting from <code>CharacterData</code> copy their * types of nodes inheriting from <code>CharacterData</code> copy their
* <code>data</code> and <code>length</code> attributes from those of * <code>data</code> and <code>length</code> attributes from those of
* the source node.</dd> * the source node.</dd>
* * </dl>
* @param importedNode The node to import. * @param importedNode The node to import.
* @param deep If <code>true</code>, recursively import the subtree under * @param deep If <code>true</code>, recursively import the subtree under
* the specified node; if <code>false</code>, import only the node * the specified node; if <code>false</code>, import only the node
@ -272,28 +272,57 @@ public interface Document extends Node {
throws DOMException; throws DOMException;
/** /**
* Creates an element of the given qualified name and namespace URI. * Creates an element of the given qualified name and namespace URI.
* HTML-only DOM implementations do not need to implement this method.
* @param namespaceURI The namespace URI of the element to create. * @param namespaceURI The namespace URI of the element to create.
* @param qualifiedName The qualified name of the element type to * @param qualifiedName The qualified name of the element type to
* instantiate. * instantiate.
* @return A new <code>Element</code> object with the following * @return A new <code>Element</code> object with the following
* attributes:AttributeValue<code>Node.nodeName</code> * attributes:
* <code>qualifiedName</code><code>Node.namespaceURI</code> * <table border='1'>
* <code>namespaceURI</code><code>Node.prefix</code>prefix, extracted * <tr>
* <th>Attribute</th>
* <th>Value</th>
* </tr>
* <tr>
* <td valign='top' rowspan='1' colspan='1'><code>Node.nodeName</code></td>
* <td valign='top' rowspan='1' colspan='1'>
* <code>qualifiedName</code></td>
* </tr>
* <tr>
* <td valign='top' rowspan='1' colspan='1'><code>Node.namespaceURI</code></td>
* <td valign='top' rowspan='1' colspan='1'>
* <code>namespaceURI</code></td>
* </tr>
* <tr>
* <td valign='top' rowspan='1' colspan='1'><code>Node.prefix</code></td>
* <td valign='top' rowspan='1' colspan='1'>prefix, extracted
* from <code>qualifiedName</code>, or <code>null</code> if there is * from <code>qualifiedName</code>, or <code>null</code> if there is
* no prefix<code>Node.localName</code>local name, extracted from * no prefix</td>
* <code>qualifiedName</code><code>Element.tagName</code> * </tr>
* <code>qualifiedName</code> * <tr>
* <td valign='top' rowspan='1' colspan='1'><code>Node.localName</code></td>
* <td valign='top' rowspan='1' colspan='1'>local name, extracted from
* <code>qualifiedName</code></td>
* </tr>
* <tr>
* <td valign='top' rowspan='1' colspan='1'><code>Element.tagName</code></td>
* <td valign='top' rowspan='1' colspan='1'>
* <code>qualifiedName</code></td>
* </tr>
* </table>
* @exception DOMException * @exception DOMException
* INVALID_CHARACTER_ERR: Raised if the specified qualified name * INVALID_CHARACTER_ERR: Raised if the specified qualified name
* contains an illegal character. * contains an illegal character, per the XML 1.0 specification .
* <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is * <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is
* malformed, if the <code>qualifiedName</code> has a prefix and the * malformed per the Namespaces in XML specification, if the
* <code>qualifiedName</code> has a prefix and the
* <code>namespaceURI</code> is <code>null</code>, or if the * <code>namespaceURI</code> is <code>null</code>, or if the
* <code>qualifiedName</code> has a prefix that is "xml" and the * <code>qualifiedName</code> has a prefix that is "xml" and the
* <code>namespaceURI</code> is different from " * <code>namespaceURI</code> is different from "
* http://www.w3.org/XML/1998/namespace" . * http://www.w3.org/XML/1998/namespace" .
* <br>NOT_SUPPORTED_ERR: Always thrown if the current document does not
* support the <code>"XML"</code> feature, since namespaces were
* defined by XML.
* @since DOM Level 2 * @since DOM Level 2
*/ */
public Element createElementNS(String namespaceURI, public Element createElementNS(String namespaceURI,
@ -301,31 +330,65 @@ public interface Document extends Node {
throws DOMException; throws DOMException;
/** /**
* Creates an attribute of the given qualified name and namespace URI. * Creates an attribute of the given qualified name and namespace URI.
* HTML-only DOM implementations do not need to implement this method.
* @param namespaceURI The namespace URI of the attribute to create. * @param namespaceURI The namespace URI of the attribute to create.
* @param qualifiedName The qualified name of the attribute to instantiate. * @param qualifiedName The qualified name of the attribute to
* instantiate.
* @return A new <code>Attr</code> object with the following attributes: * @return A new <code>Attr</code> object with the following attributes:
* AttributeValue<code>Node.nodeName</code>qualifiedName * <table border='1'>
* <code>Node.namespaceURI</code><code>namespaceURI</code> * <tr>
* <code>Node.prefix</code>prefix, extracted from * <th>
* Attribute</th>
* <th>Value</th>
* </tr>
* <tr>
* <td valign='top' rowspan='1' colspan='1'><code>Node.nodeName</code></td>
* <td valign='top' rowspan='1' colspan='1'>qualifiedName</td>
* </tr>
* <tr>
* <td valign='top' rowspan='1' colspan='1'>
* <code>Node.namespaceURI</code></td>
* <td valign='top' rowspan='1' colspan='1'><code>namespaceURI</code></td>
* </tr>
* <tr>
* <td valign='top' rowspan='1' colspan='1'>
* <code>Node.prefix</code></td>
* <td valign='top' rowspan='1' colspan='1'>prefix, extracted from
* <code>qualifiedName</code>, or <code>null</code> if there is no * <code>qualifiedName</code>, or <code>null</code> if there is no
* prefix<code>Node.localName</code>local name, extracted from * prefix</td>
* <code>qualifiedName</code><code>Attr.name</code> * </tr>
* <code>qualifiedName</code><code>Node.nodeValue</code>the empty * <tr>
* string * <td valign='top' rowspan='1' colspan='1'><code>Node.localName</code></td>
* <td valign='top' rowspan='1' colspan='1'>local name, extracted from
* <code>qualifiedName</code></td>
* </tr>
* <tr>
* <td valign='top' rowspan='1' colspan='1'><code>Attr.name</code></td>
* <td valign='top' rowspan='1' colspan='1'>
* <code>qualifiedName</code></td>
* </tr>
* <tr>
* <td valign='top' rowspan='1' colspan='1'><code>Node.nodeValue</code></td>
* <td valign='top' rowspan='1' colspan='1'>the empty
* string</td>
* </tr>
* </table>
* @exception DOMException * @exception DOMException
* INVALID_CHARACTER_ERR: Raised if the specified qualified name * INVALID_CHARACTER_ERR: Raised if the specified qualified name
* contains an illegal character. * contains an illegal character, per the XML 1.0 specification .
* <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is * <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is
* malformed, if the <code>qualifiedName</code> has a prefix and the * malformed per the Namespaces in XML specification, if the
* <code>qualifiedName</code> has a prefix and the
* <code>namespaceURI</code> is <code>null</code>, if the * <code>namespaceURI</code> is <code>null</code>, if the
* <code>qualifiedName</code> has a prefix that is "xml" and the * <code>qualifiedName</code> has a prefix that is "xml" and the
* <code>namespaceURI</code> is different from " * <code>namespaceURI</code> is different from "
* http://www.w3.org/XML/1998/namespace", or if the * http://www.w3.org/XML/1998/namespace", or if the
* <code>qualifiedName</code> is "xmlns" and the * <code>qualifiedName</code>, or its prefix, is "xmlns" and the
* <code>namespaceURI</code> is different from " * <code>namespaceURI</code> is different from "
* http://www.w3.org/2000/xmlns/". * http://www.w3.org/2000/xmlns/".
* <br>NOT_SUPPORTED_ERR: Always thrown if the current document does not
* support the <code>"XML"</code> feature, since namespaces were
* defined by XML.
* @since DOM Level 2 * @since DOM Level 2
*/ */
public Attr createAttributeNS(String namespaceURI, public Attr createAttributeNS(String namespaceURI,
@ -355,7 +418,7 @@ public interface Document extends Node {
* information that says which attributes are of type ID. Attributes * information that says which attributes are of type ID. Attributes
* with the name "ID" are not of type ID unless so defined. * with the name "ID" are not of type ID unless so defined.
* Implementations that do not know whether attributes are of type ID or * Implementations that do not know whether attributes are of type ID or
* not are expected to return <code>null</code>. * not are expected to return <code>null</code>.
* @param elementId The unique <code>id</code> value for an element. * @param elementId The unique <code>id</code> value for an element.
* @return The matching element. * @return The matching element.
* @since DOM Level 2 * @since DOM Level 2

9
java/external/src/org/w3c/dom/DocumentType.java vendored
View File

@ -68,10 +68,11 @@ public interface DocumentType extends Node {
public String getSystemId(); public String getSystemId();
/** /**
* The internal subset as a string. The actual content returned depends on * The internal subset as a string, or <code>null</code> if there is none.
* how much information is available to the implementation. This may * This is does not contain the delimiting square brackets.The actual
* vary depending on various parameters, including the XML processor * content returned depends on how much information is available to the
* used to build the document. * implementation. This may vary depending on various parameters,
* including the XML processor used to build the document.
* @since DOM Level 2 * @since DOM Level 2
*/ */
public String getInternalSubset(); public String getInternalSubset();

48
java/external/src/org/w3c/dom/Element.java vendored
View File

@ -39,7 +39,7 @@ public interface Element extends Node {
* case-preserving in XML, as are all of the operations of the DOM. The * case-preserving in XML, as are all of the operations of the DOM. The
* HTML DOM returns the <code>tagName</code> of an HTML element in the * HTML DOM returns the <code>tagName</code> of an HTML element in the
* canonical uppercase form, regardless of the case in the source HTML * canonical uppercase form, regardless of the case in the source HTML
* document. * document.
*/ */
public String getTagName(); public String getTagName();
@ -151,8 +151,11 @@ public interface Element extends Node {
public NodeList getElementsByTagName(String name); public NodeList getElementsByTagName(String name);
/** /**
* Retrieves an attribute value by local name and namespace URI. HTML-only * Retrieves an attribute value by local name and namespace URI.
* DOM implementations do not need to implement this method. * <br>Documents which do not support the "XML" feature will permit only
* the DOM Level 1 calls for creating/setting elements and attributes.
* Hence, if you specify a non-null namespace URI, these DOMs will never
* find a matching node.
* @param namespaceURI The namespace URI of the attribute to retrieve. * @param namespaceURI The namespace URI of the attribute to retrieve.
* @param localName The local name of the attribute to retrieve. * @param localName The local name of the attribute to retrieve.
* @return The <code>Attr</code> value as a string, or the empty string * @return The <code>Attr</code> value as a string, or the empty string
@ -177,7 +180,6 @@ public interface Element extends Node {
* and use <code>setAttributeNodeNS</code> or * and use <code>setAttributeNodeNS</code> or
* <code>setAttributeNode</code> to assign it as the value of an * <code>setAttributeNode</code> to assign it as the value of an
* attribute. * attribute.
* <br>HTML-only DOM implementations do not need to implement this method.
* @param namespaceURI The namespace URI of the attribute to create or * @param namespaceURI The namespace URI of the attribute to create or
* alter. * alter.
* @param qualifiedName The qualified name of the attribute to create or * @param qualifiedName The qualified name of the attribute to create or
@ -185,17 +187,21 @@ public interface Element extends Node {
* @param value The value to set in string form. * @param value The value to set in string form.
* @exception DOMException * @exception DOMException
* INVALID_CHARACTER_ERR: Raised if the specified qualified name * INVALID_CHARACTER_ERR: Raised if the specified qualified name
* contains an illegal character. * contains an illegal character, per the XML 1.0 specification .
* <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
* <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is * <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is
* malformed, if the <code>qualifiedName</code> has a prefix and the * malformed per the Namespaces in XML specification, if the
* <code>qualifiedName</code> has a prefix and the
* <code>namespaceURI</code> is <code>null</code>, if the * <code>namespaceURI</code> is <code>null</code>, if the
* <code>qualifiedName</code> has a prefix that is "xml" and the * <code>qualifiedName</code> has a prefix that is "xml" and the
* <code>namespaceURI</code> is different from " * <code>namespaceURI</code> is different from "
* http://www.w3.org/XML/1998/namespace", or if the * http://www.w3.org/XML/1998/namespace", or if the
* <code>qualifiedName</code> is "xmlns" and the * <code>qualifiedName</code>, or its prefix, is "xmlns" and the
* <code>namespaceURI</code> is different from " * <code>namespaceURI</code> is different from "
* http://www.w3.org/2000/xmlns/". * http://www.w3.org/2000/xmlns/".
* <br>NOT_SUPPORTED_ERR: Always thrown if the current document does not
* support the <code>"XML"</code> feature, since namespaces were
* defined by XML.
* @since DOM Level 2 * @since DOM Level 2
*/ */
public void setAttributeNS(String namespaceURI, public void setAttributeNS(String namespaceURI,
@ -208,7 +214,10 @@ public interface Element extends Node {
* attribute has a default value it is immediately replaced. The * attribute has a default value it is immediately replaced. The
* replacing attribute has the same namespace URI and local name, as * replacing attribute has the same namespace URI and local name, as
* well as the original prefix. * well as the original prefix.
* <br>HTML-only DOM implementations do not need to implement this method. * <br>Documents which do not support the "XML" feature will permit only
* the DOM Level 1 calls for creating/setting elements and attributes.
* Hence, if you specify a non-null namespace URI, these DOMs will never
* find a matching node.
* @param namespaceURI The namespace URI of the attribute to remove. * @param namespaceURI The namespace URI of the attribute to remove.
* @param localName The local name of the attribute to remove. * @param localName The local name of the attribute to remove.
* @exception DOMException * @exception DOMException
@ -220,8 +229,11 @@ public interface Element extends Node {
throws DOMException; throws DOMException;
/** /**
* Retrieves an <code>Attr</code> node by local name and namespace URI. * Retrieves an <code>Attr</code> node by local name and namespace URI.
* HTML-only DOM implementations do not need to implement this method. * <br>Documents which do not support the "XML" feature will permit only
* the DOM Level 1 calls for creating/setting elements and attributes.
* Hence, if you specify a non-null namespace URI, these DOMs will never
* find a matching node.
* @param namespaceURI The namespace URI of the attribute to retrieve. * @param namespaceURI The namespace URI of the attribute to retrieve.
* @param localName The local name of the attribute to retrieve. * @param localName The local name of the attribute to retrieve.
* @return The <code>Attr</code> node with the specified attribute local * @return The <code>Attr</code> node with the specified attribute local
@ -236,7 +248,6 @@ public interface Element extends Node {
* Adds a new attribute. If an attribute with that local name and that * Adds a new attribute. If an attribute with that local name and that
* namespace URI is already present in the element, it is replaced by * namespace URI is already present in the element, it is replaced by
* the new one. * the new one.
* <br>HTML-only DOM implementations do not need to implement this method.
* @param newAttr The <code>Attr</code> node to add to the attribute list. * @param newAttr The <code>Attr</code> node to add to the attribute list.
* @return If the <code>newAttr</code> attribute replaces an existing * @return If the <code>newAttr</code> attribute replaces an existing
* attribute with the same local name and namespace URI, the replaced * attribute with the same local name and namespace URI, the replaced
@ -250,6 +261,9 @@ public interface Element extends Node {
* attribute of another <code>Element</code> object. The DOM user must * attribute of another <code>Element</code> object. The DOM user must
* explicitly clone <code>Attr</code> nodes to re-use them in other * explicitly clone <code>Attr</code> nodes to re-use them in other
* elements. * elements.
* <br>NOT_SUPPORTED_ERR: Always thrown if the current document does not
* support the <code>"XML"</code> feature, since namespaces were
* defined by XML.
* @since DOM Level 2 * @since DOM Level 2
*/ */
public Attr setAttributeNodeNS(Attr newAttr) public Attr setAttributeNodeNS(Attr newAttr)
@ -260,7 +274,10 @@ public interface Element extends Node {
* <code>Elements</code> with a given local name and namespace URI in * <code>Elements</code> with a given local name and namespace URI in
* the order in which they are encountered in a preorder traversal of * the order in which they are encountered in a preorder traversal of
* this <code>Element</code> tree. * this <code>Element</code> tree.
* <br>HTML-only DOM implementations do not need to implement this method. * <br>Documents which do not support the "XML" feature will permit only
* the DOM Level 1 calls for creating/setting elements and attributes.
* Hence, if you specify a non-null namespace URI, these DOMs will never
* find a matching node.
* @param namespaceURI The namespace URI of the elements to match on. The * @param namespaceURI The namespace URI of the elements to match on. The
* special value "*" matches all namespaces. * special value "*" matches all namespaces.
* @param localName The local name of the elements to match on. The * @param localName The local name of the elements to match on. The
@ -287,8 +304,11 @@ public interface Element extends Node {
/** /**
* Returns <code>true</code> when an attribute with a given local name and * Returns <code>true</code> when an attribute with a given local name and
* namespace URI is specified on this element or has a default value, * namespace URI is specified on this element or has a default value,
* <code>false</code> otherwise. HTML-only DOM implementations do not * <code>false</code> otherwise.
* need to implement this method. * <br>Documents which do not support the "XML" feature will permit only
* the DOM Level 1 calls for creating/setting elements and attributes.
* Hence, if you specify a non-null namespace URI, these DOMs will never
* find a matching node.
* @param namespaceURI The namespace URI of the attribute to look for. * @param namespaceURI The namespace URI of the attribute to look for.
* @param localName The local name of the attribute to look for. * @param localName The local name of the attribute to look for.
* @return <code>true</code> if an attribute with the given local name * @return <code>true</code> if an attribute with the given local name

2
java/external/src/org/w3c/dom/Entity.java vendored
View File

@ -61,7 +61,7 @@ public interface Entity extends Node {
/** /**
* For unparsed entities, the name of the notation for the entity. For * For unparsed entities, the name of the notation for the entity. For
* parsed entities, this is <code>null</code>. * parsed entities, this is <code>null</code>.
*/ */
public String getNotationName(); public String getNotationName();

28
java/external/src/org/w3c/dom/NamedNodeMap.java vendored
View File

@ -56,6 +56,11 @@ public interface NamedNodeMap {
* <code>Attr</code> that is already an attribute of another * <code>Attr</code> that is already an attribute of another
* <code>Element</code> object. The DOM user must explicitly clone * <code>Element</code> object. The DOM user must explicitly clone
* <code>Attr</code> nodes to re-use them in other elements. * <code>Attr</code> nodes to re-use them in other elements.
* <br>HIERARCHY_REQUEST_ERR: Raised if an attempt is made to add a node
* doesn't belong in this NamedNodeMap. Examples would include trying
* to insert something other than an Attr node into an Element's map
* of attributes, or a non-Entity node into the DocumentType's map of
* Entities.
*/ */
public Node setNamedItem(Node arg) public Node setNamedItem(Node arg)
throws DOMException; throws DOMException;
@ -89,13 +94,16 @@ public interface NamedNodeMap {
/** /**
* The number of nodes in this map. The range of valid child node indices * The number of nodes in this map. The range of valid child node indices
* is <code>0</code> to <code>length-1</code> inclusive. * is <code>0</code> to <code>length-1</code> inclusive.
*/ */
public int getLength(); public int getLength();
/** /**
* Retrieves a node specified by local name and namespace URI. HTML-only * Retrieves a node specified by local name and namespace URI.
* DOM implementations do not need to implement this method. * <br>Documents which do not support the "XML" feature will permit only
* the DOM Level 1 calls for creating/setting elements and attributes.
* Hence, if you specify a non-null namespace URI, these DOMs will never
* find a matching node.
* @param namespaceURI The namespace URI of the node to retrieve. * @param namespaceURI The namespace URI of the node to retrieve.
* @param localName The local name of the node to retrieve. * @param localName The local name of the node to retrieve.
* @return A <code>Node</code> (of any type) with the specified local * @return A <code>Node</code> (of any type) with the specified local
@ -111,7 +119,6 @@ public interface NamedNodeMap {
* <code>localName</code>. If a node with that namespace URI and that * <code>localName</code>. If a node with that namespace URI and that
* local name is already present in this map, it is replaced by the new * local name is already present in this map, it is replaced by the new
* one. * one.
* <br>HTML-only DOM implementations do not need to implement this method.
* @param arg A node to store in this map. The node will later be * @param arg A node to store in this map. The node will later be
* accessible using the value of its <code>namespaceURI</code> and * accessible using the value of its <code>namespaceURI</code> and
* <code>localName</code> attributes. * <code>localName</code> attributes.
@ -126,6 +133,14 @@ public interface NamedNodeMap {
* <code>Attr</code> that is already an attribute of another * <code>Attr</code> that is already an attribute of another
* <code>Element</code> object. The DOM user must explicitly clone * <code>Element</code> object. The DOM user must explicitly clone
* <code>Attr</code> nodes to re-use them in other elements. * <code>Attr</code> nodes to re-use them in other elements.
* <br>HIERARCHY_REQUEST_ERR: Raised if an attempt is made to add a node
* doesn't belong in this NamedNodeMap. Examples would include trying
* to insert something other than an Attr node into an Element's map
* of attributes, or a non-Entity node into the DocumentType's map of
* Entities.
* <br>NOT_SUPPORTED_ERR: Always thrown if the current document does not
* support the <code>"XML"</code> feature, since namespaces were
* defined by XML.
* @since DOM Level 2 * @since DOM Level 2
*/ */
public Node setNamedItemNS(Node arg) public Node setNamedItemNS(Node arg)
@ -138,7 +153,10 @@ public interface NamedNodeMap {
* attribute of the <code>Node</code> interface. If so, an attribute * attribute of the <code>Node</code> interface. If so, an attribute
* immediately appears containing the default value as well as the * immediately appears containing the default value as well as the
* corresponding namespace URI, local name, and prefix when applicable. * corresponding namespace URI, local name, and prefix when applicable.
* <br>HTML-only DOM implementations do not need to implement this method. * <br>Documents which do not support the "XML" feature will permit only
* the DOM Level 1 calls for creating/setting elements and attributes.
* Hence, if you specify a non-null namespace URI, these DOMs will never
* find a matching node.
* @param namespaceURI The namespace URI of the node to remove. * @param namespaceURI The namespace URI of the node to remove.
* @param localName The local name of the node to remove. * @param localName The local name of the node to remove.
* @return The node removed from this map if a node with such a local * @return The node removed from this map if a node with such a local

176
java/external/src/org/w3c/dom/Node.java vendored
View File

@ -29,6 +29,97 @@ package org.w3c.dom;
* ), this returns <code>null</code>. Note that the specialized interfaces * ), this returns <code>null</code>. Note that the specialized interfaces
* may contain additional and more convenient mechanisms to get and set the * may contain additional and more convenient mechanisms to get and set the
* relevant information. * relevant information.
* <p>The values of <code>nodeName</code>,
* <code>nodeValue</code>, and <code>attributes</code> vary according to the
* node type as follows:
* <table border='1'>
* <tr>
* <th>Interface</th>
* <th>nodeName</th>
* <th>nodeValue</th>
* <th>attributes</th>
* </tr>
* <tr>
* <td valign='top' rowspan='1' colspan='1'>Attr</td>
* <td valign='top' rowspan='1' colspan='1'>name of
* attribute</td>
* <td valign='top' rowspan='1' colspan='1'>value of attribute</td>
* <td valign='top' rowspan='1' colspan='1'>null</td>
* </tr>
* <tr>
* <td valign='top' rowspan='1' colspan='1'>CDATASection</td>
* <td valign='top' rowspan='1' colspan='1'><code>"#cdata-section"</code></td>
* <td valign='top' rowspan='1' colspan='1'>
* content of the CDATA Section</td>
* <td valign='top' rowspan='1' colspan='1'>null</td>
* </tr>
* <tr>
* <td valign='top' rowspan='1' colspan='1'>Comment</td>
* <td valign='top' rowspan='1' colspan='1'><code>"#comment"</code></td>
* <td valign='top' rowspan='1' colspan='1'>content of
* the comment</td>
* <td valign='top' rowspan='1' colspan='1'>null</td>
* </tr>
* <tr>
* <td valign='top' rowspan='1' colspan='1'>Document</td>
* <td valign='top' rowspan='1' colspan='1'><code>"#document"</code></td>
* <td valign='top' rowspan='1' colspan='1'>null</td>
* <td valign='top' rowspan='1' colspan='1'>null</td>
* </tr>
* <tr>
* <td valign='top' rowspan='1' colspan='1'>DocumentFragment</td>
* <td valign='top' rowspan='1' colspan='1'>
* <code>"#document-fragment"</code></td>
* <td valign='top' rowspan='1' colspan='1'>null</td>
* <td valign='top' rowspan='1' colspan='1'>null</td>
* </tr>
* <tr>
* <td valign='top' rowspan='1' colspan='1'>DocumentType</td>
* <td valign='top' rowspan='1' colspan='1'>document type name</td>
* <td valign='top' rowspan='1' colspan='1'>
* null</td>
* <td valign='top' rowspan='1' colspan='1'>null</td>
* </tr>
* <tr>
* <td valign='top' rowspan='1' colspan='1'>Element</td>
* <td valign='top' rowspan='1' colspan='1'>tag name</td>
* <td valign='top' rowspan='1' colspan='1'>null</td>
* <td valign='top' rowspan='1' colspan='1'>NamedNodeMap</td>
* </tr>
* <tr>
* <td valign='top' rowspan='1' colspan='1'>Entity</td>
* <td valign='top' rowspan='1' colspan='1'>entity name</td>
* <td valign='top' rowspan='1' colspan='1'>null</td>
* <td valign='top' rowspan='1' colspan='1'>null</td>
* </tr>
* <tr>
* <td valign='top' rowspan='1' colspan='1'>
* EntityReference</td>
* <td valign='top' rowspan='1' colspan='1'>name of entity referenced</td>
* <td valign='top' rowspan='1' colspan='1'>null</td>
* <td valign='top' rowspan='1' colspan='1'>null</td>
* </tr>
* <tr>
* <td valign='top' rowspan='1' colspan='1'>Notation</td>
* <td valign='top' rowspan='1' colspan='1'>notation name</td>
* <td valign='top' rowspan='1' colspan='1'>null</td>
* <td valign='top' rowspan='1' colspan='1'>
* null</td>
* </tr>
* <tr>
* <td valign='top' rowspan='1' colspan='1'>ProcessingInstruction</td>
* <td valign='top' rowspan='1' colspan='1'>target</td>
* <td valign='top' rowspan='1' colspan='1'>entire content excluding the target</td>
* <td valign='top' rowspan='1' colspan='1'>null</td>
* </tr>
* <tr>
* <td valign='top' rowspan='1' colspan='1'>Text</td>
* <td valign='top' rowspan='1' colspan='1'>
* <code>"#text"</code></td>
* <td valign='top' rowspan='1' colspan='1'>content of the text node</td>
* <td valign='top' rowspan='1' colspan='1'>null</td>
* </tr>
* </table>
* <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113'>Document Object Model (DOM) Level 2 Core Specification</a>. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113'>Document Object Model (DOM) Level 2 Core Specification</a>.
*/ */
public interface Node { public interface Node {
@ -83,7 +174,7 @@ public interface Node {
public static final short NOTATION_NODE = 12; public static final short NOTATION_NODE = 12;
/** /**
* The name of this node, depending on its type; see the table above. * The name of this node, depending on its type; see the table above.
*/ */
public String getNodeName(); public String getNodeName();
@ -99,6 +190,16 @@ public interface Node {
*/ */
public String getNodeValue() public String getNodeValue()
throws DOMException; throws DOMException;
/**
* The value of this node, depending on its type; see the table above.
* When it is defined to be <code>null</code>, setting it has no effect.
* @exception DOMException
* NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.
* @exception DOMException
* DOMSTRING_SIZE_ERR: Raised when it would return more characters than
* fit in a <code>DOMString</code> variable on the implementation
* platform.
*/
public void setNodeValue(String nodeValue) public void setNodeValue(String nodeValue)
throws DOMException; throws DOMException;
@ -150,7 +251,7 @@ public interface Node {
/** /**
* A <code>NamedNodeMap</code> containing the attributes of this node (if * A <code>NamedNodeMap</code> containing the attributes of this node (if
* it is an <code>Element</code>) or <code>null</code> otherwise. * it is an <code>Element</code>) or <code>null</code> otherwise.
*/ */
public NamedNodeMap getAttributes(); public NamedNodeMap getAttributes();
@ -173,13 +274,14 @@ public interface Node {
* <code>refChild</code>. If the <code>newChild</code> is already in the * <code>refChild</code>. If the <code>newChild</code> is already in the
* tree, it is first removed. * tree, it is first removed.
* @param newChild The node to insert. * @param newChild The node to insert.
* @param refChild The reference node, i.e., the node before which the new * @param refChild The reference node, i.e., the node before which the
* node must be inserted. * new node must be inserted.
* @return The node being inserted. * @return The node being inserted.
* @exception DOMException * @exception DOMException
* HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not * HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not
* allow children of the type of the <code>newChild</code> node, or if * allow children of the type of the <code>newChild</code> node, or if
* the node to insert is one of this node's ancestors. * the node to insert is one of this node's ancestors or this node
* itself.
* <br>WRONG_DOCUMENT_ERR: Raised if <code>newChild</code> was created * <br>WRONG_DOCUMENT_ERR: Raised if <code>newChild</code> was created
* from a different document than the one that created this node. * from a different document than the one that created this node.
* <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly or * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly or
@ -205,7 +307,8 @@ public interface Node {
* @exception DOMException * @exception DOMException
* HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not * HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not
* allow children of the type of the <code>newChild</code> node, or if * allow children of the type of the <code>newChild</code> node, or if
* the node to put in is one of this node's ancestors. * the node to put in is one of this node's ancestors or this node
* itself.
* <br>WRONG_DOCUMENT_ERR: Raised if <code>newChild</code> was created * <br>WRONG_DOCUMENT_ERR: Raised if <code>newChild</code> was created
* from a different document than the one that created this node. * from a different document than the one that created this node.
* <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node or the parent of * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node or the parent of
@ -234,24 +337,26 @@ public interface Node {
* Adds the node <code>newChild</code> to the end of the list of children * Adds the node <code>newChild</code> to the end of the list of children
* of this node. If the <code>newChild</code> is already in the tree, it * of this node. If the <code>newChild</code> is already in the tree, it
* is first removed. * is first removed.
* @param newChild The node to add.If it is a <code>DocumentFragment</code> * @param newChild The node to add.If it is a
* object, the entire contents of the document fragment are moved * <code>DocumentFragment</code> object, the entire contents of the
* into the child list of this node * document fragment are moved into the child list of this node
* @return The node added. * @return The node added.
* @exception DOMException * @exception DOMException
* HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not * HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not
* allow children of the type of the <code>newChild</code> node, or if * allow children of the type of the <code>newChild</code> node, or if
* the node to append is one of this node's ancestors. * the node to append is one of this node's ancestors or this node
* itself.
* <br>WRONG_DOCUMENT_ERR: Raised if <code>newChild</code> was created * <br>WRONG_DOCUMENT_ERR: Raised if <code>newChild</code> was created
* from a different document than the one that created this node. * from a different document than the one that created this node.
* <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly or
* if the previous parent of the node being inserted is readonly.
*/ */
public Node appendChild(Node newChild) public Node appendChild(Node newChild)
throws DOMException; throws DOMException;
/** /**
* Returns whether this node has any children. * Returns whether this node has any children.
* @return <code>true</code> if this node has any children, * @return <code>true</code> if this node has any children,
* <code>false</code> otherwise. * <code>false</code> otherwise.
*/ */
public boolean hasChildNodes(); public boolean hasChildNodes();
@ -277,7 +382,7 @@ public interface Node {
* <code>Notation</code> nodes is implementation dependent. * <code>Notation</code> nodes is implementation dependent.
* @param deep If <code>true</code>, recursively clone the subtree under * @param deep If <code>true</code>, recursively clone the subtree under
* the specified node; if <code>false</code>, clone only the node * the specified node; if <code>false</code>, clone only the node
* itself (and its attributes, if it is an <code>Element</code>). * itself (and its attributes, if it is an <code>Element</code>).
* @return The duplicate node. * @return The duplicate node.
*/ */
public Node cloneNode(boolean deep); public Node cloneNode(boolean deep);
@ -352,20 +457,51 @@ public interface Node {
* <code>Document</code> interface, this is always <code>null</code>. * <code>Document</code> interface, this is always <code>null</code>.
* @exception DOMException * @exception DOMException
* INVALID_CHARACTER_ERR: Raised if the specified prefix contains an * INVALID_CHARACTER_ERR: Raised if the specified prefix contains an
* illegal character. * illegal character, per the XML 1.0 specification .
* <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
* <br>NAMESPACE_ERR: Raised if the specified <code>prefix</code> is * <br>NAMESPACE_ERR: Raised if the specified <code>prefix</code> is
* malformed, if the <code>namespaceURI</code> of this node is * malformed per the Namespaces in XML specification, if the
* <code>null</code>, if the specified prefix is "xml" and the * <code>namespaceURI</code> of this node is <code>null</code>, if the
* <code>namespaceURI</code> of this node is different from " * specified prefix is "xml" and the <code>namespaceURI</code> of this
* http://www.w3.org/XML/1998/namespace", if this node is an attribute * node is different from "http://www.w3.org/XML/1998/namespace", if
* and the specified prefix is "xmlns" and the * this node is an attribute and the specified prefix is "xmlns" and
* <code>namespaceURI</code> of this node is different from " * the <code>namespaceURI</code> of this node is different from "
* http://www.w3.org/2000/xmlns/", or if this node is an attribute and * http://www.w3.org/2000/xmlns/", or if this node is an attribute and
* the <code>qualifiedName</code> of this node is "xmlns" . * the <code>qualifiedName</code> of this node is "xmlns" .
* @since DOM Level 2 * @since DOM Level 2
*/ */
public String getPrefix(); public String getPrefix();
/**
* The namespace prefix of this node, or <code>null</code> if it is
* unspecified.
* <br>Note that setting this attribute, when permitted, changes the
* <code>nodeName</code> attribute, which holds the qualified name, as
* well as the <code>tagName</code> and <code>name</code> attributes of
* the <code>Element</code> and <code>Attr</code> interfaces, when
* applicable.
* <br>Note also that changing the prefix of an attribute that is known to
* have a default value, does not make a new attribute with the default
* value and the original prefix appear, since the
* <code>namespaceURI</code> and <code>localName</code> do not change.
* <br>For nodes of any type other than <code>ELEMENT_NODE</code> and
* <code>ATTRIBUTE_NODE</code> and nodes created with a DOM Level 1
* method, such as <code>createElement</code> from the
* <code>Document</code> interface, this is always <code>null</code>.
* @exception DOMException
* INVALID_CHARACTER_ERR: Raised if the specified prefix contains an
* illegal character, per the XML 1.0 specification .
* <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
* <br>NAMESPACE_ERR: Raised if the specified <code>prefix</code> is
* malformed per the Namespaces in XML specification, if the
* <code>namespaceURI</code> of this node is <code>null</code>, if the
* specified prefix is "xml" and the <code>namespaceURI</code> of this
* node is different from "http://www.w3.org/XML/1998/namespace", if
* this node is an attribute and the specified prefix is "xmlns" and
* the <code>namespaceURI</code> of this node is different from "
* http://www.w3.org/2000/xmlns/", or if this node is an attribute and
* the <code>qualifiedName</code> of this node is "xmlns" .
* @since DOM Level 2
*/
public void setPrefix(String prefix) public void setPrefix(String prefix)
throws DOMException; throws DOMException;

2
java/external/src/org/w3c/dom/NodeList.java vendored
View File

@ -34,7 +34,7 @@ public interface NodeList {
/** /**
* The number of nodes in the list. The range of valid child node indices * The number of nodes in the list. The range of valid child node indices
* is 0 to <code>length-1</code> inclusive. * is 0 to <code>length-1</code> inclusive.
*/ */
public int getLength(); public int getLength();

7
java/external/src/org/w3c/dom/ProcessingInstruction.java vendored
View File

@ -34,6 +34,13 @@ public interface ProcessingInstruction extends Node {
* NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly. * NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.
*/ */
public String getData(); public String getData();
/**
* The content of this processing instruction. This is from the first non
* white space character after the target to the character immediately
* preceding the <code>?&gt;</code>.
* @exception DOMException
* NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.
*/
public void setData(String data) public void setData(String data)
throws DOMException; throws DOMException;

854
java/external/src/org/w3c/dom/css/CSS2Properties.java vendored
View File

File diff suppressed because it is too large Load Diff

8
java/external/src/org/w3c/dom/css/CSSCharsetRule.java vendored
View File

@ -42,6 +42,14 @@ public interface CSSCharsetRule extends CSSRule {
* readonly. * readonly.
*/ */
public String getEncoding(); public String getEncoding();
/**
* The encoding information used in this <code>@charset</code> rule.
* @exception DOMException
* SYNTAX_ERR: Raised if the specified encoding value has a syntax error
* and is unparsable.
* <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this encoding rule is
* readonly.
*/
public void setEncoding(String encoding) public void setEncoding(String encoding)
throws DOMException; throws DOMException;

14
java/external/src/org/w3c/dom/css/CSSMediaRule.java vendored
View File

@ -35,14 +35,14 @@ public interface CSSMediaRule extends CSSRule {
/** /**
* Used to insert a new rule into the media block. * Used to insert a new rule into the media block.
* @param rule The parsable text representing the rule. For rule sets * @param rule The parsable text representing the rule. For rule sets
* this contains both the selector and the style declaration. For * this contains both the selector and the style declaration. For
* at-rules, this specifies both the at-identifier and the rule * at-rules, this specifies both the at-identifier and the rule
* content. * content.
* @param index The index within the media block's rule collection of the * @param index The index within the media block's rule collection of
* rule before which to insert the specified rule. If the specified * the rule before which to insert the specified rule. If the
* index is equal to the length of the media blocks's rule collection, * specified index is equal to the length of the media blocks's rule
* the rule will be added to the end of the media block. * collection, the rule will be added to the end of the media block.
* @return The index within the media block's rule collection of the * @return The index within the media block's rule collection of the
* newly inserted rule. * newly inserted rule.
* @exception DOMException * @exception DOMException
@ -62,8 +62,8 @@ public interface CSSMediaRule extends CSSRule {
/** /**
* Used to delete a rule from the media block. * Used to delete a rule from the media block.
* @param index The index within the media block's rule collection of the * @param index The index within the media block's rule collection of
* rule to remove. * the rule to remove.
* @exception DOMException * @exception DOMException
* INDEX_SIZE_ERR: Raised if the specified index does not correspond to * INDEX_SIZE_ERR: Raised if the specified index does not correspond to
* a rule in the media rule list. * a rule in the media rule list.

7
java/external/src/org/w3c/dom/css/CSSPageRule.java vendored
View File

@ -30,6 +30,13 @@ public interface CSSPageRule extends CSSRule {
* <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this rule is readonly. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this rule is readonly.
*/ */
public String getSelectorText(); public String getSelectorText();
/**
* The parsable textual representation of the page selector for the rule.
* @exception DOMException
* SYNTAX_ERR: Raised if the specified CSS string value has a syntax
* error and is unparsable.
* <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this rule is readonly.
*/
public void setSelectorText(String selectorText) public void setSelectorText(String selectorText)
throws DOMException; throws DOMException;

10
java/external/src/org/w3c/dom/css/CSSPrimitiveValue.java vendored
View File

@ -177,7 +177,7 @@ public interface CSSPrimitiveValue extends CSSValue {
* attached with this value can not accept the specified unit or the * attached with this value can not accept the specified unit or the
* float value, the value will be unchanged and a * float value, the value will be unchanged and a
* <code>DOMException</code> will be raised. * <code>DOMException</code> will be raised.
* @param unitType A unit code as defined above. The unit code can only * @param unitType A unit code as defined above. The unit code can only
* be a float unit type (i.e. <code>CSS_NUMBER</code>, * be a float unit type (i.e. <code>CSS_NUMBER</code>,
* <code>CSS_PERCENTAGE</code>, <code>CSS_EMS</code>, * <code>CSS_PERCENTAGE</code>, <code>CSS_EMS</code>,
* <code>CSS_EXS</code>, <code>CSS_PX</code>, <code>CSS_CM</code>, * <code>CSS_EXS</code>, <code>CSS_PX</code>, <code>CSS_CM</code>,
@ -186,7 +186,7 @@ public interface CSSPrimitiveValue extends CSSValue {
* <code>CSS_GRAD</code>, <code>CSS_MS</code>, <code>CSS_S</code>, * <code>CSS_GRAD</code>, <code>CSS_MS</code>, <code>CSS_S</code>,
* <code>CSS_HZ</code>, <code>CSS_KHZ</code>, * <code>CSS_HZ</code>, <code>CSS_KHZ</code>,
* <code>CSS_DIMENSION</code>). * <code>CSS_DIMENSION</code>).
* @param floatValue The new float value. * @param floatValue The new float value.
* @exception DOMException * @exception DOMException
* INVALID_ACCESS_ERR: Raised if the attached property doesn't support * INVALID_ACCESS_ERR: Raised if the attached property doesn't support
* the float value or the unit type. * the float value or the unit type.
@ -200,7 +200,7 @@ public interface CSSPrimitiveValue extends CSSValue {
* This method is used to get a float value in a specified unit. If this * This method is used to get a float value in a specified unit. If this
* CSS value doesn't contain a float value or can't be converted into * CSS value doesn't contain a float value or can't be converted into
* the specified unit, a <code>DOMException</code> is raised. * the specified unit, a <code>DOMException</code> is raised.
* @param unitType A unit code to get the float value. The unit code can * @param unitType A unit code to get the float value. The unit code can
* only be a float unit type (i.e. <code>CSS_NUMBER</code>, * only be a float unit type (i.e. <code>CSS_NUMBER</code>,
* <code>CSS_PERCENTAGE</code>, <code>CSS_EMS</code>, * <code>CSS_PERCENTAGE</code>, <code>CSS_EMS</code>,
* <code>CSS_EXS</code>, <code>CSS_PX</code>, <code>CSS_CM</code>, * <code>CSS_EXS</code>, <code>CSS_PX</code>, <code>CSS_CM</code>,
@ -223,11 +223,11 @@ public interface CSSPrimitiveValue extends CSSValue {
* property attached to this value can't accept the specified unit or * property attached to this value can't accept the specified unit or
* the string value, the value will be unchanged and a * the string value, the value will be unchanged and a
* <code>DOMException</code> will be raised. * <code>DOMException</code> will be raised.
* @param stringType A string code as defined above. The string code can * @param stringType A string code as defined above. The string code can
* only be a string unit type (i.e. <code>CSS_STRING</code>, * only be a string unit type (i.e. <code>CSS_STRING</code>,
* <code>CSS_URI</code>, <code>CSS_IDENT</code>, and * <code>CSS_URI</code>, <code>CSS_IDENT</code>, and
* <code>CSS_ATTR</code>). * <code>CSS_ATTR</code>).
* @param stringValue The new string value. * @param stringValue The new string value.
* @exception DOMException * @exception DOMException
* INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a string * INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a string
* value or if the string value can't be converted into the specified * value or if the string value can't be converted into the specified

12
java/external/src/org/w3c/dom/css/CSSRule.java vendored
View File

@ -75,6 +75,18 @@ public interface CSSRule {
* <br>NO_MODIFICATION_ALLOWED_ERR: Raised if the rule is readonly. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if the rule is readonly.
*/ */
public String getCssText(); public String getCssText();
/**
* The parsable textual representation of the rule. This reflects the
* current state of the rule and not its initial value.
* @exception DOMException
* SYNTAX_ERR: Raised if the specified CSS string value has a syntax
* error and is unparsable.
* <br>INVALID_MODIFICATION_ERR: Raised if the specified CSS string
* value represents a different type of rule than the current one.
* <br>HIERARCHY_REQUEST_ERR: Raised if the rule cannot be inserted at
* this point in the style sheet.
* <br>NO_MODIFICATION_ALLOWED_ERR: Raised if the rule is readonly.
*/
public void setCssText(String cssText) public void setCssText(String cssText)
throws DOMException; throws DOMException;

38
java/external/src/org/w3c/dom/css/CSSStyleDeclaration.java vendored
View File

@ -47,14 +47,26 @@ public interface CSSStyleDeclaration {
* readonly or a property is readonly. * readonly or a property is readonly.
*/ */
public String getCssText(); public String getCssText();
/**
* The parsable textual representation of the declaration block
* (excluding the surrounding curly braces). Setting this attribute will
* result in the parsing of the new value and resetting of all the
* properties in the declaration block including the removal or addition
* of properties.
* @exception DOMException
* SYNTAX_ERR: Raised if the specified CSS string value has a syntax
* error and is unparsable.
* <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this declaration is
* readonly or a property is readonly.
*/
public void setCssText(String cssText) public void setCssText(String cssText)
throws DOMException; throws DOMException;
/** /**
* Used to retrieve the value of a CSS property if it has been explicitly * Used to retrieve the value of a CSS property if it has been explicitly
* set within this declaration block. * set within this declaration block.
* @param propertyName The name of the CSS property. See the CSS property * @param propertyName The name of the CSS property. See the CSS
* index. * property index.
* @return Returns the value of the property if it has been explicitly * @return Returns the value of the property if it has been explicitly
* set for this declaration block. Returns the empty string if the * set for this declaration block. Returns the empty string if the
* property has not been set. * property has not been set.
@ -68,8 +80,8 @@ public interface CSSStyleDeclaration {
* property. Shorthand property values can only be accessed and modified * property. Shorthand property values can only be accessed and modified
* as strings, using the <code>getPropertyValue</code> and * as strings, using the <code>getPropertyValue</code> and
* <code>setProperty</code> methods. * <code>setProperty</code> methods.
* @param propertyName The name of the CSS property. See the CSS property * @param propertyName The name of the CSS property. See the CSS
* index. * property index.
* @return Returns the value of the property if it has been explicitly * @return Returns the value of the property if it has been explicitly
* set for this declaration block. Returns <code>null</code> if the * set for this declaration block. Returns <code>null</code> if the
* property has not been set. * property has not been set.
@ -79,8 +91,8 @@ public interface CSSStyleDeclaration {
/** /**
* Used to remove a CSS property if it has been explicitly set within * Used to remove a CSS property if it has been explicitly set within
* this declaration block. * this declaration block.
* @param propertyName The name of the CSS property. See the CSS property * @param propertyName The name of the CSS property. See the CSS
* index. * property index.
* @return Returns the value of the property if it has been explicitly * @return Returns the value of the property if it has been explicitly
* set for this declaration block. Returns the empty string if the * set for this declaration block. Returns the empty string if the
* property has not been set or the property name does not correspond * property has not been set or the property name does not correspond
@ -96,8 +108,8 @@ public interface CSSStyleDeclaration {
* Used to retrieve the priority of a CSS property (e.g. the * Used to retrieve the priority of a CSS property (e.g. the
* <code>"important"</code> qualifier) if the property has been * <code>"important"</code> qualifier) if the property has been
* explicitly set in this declaration block. * explicitly set in this declaration block.
* @param propertyName The name of the CSS property. See the CSS property * @param propertyName The name of the CSS property. See the CSS
* index. * property index.
* @return A string representing the priority (e.g. * @return A string representing the priority (e.g.
* <code>"important"</code>) if one exists. The empty string if none * <code>"important"</code>) if one exists. The empty string if none
* exists. * exists.
@ -107,10 +119,10 @@ public interface CSSStyleDeclaration {
/** /**
* Used to set a property value and priority within this declaration * Used to set a property value and priority within this declaration
* block. * block.
* @param propertyName The name of the CSS property. See the CSS property * @param propertyName The name of the CSS property. See the CSS
* index. * property index.
* @param value The new value of the property. * @param value The new value of the property.
* @param priority The new priority of the property (e.g. * @param priority The new priority of the property (e.g.
* <code>"important"</code>). * <code>"important"</code>).
* @exception DOMException * @exception DOMException
* SYNTAX_ERR: Raised if the specified value has a syntax error and is * SYNTAX_ERR: Raised if the specified value has a syntax error and is
@ -136,7 +148,7 @@ public interface CSSStyleDeclaration {
* method does not have to be the order in which they were set. This * method does not have to be the order in which they were set. This
* method can be used to iterate over all properties in this declaration * method can be used to iterate over all properties in this declaration
* block. * block.
* @param index Index of the property name to retrieve. * @param index Index of the property name to retrieve.
* @return The name of the property at this ordinal position. The empty * @return The name of the property at this ordinal position. The empty
* string if no property exists at this position. * string if no property exists at this position.
*/ */

9
java/external/src/org/w3c/dom/css/CSSStyleRule.java vendored
View File

@ -31,6 +31,15 @@ public interface CSSStyleRule extends CSSRule {
* <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this rule is readonly. * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this rule is readonly.
*/ */
public String getSelectorText(); public String getSelectorText();
/**
* The textual representation of the selector for the rule set. The
* implementation may have stripped out insignificant whitespace while
* parsing the selector.
* @exception DOMException
* SYNTAX_ERR: Raised if the specified CSS string value has a syntax
* error and is unparsable.
* <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this rule is readonly.
*/
public void setSelectorText(String selectorText) public void setSelectorText(String selectorText)
throws DOMException; throws DOMException;

6
java/external/src/org/w3c/dom/css/CSSStyleSheet.java vendored
View File

@ -44,11 +44,11 @@ public interface CSSStyleSheet extends StyleSheet {
/** /**
* Used to insert a new rule into the style sheet. The new rule now * Used to insert a new rule into the style sheet. The new rule now
* becomes part of the cascade. * becomes part of the cascade.
* @param rule The parsable text representing the rule. For rule sets * @param rule The parsable text representing the rule. For rule sets
* this contains both the selector and the style declaration. For * this contains both the selector and the style declaration. For
* at-rules, this specifies both the at-identifier and the rule * at-rules, this specifies both the at-identifier and the rule
* content. * content.
* @param index The index within the style sheet's rule list of the rule * @param index The index within the style sheet's rule list of the rule
* before which to insert the specified rule. If the specified index * before which to insert the specified rule. If the specified index
* is equal to the length of the style sheet's rule collection, the * is equal to the length of the style sheet's rule collection, the
* rule will be added to the end of the style sheet. * rule will be added to the end of the style sheet.
@ -71,7 +71,7 @@ public interface CSSStyleSheet extends StyleSheet {
/** /**
* Used to delete a rule from the style sheet. * Used to delete a rule from the style sheet.
* @param index The index within the style sheet's rule list of the rule * @param index The index within the style sheet's rule list of the rule
* to remove. * to remove.
* @exception DOMException * @exception DOMException
* INDEX_SIZE_ERR: Raised if the specified index does not correspond to * INDEX_SIZE_ERR: Raised if the specified index does not correspond to

10
java/external/src/org/w3c/dom/css/CSSValue.java vendored
View File

@ -57,6 +57,16 @@ public interface CSSValue {
* <br> NO_MODIFICATION_ALLOWED_ERR: Raised if this value is readonly. * <br> NO_MODIFICATION_ALLOWED_ERR: Raised if this value is readonly.
*/ */
public String getCssText(); public String getCssText();
/**
* A string representation of the current value.
* @exception DOMException
* SYNTAX_ERR: Raised if the specified CSS string value has a syntax
* error (according to the attached property) or is unparsable.
* <br>INVALID_MODIFICATION_ERR: Raised if the specified CSS string
* value represents a different type of values than the values allowed
* by the CSS property.
* <br> NO_MODIFICATION_ALLOWED_ERR: Raised if this value is readonly.
*/
public void setCssText(String cssText) public void setCssText(String cssText)
throws DOMException; throws DOMException;

6
java/external/src/org/w3c/dom/css/DOMImplementationCSS.java vendored
View File

@ -25,9 +25,9 @@ import org.w3c.dom.DOMException;
public interface DOMImplementationCSS extends DOMImplementation { public interface DOMImplementationCSS extends DOMImplementation {
/** /**
* Creates a new <code>CSSStyleSheet</code>. * Creates a new <code>CSSStyleSheet</code>.
* @param title The advisory title. See also the section. * @param title The advisory title. See also the section.
* @param media The comma-separated list of media associated with the new * @param media The comma-separated list of media associated with the
* style sheet. See also the section. * new style sheet. See also the section.
* @return A new CSS style sheet. * @return A new CSS style sheet.
* @exception DOMException * @exception DOMException
* SYNTAX_ERR: Raised if the specified media string value has a syntax * SYNTAX_ERR: Raised if the specified media string value has a syntax

6
java/external/src/org/w3c/dom/css/DocumentCSS.java vendored
View File

@ -12,8 +12,8 @@
package org.w3c.dom.css; package org.w3c.dom.css;
import org.w3c.dom.stylesheets.DocumentStyle;
import org.w3c.dom.Element; import org.w3c.dom.Element;
import org.w3c.dom.stylesheets.DocumentStyle;
/** /**
* This interface represents a document with a CSS view. * This interface represents a document with a CSS view.
@ -39,9 +39,9 @@ public interface DocumentCSS extends DocumentStyle {
/** /**
* This method is used to retrieve the override style declaration for a * This method is used to retrieve the override style declaration for a
* specified element and a specified pseudo-element. * specified element and a specified pseudo-element.
* @param elt The element whose style is to be modified. This parameter * @param elt The element whose style is to be modified. This parameter
* cannot be null. * cannot be null.
* @param pseudoElt The pseudo-element or <code>null</code> if none. * @param pseudoElt The pseudo-element or <code>null</code> if none.
* @return The override style declaration. * @return The override style declaration.
*/ */
public CSSStyleDeclaration getOverrideStyle(Element elt, public CSSStyleDeclaration getOverrideStyle(Element elt,

6
java/external/src/org/w3c/dom/css/ViewCSS.java vendored
View File

@ -12,8 +12,8 @@
package org.w3c.dom.css; package org.w3c.dom.css;
import org.w3c.dom.views.AbstractView;
import org.w3c.dom.Element; import org.w3c.dom.Element;
import org.w3c.dom.views.AbstractView;
/** /**
* This interface represents a CSS view. The <code>getComputedStyle</code> * This interface represents a CSS view. The <code>getComputedStyle</code>
@ -31,9 +31,9 @@ import org.w3c.dom.Element;
public interface ViewCSS extends AbstractView { public interface ViewCSS extends AbstractView {
/** /**
* This method is used to get the computed style as it is defined in . * This method is used to get the computed style as it is defined in .
* @param elt The element whose style is to be computed. This parameter * @param elt The element whose style is to be computed. This parameter
* cannot be null. * cannot be null.
* @param pseudoElt The pseudo-element or <code>null</code> if none. * @param pseudoElt The pseudo-element or <code>null</code> if none.
* @return The computed style. The <code>CSSStyleDeclaration</code> is * @return The computed style. The <code>CSSStyleDeclaration</code> is
* read-only and contains only absolute values. * read-only and contains only absolute values.
*/ */

2
java/external/src/org/w3c/dom/events/EventListener.java vendored
View File

@ -31,7 +31,7 @@ public interface EventListener {
/** /**
* This method is called whenever an event occurs of the type for which * This method is called whenever an event occurs of the type for which
* the <code> EventListener</code> interface was registered. * the <code> EventListener</code> interface was registered.
* @param evt The <code>Event</code> contains contextual information * @param evt The <code>Event</code> contains contextual information
* about the event. It also contains the <code>stopPropagation</code> * about the event. It also contains the <code>stopPropagation</code>
* and <code>preventDefault</code> methods which are used in * and <code>preventDefault</code> methods which are used in
* determining the event's flow and default action. * determining the event's flow and default action.

12
java/external/src/org/w3c/dom/events/MouseEvent.java vendored
View File

@ -117,10 +117,14 @@ public interface MouseEvent extends UIEvent {
* @param viewArg Specifies the <code>Event</code>'s * @param viewArg Specifies the <code>Event</code>'s
* <code>AbstractView</code>. * <code>AbstractView</code>.
* @param detailArg Specifies the <code>Event</code>'s mouse click count. * @param detailArg Specifies the <code>Event</code>'s mouse click count.
* @param screenXArg Specifies the <code>Event</code>'s screen x coordinate * @param screenXArg Specifies the <code>Event</code>'s screen x
* @param screenYArg Specifies the <code>Event</code>'s screen y coordinate * coordinate
* @param clientXArg Specifies the <code>Event</code>'s client x coordinate * @param screenYArg Specifies the <code>Event</code>'s screen y
* @param clientYArg Specifies the <code>Event</code>'s client y coordinate * coordinate
* @param clientXArg Specifies the <code>Event</code>'s client x
* coordinate
* @param clientYArg Specifies the <code>Event</code>'s client y
* coordinate
* @param ctrlKeyArg Specifies whether or not control key was depressed * @param ctrlKeyArg Specifies whether or not control key was depressed
* during the <code>Event</code>. * during the <code>Event</code>.
* @param altKeyArg Specifies whether or not alt key was depressed during * @param altKeyArg Specifies whether or not alt key was depressed during

21
java/external/src/org/w3c/dom/ranges/Range.java vendored
View File

@ -13,8 +13,8 @@
package org.w3c.dom.ranges; package org.w3c.dom.ranges;
import org.w3c.dom.Node; import org.w3c.dom.Node;
import org.w3c.dom.DocumentFragment;
import org.w3c.dom.DOMException; import org.w3c.dom.DOMException;
import org.w3c.dom.DocumentFragment;
/** /**
* <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113'>Document Object Model (DOM) Level 2 Traversal and Range Specification</a>. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113'>Document Object Model (DOM) Level 2 Traversal and Range Specification</a>.
@ -93,6 +93,8 @@ public interface Range {
* node. Child units are Nodes in all other cases. * node. Child units are Nodes in all other cases.
* <br>INVALID_STATE_ERR: Raised if <code>detach()</code> has already * <br>INVALID_STATE_ERR: Raised if <code>detach()</code> has already
* been invoked on this object. * been invoked on this object.
* <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created
* from a different document than the one that created this range.
*/ */
public void setStart(Node refNode, public void setStart(Node refNode,
int offset) int offset)
@ -115,6 +117,8 @@ public interface Range {
* node. Child units are Nodes in all other cases. * node. Child units are Nodes in all other cases.
* <br>INVALID_STATE_ERR: Raised if <code>detach()</code> has already * <br>INVALID_STATE_ERR: Raised if <code>detach()</code> has already
* been invoked on this object. * been invoked on this object.
* <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created
* from a different document than the one that created this range.
*/ */
public void setEnd(Node refNode, public void setEnd(Node refNode,
int offset) int offset)
@ -131,6 +135,8 @@ public interface Range {
* @exception DOMException * @exception DOMException
* INVALID_STATE_ERR: Raised if <code>detach()</code> has already been * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been
* invoked on this object. * invoked on this object.
* <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created
* from a different document than the one that created this range.
*/ */
public void setStartBefore(Node refNode) public void setStartBefore(Node refNode)
throws RangeException, DOMException; throws RangeException, DOMException;
@ -146,6 +152,8 @@ public interface Range {
* @exception DOMException * @exception DOMException
* INVALID_STATE_ERR: Raised if <code>detach()</code> has already been * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been
* invoked on this object. * invoked on this object.
* <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created
* from a different document than the one that created this range.
*/ */
public void setStartAfter(Node refNode) public void setStartAfter(Node refNode)
throws RangeException, DOMException; throws RangeException, DOMException;
@ -161,6 +169,8 @@ public interface Range {
* @exception DOMException * @exception DOMException
* INVALID_STATE_ERR: Raised if <code>detach()</code> has already been * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been
* invoked on this object. * invoked on this object.
* <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created
* from a different document than the one that created this range.
*/ */
public void setEndBefore(Node refNode) public void setEndBefore(Node refNode)
throws RangeException, DOMException; throws RangeException, DOMException;
@ -176,6 +186,8 @@ public interface Range {
* @exception DOMException * @exception DOMException
* INVALID_STATE_ERR: Raised if <code>detach()</code> has already been * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been
* invoked on this object. * invoked on this object.
* <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created
* from a different document than the one that created this range.
*/ */
public void setEndAfter(Node refNode) public void setEndAfter(Node refNode)
throws RangeException, DOMException; throws RangeException, DOMException;
@ -202,6 +214,8 @@ public interface Range {
* @exception DOMException * @exception DOMException
* INVALID_STATE_ERR: Raised if <code>detach()</code> has already been * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been
* invoked on this object. * invoked on this object.
* <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created
* from a different document than the one that created this range.
*/ */
public void selectNode(Node refNode) public void selectNode(Node refNode)
throws RangeException, DOMException; throws RangeException, DOMException;
@ -215,6 +229,8 @@ public interface Range {
* @exception DOMException * @exception DOMException
* INVALID_STATE_ERR: Raised if <code>detach()</code> has already been * INVALID_STATE_ERR: Raised if <code>detach()</code> has already been
* invoked on this object. * invoked on this object.
* <br>WRONG_DOCUMENT_ERR: Raised if <code>refNode</code> was created
* from a different document than the one that created this range.
*/ */
public void selectNodeContents(Node refNode) public void selectNodeContents(Node refNode)
throws RangeException, DOMException; throws RangeException, DOMException;
@ -247,7 +263,8 @@ public interface Range {
/** /**
* Compare the boundary-points of two Ranges in a document. * Compare the boundary-points of two Ranges in a document.
* @param how A code representing the type of comparison, as defined above. * @param how A code representing the type of comparison, as defined
* above.
* @param sourceRange The <code>Range</code> on which this current * @param sourceRange The <code>Range</code> on which this current
* <code>Range</code> is compared to. * <code>Range</code> is compared to.
* @return -1, 0 or 1 depending on whether the corresponding * @return -1, 0 or 1 depending on whether the corresponding

11
java/external/src/org/w3c/dom/stylesheets/MediaList.java vendored
View File

@ -35,6 +35,15 @@ public interface MediaList {
* readonly. * readonly.
*/ */
public String getMediaText(); public String getMediaText();
/**
* The parsable textual representation of the media list. This is a
* comma-separated list of media.
* @exception DOMException
* SYNTAX_ERR: Raised if the specified string value has a syntax error
* and is unparsable.
* <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this media list is
* readonly.
*/
public void setMediaText(String mediaText) public void setMediaText(String mediaText)
throws DOMException; throws DOMException;
@ -48,7 +57,7 @@ public interface MediaList {
* Returns the <code>index</code>th in the list. If <code>index</code> is * Returns the <code>index</code>th in the list. If <code>index</code> is
* greater than or equal to the number of media in the list, this * greater than or equal to the number of media in the list, this
* returns <code>null</code>. * returns <code>null</code>.
* @param index Index into the collection. * @param index Index into the collection.
* @return The medium at the <code>index</code>th position in the * @return The medium at the <code>index</code>th position in the
* <code>MediaList</code>, or <code>null</code> if that is not a valid * <code>MediaList</code>, or <code>null</code> if that is not a valid
* index. * index.

8
java/external/src/org/w3c/dom/stylesheets/StyleSheet.java vendored
View File

@ -44,6 +44,14 @@ public interface StyleSheet {
* user agent, the <code>disabled</code> attribute is ignored. * user agent, the <code>disabled</code> attribute is ignored.
*/ */
public boolean getDisabled(); public boolean getDisabled();
/**
* <code>false</code> if the style sheet is applied to the document.
* <code>true</code> if it is not. Modifying this attribute may cause a
* new resolution of style for the document. A stylesheet only applies
* if both an appropriate medium definition is present and the disabled
* attribute is false. So, if the media doesn't apply to the current
* user agent, the <code>disabled</code> attribute is ignored.
*/
public void setDisabled(boolean disabled); public void setDisabled(boolean disabled);
/** /**

38
java/external/src/org/w3c/dom/traversal/DocumentTraversal.java vendored
View File

@ -16,12 +16,13 @@ import org.w3c.dom.Node;
import org.w3c.dom.DOMException; import org.w3c.dom.DOMException;
/** /**
* <code>DocumentTraversal</code> contains methods that create iterators and * <code>DocumentTraversal</code> contains methods that create
* tree-walkers to traverse a node and its children in document order (depth * <code>NodeIterators</code> and <code>TreeWalkers</code> to traverse a
* first, pre-order traversal, which is equivalent to the order in which the * node and its children in document order (depth first, pre-order
* start tags occur in the text representation of the document). In DOMs * traversal, which is equivalent to the order in which the start tags occur
* which support the Traversal feature, <code>DocumentTraversal</code> will * in the text representation of the document). In DOMs which support the
* be implemented by the same objects that implement the Document interface. * Traversal feature, <code>DocumentTraversal</code> will be implemented by
* the same objects that implement the Document interface.
* <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113'>Document Object Model (DOM) Level 2 Traversal and Range Specification</a>. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113'>Document Object Model (DOM) Level 2 Traversal and Range Specification</a>.
* @since DOM Level 2 * @since DOM Level 2
*/ */
@ -29,16 +30,16 @@ public interface DocumentTraversal {
/** /**
* Create a new <code>NodeIterator</code> over the subtree rooted at the * Create a new <code>NodeIterator</code> over the subtree rooted at the
* specified node. * specified node.
* @param root The node which will be iterated together with its children. * @param root The node which will be iterated together with its
* The iterator is initially positioned just before this node. The * children. The <code>NodeIterator</code> is initially positioned
* <code>whatToShow</code> flags and the filter, if any, are not * just before this node. The <code>whatToShow</code> flags and the
* considered when setting this position. The root must not be * filter, if any, are not considered when setting this position. The
* <code>null</code>. * root must not be <code>null</code>.
* @param whatToShow This flag specifies which node types may appear in * @param whatToShow This flag specifies which node types may appear in
* the logical view of the tree presented by the iterator. See the * the logical view of the tree presented by the
* description of <code>NodeFilter</code> for the set of possible * <code>NodeIterator</code>. See the description of
* <code>SHOW_</code> values.These flags can be combined using * <code>NodeFilter</code> for the set of possible <code>SHOW_</code>
* <code>OR</code>. * values.These flags can be combined using <code>OR</code>.
* @param filter The <code>NodeFilter</code> to be used with this * @param filter The <code>NodeFilter</code> to be used with this
* <code>TreeWalker</code>, or <code>null</code> to indicate no filter. * <code>TreeWalker</code>, or <code>null</code> to indicate no filter.
* @param entityReferenceExpansion The value of this flag determines * @param entityReferenceExpansion The value of this flag determines
@ -68,9 +69,10 @@ public interface DocumentTraversal {
* <code>parentNode</code> and nextNode. The <code>root</code> must * <code>parentNode</code> and nextNode. The <code>root</code> must
* not be <code>null</code>. * not be <code>null</code>.
* @param whatToShow This flag specifies which node types may appear in * @param whatToShow This flag specifies which node types may appear in
* the logical view of the tree presented by the tree-walker. See the * the logical view of the tree presented by the
* description of <code>NodeFilter</code> for the set of possible * <code>TreeWalker</code>. See the description of
* SHOW_ values.These flags can be combined using <code>OR</code>. * <code>NodeFilter</code> for the set of possible <code>SHOW_</code>
* values.These flags can be combined using <code>OR</code>.
* @param filter The <code>NodeFilter</code> to be used with this * @param filter The <code>NodeFilter</code> to be used with this
* <code>TreeWalker</code>, or <code>null</code> to indicate no filter. * <code>TreeWalker</code>, or <code>null</code> to indicate no filter.
* @param entityReferenceExpansion If this flag is false, the contents of * @param entityReferenceExpansion If this flag is false, the contents of

34
java/external/src/org/w3c/dom/traversal/NodeFilter.java vendored
View File

@ -68,11 +68,11 @@ public interface NodeFilter {
public static final int SHOW_ELEMENT = 0x00000001; public static final int SHOW_ELEMENT = 0x00000001;
/** /**
* Show <code>Attr</code> nodes. This is meaningful only when creating an * Show <code>Attr</code> nodes. This is meaningful only when creating an
* iterator or tree-walker with an attribute node as its * <code>NodeIterator</code> or <code>TreeWalker</code> with an
* <code>root</code>; in this case, it means that the attribute node * attribute node as its <code>root</code>; in this case, it means that
* will appear in the first position of the iteration or traversal. * the attribute node will appear in the first position of the iteration
* Since attributes are never children of other nodes, they do not * or traversal. Since attributes are never children of other nodes,
* appear when traversing over the document tree. * they do not appear when traversing over the document tree.
*/ */
public static final int SHOW_ATTRIBUTE = 0x00000002; public static final int SHOW_ATTRIBUTE = 0x00000002;
/** /**
@ -89,11 +89,12 @@ public interface NodeFilter {
public static final int SHOW_ENTITY_REFERENCE = 0x00000010; public static final int SHOW_ENTITY_REFERENCE = 0x00000010;
/** /**
* Show <code>Entity</code> nodes. This is meaningful only when creating * Show <code>Entity</code> nodes. This is meaningful only when creating
* an iterator or tree-walker with an<code> Entity</code> node as its * an <code>NodeIterator</code> or <code>TreeWalker</code> with an
* <code>root</code>; in this case, it means that the <code>Entity</code> * <code>Entity</code> node as its <code>root</code>; in this case, it
* node will appear in the first position of the traversal. Since * means that the <code>Entity</code> node will appear in the first
* entities are not part of the document tree, they do not appear when * position of the traversal. Since entities are not part of the
* traversing over the document tree. * document tree, they do not appear when traversing over the document
* tree.
*/ */
public static final int SHOW_ENTITY = 0x00000020; public static final int SHOW_ENTITY = 0x00000020;
/** /**
@ -118,11 +119,12 @@ public interface NodeFilter {
public static final int SHOW_DOCUMENT_FRAGMENT = 0x00000400; public static final int SHOW_DOCUMENT_FRAGMENT = 0x00000400;
/** /**
* Show <code>Notation</code> nodes. This is meaningful only when creating * Show <code>Notation</code> nodes. This is meaningful only when creating
* an iterator or tree-walker with a <code>Notation</code> node as its * an <code>NodeIterator</code> or <code>TreeWalker</code> with a
* <code>root</code>; in this case, it means that the * <code>Notation</code> node as its <code>root</code>; in this case, it
* <code>Notation</code> node will appear in the first position of the * means that the <code>Notation</code> node will appear in the first
* traversal. Since notations are not part of the document tree, they do * position of the traversal. Since notations are not part of the
* not appear when traversing over the document tree. * document tree, they do not appear when traversing over the document
* tree.
*/ */
public static final int SHOW_NOTATION = 0x00000800; public static final int SHOW_NOTATION = 0x00000800;
@ -134,7 +136,7 @@ public interface NodeFilter {
* user code. (Though you could do so if you wanted to use the same * user code. (Though you could do so if you wanted to use the same
* filter to guide your own application logic.) * filter to guide your own application logic.)
* @param n The node to check to see if it passes the filter or not. * @param n The node to check to see if it passes the filter or not.
* @return a constant to determine whether the node is accepted, * @return A constant to determine whether the node is accepted,
* rejected, or skipped, as defined above. * rejected, or skipped, as defined above.
*/ */
public short acceptNode(Node n); public short acceptNode(Node n);

53
java/external/src/org/w3c/dom/traversal/NodeIterator.java vendored
View File

@ -16,15 +16,15 @@ import org.w3c.dom.Node;
import org.w3c.dom.DOMException; import org.w3c.dom.DOMException;
/** /**
* <code>Iterators</code> are used to step through a set of nodes, e.g. the * <code>NodeIterators</code> are used to step through a set of nodes, e.g.
* set of nodes in a <code>NodeList</code>, the document subtree governed by * the set of nodes in a <code>NodeList</code>, the document subtree
* a particular <code>Node</code>, the results of a query, or any other set * governed by a particular <code>Node</code>, the results of a query, or
* of nodes. The set of nodes to be iterated is determined by the * any other set of nodes. The set of nodes to be iterated is determined by
* implementation of the <code>NodeIterator</code>. DOM Level 2 specifies a * the implementation of the <code>NodeIterator</code>. DOM Level 2
* single <code>NodeIterator</code> implementation for document-order * specifies a single <code>NodeIterator</code> implementation for
* traversal of a document subtree. Instances of these iterators are created * document-order traversal of a document subtree. Instances of these
* by calling <code>DocumentTraversal</code> * <code>NodeIterators</code> are created by calling
* <code>.createNodeIterator()</code>. * <code>DocumentTraversal</code><code>.createNodeIterator()</code>.
* <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113'>Document Object Model (DOM) Level 2 Traversal and Range Specification</a>. * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113'>Document Object Model (DOM) Level 2 Traversal and Range Specification</a>.
* @since DOM Level 2 * @since DOM Level 2
*/ */
@ -37,8 +37,8 @@ public interface NodeIterator {
/** /**
* This attribute determines which node types are presented via the * This attribute determines which node types are presented via the
* iterator. The available set of constants is defined in the * <code>NodeIterator</code>. The available set of constants is defined
* <code>NodeFilter</code> interface. Nodes not accepted by * in the <code>NodeFilter</code> interface. Nodes not accepted by
* <code>whatToShow</code> will be skipped, but their children may still * <code>whatToShow</code> will be skipped, but their children may still
* be considered. Note that this skip takes precedence over the filter, * be considered. Note that this skip takes precedence over the filter,
* if any. * if any.
@ -52,10 +52,10 @@ public interface NodeIterator {
/** /**
* The value of this flag determines whether the children of entity * The value of this flag determines whether the children of entity
* reference nodes are visible to the iterator. If false, they and * reference nodes are visible to the <code>NodeIterator</code>. If
* their descendants will be rejected. Note that this rejection takes * false, these children and their descendants will be rejected. Note
* precedence over <code>whatToShow</code> and the filter. Also note * that this rejection takes precedence over <code>whatToShow</code> and
* that this is currently the only situation where * the filter. Also note that this is currently the only situation where
* <code>NodeIterators</code> may reject a complete subtree rather than * <code>NodeIterators</code> may reject a complete subtree rather than
* skipping individual nodes. * skipping individual nodes.
* <br> * <br>
@ -63,18 +63,18 @@ public interface NodeIterator {
* expanded and does not expose the entity reference node itself, use * expanded and does not expose the entity reference node itself, use
* the <code>whatToShow</code> flags to hide the entity reference node * the <code>whatToShow</code> flags to hide the entity reference node
* and set <code>expandEntityReferences</code> to true when creating the * and set <code>expandEntityReferences</code> to true when creating the
* iterator. To produce a view of the document that has entity reference * <code>NodeIterator</code>. To produce a view of the document that has
* nodes but no entity expansion, use the <code>whatToShow</code> flags * entity reference nodes but no entity expansion, use the
* to show the entity reference node and set * <code>whatToShow</code> flags to show the entity reference node and
* <code>expandEntityReferences</code> to false. * set <code>expandEntityReferences</code> to false.
*/ */
public boolean getExpandEntityReferences(); public boolean getExpandEntityReferences();
/** /**
* Returns the next node in the set and advances the position of the * Returns the next node in the set and advances the position of the
* iterator in the set. After a <code>NodeIterator</code> is created, * <code>NodeIterator</code> in the set. After a
* the first call to <code>nextNode()</code> returns the first node in * <code>NodeIterator</code> is created, the first call to
* the set. * <code>nextNode()</code> returns the first node in the set.
* @return The next <code>Node</code> in the set being iterated over, or * @return The next <code>Node</code> in the set being iterated over, or
* <code>null</code> if there are no more members in that set. * <code>null</code> if there are no more members in that set.
* @exception DOMException * @exception DOMException
@ -98,10 +98,11 @@ public interface NodeIterator {
/** /**
* Detaches the <code>NodeIterator</code> from the set which it iterated * Detaches the <code>NodeIterator</code> from the set which it iterated
* over, releasing any computational resources and placing the iterator * over, releasing any computational resources and placing the
* in the INVALID state. After <code>detach</code> has been invoked, * <code>NodeIterator</code> in the INVALID state. After
* calls to <code>nextNode</code> or <code>previousNode</code> will * <code>detach</code> has been invoked, calls to <code>nextNode</code>
* raise the exception INVALID_STATE_ERR. * or <code>previousNode</code> will raise the exception
* INVALID_STATE_ERR.
*/ */
public void detach(); public void detach();

19
java/external/src/org/w3c/dom/traversal/TreeWalker.java vendored
View File

@ -58,8 +58,8 @@ public interface TreeWalker {
/** /**
* The value of this flag determines whether the children of entity * The value of this flag determines whether the children of entity
* reference nodes are visible to the <code>TreeWalker</code>. If false, * reference nodes are visible to the <code>TreeWalker</code>. If false,
* they and their descendants will be rejected. Note that this * these children and their descendants will be rejected. Note that
* rejection takes precedence over <code>whatToShow</code> and the * this rejection takes precedence over <code>whatToShow</code> and the
* filter, if any. * filter, if any.
* <br> To produce a view of the document that has entity references * <br> To produce a view of the document that has entity references
* expanded and does not expose the entity reference node itself, use * expanded and does not expose the entity reference node itself, use
@ -88,6 +88,21 @@ public interface TreeWalker {
* <code>currentNode</code> to <code>null</code>. * <code>currentNode</code> to <code>null</code>.
*/ */
public Node getCurrentNode(); public Node getCurrentNode();
/**
* The node at which the <code>TreeWalker</code> is currently positioned.
* <br>Alterations to the DOM tree may cause the current node to no longer
* be accepted by the <code>TreeWalker</code>'s associated filter.
* <code>currentNode</code> may also be explicitly set to any node,
* whether or not it is within the subtree specified by the
* <code>root</code> node or would be accepted by the filter and
* <code>whatToShow</code> flags. Further traversal occurs relative to
* <code>currentNode</code> even if it is not part of the current view,
* by applying the filters in the requested direction; if no traversal
* is possible, <code>currentNode</code> is not changed.
* @exception DOMException
* NOT_SUPPORTED_ERR: Raised if an attempt is made to set
* <code>currentNode</code> to <code>null</code>.
*/
public void setCurrentNode(Node currentNode) public void setCurrentNode(Node currentNode)
throws DOMException; throws DOMException;