java.sql
インタフェース Struct

public interface Struct

SQL 構造化型の Java プログラミング言語の標準のマッピングです。Struct オブジェクトは、それが表す SQL 構造化型の各属性の値を格納します。デフォルトでは、Struct のインスタンスは、アプリケーションがそのインスタンスへの参照を持っている間は有効です。

導入されたバージョン:

1.2

関連項目:

「JDBC 2.0 API に含まれるもの」

メソッドの概要

Object[]	getAttributes() この Struct オブジェクトが表す SQL 構造化型の属性の順序付けされた値を作成します。
Object[]	getAttributes(Map map) この Struct オブジェクトが表す SQL 構造化型の属性の順序付けされた値を作成します。
String	getSQLTypeName() この Struct オブジェクトが表す SQL 構造化型の SQL 型名を取得します。

メソッドの詳細

getSQLTypeName

public String getSQLTypeName()
                      throws SQLException

この Struct オブジェクトが表す SQL 構造化型の SQL 型名を取得します。

戻り値:

この Struct オブジェクトがその汎用表現である SQL 構造化型の完全指定された型名

例外:

SQLException - データベースアクセスエラーが発生した場合

getAttributes

public Object[] getAttributes()
                       throws SQLException

この Struct オブジェクトが表す SQL 構造化型の属性の順序付けされた値を作成します。このメソッドは、型マップのカスタマイズには、接続に関連する型マップを使います。接続の型マップにこの Struct オブジェクトが表す構造化型と一致するエントリがない場合、ドライバは標準のマッピングを使います。

概念的には、このメソッドは構造化型の各属性で getObject メソッドを呼び出し、結果が格納されている Java 配列を返します。

戻り値:

順序付けされた属性値が格納されている配列

例外:

SQLException - データベースアクセスエラーが発生した場合

getAttributes

public Object[] getAttributes(Map map)
                       throws SQLException

この Struct オブジェクトが表す SQL 構造化型の属性の順序付けされた値を作成します。このメソッドは、型マップのカスタマイズには、指定された型マップを使用します。指定された型マップにこの Struct オブジェクトが表す構造化型と一致するエントリがない場合、ドライバは標準のマッピングを使用します。このメソッドでは、接続に関連する型マッピングは使用しません。

概念的には、このメソッドは構造化型の各属性で getObject メソッドを呼び出し、結果が格納されている Java 配列を返します。

パラメータ:

map - SQL 型名の Java クラスへのマッピング

戻り値:

順序付けされた属性値が格納されている配列

例外:

SQLException - データベースアクセスエラーが発生した場合