Update old school @exception with new school @throws.
git-svn-id: https://svn.apache.org/repos/asf/commons/proper/digester/trunk@1747105 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/core/src/main/java/org/apache/commons/digester3/Digester.java b/core/src/main/java/org/apache/commons/digester3/Digester.java
index 473dd12..787fd4d 100644
--- a/core/src/main/java/org/apache/commons/digester3/Digester.java
+++ b/core/src/main/java/org/apache/commons/digester3/Digester.java
@@ -451,9 +451,9 @@
* @param feature Name of the feature to inquire about
* @return true, if the requested feature is supported by the underlying implementation of
* <code>org.xml.sax.XMLReader</code>, false otherwise
- * @exception ParserConfigurationException if a parser configuration error occurs
- * @exception SAXNotRecognizedException if the property name is not recognized
- * @exception SAXNotSupportedException if the property name is recognized but not supported
+ * @throws ParserConfigurationException if a parser configuration error occurs
+ * @throws SAXNotRecognizedException if the property name is not recognized
+ * @throws SAXNotSupportedException if the property name is recognized but not supported
*/
public boolean getFeature( String feature )
throws ParserConfigurationException, SAXNotRecognizedException, SAXNotSupportedException
@@ -470,9 +470,9 @@
*
* @param feature Name of the feature to set the status for
* @param value The new value for this feature
- * @exception ParserConfigurationException if a parser configuration error occurs
- * @exception SAXNotRecognizedException if the property name is not recognized
- * @exception SAXNotSupportedException if the property name is recognized but not supported
+ * @throws ParserConfigurationException if a parser configuration error occurs
+ * @throws SAXNotRecognizedException if the property name is not recognized
+ * @throws SAXNotSupportedException if the property name is recognized but not supported
*/
public void setFeature( String feature, boolean value )
throws ParserConfigurationException, SAXNotRecognizedException, SAXNotSupportedException
@@ -668,8 +668,8 @@
*
* @param property Property name to be retrieved
* @return the current value of the specified property for the underlying <code>XMLReader</code> implementation.
- * @exception SAXNotRecognizedException if the property name is not recognized
- * @exception SAXNotSupportedException if the property name is recognized but not supported
+ * @throws SAXNotRecognizedException if the property name is not recognized
+ * @throws SAXNotSupportedException if the property name is recognized but not supported
*/
public Object getProperty( String property )
throws SAXNotRecognizedException, SAXNotSupportedException
@@ -683,8 +683,8 @@
*
* @param property Property name to be set
* @param value Property value to be set
- * @exception SAXNotRecognizedException if the property name is not recognized
- * @exception SAXNotSupportedException if the property name is recognized but not supported
+ * @throws SAXNotRecognizedException if the property name is not recognized
+ * @throws SAXNotSupportedException if the property name is recognized but not supported
*/
public void setProperty( String property, Object value )
throws SAXNotRecognizedException, SAXNotSupportedException
@@ -794,7 +794,7 @@
* FIXME: there is a bug in JAXP/XERCES that prevent the use of a parser that contains a schema with a DTD.
*
* @return the XMLReader to be used for parsing the input document.
- * @exception SAXException if no XMLReader can be instantiated
+ * @throws SAXException if no XMLReader can be instantiated
*/
public XMLReader getXMLReader()
throws SAXException
@@ -1571,8 +1571,8 @@
* @param <T> the type used to auto-cast the returned object to the assigned variable type
* @param file File containing the XML data to be parsed
* @return the root element from the object stack (if any)
- * @exception IOException if an input/output error occurs
- * @exception SAXException if a parsing exception occurs
+ * @throws IOException if an input/output error occurs
+ * @throws SAXException if a parsing exception occurs
*/
public <T> T parse( File file )
throws IOException, SAXException
@@ -1618,8 +1618,8 @@
* @param <T> the type used to auto-cast the returned object to the assigned variable type
* @param input Input source containing the XML data to be parsed
* @return the root element from the object stack (if any)
- * @exception IOException if an input/output error occurs
- * @exception SAXException if a parsing exception occurs
+ * @throws IOException if an input/output error occurs
+ * @throws SAXException if a parsing exception occurs
*/
public <T> T parse( InputSource input )
throws IOException, SAXException
@@ -1681,8 +1681,8 @@
* @param <T> the type used to auto-cast the returned object to the assigned variable type
* @param input Input stream containing the XML data to be parsed
* @return the root element from the object stack (if any)
- * @exception IOException if an input/output error occurs
- * @exception SAXException if a parsing exception occurs
+ * @throws IOException if an input/output error occurs
+ * @throws SAXException if a parsing exception occurs
*/
public <T> T parse( InputStream input )
throws IOException, SAXException
@@ -1725,8 +1725,8 @@
* @param <T> the type used to auto-cast the returned object to the assigned variable type
* @param reader Reader containing the XML data to be parsed
* @return the root element from the object stack (if any)
- * @exception IOException if an input/output error occurs
- * @exception SAXException if a parsing exception occurs
+ * @throws IOException if an input/output error occurs
+ * @throws SAXException if a parsing exception occurs
*/
public <T> T parse( Reader reader )
throws IOException, SAXException
@@ -1769,8 +1769,8 @@
* @param <T> the type used to auto-cast the returned object to the assigned variable type
* @param uri URI containing the XML data to be parsed
* @return the root element from the object stack (if any)
- * @exception IOException if an input/output error occurs
- * @exception SAXException if a parsing exception occurs
+ * @throws IOException if an input/output error occurs
+ * @throws SAXException if a parsing exception occurs
*/
public <T> T parse( String uri )
throws IOException, SAXException
@@ -1813,8 +1813,8 @@
* @param <T> the type used to auto-cast the returned object to the assigned variable type
* @param url URL containing the XML data to be parsed
* @return the root element from the object stack (if any)
- * @exception IOException if an input/output error occurs
- * @exception SAXException if a parsing exception occurs
+ * @throws IOException if an input/output error occurs
+ * @throws SAXException if a parsing exception occurs
* @since 1.8
*/
public <T> T parse( URL url )
diff --git a/core/src/main/java/org/apache/commons/digester3/FactoryCreateRule.java b/core/src/main/java/org/apache/commons/digester3/FactoryCreateRule.java
index 250e539..80dc561 100644
--- a/core/src/main/java/org/apache/commons/digester3/FactoryCreateRule.java
+++ b/core/src/main/java/org/apache/commons/digester3/FactoryCreateRule.java
@@ -355,7 +355,7 @@
*
* @param attributes Attributes passed to our factory creation element
* @return An instance of our associated object creation factory, creating one if necessary
- * @exception Exception if any error occurs
+ * @throws Exception if any error occurs
*/
protected ObjectCreationFactory<?> getFactory( Attributes attributes )
throws Exception
diff --git a/core/src/main/java/org/apache/commons/digester3/binder/DigesterLoader.java b/core/src/main/java/org/apache/commons/digester3/binder/DigesterLoader.java
index c69bff7..f6499e9 100644
--- a/core/src/main/java/org/apache/commons/digester3/binder/DigesterLoader.java
+++ b/core/src/main/java/org/apache/commons/digester3/binder/DigesterLoader.java
@@ -314,9 +314,9 @@
* @param feature Name of the feature to set the status for
* @param value The new value for this feature
* @return This loader instance, useful to chain methods.
- * @exception ParserConfigurationException if a parser configuration error occurs
- * @exception SAXNotRecognizedException if the property name is not recognized
- * @exception SAXNotSupportedException if the property name is recognized but not supported
+ * @throws ParserConfigurationException if a parser configuration error occurs
+ * @throws SAXNotRecognizedException if the property name is not recognized
+ * @throws SAXNotSupportedException if the property name is recognized but not supported
* @since 3.3
*/
public DigesterLoader setFeature( String feature, boolean value )
diff --git a/core/src/main/java/org/apache/commons/digester3/plugins/PluginDeclarationRule.java b/core/src/main/java/org/apache/commons/digester3/plugins/PluginDeclarationRule.java
index ba748d2..ab9890a 100644
--- a/core/src/main/java/org/apache/commons/digester3/plugins/PluginDeclarationRule.java
+++ b/core/src/main/java/org/apache/commons/digester3/plugins/PluginDeclarationRule.java
@@ -58,7 +58,7 @@
* @param namespace The xml namespace in which the xml element which triggered this rule resides.
* @param name The name of the xml element which triggered this rule.
* @param attributes The set of attributes on the xml element which triggered this rule.
- * @exception Exception if any error occurs
+ * @throws Exception if any error occurs
*/
@Override
public void begin( String namespace, String name, Attributes attributes )
diff --git a/core/src/test/java/org/apache/commons/digester3/CallMethodRuleTestCase.java b/core/src/test/java/org/apache/commons/digester3/CallMethodRuleTestCase.java
index 014c076..5ac0f29 100644
--- a/core/src/test/java/org/apache/commons/digester3/CallMethodRuleTestCase.java
+++ b/core/src/test/java/org/apache/commons/digester3/CallMethodRuleTestCase.java
@@ -705,7 +705,7 @@
* Return an appropriate InputStream for the specified test file (which must be inside our current package.
*
* @param name Name of the test file we want
- * @exception IOException if an input/output error occurs
+ * @throws IOException if an input/output error occurs
*/
protected InputStream getInputStream( String name )
throws IOException
diff --git a/core/src/test/java/org/apache/commons/digester3/NamespaceSnapshotTestCase.java b/core/src/test/java/org/apache/commons/digester3/NamespaceSnapshotTestCase.java
index ed7c961..0e2eaee 100644
--- a/core/src/test/java/org/apache/commons/digester3/NamespaceSnapshotTestCase.java
+++ b/core/src/test/java/org/apache/commons/digester3/NamespaceSnapshotTestCase.java
@@ -143,7 +143,7 @@
* Return an appropriate InputStream for the specified test file (which must be inside our current package.
*
* @param name Name of the test file we want
- * @exception IOException if an input/output error occurs
+ * @throws IOException if an input/output error occurs
*/
protected InputStream getInputStream( String name )
throws IOException
diff --git a/core/src/test/java/org/apache/commons/digester3/NodeCreateRuleTestCase.java b/core/src/test/java/org/apache/commons/digester3/NodeCreateRuleTestCase.java
index 8ad655f..36c87a6 100644
--- a/core/src/test/java/org/apache/commons/digester3/NodeCreateRuleTestCase.java
+++ b/core/src/test/java/org/apache/commons/digester3/NodeCreateRuleTestCase.java
@@ -530,7 +530,7 @@
* Return an appropriate InputStream for the specified test file (which must be inside our current package.
*
* @param name Name of the test file we want
- * @exception IOException if an input/output error occurs
+ * @throws IOException if an input/output error occurs
*/
protected InputStream getInputStream( String name )
throws IOException
diff --git a/core/src/test/java/org/apache/commons/digester3/RuleTestCase.java b/core/src/test/java/org/apache/commons/digester3/RuleTestCase.java
index 72619af..b56c008 100644
--- a/core/src/test/java/org/apache/commons/digester3/RuleTestCase.java
+++ b/core/src/test/java/org/apache/commons/digester3/RuleTestCase.java
@@ -527,7 +527,7 @@
* Return an appropriate InputStream for the specified test file (which must be inside our current package.
*
* @param name Name of the test file we want
- * @exception IOException if an input/output error occurs
+ * @throws IOException if an input/output error occurs
*/
protected InputStream getInputStream( String name )
throws IOException
diff --git a/core/src/test/java/org/apache/commons/digester3/XIncludeTestCase.java b/core/src/test/java/org/apache/commons/digester3/XIncludeTestCase.java
index 2cdc923..a9495fa 100644
--- a/core/src/test/java/org/apache/commons/digester3/XIncludeTestCase.java
+++ b/core/src/test/java/org/apache/commons/digester3/XIncludeTestCase.java
@@ -95,7 +95,7 @@
* Return an appropriate InputStream for the specified test file (which must be inside our current package.
*
* @param name Name of the test file we want
- * @exception IOException if an input/output error occurs
+ * @throws IOException if an input/output error occurs
*/
protected InputStream getInputStream( String name )
throws IOException
diff --git a/core/src/test/java/org/apache/commons/digester3/XMLSchemaTestCase.java b/core/src/test/java/org/apache/commons/digester3/XMLSchemaTestCase.java
index 1e995f3..960b6be 100644
--- a/core/src/test/java/org/apache/commons/digester3/XMLSchemaTestCase.java
+++ b/core/src/test/java/org/apache/commons/digester3/XMLSchemaTestCase.java
@@ -143,7 +143,7 @@
* Return an appropriate InputStream for the specified test file (which must be inside our current package.
*
* @param name Name of the test file we want
- * @exception IOException if an input/output error occurs
+ * @throws IOException if an input/output error occurs
*/
protected InputStream getInputStream( String name )
throws IOException
diff --git a/core/src/test/java/org/apache/commons/digester3/plugins/Utils.java b/core/src/test/java/org/apache/commons/digester3/plugins/Utils.java
index 38654d9..6190a19 100644
--- a/core/src/test/java/org/apache/commons/digester3/plugins/Utils.java
+++ b/core/src/test/java/org/apache/commons/digester3/plugins/Utils.java
@@ -33,7 +33,7 @@
*
* @param caller is always "this" for the calling object.
* @param name is the test file we want
- * @exception IOException if an input/output error occurs
+ * @throws IOException if an input/output error occurs
*/
public static InputStream getInputStream( Object caller, String name )
throws IOException