Name: sdR10048 Date: 10/22/2003


Filed By : SPB JCK team (###@###.###)
JDK : java full version "1.5.0-beta-b23"

Problem description
===================
Javadoc for SerialArray's constructor and methods
has a broken/ambiguous @throw sections.
For example:
===
public SerialArray(java.sql.Array array)
            throws SerialException,
                   java.sql.SQLException
Throws:
SerialException
java.sql.SQLException
===
(No circumstances when the designated exception can occur)

===
public java.lang.Object getArray()
                          throws SerialException
Returns a new array that is a copy of this SerialArray object.

Specified by:
getArray in interface java.sql.Array
Returns:
a copy of this SerialArray object as an Object in the Java programming language
Throws:
SerialException - if if an error occurs
===
(pretty unclear what are the circumstances when the designated exception can occur, also there is a typo "if if" here)

===
public java.sql.ResultSet getResultSet(java.util.Map map)
                                throws SerialException
Specified by:
getResultSet in interface java.sql.Array
Parameters:
map - a java.util.Map object mapping SQL types to classes in the Java programming language
Returns:
a ResultSet object containing all of the elements in this SerialArray object, with a separate row for each element
Throws:
SerialException, - which in turn throws an UnsupportedOperationException, if this method is called
SerialException
===

======================================================================