stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

8047723: @since tag cleanup in jaxp

Browse Source 
Reviewed-by: joehw
This commit is contained in:
Henry Jen 2014-06-19 15:35:10 -07:00
parent 80bb4ab1c8
commit 52f6412c53
105 changed files with 204 additions and 143 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
jaxp/src/javax/xml/parsers/DocumentBuilder.java
View File

@ -57,6 +57,7 @@ import org.xml.sax.SAXException;
* communicate with the application using these existing APIs.
*
* @author <a href="mailto:Jeff.Suttor@Sun.com">Jeff Suttor</a>
* @since 1.4
*/
public abstract class DocumentBuilder {

4
jaxp/src/javax/xml/parsers/DocumentBuilderFactory.java
View File

@ -35,7 +35,7 @@ import javax.xml.validation.Schema;
* @author <a href="mailto:Neeraj.Bajaj@sun.com">Neeraj Bajaj</a>
*
* @version $Revision: 1.9 $, $Date: 2010/05/25 16:19:44 $
* @since 1.4
*/
public abstract class DocumentBuilderFactory {
@ -440,6 +440,7 @@ public abstract class DocumentBuilderFactory {
* @throws ParserConfigurationException if this <code>DocumentBuilderFactory</code> or the <code>DocumentBuilder</code>s
* it creates cannot support this feature.
* @throws NullPointerException If the <code>name</code> parameter is null.
* @since 1.5
*/
public abstract void setFeature(String name, boolean value)
throws ParserConfigurationException;
@ -461,6 +462,7 @@ public abstract class DocumentBuilderFactory {
*
* @throws ParserConfigurationException if this <code>DocumentBuilderFactory</code>
* or the <code>DocumentBuilder</code>s it creates cannot support this feature.
* @since 1.5
*/
public abstract boolean getFeature(String name)
throws ParserConfigurationException;

1
jaxp/src/javax/xml/parsers/FactoryConfigurationError.java
View File

@ -33,6 +33,7 @@ package javax.xml.parsers;
*
* @author <a href="mailto:Jeff.Suttor@Sun.com">Jeff Suttor</a>
* @version $Revision: 1.7 $, $Date: 2010-11-01 04:36:09 $
* @since 1.4
*/
public class FactoryConfigurationError extends Error {

1
jaxp/src/javax/xml/parsers/ParserConfigurationException.java
View File

@ -29,6 +29,7 @@ package javax.xml.parsers;
* Indicates a serious configuration error.
*
* @author <a href="mailto:Jeff.Suttor@Sun.com">Jeff Suttor</a>
* @since 1.4
*/
public class ParserConfigurationException extends Exception {

1
jaxp/src/javax/xml/parsers/SAXParser.java
View File

@ -75,6 +75,7 @@ import org.xml.sax.helpers.DefaultHandler;
* this revised class.
*
* @author <a href="mailto:Jeff.Suttor@Sun.com">Jeff Suttor</a>
* @since 1.4
*/
public abstract class SAXParser {

2
jaxp/src/javax/xml/parsers/SAXParserFactory.java
View File

@ -38,7 +38,7 @@ import org.xml.sax.SAXNotSupportedException;
* @author <a href="mailto:Neeraj.Bajaj@sun.com">Neeraj Bajaj</a>
*
* @version $Revision: 1.9 $, $Date: 2010/05/25 16:19:44 $
*
* @since 1.4
*/
public abstract class SAXParserFactory {

2
jaxp/src/javax/xml/transform/ErrorListener.java
View File

@ -49,6 +49,8 @@ package javax.xml.transform;
*
* <p><code>Transformer</code>s may use this mechanism to report XML parsing
* errors as well as transformation errors.</p>
*
* @since 1.4
*/
public interface ErrorListener {

1
jaxp/src/javax/xml/transform/OutputKeys.java
View File

@ -33,6 +33,7 @@ package javax.xml.transform;
*
* @see <a href="http://www.w3.org/TR/xslt#output">
* section 16 of the XSL Transformations (XSLT) W3C Recommendation</a>
* @since 1.4
*/
public class OutputKeys {

1
jaxp/src/javax/xml/transform/Result.java
View File

@ -30,6 +30,7 @@ package javax.xml.transform;
* needed to build a transformation result tree.</p>
*
* @author <a href="Jeff.Suttor@Sun.com">Jeff Suttor</a>
* @since 1.4
*/
public interface Result {

2
jaxp/src/javax/xml/transform/Source.java
View File

@ -28,6 +28,8 @@ package javax.xml.transform;
/**
* An object that implements this interface contains the information
* needed to act as source input (XML source or transformation instructions).
*
* @since 1.4
*/
public interface Source {

2
jaxp/src/javax/xml/transform/SourceLocator.java
View File

@ -28,6 +28,8 @@ package javax.xml.transform;
/**
* This interface is primarily for the purposes of reporting where
* an error occurred in the XML source or transformation instructions.
*
* @since 1.4
*/
public interface SourceLocator {

2
jaxp/src/javax/xml/transform/Templates.java
View File

@ -37,6 +37,8 @@ import java.util.Properties;
* <p>Templates must be threadsafe for a given instance
* over multiple threads running concurrently, and may
* be used multiple times in a given session.</p>
*
* @since 1.4
*/
public interface Templates {

1
jaxp/src/javax/xml/transform/Transformer.java
View File

@ -45,6 +45,7 @@ import java.util.Properties;
* output properties are preserved across transformations.</p>
*
* @author <a href="Jeff.Suttor@Sun.com">Jeff Suttor</a>
* @since 1.4
*/
public abstract class Transformer {

2
jaxp/src/javax/xml/transform/TransformerConfigurationException.java
View File

@ -27,6 +27,8 @@ package javax.xml.transform;
/**
* Indicates a serious configuration error.
*
* @since 1.4
*/
public class TransformerConfigurationException extends TransformerException {

2
jaxp/src/javax/xml/transform/TransformerException.java
View File

@ -31,6 +31,8 @@ import java.lang.reflect.InvocationTargetException;
/**
* This class specifies an exceptional condition that occured
* during the transformation process.
*
* @since 1.4
*/
public class TransformerException extends Exception {

2
jaxp/src/javax/xml/transform/TransformerFactoryConfigurationError.java
View File

@ -30,6 +30,8 @@ package javax.xml.transform;
* exists. This error will typically be thrown when the class of a
* transformation factory specified in the system properties cannot be found
* or instantiated.
*
* @since 1.4
*/
public class TransformerFactoryConfigurationError extends Error {
private static final long serialVersionUID = -6527718720676281516L;

2
jaxp/src/javax/xml/transform/URIResolver.java
View File

@ -28,6 +28,8 @@ package javax.xml.transform;
/**
* <p>An object that implements this interface that can be called by the processor
* to turn a URI used in document(), xsl:import, or xsl:include into a Source object.
*
* @since 1.4
*/
public interface URIResolver {

2
jaxp/src/javax/xml/transform/dom/DOMLocator.java
View File

@ -37,6 +37,8 @@ import org.w3c.dom.Node;
* object returned by an exception. A {@link javax.xml.transform.Transformer}
* may use this object for purposes other than error reporting, for instance,
* to indicate the source node that originated a result node.
*
* @since 1.4
*/
public interface DOMLocator extends SourceLocator {

1
jaxp/src/javax/xml/transform/dom/DOMResult.java
View File

@ -35,6 +35,7 @@ import org.w3c.dom.Node;
* which may be retrieved with {@link #getNode()}.</p>
*
* @author <a href="Jeff.Suttor@Sun.com">Jeff Suttor</a>
* @since 1.4
*/
public class DOMResult implements Result {

1
jaxp/src/javax/xml/transform/dom/DOMSource.java
View File

@ -40,6 +40,7 @@ import org.w3c.dom.Node;
*
* @author <a href="Jeff.Suttor@Sun.com">Jeff Suttor</a>
* @see <a href="http://www.w3.org/TR/DOM-Level-2">Document Object Model (DOM) Level 2 Specification</a>
* @since 1.4
*/
public class DOMSource implements Source {

1
jaxp/src/javax/xml/transform/sax/SAXResult.java
View File

@ -34,6 +34,7 @@ import org.xml.sax.ext.LexicalHandler;
* <p>Acts as an holder for a transformation Result.</p>
*
* @author <a href="Jeff.Suttor@Sun.com">Jeff Suttor</a>
* @since 1.4
*/
public class SAXResult implements Result {

1
jaxp/src/javax/xml/transform/sax/SAXSource.java
View File

@ -41,6 +41,7 @@ import org.xml.sax.XMLReader;
* {@link javax.xml.parsers.SAXParserFactory#setNamespaceAware(boolean awareness)} method.</p>
*
* @author <a href="mailto:Jeff.Suttor@Sun.com">Jeff Suttor</a>
* @since 1.4
*/
public class SAXSource implements Source {

2
jaxp/src/javax/xml/transform/sax/SAXTransformerFactory.java
View File

@ -39,6 +39,8 @@ import org.xml.sax.XMLFilter;
* for an XMLReader used during a transformation, it should use a URIResolver
* to return the SAXSource which provides (with getXMLReader) a reference to
* the XMLReader.</p>
*
* @since 1.4
*/
public abstract class SAXTransformerFactory extends TransformerFactory {

2
jaxp/src/javax/xml/transform/sax/TemplatesHandler.java
View File

@ -34,6 +34,8 @@ import org.xml.sax.ContentHandler;
* parse events (parsing transformation instructions) into a Templates object.
*
* <p>Note that TemplatesHandler does not need to implement LexicalHandler.</p>
*
* @since 1.4
*/
public interface TemplatesHandler extends ContentHandler {

2
jaxp/src/javax/xml/transform/sax/TransformerHandler.java
View File

@ -36,6 +36,8 @@ import org.xml.sax.ext.LexicalHandler;
* A TransformerHandler
* listens for SAX ContentHandler parse events and transforms
* them to a Result.
*
* @since 1.4
*/
public interface TransformerHandler
extends ContentHandler, LexicalHandler, DTDHandler {

1
jaxp/src/javax/xml/transform/stream/StreamResult.java
View File

@ -37,6 +37,7 @@ import java.net.MalformedURLException;
* which may be XML, plain Text, HTML, or some other form of markup.</p>
*
* @author <a href="Jeff.Suttor@Sun.com">Jeff Suttor</a>
* @since 1.4
*/
public class StreamResult implements Result {

1
jaxp/src/javax/xml/transform/stream/StreamSource.java
View File

@ -39,6 +39,7 @@ import javax.xml.transform.Source;
* <code>StreamSource</code> instances may only be used once.</p>
*
* @author <a href="Jeff.Suttor@Sun.com">Jeff Suttor</a>
* @since 1.4
*/
public class StreamSource implements Source {

6
jaxp/src/org/w3c/dom/Attr.java
View File

@ -239,7 +239,7 @@ public interface Attr extends Node {
/**
* The <code>Element</code> node this attribute is attached to or
* <code>null</code> if this attribute is not in use.
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public Element getOwnerElement();
@ -249,7 +249,7 @@ public interface Attr extends Node {
* after loading the document or invoking
* <code>Document.normalizeDocument()</code>, <code>schemaTypeInfo</code>
* may not be reliable if the node was moved.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public TypeInfo getSchemaTypeInfo();
@ -297,7 +297,7 @@ public interface Attr extends Node {
* reevaluated in accordance to the schema used. As a consequence, if
* the <code>Attr.schemaTypeInfo</code> attribute contains an ID type,
* <code>isId</code> will always return true.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public boolean isId();

2
jaxp/src/org/w3c/dom/DOMConfiguration.java
View File

@ -383,7 +383,7 @@ package org.w3c.dom;
* set, <code>Document.normalizeDocument()</code> will invoke the resource
* resolver instead of using <code>Document.documentURI</code>.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public interface DOMConfiguration {
/**

2
jaxp/src/org/w3c/dom/DOMError.java
View File

@ -44,7 +44,7 @@ package org.w3c.dom;
/**
* <code>DOMError</code> is an interface that describes an error.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public interface DOMError {
// ErrorSeverity

2
jaxp/src/org/w3c/dom/DOMErrorHandler.java
View File

@ -53,7 +53,7 @@ package org.w3c.dom;
* <p> The application that is using the DOM implementation is expected to
* implement this interface.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public interface DOMErrorHandler {
/**

14
jaxp/src/org/w3c/dom/DOMException.java
View File

@ -116,29 +116,29 @@ public class DOMException extends RuntimeException {
/**
* If an attempt is made to use an object that is not, or is no longer,
* usable.
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public static final short INVALID_STATE_ERR = 11;
/**
* If an invalid or illegal string is specified.
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public static final short SYNTAX_ERR = 12;
/**
* If an attempt is made to modify the type of the underlying object.
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public static final short INVALID_MODIFICATION_ERR = 13;
/**
* If an attempt is made to create or change an object in a way which is
* incorrect with regard to namespaces.
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public static final short NAMESPACE_ERR = 14;
/**
* If a parameter or an operation is not supported by the underlying
* object.
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public static final short INVALID_ACCESS_ERR = 15;
/**
@ -147,13 +147,13 @@ public class DOMException extends RuntimeException {
* with respect to "partial validity", this exception would be raised
* and the operation would not be done. This code is used in [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Val-20040127/'>DOM Level 3 Validation</a>]
* . Refer to this specification for further information.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public static final short VALIDATION_ERR = 16;
/**
* If the type of an object is incompatible with the expected type of the
* parameter associated to the object.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public static final short TYPE_MISMATCH_ERR = 17;

6
jaxp/src/org/w3c/dom/DOMImplementation.java
View File

@ -77,7 +77,7 @@ public interface DOMImplementation {
* <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not
* support the feature "XML" and the language exposed 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>]).
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public DocumentType createDocumentType(String qualifiedName,
String publicId,
@ -129,7 +129,7 @@ public interface DOMImplementation {
* <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not
* support the feature "XML" and the language exposed 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>]).
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public Document createDocument(String namespaceURI,
String qualifiedName,
@ -157,7 +157,7 @@ public interface DOMImplementation {
* return results inconsistent with the primary core
* <code>DOMImplementation</code> such as <code>hasFeature</code>,
* <code>getFeature</code>, etc.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public Object getFeature(String feature,
String version);

2
jaxp/src/org/w3c/dom/DOMImplementationList.java
View File

@ -48,7 +48,7 @@ package org.w3c.dom;
* <code>DOMImplementationList</code> are accessible via an integral index,
* starting from 0.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public interface DOMImplementationList {
/**

2
jaxp/src/org/w3c/dom/DOMImplementationSource.java
View File

@ -49,7 +49,7 @@ package org.w3c.dom;
* listed in the binding-specific list of available sources so that its
* <code>DOMImplementation</code> objects are made available.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public interface DOMImplementationSource {
/**

2
jaxp/src/org/w3c/dom/DOMLocator.java
View File

@ -45,7 +45,7 @@ package org.w3c.dom;
* <code>DOMLocator</code> is an interface that describes a location (e.g.
* where an error occurred).
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public interface DOMLocator {
/**

2
jaxp/src/org/w3c/dom/DOMStringList.java
View File

@ -48,7 +48,7 @@ package org.w3c.dom;
* <code>DOMStringList</code> are accessible via an integral index, starting
* from 0.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public interface DOMStringList {
/**

40
jaxp/src/org/w3c/dom/Document.java
View File

@ -73,7 +73,7 @@ public interface Document extends Node {
* changing it afterwards is very unlikely to result in a change of the
* features supported.
*
* @since DOM Level 3
* @since 1.4, DOM Level 3
*/
public DocumentType getDoctype();
@ -337,7 +337,7 @@ public interface Document extends Node {
* <code>Document.xmlVersion</code> attribute. This may happen when
* importing an XML 1.1 [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>] element
* into an XML 1.0 document, for instance.
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public Node importNode(Node importedNode,
boolean deep)
@ -401,7 +401,7 @@ public interface Document extends Node {
* <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 1.4, DOM Level 2
*/
public Element createElementNS(String namespaceURI,
String qualifiedName)
@ -470,7 +470,7 @@ public interface Document extends Node {
* <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 1.4, DOM Level 2
*/
public Attr createAttributeNS(String namespaceURI,
String qualifiedName)
@ -485,7 +485,7 @@ public interface Document extends Node {
* special value "*" matches all local names.
* @return A new <code>NodeList</code> object containing all the matched
* <code>Elements</code>.
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public NodeList getElementsByTagNameNS(String namespaceURI,
String localName);
@ -501,7 +501,7 @@ public interface Document extends Node {
* ID unless so defined.
* @param elementId The unique <code>id</code> value for an element.
* @return The matching element or <code>null</code> if there is none.
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public Element getElementById(String elementId);
@ -509,7 +509,7 @@ public interface Document extends Node {
* An attribute specifying the encoding used for this document at the time
* of the parsing. This is <code>null</code> when it is not known, such
* as when the <code>Document</code> was created in memory.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public String getInputEncoding();
@ -517,7 +517,7 @@ public interface Document extends Node {
* An attribute specifying, as part of the <a href='http://www.w3.org/TR/2004/REC-xml-20040204#NT-XMLDecl'>XML declaration</a>, the encoding of this document. This is <code>null</code> when
* unspecified or when it is not known, such as when the
* <code>Document</code> was created in memory.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public String getXmlEncoding();
@ -529,7 +529,7 @@ public interface Document extends Node {
* <code>Document.normalizeDocument()</code> with the "validate"
* parameter to verify if the value matches the <a href='http://www.w3.org/TR/2004/REC-xml-20040204#sec-rmd'>validity
* constraint for standalone document declaration</a> as defined in [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>].
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public boolean getXmlStandalone();
/**
@ -543,7 +543,7 @@ public interface Document extends Node {
* @exception DOMException
* NOT_SUPPORTED_ERR: Raised if this document does not support the
* "XML" feature.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public void setXmlStandalone(boolean xmlStandalone)
throws DOMException;
@ -570,7 +570,7 @@ public interface Document extends Node {
* objects supporting a version of the "XMLVersion" feature must not
* raise a <code>NOT_SUPPORTED_ERR</code> exception for the same version
* number when using <code>Document.xmlVersion</code>.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public String getXmlVersion();
/**
@ -599,7 +599,7 @@ public interface Document extends Node {
* NOT_SUPPORTED_ERR: Raised if the version is set to a value that is
* not supported by this <code>Document</code> or if this document
* does not support the "XML" feature.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public void setXmlVersion(String xmlVersion)
throws DOMException;
@ -612,7 +612,7 @@ public interface Document extends Node {
* errors while using <code>Document.normalizeDocument()</code>. In case
* of error, the behavior is undefined. This attribute is
* <code>true</code> by default.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public boolean getStrictErrorChecking();
/**
@ -623,7 +623,7 @@ public interface Document extends Node {
* errors while using <code>Document.normalizeDocument()</code>. In case
* of error, the behavior is undefined. This attribute is
* <code>true</code> by default.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public void setStrictErrorChecking(boolean strictErrorChecking);
@ -638,7 +638,7 @@ public interface Document extends Node {
* "HTML" [<a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>DOM Level 2 HTML</a>]
* , the href attribute of the HTML BASE element takes precedence over
* this attribute when computing <code>Node.baseURI</code>.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public String getDocumentURI();
/**
@ -652,7 +652,7 @@ public interface Document extends Node {
* "HTML" [<a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>DOM Level 2 HTML</a>]
* , the href attribute of the HTML BASE element takes precedence over
* this attribute when computing <code>Node.baseURI</code>.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public void setDocumentURI(String documentURI);
@ -723,7 +723,7 @@ public interface Document extends Node {
* <code>DOCUMENT</code>, <code>DOCUMENT_TYPE</code>.
* <br>NO_MODIFICATION_ALLOWED_ERR: Raised when the source node is
* readonly.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public Node adoptNode(Node source)
throws DOMException;
@ -731,7 +731,7 @@ public interface Document extends Node {
/**
* The configuration used when <code>Document.normalizeDocument()</code>
* is invoked.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public DOMConfiguration getDomConfig();
@ -765,7 +765,7 @@ public interface Document extends Node {
* " parameter. Note this method might also report fatal errors (
* <code>DOMError.SEVERITY_FATAL_ERROR</code>) if an implementation
* cannot recover from an error.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public void normalizeDocument();
@ -834,7 +834,7 @@ public interface Document extends Node {
* . Also raised, when the node being renamed is an attribute, if the
* <code>qualifiedName</code>, or its prefix, is "xmlns" and the
* <code>namespaceURI</code> is different from "<a href='http://www.w3.org/2000/xmlns/'>http://www.w3.org/2000/xmlns/</a>".
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public Node renameNode(Node n,
String namespaceURI,

6
jaxp/src/org/w3c/dom/DocumentType.java
View File

@ -87,14 +87,14 @@ public interface DocumentType extends Node {
/**
* The public identifier of the external subset.
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public String getPublicId();
/**
* The system identifier of the external subset. This may be an absolute
* URI or not.
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public String getSystemId();
@ -105,7 +105,7 @@ public interface DocumentType extends Node {
* information is available to the implementation. This may vary
* depending on various parameters, including the XML processor used to
* build the document.
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public String getInternalSubset();

24
jaxp/src/org/w3c/dom/Element.java
View File

@ -203,7 +203,7 @@ public interface Element extends Node {
* NOT_SUPPORTED_ERR: May be raised if the implementation does not
* support the feature <code>"XML"</code> and the language exposed
* 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>]).
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public String getAttributeNS(String namespaceURI,
String localName)
@ -249,7 +249,7 @@ public interface Element extends Node {
* <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not
* support the feature <code>"XML"</code> and the language exposed
* 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>]).
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public void setAttributeNS(String namespaceURI,
String qualifiedName,
@ -278,7 +278,7 @@ public interface Element extends Node {
* <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not
* support the feature <code>"XML"</code> and the language exposed
* 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>]).
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public void removeAttributeNS(String namespaceURI,
String localName)
@ -299,7 +299,7 @@ public interface Element extends Node {
* NOT_SUPPORTED_ERR: May be raised if the implementation does not
* support the feature <code>"XML"</code> and the language exposed
* 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>]).
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public Attr getAttributeNodeNS(String namespaceURI,
String localName)
@ -329,7 +329,7 @@ public interface Element extends Node {
* <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not
* support the feature <code>"XML"</code> and the language exposed
* 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>]).
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public Attr setAttributeNodeNS(Attr newAttr)
throws DOMException;
@ -348,7 +348,7 @@ public interface Element extends Node {
* NOT_SUPPORTED_ERR: May be raised if the implementation does not
* support the feature <code>"XML"</code> and the language exposed
* 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>]).
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public NodeList getElementsByTagNameNS(String namespaceURI,
String localName)
@ -362,7 +362,7 @@ public interface Element extends Node {
* @return <code>true</code> if an attribute with the given name is
* specified on this element or has a default value, <code>false</code>
* otherwise.
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public boolean hasAttribute(String name);
@ -383,7 +383,7 @@ public interface Element extends Node {
* NOT_SUPPORTED_ERR: May be raised if the implementation does not
* support the feature <code>"XML"</code> and the language exposed
* 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>]).
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public boolean hasAttributeNS(String namespaceURI,
String localName)
@ -391,7 +391,7 @@ public interface Element extends Node {
/**
* The type information associated with this element.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public TypeInfo getSchemaTypeInfo();
@ -413,7 +413,7 @@ public interface Element extends Node {
* NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
* <br>NOT_FOUND_ERR: Raised if the specified node is not an attribute
* of this element.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public void setIdAttribute(String name,
boolean isId)
@ -436,7 +436,7 @@ public interface Element extends Node {
* NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
* <br>NOT_FOUND_ERR: Raised if the specified node is not an attribute
* of this element.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public void setIdAttributeNS(String namespaceURI,
String localName,
@ -459,7 +459,7 @@ public interface Element extends Node {
* NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
* <br>NOT_FOUND_ERR: Raised if the specified node is not an attribute
* of this element.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public void setIdAttributeNode(Attr idAttr,
boolean isId)

6
jaxp/src/org/w3c/dom/Entity.java
View File

@ -96,7 +96,7 @@ public interface Entity extends Node {
* of parsing, when it is an external parsed entity. This is
* <code>null</code> if it an entity from the internal subset or if it
* is not known.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public String getInputEncoding();
@ -104,7 +104,7 @@ public interface Entity extends Node {
* An attribute specifying, as part of the text declaration, the encoding
* of this entity, when it is an external parsed entity. This is
* <code>null</code> otherwise.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public String getXmlEncoding();
@ -112,7 +112,7 @@ public interface Entity extends Node {
* An attribute specifying, as part of the text declaration, the version
* number of this entity, when it is an external parsed entity. This is
* <code>null</code> otherwise.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public String getXmlVersion();

2
jaxp/src/org/w3c/dom/NameList.java
View File

@ -48,7 +48,7 @@ package org.w3c.dom;
* implemented. The items in the <code>NameList</code> are accessible via an
* integral index, starting from 0.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public interface NameList {
/**

6
jaxp/src/org/w3c/dom/NamedNodeMap.java
View File

@ -141,7 +141,7 @@ public interface NamedNodeMap {
* NOT_SUPPORTED_ERR: May be raised if the implementation does not
* support the feature "XML" and the language exposed 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>]).
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public Node getNamedItemNS(String namespaceURI,
String localName)
@ -177,7 +177,7 @@ public interface NamedNodeMap {
* <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not
* support the feature "XML" and the language exposed 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>]).
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public Node setNamedItemNS(Node arg)
throws DOMException;
@ -203,7 +203,7 @@ public interface NamedNodeMap {
* <br>NOT_SUPPORTED_ERR: May be raised if the implementation does not
* support the feature "XML" and the language exposed 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>]).
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public Node removeNamedItemNS(String namespaceURI,
String localName)

48
jaxp/src/org/w3c/dom/Node.java
View File

@ -299,7 +299,7 @@ public interface Node {
* which is not used with any <code>Document</code> yet, this is
* <code>null</code>.
*
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public Document getOwnerDocument();
@ -335,7 +335,7 @@ public interface Node {
* support the insertion of a <code>DocumentType</code> or
* <code>Element</code> node.
*
* @since DOM Level 3
* @since 1.4, DOM Level 3
*/
public Node insertBefore(Node newChild,
Node refChild)
@ -373,7 +373,7 @@ public interface Node {
* support the replacement of the <code>DocumentType</code> child or
* <code>Element</code> child.
*
* @since DOM Level 3
* @since 1.4, DOM Level 3
*/
public Node replaceChild(Node newChild,
Node oldChild)
@ -393,7 +393,7 @@ public interface Node {
* support the removal of the <code>DocumentType</code> child or the
* <code>Element</code> child.
*
* @since DOM Level 3
* @since 1.4, DOM Level 3
*/
public Node removeChild(Node oldChild)
throws DOMException;
@ -422,7 +422,7 @@ public interface Node {
* if the DOM implementation doesn't support the removal of the
* <code>DocumentType</code> child or <code>Element</code> child.
*
* @since DOM Level 3
* @since 1.4, DOM Level 3
*/
public Node appendChild(Node newChild)
throws DOMException;
@ -491,7 +491,7 @@ public interface Node {
* sufficient, since XPointers do not differentiate between
* <code>Text</code> nodes and <code>CDATASection</code> nodes.
*
* @since DOM Level 3
* @since 1.4, DOM Level 3
*/
public void normalize();
@ -503,7 +503,7 @@ public interface Node {
* @return Returns <code>true</code> if the specified feature is
* supported on this node, <code>false</code> otherwise.
*
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public boolean isSupported(String feature,
String version);
@ -523,7 +523,7 @@ public interface Node {
* attached to. If an attribute is not explicitly given a namespace, it
* simply has no namespace.
*
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public String getNamespaceURI();
@ -547,7 +547,7 @@ public interface Node {
* method, such as <code>createElement</code> from the
* <code>Document</code> interface, this is always <code>null</code>.
*
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public String getPrefix();
/**
@ -584,7 +584,7 @@ public interface Node {
* this node is "xmlns" [<a href='http://www.w3.org/TR/1999/REC-xml-names-19990114/'>XML Namespaces</a>]
* .
*
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public void setPrefix(String prefix)
throws DOMException;
@ -596,7 +596,7 @@ public interface Node {
* method, such as <code>Document.createElement()</code>, this is always
* <code>null</code>.
*
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public String getLocalName();
@ -605,7 +605,7 @@ public interface Node {
* @return Returns <code>true</code> if this node has any attributes,
* <code>false</code> otherwise.
*
* @since DOM Level 2
* @since 1.4, DOM Level 2
*/
public boolean hasAttributes();
@ -619,7 +619,7 @@ public interface Node {
* <code>documentURI</code> attribute from the <code>Document</code>
* interface otherwise.
*
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public String getBaseURI();
@ -666,7 +666,7 @@ public interface Node {
* implementations that do not coordinate to return consistent
* implementation-specific results.
*
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public short compareDocumentPosition(Node other)
throws DOMException;
@ -717,7 +717,7 @@ public interface Node {
* fit in a <code>DOMString</code> variable on the implementation
* platform.
*
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public String getTextContent()
throws DOMException;
@ -765,7 +765,7 @@ public interface Node {
* @exception DOMException
* NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.
*
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public void setTextContent(String textContent)
throws DOMException;
@ -783,7 +783,7 @@ public interface Node {
* @return Returns <code>true</code> if the nodes are the same,
* <code>false</code> otherwise.
*
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public boolean isSameNode(Node other);
@ -798,7 +798,7 @@ public interface Node {
* associated to the namespace prefix, the returned namespace prefix
* is implementation dependent.
*
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public String lookupPrefix(String namespaceURI);
@ -810,7 +810,7 @@ public interface Node {
* <code>namespaceURI</code> is the default namespace,
* <code>false</code> otherwise.
*
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public boolean isDefaultNamespace(String namespaceURI);
@ -824,7 +824,7 @@ public interface Node {
* @return Returns the associated namespace URI or <code>null</code> if
* none is found.
*
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public String lookupNamespaceURI(String prefix);
@ -890,7 +890,7 @@ public interface Node {
* @return Returns <code>true</code> if the nodes are equal,
* <code>false</code> otherwise.
*
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public boolean isEqualNode(Node arg);
@ -915,7 +915,7 @@ public interface Node {
* with the primary core <code>Node</code> such as attributes,
* childNodes, etc.
*
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public Object getFeature(String feature,
String version);
@ -932,7 +932,7 @@ public interface Node {
* @return Returns the <code>DOMUserData</code> previously associated to
* the given key on this node, or <code>null</code> if there was none.
*
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public Object setUserData(String key,
Object data,
@ -946,7 +946,7 @@ public interface Node {
* @return Returns the <code>DOMUserData</code> associated to the given
* key on this node, or <code>null</code> if there was none.
*
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public Object getUserData(String key);

6
jaxp/src/org/w3c/dom/Text.java
View File

@ -93,7 +93,7 @@ public interface Text extends CharacterData {
* determined to contain whitespace in element content during the load
* of the document or if validation occurs while using
* <code>Document.normalizeDocument()</code>.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public boolean isElementContentWhitespace();
@ -121,7 +121,7 @@ public interface Text extends CharacterData {
* </pre>
* <em>Figure: barTextNode.wholeText value is "barfoo"</em>
*
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public String getWholeText();
@ -179,7 +179,7 @@ public interface Text extends CharacterData {
* @exception DOMException
* NO_MODIFICATION_ALLOWED_ERR: Raised if one of the <code>Text</code>
* nodes being replaced is readonly.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public Text replaceWholeText(String content)
throws DOMException;

2
jaxp/src/org/w3c/dom/TypeInfo.java
View File

@ -118,7 +118,7 @@ package org.w3c.dom;
* and therefore should define how to represent their type systems using
* <code>TypeInfo</code>.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public interface TypeInfo {
/**

2
jaxp/src/org/w3c/dom/UserDataHandler.java
View File

@ -49,7 +49,7 @@ package org.w3c.dom;
* implement various behaviors regarding the data it associates to the DOM
* nodes. This interface defines that handler.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public interface UserDataHandler {
// OperationType

2
jaxp/src/org/w3c/dom/bootstrap/DOMImplementationRegistry.java
View File

@ -79,7 +79,7 @@ import java.security.PrivilegedAction;
*
* @see DOMImplementation
* @see DOMImplementationSource
* @since DOM Level 3
* @since 1.5, DOM Level 3
*/
public final class DOMImplementationRegistry {
/**

2
jaxp/src/org/w3c/dom/events/DocumentEvent.java
View File

@ -50,7 +50,7 @@ import org.w3c.dom.DOMException;
* implemented on the same object which implements the <code>Document</code>
* interface in an implementation which supports the Event model.
* <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113'>Document Object Model (DOM) Level 2 Events Specification</a>.
* @since DOM Level 2
* @since 1.5, DOM Level 2
*/
public interface DocumentEvent {
/**

2
jaxp/src/org/w3c/dom/events/Event.java
View File

@ -51,7 +51,7 @@ package org.w3c.dom.events;
* type of event they accompany. These derived interfaces are also
* implemented by the object passed to the event listener.
* <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113'>Document Object Model (DOM) Level 2 Events Specification</a>.
* @since DOM Level 2
* @since 1.5, DOM Level 2
*/
public interface Event {
// PhaseType

2
jaxp/src/org/w3c/dom/events/EventException.java
View File

@ -45,7 +45,7 @@ package org.w3c.dom.events;
* Event operations may throw an <code>EventException</code> as specified in
* their method descriptions.
* <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113'>Document Object Model (DOM) Level 2 Events Specification</a>.
* @since DOM Level 2
* @since 1.5, DOM Level 2
*/
public class EventException extends RuntimeException {
public EventException(short code, String message) {

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

@ -54,7 +54,7 @@ package org.w3c.dom.events;
* the user wishes the same <code>EventListener</code>s to be added to the
* newly created copy the user must add them manually.
* <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113'>Document Object Model (DOM) Level 2 Events Specification</a>.
* @since DOM Level 2
* @since 1.5, DOM Level 2
*/
public interface EventListener {
/**

2
jaxp/src/org/w3c/dom/events/EventTarget.java
View File

@ -50,7 +50,7 @@ package org.w3c.dom.events;
* <code>EventListeners</code> on an <code>EventTarget</code> and dispatch
* of events to that <code>EventTarget</code>.
* <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113'>Document Object Model (DOM) Level 2 Events Specification</a>.
* @since DOM Level 2
* @since 1.5, DOM Level 2
*/
public interface EventTarget {
/**

2
jaxp/src/org/w3c/dom/events/MouseEvent.java
View File

@ -58,7 +58,7 @@ import org.w3c.dom.views.AbstractView;
* bubbling to obtain notification of mouse events which occur within its
* descendent elements.
* <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113'>Document Object Model (DOM) Level 2 Events Specification</a>.
* @since DOM Level 2
* @since 1.5, DOM Level 2
*/
public interface MouseEvent extends UIEvent {
/**

2
jaxp/src/org/w3c/dom/events/MutationEvent.java
View File

@ -47,7 +47,7 @@ import org.w3c.dom.Node;
* The <code>MutationEvent</code> interface provides specific contextual
* information associated with Mutation events.
* <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113'>Document Object Model (DOM) Level 2 Events Specification</a>.
* @since DOM Level 2
* @since 1.5, DOM Level 2
*/
public interface MutationEvent extends Event {
// attrChangeType

2
jaxp/src/org/w3c/dom/events/UIEvent.java
View File

@ -47,7 +47,7 @@ import org.w3c.dom.views.AbstractView;
* The <code>UIEvent</code> interface provides specific contextual information
* associated with User Interface events.
* <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113'>Document Object Model (DOM) Level 2 Events Specification</a>.
* @since DOM Level 2
* @since 1.5, DOM Level 2
*/
public interface UIEvent extends Event {
/**

2
jaxp/src/org/w3c/dom/ls/DOMImplementationLS.java
View File

@ -57,6 +57,8 @@ import org.w3c.dom.DOMException;
* <code>"3.0"</code> (respectively).
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load
and Save Specification</a>.
*
* @since 1.5
*/
public interface DOMImplementationLS {
// DOMImplementationLSMode

2
jaxp/src/org/w3c/dom/ls/LSException.java
View File

@ -54,6 +54,8 @@ package org.w3c.dom.ls;
* implementation dependent.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load
and Save Specification</a>.
*
* @since 1.5
*/
public class LSException extends RuntimeException {
public LSException(short code, String message) {

2
jaxp/src/org/w3c/dom/ls/LSInput.java
View File

@ -82,6 +82,8 @@ package org.w3c.dom.ls;
* modify the copies, if necessary).
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load
and Save Specification</a>.
*
* @since 1.5
*/
public interface LSInput {
/**

2
jaxp/src/org/w3c/dom/ls/LSLoadEvent.java
View File

@ -49,6 +49,8 @@ import org.w3c.dom.events.Event;
* of a document load.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load
and Save Specification</a>.
*
* @since 1.5
*/
public interface LSLoadEvent extends Event {
/**

2
jaxp/src/org/w3c/dom/ls/LSOutput.java
View File

@ -74,6 +74,8 @@ package org.w3c.dom.ls;
* modify the copies, if necessary).
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load
and Save Specification</a>.
*
* @since 1.5
*/
public interface LSOutput {
/**

2
jaxp/src/org/w3c/dom/ls/LSParser.java
View File

@ -166,6 +166,8 @@ import org.w3c.dom.DOMException;
* permission denied,...), XML well-formedness errors, and so on.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load
and Save Specification</a>.
*
* @since 1.5
*/
public interface LSParser {
/**

2
jaxp/src/org/w3c/dom/ls/LSParserFilter.java
View File

@ -73,6 +73,8 @@ import org.w3c.dom.Element;
* throwing exceptions from a filter is DOM implementation dependent.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load
and Save Specification</a>.
*
* @since 1.5
*/
public interface LSParserFilter {
// Constants returned by startElement and acceptNode

2
jaxp/src/org/w3c/dom/ls/LSProgressEvent.java
View File

@ -53,6 +53,8 @@ import org.w3c.dom.events.Event;
* input dependent.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load
and Save Specification</a>.
*
* @since 1.5
*/
public interface LSProgressEvent extends Event {
/**

2
jaxp/src/org/w3c/dom/ls/LSResourceResolver.java
View File

@ -63,6 +63,8 @@ package org.w3c.dom.ls;
* interface.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load
and Save Specification</a>.
*
* @since 1.5
*/
public interface LSResourceResolver {
/**

2
jaxp/src/org/w3c/dom/ls/LSSerializer.java
View File

@ -204,6 +204,8 @@ import org.w3c.dom.DOMException;
* permission denied,...) and so on.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load
and Save Specification</a>.
*
* @since 1.5
*/
public interface LSSerializer {
/**

2
jaxp/src/org/w3c/dom/ls/LSSerializerFilter.java
View File

@ -70,6 +70,8 @@ import org.w3c.dom.traversal.NodeFilter;
* document.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load
and Save Specification</a>.
*
* @since 1.5
*/
public interface LSSerializerFilter extends NodeFilter {
/**

2
jaxp/src/org/w3c/dom/package.html
View File

@ -10,6 +10,6 @@ to dynamically access and update the content and structure of documents.
See the <a href="http://www.w3.org/TR/DOM-Level-2-Core/">specification</a>
for more information.
@since JDK1.4
@since 1.4
</body>
</html>

2
jaxp/src/org/w3c/dom/views/AbstractView.java
View File

@ -44,7 +44,7 @@ package org.w3c.dom.views;
/**
* A base interface that all views shall derive from.
* <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Views-20001113'>Document Object Model (DOM) Level 2 Views Specification</a>.
* @since DOM Level 2
* @since 1.8, DOM Level 2
*/
public interface AbstractView {
/**

2
jaxp/src/org/w3c/dom/views/DocumentView.java
View File

@ -47,7 +47,7 @@ package org.w3c.dom.views;
* Views. It provides an attribute to retrieve the default view of a
* document.
* <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Views-20001113'>Document Object Model (DOM) Level 2 Views Specification</a>.
* @since DOM Level 2
* @since 1.8, DOM Level 2
*/
public interface DocumentView {
/**

2
jaxp/src/org/xml/sax/AttributeList.java
View File

@ -88,7 +88,7 @@ package org.xml.sax;
* @deprecated This interface has been replaced by the SAX2
* {@link org.xml.sax.Attributes Attributes}
* interface, which includes Namespace support.
* @since SAX 1.0
* @since 1.4, SAX 1.0
* @author David Megginson
* @see org.xml.sax.DocumentHandler#startElement startElement
* @see org.xml.sax.helpers.AttributeListImpl AttributeListImpl

2
jaxp/src/org/xml/sax/Attributes.java
View File

@ -85,7 +85,7 @@ package org.xml.sax;
* <p>The order of attributes in the list is unspecified, and will
* vary from implementation to implementation.</p>
*
* @since SAX 2.0
* @since 1.4, SAX 2.0
* @author David Megginson
* @see org.xml.sax.helpers.AttributesImpl
* @see org.xml.sax.ext.DeclHandler#attributeDecl

2
jaxp/src/org/xml/sax/ContentHandler.java
View File

@ -73,7 +73,7 @@ package org.xml.sax;
* anyway, so the user should consider this a feature rather than a
* bug.</p>
*
* @since SAX 2.0
* @since 1.4, SAX 2.0
* @author David Megginson
* @see org.xml.sax.XMLReader
* @see org.xml.sax.DTDHandler

2
jaxp/src/org/xml/sax/DTDHandler.java
View File

@ -67,7 +67,7 @@ package org.xml.sax;
* obtained through this interface to find the entity and/or
* notation corresponding with the attribute value.</p>
*
* @since SAX 1.0
* @since 1.4, SAX 1.0
* @author David Megginson
* @see org.xml.sax.XMLReader#setDTDHandler
*/

2
jaxp/src/org/xml/sax/DocumentHandler.java
View File

@ -62,7 +62,7 @@ package org.xml.sax;
* @deprecated This interface has been replaced by the SAX2
* {@link org.xml.sax.ContentHandler ContentHandler}
* interface, which includes Namespace support.
* @since SAX 1.0
* @since 1.4, SAX 1.0
* @author David Megginson
* @see org.xml.sax.Parser#setDocumentHandler
* @see org.xml.sax.Locator

2
jaxp/src/org/xml/sax/EntityResolver.java
View File

@ -85,7 +85,7 @@ import java.io.IOException;
* identifiers to local URIs or to look up replacements in a catalog
* (possibly by using the public identifier).</p>
*
* @since SAX 1.0
* @since 1.4, SAX 1.0
* @author David Megginson
* @see org.xml.sax.XMLReader#setEntityResolver
* @see org.xml.sax.InputSource

2
jaxp/src/org/xml/sax/ErrorHandler.java
View File

@ -65,7 +65,7 @@ package org.xml.sax;
* For example, {@link XMLReader#parse XMLReader.parse()} would throw
* an IOException for errors accessing entities or the document.</p>
*
* @since SAX 1.0
* @since 1.4, SAX 1.0
* @author David Megginson
* @see org.xml.sax.XMLReader#setErrorHandler
* @see org.xml.sax.SAXParseException

2
jaxp/src/org/xml/sax/HandlerBase.java
View File

@ -59,7 +59,7 @@ package org.xml.sax;
* interface. It has been replaced by the SAX2
* {@link org.xml.sax.helpers.DefaultHandler DefaultHandler}
* class.
* @since SAX 1.0
* @since 1.4, SAX 1.0
* @author David Megginson
* @see org.xml.sax.EntityResolver
* @see org.xml.sax.DTDHandler

2
jaxp/src/org/xml/sax/InputSource.java
View File

@ -74,7 +74,7 @@ import java.io.InputStream;
* so applications should not attempt to re-use such streams after they
* have been handed to a parser. </p>
*
* @since SAX 1.0
* @since 1.4, SAX 1.0
* @author David Megginson
* @see org.xml.sax.XMLReader#parse(org.xml.sax.InputSource)
* @see org.xml.sax.EntityResolver#resolveEntity

2
jaxp/src/org/xml/sax/Locator.java
View File

@ -62,7 +62,7 @@ package org.xml.sax;
* event, the application should assume that a locator is not
* available.</p>
*
* @since SAX 1.0
* @since 1.4, SAX 1.0
* @author David Megginson
* @see org.xml.sax.ContentHandler#setDocumentLocator
*/

2
jaxp/src/org/xml/sax/Parser.java
View File

@ -64,7 +64,7 @@ import java.util.Locale;
* @deprecated This interface has been replaced by the SAX2
* {@link org.xml.sax.XMLReader XMLReader}
* interface, which includes Namespace support.
* @since SAX 1.0
* @since 1.4, SAX 1.0
* @author David Megginson
* @see org.xml.sax.EntityResolver
* @see org.xml.sax.DTDHandler

2
jaxp/src/org/xml/sax/SAXException.java
View File

@ -54,7 +54,7 @@ package org.xml.sax;
* specific location in an XML document, it should use the
* {@link org.xml.sax.SAXParseException SAXParseException} subclass.</p>
*
* @since SAX 1.0
* @since 1.4, SAX 1.0
* @author David Megginson
* @version 2.0.1 (sax2r2)
* @see org.xml.sax.SAXParseException

2
jaxp/src/org/xml/sax/SAXNotRecognizedException.java
View File

@ -46,7 +46,7 @@ package org.xml.sax;
* unrecognized feature or property identifier; SAX applications and
* extensions may use this class for other, similar purposes.</p>
*
* @since SAX 2.0
* @since 1.4, SAX 2.0
* @author David Megginson
* @see org.xml.sax.SAXNotSupportedException
*/

2
jaxp/src/org/xml/sax/SAXNotSupportedException.java
View File

@ -46,7 +46,7 @@ package org.xml.sax;
* operation (setting a state or value). Other SAX2 applications and
* extensions may use this class for similar purposes.</p>
*
* @since SAX 2.0
* @since 1.4, SAX 2.0
* @author David Megginson
* @see org.xml.sax.SAXNotRecognizedException
*/

2
jaxp/src/org/xml/sax/SAXParseException.java
View File

@ -52,7 +52,7 @@ package org.xml.sax;
* <p>Since this exception is a subclass of {@link org.xml.sax.SAXException
* SAXException}, it inherits the ability to wrap another exception.</p>
*
* @since SAX 1.0
* @since 1.4, SAX 1.0
* @author David Megginson
* @version 2.0.1 (sax2r2)
* @see org.xml.sax.SAXException

2
jaxp/src/org/xml/sax/XMLFilter.java
View File

@ -53,7 +53,7 @@ package org.xml.sax;
* {@link org.xml.sax.ContentHandler ContentHandler} and {@link org.xml.sax.ErrorHandler
* ErrorHandler} events automatically.</p>
*
* @since SAX 2.0
* @since 1.4, SAX 2.0
* @author David Megginson
* @see org.xml.sax.helpers.XMLFilterImpl
*/

2
jaxp/src/org/xml/sax/XMLReader.java
View File

@ -75,7 +75,7 @@ import java.io.IOException;
* <p>There are adapters available to convert a SAX1 Parser to
* a SAX2 XMLReader and vice-versa.</p>
*
* @since SAX 2.0
* @since 1.4, SAX 2.0
* @author David Megginson
* @see org.xml.sax.XMLFilter
* @see org.xml.sax.helpers.ParserAdapter

2
jaxp/src/org/xml/sax/ext/Attributes2.java
View File

@ -57,7 +57,7 @@ import org.xml.sax.Attributes;
* must have been declared.
* </p>
*
* @since SAX 2.0 (extensions 1.1 alpha)
* @since 1.5, SAX 2.0 (extensions 1.1 alpha)
* @author David Brownell
*/
public interface Attributes2 extends Attributes

2
jaxp/src/org/xml/sax/ext/Attributes2Impl.java
View File

@ -56,7 +56,7 @@ import org.xml.sax.helpers.AttributesImpl;
* its <em>declared</em> flag to match.
* </p>
*
* @since SAX 2.0 (extensions 1.1 alpha)
* @since 1.5, SAX 2.0 (extensions 1.1 alpha)
* @author David Brownell
*/
public class Attributes2Impl extends AttributesImpl implements Attributes2

2
jaxp/src/org/xml/sax/ext/DeclHandler.java
View File

@ -66,7 +66,7 @@ import org.xml.sax.SAXException;
* {@link org.xml.sax.SAXNotRecognizedException SAXNotRecognizedException}
* when you attempt to register the handler.</p>
*
* @since SAX 2.0 (extensions 1.0)
* @since 1.4, SAX 2.0 (extensions 1.0)
* @author David Megginson
*/
public interface DeclHandler

2
jaxp/src/org/xml/sax/ext/DefaultHandler2.java
View File

@ -55,7 +55,7 @@ import org.xml.sax.helpers.DefaultHandler;
* <em>ContentHandler.startElement()</em> call might be passed a
* {@link Attributes2} object.
*
* @since SAX 2.0 (extensions 1.1 alpha)
* @since 1.5, SAX 2.0 (extensions 1.1 alpha)
* @author David Brownell
*/
public class DefaultHandler2 extends DefaultHandler

2
jaxp/src/org/xml/sax/ext/EntityResolver2.java
View File

@ -80,7 +80,7 @@ import org.xml.sax.SAXException;
*
* @see org.xml.sax.XMLReader#setEntityResolver
*
* @since SAX 2.0 (extensions 1.1 alpha)
* @since 1.5, SAX 2.0 (extensions 1.1 alpha)
* @author David Brownell
*/
public interface EntityResolver2 extends EntityResolver

2
jaxp/src/org/xml/sax/ext/LexicalHandler.java
View File

@ -62,7 +62,7 @@ import org.xml.sax.SAXException;
* {@link org.xml.sax.SAXNotRecognizedException SAXNotRecognizedException}
* when you attempt to register the handler.</p>
*
* @since SAX 2.0 (extensions 1.0)
* @since 1.4, SAX 2.0 (extensions 1.0)
* @author David Megginson
*/
public interface LexicalHandler

2
jaxp/src/org/xml/sax/ext/Locator2.java
View File

@ -51,7 +51,7 @@ import org.xml.sax.Locator;
* <p> XMLReader implementations are not required to support this
* information, and it is not part of core-only SAX2 distributions.</p>
*
* @since SAX 2.0 (extensions 1.1 alpha)
* @since 1.5, SAX 2.0 (extensions 1.1 alpha)
* @author David Brownell
*/
public interface Locator2 extends Locator

2
jaxp/src/org/xml/sax/ext/Locator2Impl.java
View File

@ -45,7 +45,7 @@ import org.xml.sax.helpers.LocatorImpl;
*
* <p> This is not part of core-only SAX2 distributions.</p>
*
* @since SAX 2.0.2
* @since 1.5, SAX 2.0.2
* @author David Brownell
*/
public class Locator2Impl extends LocatorImpl implements Locator2

2
jaxp/src/org/xml/sax/helpers/AttributeListImpl.java
View File

@ -82,7 +82,7 @@ import java.util.Vector;
* which is implemented in the
* {@link org.xml.sax.helpers.AttributesImpl
* AttributesImpl} helper class.
* @since SAX 1.0
* @since 1.4, SAX 1.0
* @author David Megginson
* @see org.xml.sax.AttributeList
* @see org.xml.sax.DocumentHandler#startElement

2
jaxp/src/org/xml/sax/helpers/AttributesImpl.java
View File

@ -64,7 +64,7 @@ import org.xml.sax.Attributes;
* AttributeList} interface, it also includes a much more efficient
* implementation using a single array rather than a set of Vectors.</p>
*
* @since SAX 2.0
* @since 1.4, SAX 2.0
* @author David Megginson
*/
public class AttributesImpl implements Attributes

2
jaxp/src/org/xml/sax/helpers/DefaultHandler.java
View File

@ -73,7 +73,7 @@ import org.xml.sax.SAXParseException;
* <p>This class replaces the deprecated SAX1
* {@link org.xml.sax.HandlerBase HandlerBase} class.</p>
*
* @since SAX 2.0
* @since 1.4, SAX 2.0
* @author David Megginson,
* @see org.xml.sax.EntityResolver
* @see org.xml.sax.DTDHandler

2
jaxp/src/org/xml/sax/helpers/LocatorImpl.java
View File

@ -69,7 +69,7 @@ import org.xml.sax.Locator;
* is more efficient to provide location information only when
* requested, rather than constantly updating a Locator object.</p>
*
* @since SAX 1.0
* @since 1.4, SAX 1.0
* @author David Megginson
* @see org.xml.sax.Locator Locator
*/

8
jaxp/src/org/xml/sax/helpers/NamespaceSupport.java
View File

@ -90,7 +90,7 @@ import java.util.Vector;
* Applications must track namespace information themselves if they
* want to use namespace information.
*
* @since SAX 2.0
* @since 1.4, SAX 2.0
* @author David Megginson
*/
public class NamespaceSupport
@ -126,7 +126,7 @@ public class NamespaceSupport
* <em>xmlns</em> and <em>xmlns:*</em> attributes, which are used to
* declare namespaces. </p>
*
* @since SAX 2.1alpha
* @since 1.5, SAX 2.1alpha
* @see #setNamespaceDeclUris
* @see #isNamespaceDeclUris
*/
@ -497,7 +497,7 @@ public class NamespaceSupport
* by {@link #processName processName()}. This may only be
* changed before any contexts have been pushed.
*
* @since SAX 2.1alpha
* @since 1.5, SAX 2.1alpha
*
* @exception IllegalStateException when attempting to set this
* after any context has been pushed.
@ -521,7 +521,7 @@ public class NamespaceSupport
* Returns true if namespace declaration attributes are placed into
* a namespace. This behavior is not the default.
*
* @since SAX 2.1alpha
* @since 1.5, SAX 2.1alpha
*/
public boolean isNamespaceDeclUris ()
{ return namespaceDeclUris; }

Some files were not shown because too many files have changed in this diff Show More