< prev index next >
src/java.xml/share/classes/org/xml/sax/helpers/ParserAdapter.java
Print this page
@@ -1,7 +1,7 @@
/*
- * Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
@@ -79,11 +79,11 @@
* Construct a new parser adapter.
*
* <p>Use the "org.xml.sax.parser" property to locate the
* embedded SAX1 driver.</p>
*
- * @exception SAXException If the embedded driver
+ * @throws SAXException If the embedded driver
* cannot be instantiated or if the
* org.xml.sax.parser property is not specified.
*/
public ParserAdapter ()
throws SAXException
@@ -126,11 +126,11 @@
* <p>Note that the embedded parser cannot be changed once the
* adapter is created; to embed a different parser, allocate
* a new ParserAdapter.</p>
*
* @param parser The SAX1 parser to embed.
- * @exception java.lang.NullPointerException If the parser parameter
+ * @throws java.lang.NullPointerException If the parser parameter
* is null.
*/
public ParserAdapter (Parser parser)
{
super();
@@ -140,11 +140,11 @@
/**
* Internal setup method.
*
* @param parser The embedded parser.
- * @exception java.lang.NullPointerException If the parser parameter
+ * @throws java.lang.NullPointerException If the parser parameter
* is null.
*/
private void setup (Parser parser)
{
if (parser == null) {
@@ -179,13 +179,13 @@
* <p>The only features recognized are namespaces and
* namespace-prefixes.</p>
*
* @param name The feature name, as a complete URI.
* @param value The requested feature value.
- * @exception SAXNotRecognizedException If the feature
+ * @throws SAXNotRecognizedException If the feature
* can't be assigned or retrieved.
- * @exception SAXNotSupportedException If the feature
+ * @throws SAXNotSupportedException If the feature
* can't be assigned that value.
* @see org.xml.sax.XMLReader#setFeature
*/
public void setFeature (String name, boolean value)
throws SAXNotRecognizedException, SAXNotSupportedException
@@ -217,13 +217,13 @@
* <p>The only features recognized are namespaces and
* namespace-prefixes.</p>
*
* @param name The feature name, as a complete URI.
* @return The current feature value.
- * @exception SAXNotRecognizedException If the feature
+ * @throws SAXNotRecognizedException If the feature
* value can't be assigned or retrieved.
- * @exception SAXNotSupportedException If the
+ * @throws SAXNotSupportedException If the
* feature is not currently readable.
* @see org.xml.sax.XMLReader#setFeature
*/
public boolean getFeature (String name)
throws SAXNotRecognizedException, SAXNotSupportedException
@@ -245,13 +245,13 @@
*
* <p>No properties are currently recognized.</p>
*
* @param name The property name.
* @param value The property value.
- * @exception SAXNotRecognizedException If the property
+ * @throws SAXNotRecognizedException If the property
* value can't be assigned or retrieved.
- * @exception SAXNotSupportedException If the property
+ * @throws SAXNotSupportedException If the property
* can't be assigned that value.
* @see org.xml.sax.XMLReader#setProperty
*/
public void setProperty (String name, Object value)
throws SAXNotRecognizedException, SAXNotSupportedException
@@ -265,13 +265,13 @@
*
* <p>No properties are currently recognized.</p>
*
* @param name The property name.
* @return The property value.
- * @exception SAXNotRecognizedException If the property
+ * @throws SAXNotRecognizedException If the property
* value can't be assigned or retrieved.
- * @exception SAXNotSupportedException If the property
+ * @throws SAXNotSupportedException If the property
* value is not currently readable.
* @see org.xml.sax.XMLReader#getProperty
*/
public Object getProperty (String name)
throws SAXNotRecognizedException, SAXNotSupportedException
@@ -378,13 +378,13 @@
/**
* Parse an XML document.
*
* @param systemId The absolute URL of the document.
- * @exception java.io.IOException If there is a problem reading
+ * @throws java.io.IOException If there is a problem reading
* the raw content of the document.
- * @exception SAXException If there is a problem
+ * @throws SAXException If there is a problem
* processing the document.
* @see #parse(org.xml.sax.InputSource)
* @see org.xml.sax.Parser#parse(java.lang.String)
*/
public void parse (String systemId)
@@ -396,13 +396,13 @@
/**
* Parse an XML document.
*
* @param input An input source for the document.
- * @exception java.io.IOException If there is a problem reading
+ * @throws java.io.IOException If there is a problem reading
* the raw content of the document.
- * @exception SAXException If there is a problem
+ * @throws SAXException If there is a problem
* processing the document.
* @see #parse(java.lang.String)
* @see org.xml.sax.Parser#parse(org.xml.sax.InputSource)
*/
public void parse (InputSource input)
@@ -446,11 +446,11 @@
/**
* Adapter implementation method; do not call.
* Adapt a SAX1 start document event.
*
- * @exception SAXException The client may raise a
+ * @throws SAXException The client may raise a
* processing exception.
* @see org.xml.sax.DocumentHandler#startDocument
*/
public void startDocument ()
throws SAXException
@@ -463,11 +463,11 @@
/**
* Adapter implementation method; do not call.
* Adapt a SAX1 end document event.
*
- * @exception SAXException The client may raise a
+ * @throws SAXException The client may raise a
* processing exception.
* @see org.xml.sax.DocumentHandler#endDocument
*/
public void endDocument ()
throws SAXException
@@ -484,11 +484,11 @@
*
* <p>If necessary, perform Namespace processing.</p>
*
* @param qName The qualified (prefixed) name.
* @param qAtts The XML attribute list (with qnames).
- * @exception SAXException The client may raise a
+ * @throws SAXException The client may raise a
* processing exception.
*/
public void startElement (String qName, AttributeList qAtts)
throws SAXException
{
@@ -614,11 +614,11 @@
/**
* Adapter implementation method; do not call.
* Adapt a SAX1 end element event.
*
* @param qName The qualified (prefixed) name.
- * @exception SAXException The client may raise a
+ * @throws SAXException The client may raise a
* processing exception.
* @see org.xml.sax.DocumentHandler#endElement
*/
public void endElement (String qName)
throws SAXException
@@ -651,11 +651,11 @@
* Adapt a SAX1 characters event.
*
* @param ch An array of characters.
* @param start The starting position in the array.
* @param length The number of characters to use.
- * @exception SAXException The client may raise a
+ * @throws SAXException The client may raise a
* processing exception.
* @see org.xml.sax.DocumentHandler#characters
*/
public void characters (char ch[], int start, int length)
throws SAXException
@@ -671,11 +671,11 @@
* Adapt a SAX1 ignorable whitespace event.
*
* @param ch An array of characters.
* @param start The starting position in the array.
* @param length The number of characters to use.
- * @exception SAXException The client may raise a
+ * @throws SAXException The client may raise a
* processing exception.
* @see org.xml.sax.DocumentHandler#ignorableWhitespace
*/
public void ignorableWhitespace (char ch[], int start, int length)
throws SAXException
@@ -690,11 +690,11 @@
* Adapter implementation method; do not call.
* Adapt a SAX1 processing instruction event.
*
* @param target The processing instruction target.
* @param data The remainder of the processing instruction
- * @exception SAXException The client may raise a
+ * @throws SAXException The client may raise a
* processing exception.
* @see org.xml.sax.DocumentHandler#processingInstruction
*/
public void processingInstruction (String target, String data)
throws SAXException
@@ -746,11 +746,11 @@
* interested.</p>
*
* @param qName The qualified (prefixed) name.
* @param isAttribute true if this is an attribute name.
* @return The name split into three parts.
- * @exception SAXException The client may throw
+ * @throws SAXException The client may throw
* an exception if there is an error callback.
*/
private String [] processName (String qName, boolean isAttribute,
boolean useException)
throws SAXException
@@ -771,11 +771,11 @@
/**
* Report a non-fatal error.
*
* @param message The error message.
- * @exception SAXException The client may throw
+ * @throws SAXException The client may throw
* an exception.
*/
void reportError (String message)
throws SAXException
{
@@ -805,11 +805,11 @@
* <p>Use this method to detect illegal feature or
* property changes.</p>
*
* @param type The type of thing (feature or property).
* @param name The feature or property name.
- * @exception SAXNotSupportedException If a
+ * @throws SAXNotSupportedException If a
* document is currently being parsed.
*/
private void checkNotParsing (String type, String name)
throws SAXNotSupportedException
{
< prev index next >