commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From simonetrip...@apache.org
Subject svn commit: r1075937 - /commons/sandbox/digester3/trunk/src/main/java/org/apache/commons/digester3/Digester.java
Date Tue, 01 Mar 2011 17:40:25 GMT
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



Mime
View raw message