| java.sql.Ref |
This interface represents an SQL Ref - a data object containing a cursor or pointer to a result table.
The data structure identified by an instance of Ref is held in the
database, so the data is not necessarily read and converted
into a Java object until getObject is called. However, if
the database supports the Ref type, it is not typically
necessary to get the underlying object before using it in a method call -
the Ref object can be used in place of the data structure.
A Ref object is stored into the database using the
setRef(int, Ref) method.
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Gets the fully-qualified SQL name of the SQL structured type that this
Ref references.
| |||||||||||
Gets the SQL structured type instance referenced by this
Ref.
| |||||||||||
Returns the associated object and uses the relevant mapping to convert it
to a Java type.
| |||||||||||
Sets the value of the structured type that this
Ref references to
a supplied object.
| |||||||||||
Gets the fully-qualified SQL name of the SQL structured type that this
Ref references.
| Returns | |
|---|---|
String |
the fully qualified name of the SQL structured type. |
| Throws | |
|---|---|
SQLException |
if there is a database error. |
Gets the SQL structured type instance referenced by this Ref.
| Returns | |
|---|---|
Object |
a Java object whose type is defined by the mapping for the SQL structured type. |
| Throws | |
|---|---|
SQLException |
if there is a database error. |
Returns the associated object and uses the relevant mapping to convert it to a Java type.
| Parameters | |
|---|---|
map |
Map:
the mapping for type conversion. |
| Returns | |
|---|---|
Object |
a Java object whose type is defined by the mapping for the SQL structured type. |
| Throws | |
|---|---|
SQLException |
if there is a database error. |
Sets the value of the structured type that this Ref references to
a supplied object.
| Parameters | |
|---|---|
value |
Object:
the Object representing the new SQL structured type
that this Ref references. |
| Throws | |
|---|---|
SQLException |
if there is a database error. |
Developers