Author: simonetripodi
Date: Tue Mar 1 17:40:25 2011
New Revision: 1075937
URL: http://svn.apache.org/viewvc?rev=1075937&view=rev
Log:
added the warning that Digester.parse() method can throw CCE
Modified:
commons/sandbox/digester3/trunk/src/main/java/org/apache/commons/digester3/Digester.java
Modified:
commons/sandbox/digester3/trunk/src/main/java/org/apache/commons/digester3/Digester.java
URL:
http://svn.apache.org/viewvc/commons/sandbox/digester3/trunk/src/main/java/org/apache/commons/digester3/Digester.java?rev=1075937&r1=1075936&r2=1075937&view=diff
==============================================================================
---
commons/sandbox/digester3/trunk/src/main/java/org/apache/commons/digester3/Digester.java
(original)
+++
commons/sandbox/digester3/trunk/src/main/java/org/apache/commons/digester3/Digester.java
Tue Mar 1 17:40:25 2011
@@ -87,6 +87,9 @@ public interface Digester extends Conten
* Parse the content of the specified input source using this Digester.
* Returns the root element from the object stack (if any).
*
+ * <b>WARNING</b>: this method is subject to {@link ClassCastException} if
+ * the returned object is not assignable to the generic type.
+ *
* @param input Input source containing the XML data to be parsed
*
* @exception IOException if an input/output error occurs
@@ -98,6 +101,9 @@ public interface Digester extends Conten
* Parse the content of the specified input stream using this Digester.
* Returns the root element from the object stack (if any).
*
+ * <b>WARNING</b>: this method is subject to {@link ClassCastException} if
+ * the returned object is not assignable to the generic type.
+ *
* @param input Input stream containing the XML data to be parsed
*
* @exception IOException if an input/output error occurs
@@ -109,6 +115,9 @@ public interface Digester extends Conten
* Parse the content of the specified reader using this Digester.
* Returns the root element from the object stack (if any).
*
+ * <b>WARNING</b>: this method is subject to {@link ClassCastException} if
+ * the returned object is not assignable to the generic type.
+ *
* @param reader Reader containing the XML data to be parsed
*
* @exception IOException if an input/output error occurs
@@ -120,6 +129,9 @@ public interface Digester extends Conten
* Parse the content of the specified URI using this Digester.
* Returns the root element from the object stack (if any).
*
+ * <b>WARNING</b>: this method is subject to {@link ClassCastException} if
+ * the returned object is not assignable to the generic type.
+ *
* @param uri URI containing the XML data to be parsed
*
* @exception IOException if an input/output error occurs
@@ -131,6 +143,9 @@ public interface Digester extends Conten
* Parse the content of the specified URL using this Digester.
* Returns the root element from the object stack (if any).
*
+ * <b>WARNING</b>: this method is subject to {@link ClassCastException} if
+ * the returned object is not assignable to the generic type.
+ *
* @param url URL containing the XML data to be parsed
*
* @exception IOException if an input/output error occurs
