public interface Struct
The standard mapping in the Java programming language for an SQL
structured type. A Struct object contains a
value for each attribute of the SQL structured type that
it represents.
By default, an instance ofStruct is valid as long as the
application has a reference to it.
All methods on the Struct interface must be fully implemented if the
JDBC driver supports the data type.
| Modifier and Type | Method and Description |
|---|---|
Object[] |
getAttributes()
Produces the ordered values of the attributes of the SQL
structured type that this
Struct object represents. |
Object[] |
getAttributes(Map<String,Class<?>> map)
Produces the ordered values of the attributes of the SQL
structured type that this
Struct object represents. |
String |
getSQLTypeName()
Retrieves the SQL type name of the SQL structured type
that this
Struct object represents. |
String getSQLTypeName() throws SQLException
Struct object represents.Struct object
is the generic representationSQLException - if a database access error occursSQLFeatureNotSupportedException - if the JDBC driver does not support
this methodObject[] getAttributes() throws SQLException
Struct object represents.
As individual attributes are processed, this method uses the type map
associated with the
connection for customizations of the type mappings.
If there is no
entry in the connection's type map that matches the structured
type that an attribute represents,
the driver uses the standard mapping.
Conceptually, this method calls the method
getObject on each attribute
of the structured type and returns a Java array containing
the result.
SQLException - if a database access error occursSQLFeatureNotSupportedException - if the JDBC driver does not support
this methodObject[] getAttributes(Map<String,Class<?>> map) throws SQLException
Struct object represents.
As individual attrbutes are proccessed, this method uses the given type map
for customizations of the type mappings.
If there is no
entry in the given type map that matches the structured
type that an attribute represents,
the driver uses the standard mapping. This method never
uses the type map associated with the connection.
Conceptually, this method calls the method
getObject on each attribute
of the structured type and returns a Java array containing
the result.
map - a mapping of SQL type names to Java classesSQLException - if a database access error occursSQLFeatureNotSupportedException - if the JDBC driver does not support
this method Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2011, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b138