- /*
- * @(#)Struct.java 1.20 03/01/23
- *
- * Copyright 2003 Sun Microsystems, Inc. All rights reserved.
- * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
- */
-
- package java.sql;
-
- /**
- * <p>The standard mapping in the Java programming language for an SQL
- * structured type. A <code>Struct</code> object contains a
- * value for each attribute of the SQL structured type that
- * it represents.
- * By default, an instance of<code>Struct</code> is valid as long as the
- * application has a reference to it.
- * @since 1.2
- */
-
- public interface Struct {
-
- /**
- * Retrieves the SQL type name of the SQL structured type
- * that this <code>Struct</code> object represents.
- *
- * @return the fully-qualified type name of the SQL structured
- * type for which this <code>Struct</code> object
- * is the generic representation
- * @exception SQLException if a database access error occurs
- */
- String getSQLTypeName() throws SQLException;
-
- /**
- * Produces the ordered values of the attributes of the SQL
- * structurec type that this <code>Struct</code> object represents.
- * 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 this <code>Struct</code> object represents,
- * the driver uses the standard mapping.
- * <p>
- * Conceptually, this method calls the method
- * <code>getObject</code> on each attribute
- * of the structured type and returns a Java array containing
- * the result.
- *
- * @return an array containing the ordered attribute values
- * @exception SQLException if a database access error occurs
- */
- Object[] getAttributes() throws SQLException;
-
- /**
- * Produces the ordered values of the attributes of the SQL
- * structurec type that this <code>Struct</code> object represents.
- * 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 this <code>Struct</code> object represents,
- * the driver uses the standard mapping. This method never
- * uses the type map associated with the connection.
- * <p>
- * Conceptually, this method calls the method
- * <code>getObject</code> on each attribute
- * of the structured type and returns a Java array containing
- * the result.
- *
- * @param map a mapping of SQL type names to Java classes
- * @return an array containing the ordered attribute values
- * @exception SQLException if a database access error occurs
- */
- Object[] getAttributes(java.util.Map map) throws SQLException;
- }
-
-