jaxp/src/org/w3c/dom/Element.java
changeset 25262 1fe892ba017a
parent 12457 c348e06f0e82
equal deleted inserted replaced
24908:2dcf544eb7ed 25262:1fe892ba017a
   201      *   if that attribute does not have a specified or default value.
   201      *   if that attribute does not have a specified or default value.
   202      * @exception DOMException
   202      * @exception DOMException
   203      *   NOT_SUPPORTED_ERR: May be raised if the implementation does not
   203      *   NOT_SUPPORTED_ERR: May be raised if the implementation does not
   204      *   support the feature <code>"XML"</code> and the language exposed
   204      *   support the feature <code>"XML"</code> and the language exposed
   205      *   through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]).
   205      *   through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]).
   206      * @since DOM Level 2
   206      * @since 1.4, DOM Level 2
   207      */
   207      */
   208     public String getAttributeNS(String namespaceURI,
   208     public String getAttributeNS(String namespaceURI,
   209                                  String localName)
   209                                  String localName)
   210                                  throws DOMException;
   210                                  throws DOMException;
   211 
   211 
   247      *   http://www.w3.org/XML/1998/namespace</a>", if the <code>qualifiedName</code> or its prefix is "xmlns" and the
   247      *   http://www.w3.org/XML/1998/namespace</a>", if the <code>qualifiedName</code> or its prefix is "xmlns" and the
   248      *   <code>namespaceURI</code> is different from "<a href='http://www.w3.org/2000/xmlns/'>http://www.w3.org/2000/xmlns/</a>", or if the <code>namespaceURI</code> is "<a href='http://www.w3.org/2000/xmlns/'>http://www.w3.org/2000/xmlns/</a>" and neither the <code>qualifiedName</code> nor its prefix is "xmlns".
   248      *   <code>namespaceURI</code> is different from "<a href='http://www.w3.org/2000/xmlns/'>http://www.w3.org/2000/xmlns/</a>", or if the <code>namespaceURI</code> is "<a href='http://www.w3.org/2000/xmlns/'>http://www.w3.org/2000/xmlns/</a>" and neither the <code>qualifiedName</code> nor its prefix is "xmlns".
   249      *   <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not
   249      *   <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not
   250      *   support the feature <code>"XML"</code> and the language exposed
   250      *   support the feature <code>"XML"</code> and the language exposed
   251      *   through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]).
   251      *   through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]).
   252      * @since DOM Level 2
   252      * @since 1.4, DOM Level 2
   253      */
   253      */
   254     public void setAttributeNS(String namespaceURI,
   254     public void setAttributeNS(String namespaceURI,
   255                                String qualifiedName,
   255                                String qualifiedName,
   256                                String value)
   256                                String value)
   257                                throws DOMException;
   257                                throws DOMException;
   276      * @exception DOMException
   276      * @exception DOMException
   277      *   NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
   277      *   NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
   278      *   <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not
   278      *   <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not
   279      *   support the feature <code>"XML"</code> and the language exposed
   279      *   support the feature <code>"XML"</code> and the language exposed
   280      *   through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]).
   280      *   through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]).
   281      * @since DOM Level 2
   281      * @since 1.4, DOM Level 2
   282      */
   282      */
   283     public void removeAttributeNS(String namespaceURI,
   283     public void removeAttributeNS(String namespaceURI,
   284                                   String localName)
   284                                   String localName)
   285                                   throws DOMException;
   285                                   throws DOMException;
   286 
   286 
   297      *   attribute.
   297      *   attribute.
   298      * @exception DOMException
   298      * @exception DOMException
   299      *   NOT_SUPPORTED_ERR: May be raised if the implementation does not
   299      *   NOT_SUPPORTED_ERR: May be raised if the implementation does not
   300      *   support the feature <code>"XML"</code> and the language exposed
   300      *   support the feature <code>"XML"</code> and the language exposed
   301      *   through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]).
   301      *   through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]).
   302      * @since DOM Level 2
   302      * @since 1.4, DOM Level 2
   303      */
   303      */
   304     public Attr getAttributeNodeNS(String namespaceURI,
   304     public Attr getAttributeNodeNS(String namespaceURI,
   305                                    String localName)
   305                                    String localName)
   306                                    throws DOMException;
   306                                    throws DOMException;
   307 
   307 
   327      *   explicitly clone <code>Attr</code> nodes to re-use them in other
   327      *   explicitly clone <code>Attr</code> nodes to re-use them in other
   328      *   elements.
   328      *   elements.
   329      *   <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not
   329      *   <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not
   330      *   support the feature <code>"XML"</code> and the language exposed
   330      *   support the feature <code>"XML"</code> and the language exposed
   331      *   through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]).
   331      *   through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]).
   332      * @since DOM Level 2
   332      * @since 1.4, DOM Level 2
   333      */
   333      */
   334     public Attr setAttributeNodeNS(Attr newAttr)
   334     public Attr setAttributeNodeNS(Attr newAttr)
   335                                    throws DOMException;
   335                                    throws DOMException;
   336 
   336 
   337     /**
   337     /**
   346      *   <code>Elements</code>.
   346      *   <code>Elements</code>.
   347      * @exception DOMException
   347      * @exception DOMException
   348      *   NOT_SUPPORTED_ERR: May be raised if the implementation does not
   348      *   NOT_SUPPORTED_ERR: May be raised if the implementation does not
   349      *   support the feature <code>"XML"</code> and the language exposed
   349      *   support the feature <code>"XML"</code> and the language exposed
   350      *   through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]).
   350      *   through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]).
   351      * @since DOM Level 2
   351      * @since 1.4, DOM Level 2
   352      */
   352      */
   353     public NodeList getElementsByTagNameNS(String namespaceURI,
   353     public NodeList getElementsByTagNameNS(String namespaceURI,
   354                                            String localName)
   354                                            String localName)
   355                                            throws DOMException;
   355                                            throws DOMException;
   356 
   356 
   360      * otherwise.
   360      * otherwise.
   361      * @param name The name of the attribute to look for.
   361      * @param name The name of the attribute to look for.
   362      * @return <code>true</code> if an attribute with the given name is
   362      * @return <code>true</code> if an attribute with the given name is
   363      *   specified on this element or has a default value, <code>false</code>
   363      *   specified on this element or has a default value, <code>false</code>
   364      *    otherwise.
   364      *    otherwise.
   365      * @since DOM Level 2
   365      * @since 1.4, DOM Level 2
   366      */
   366      */
   367     public boolean hasAttribute(String name);
   367     public boolean hasAttribute(String name);
   368 
   368 
   369     /**
   369     /**
   370      * Returns <code>true</code> when an attribute with a given local name and
   370      * Returns <code>true</code> when an attribute with a given local name and
   381      *   element, <code>false</code> otherwise.
   381      *   element, <code>false</code> otherwise.
   382      * @exception DOMException
   382      * @exception DOMException
   383      *   NOT_SUPPORTED_ERR: May be raised if the implementation does not
   383      *   NOT_SUPPORTED_ERR: May be raised if the implementation does not
   384      *   support the feature <code>"XML"</code> and the language exposed
   384      *   support the feature <code>"XML"</code> and the language exposed
   385      *   through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]).
   385      *   through the Document does not support XML Namespaces (such as [<a href='http://www.w3.org/TR/1999/REC-html401-19991224/'>HTML 4.01</a>]).
   386      * @since DOM Level 2
   386      * @since 1.4, DOM Level 2
   387      */
   387      */
   388     public boolean hasAttributeNS(String namespaceURI,
   388     public boolean hasAttributeNS(String namespaceURI,
   389                                   String localName)
   389                                   String localName)
   390                                   throws DOMException;
   390                                   throws DOMException;
   391 
   391 
   392     /**
   392     /**
   393      *  The type information associated with this element.
   393      *  The type information associated with this element.
   394      * @since DOM Level 3
   394      * @since 1.5, DOM Level 3
   395      */
   395      */
   396     public TypeInfo getSchemaTypeInfo();
   396     public TypeInfo getSchemaTypeInfo();
   397 
   397 
   398     /**
   398     /**
   399      *  If the parameter <code>isId</code> is <code>true</code>, this method
   399      *  If the parameter <code>isId</code> is <code>true</code>, this method
   411      * @param isId Whether the attribute is a of type ID.
   411      * @param isId Whether the attribute is a of type ID.
   412      * @exception DOMException
   412      * @exception DOMException
   413      *   NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
   413      *   NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
   414      *   <br>NOT_FOUND_ERR: Raised if the specified node is not an attribute
   414      *   <br>NOT_FOUND_ERR: Raised if the specified node is not an attribute
   415      *   of this element.
   415      *   of this element.
   416      * @since DOM Level 3
   416      * @since 1.5, DOM Level 3
   417      */
   417      */
   418     public void setIdAttribute(String name,
   418     public void setIdAttribute(String name,
   419                                boolean isId)
   419                                boolean isId)
   420                                throws DOMException;
   420                                throws DOMException;
   421 
   421 
   434      * @param isId Whether the attribute is a of type ID.
   434      * @param isId Whether the attribute is a of type ID.
   435      * @exception DOMException
   435      * @exception DOMException
   436      *   NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
   436      *   NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
   437      *   <br>NOT_FOUND_ERR: Raised if the specified node is not an attribute
   437      *   <br>NOT_FOUND_ERR: Raised if the specified node is not an attribute
   438      *   of this element.
   438      *   of this element.
   439      * @since DOM Level 3
   439      * @since 1.5, DOM Level 3
   440      */
   440      */
   441     public void setIdAttributeNS(String namespaceURI,
   441     public void setIdAttributeNS(String namespaceURI,
   442                                  String localName,
   442                                  String localName,
   443                                  boolean isId)
   443                                  boolean isId)
   444                                  throws DOMException;
   444                                  throws DOMException;
   457      * @param isId Whether the attribute is a of type ID.
   457      * @param isId Whether the attribute is a of type ID.
   458      * @exception DOMException
   458      * @exception DOMException
   459      *   NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
   459      *   NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
   460      *   <br>NOT_FOUND_ERR: Raised if the specified node is not an attribute
   460      *   <br>NOT_FOUND_ERR: Raised if the specified node is not an attribute
   461      *   of this element.
   461      *   of this element.
   462      * @since DOM Level 3
   462      * @since 1.5, DOM Level 3
   463      */
   463      */
   464     public void setIdAttributeNode(Attr idAttr,
   464     public void setIdAttributeNode(Attr idAttr,
   465                                    boolean isId)
   465                                    boolean isId)
   466                                    throws DOMException;
   466                                    throws DOMException;
   467 
   467