javax.sql.rowset.serial
public class: SerialStruct [javadoc |
source]
java.lang.Object
javax.sql.rowset.serial.SerialStruct
All Implemented Interfaces:
Cloneable, Struct, Serializable
A serialized mapping in the Java programming language of an SQL
structured type. Each attribute that is not already serialized
is mapped to a serialized form, and if an attribute is itself
a structured type, each of its attributes that is not already
serialized is mapped to a serialized form.
In addition, the structured type is custom mapped to a class in the
Java programming language if there is such a mapping, as are
its attributes, if appropriate.
The SerialStruct class provides a constructor for creating
an instance from a Struct object, a method for retrieving
the SQL type name of the SQL structured type in the database, and methods
for retrieving its attribute values.
| Field Summary |
|---|
| static final long | serialVersionUID | The identifier that assists in the serialization of this
SerialStruct object. |
| Constructor: |
|---|
 public SerialStruct(Struct in,
Map map) throws SerialException {
try {
// get the type name
SQLTypeName = new String(in.getSQLTypeName());
System.out.println("SQLTypeName: " + SQLTypeName);
// get the attributes of the struct
attribs = in.getAttributes(map);
/*
* the array may contain further Structs
* and/or classes that have been mapped,
* other types that we have to serialize
*/
mapToSerial(map);
} catch (SQLException e) {
throw new SerialException(e.getMessage());
}
}
Constructs a SerialStruct object from the given
Struct object, using the given java.util.Map
object for custom mapping the SQL structured type or any of its
attributes that are SQL structured types. Parameters:
map - a java.util.Map object in which
each entry consists of 1) a String object
giving the fully qualified name of a UDT and 2) the
Class object for the SQLData implementation
that defines how the UDT is to be mapped
SerialException - if an error occurs
- java.sql.Struct
|
public SerialStruct(SQLData in,
Map map) throws SerialException {
try {
//set the type name
SQLTypeName = new String(in.getSQLTypeName());
Vector tmp = new Vector();
in.writeSQL(new SQLOutputImpl(tmp, map));
attribs = tmp.toArray();
} catch (SQLException e) {
throw new SerialException(e.getMessage());
}
} Constructs a SerialStruct object from the
given SQLData object, using the given type
map to custom map it to a class in the Java programming
language. The type map gives the SQL type and the class
to which it is mapped. The SQLData object
defines the class to which the SQL type will be mapped. Parameters:
in - an instance of the SQLData class
that defines the mapping of the SQL structured
type to one or more objects in the Java programming language
map - a java.util.Map object in which
each entry consists of 1) a String object
giving the fully qualified name of a UDT and 2) the
Class object for the SQLData implementation
that defines how the UDT is to be mapped
SerialException - if an error occurs
|
| Methods from java.lang.Object: |
|---|
|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Method from javax.sql.rowset.serial.SerialStruct Detail: |
|---|
public Object[] getAttributes() throws SerialException {
return attribs;
} Retrieves an array of Object values containing the
attributes of the SQL structured type that this
SerialStruct object represents. |
public Object[] getAttributes(Map map) throws SerialException {
return attribs;
} Retrieves the attributes for the SQL structured type that
this SerialStruct represents as an array of
Object values, using the given type map for
custom mapping if appropriate. |
public String getSQLTypeName() throws SerialException {
return SQLTypeName;
} Retrieves the SQL type name for this SerialStruct
object. This is the name used in the SQL definition of the
structured type |
Save This Page