Name: sdR10048 Date: 06/24/2003


Filed By : SPB JCK team (###@###.###)
JDK : This JSR is not yet in JDK 1.5
JCK : 1.5
Platform[s] : Solaris
JCK test owner : http://javaweb.eng/jct/sqe/JCK-tck/usr/owners.jto
Failing Test [s] : N/A


Specification excerpt:
======================
--------- J2SE API spec v.1.5 ---------
...
public SQLInputImpl(java.lang.Object[]?attributes,
                    java.util.Map?map)

Creates an SQLInputImpl object initialized with the given array of attributes and the given type map. The designated map organization is entirely dependent on the map required between the underlying UDT type and the class definition.
...
---------- end-of-excerpt ---------------

Problem description
===================
Javadoc does not specify the expected Map organization.

It is obvious that the concrete Map pairs are dependent on the map required between the underlying UDT type and the class definition (as javadoc says) but which kind of pair they are: string to class, string to string - that is unclear.

This defect in public API reduces usability of this constructor for application developers.

See http://java.sun.com/j2se/javadoc/writingapispecs/index.html#method for more information.

This problem also can be found at:

 > javax.sql.rowset.serial.SQLInputImpl(java.lang.Object[], java.util.Map)
 > javax.sql.rowset.serial.SQLOutputImpl(java.util.Vector, java.util.Map)
 > javax.sql.rowset.serial.SerialRef.getObject(java.util.Map)
 > javax.sql.rowset.serial.SerialStruct(java.sql.SQLData, java.util.Map)
 > javax.sql.rowset.serial.SerialStruct(java.sql.Struct, java.util.Map)
 > javax.sql.rowset.serial.SerialStruct.getAttributes(java.util.Map)

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