JavaTM Platform
Standard Ed. 6

java.sql
インタフェース ResultSetMetaData

すべてのスーパーインタフェース:
Wrapper
既知のサブインタフェースの一覧:
RowSetMetaData
既知の実装クラスの一覧:
RowSetMetaDataImpl

public interface ResultSetMetaData
extends Wrapper

ResultSet オブジェクトの列の型とプロパティーに関する情報を取得するのに使用できるオブジェクトです。次のコードフラグメントは、ResultSet オブジェクトの rs を生成し、ResultSetMetaData オブジェクトの rsmd を生成し、rsmd を使用して、rs が持っている列の数と、rs にある最初の列を WHERE 節に使用できるかどうかを判別します。


     ResultSet rs = stmt.executeQuery("SELECT a, b, c FROM TABLE2");
     ResultSetMetaData rsmd = rs.getMetaData();
     int numberOfColumns = rsmd.getColumnCount();
     boolean b = rsmd.isSearchable(1);

 


フィールドの概要
static int columnNoNulls
          列が NULL 値を許可しないことを示す定数です。
static int columnNullable
          列が NULL 値を許可することを示す定数です。
static int columnNullableUnknown
          列が NULL 値を許可するかどうか不明であることを示す定数です。
 
メソッドの概要
 String getCatalogName(int column)
          指定された列のテーブルのカタログ名を取得します。
 String getColumnClassName(int column)
           Java クラスの完全指定された名前を返します。
 int getColumnCount()
          この ResultSet オブジェクトの列数を返します。
 int getColumnDisplaySize(int column)
          指定された列の通常の最大幅を文字数で示します。
 String getColumnLabel(int column)
          印刷や表示に使用する、指定された列の推奨タイトルを取得します。
 String getColumnName(int column)
          指定された列の名前を取得します。
 int getColumnType(int column)
          指定された列の SQL 型を取得します。
 String getColumnTypeName(int column)
          指定された列のデータベース固有の型名を取得します。
 int getPrecision(int column)
          指定された列に指定された列のサイズを取得します。
 int getScale(int column)
          指定された列の小数点以下の桁数を取得します。
 String getSchemaName(int column)
          指定された列のテーブルのスキーマを取得します。
 String getTableName(int column)
          指定された列のテーブル名を取得します。
 boolean isAutoIncrement(int column)
          指定された列が自動的に番号付けされるかどうかを示します。
 boolean isCaseSensitive(int column)
          列の大文字小文字が区別されるかどうかを示します。
 boolean isCurrency(int column)
          指定された列がキャッシュの値かどうかを示します。
 boolean isDefinitelyWritable(int column)
          指定された列の書き込みが必ず成功するかどうかを示します。
 int isNullable(int column)
          指定された列に NULL をセットできるかどうかを示します。
 boolean isReadOnly(int column)
          指定された列が絶対的に書き込み可能でないかどうかを示します。
 boolean isSearchable(int column)
          指定された列を where 節で使用できるかどうかを示します。
 boolean isSigned(int column)
          指定された列の値が符号付き数値かどうかを示します。
 boolean isWritable(int column)
          指定された列への書き込みを成功させることができるかどうかを示します。
 
インタフェース java.sql.Wrapper から継承されたメソッド
isWrapperFor, unwrap
 

フィールドの詳細

columnNoNulls

static final int columnNoNulls
列が NULL 値を許可しないことを示す定数です。

関連項目:
定数フィールド値

columnNullable

static final int columnNullable
列が NULL 値を許可することを示す定数です。

関連項目:
定数フィールド値

columnNullableUnknown

static final int columnNullableUnknown
列が NULL 値を許可するかどうか不明であることを示す定数です。

関連項目:
定数フィールド値
メソッドの詳細

getColumnCount

int getColumnCount()
                   throws SQLException
この ResultSet オブジェクトの列数を返します。

戻り値:
列数
例外:
SQLException - データベースアクセスエラーが発生した場合

isAutoIncrement

boolean isAutoIncrement(int column)
                        throws SQLException
指定された列が自動的に番号付けされるかどうかを示します。

パラメータ:
column - 最初の列は 1、2 番目の列は 2、... となる
戻り値:
上記の場合は true、そうでない場合は false
例外:
SQLException - データベースアクセスエラーが発生した場合

isCaseSensitive

boolean isCaseSensitive(int column)
                        throws SQLException
列の大文字小文字が区別されるかどうかを示します。

パラメータ:
column - 最初の列は 1、2 番目の列は 2、... となる
戻り値:
上記の場合は true、そうでない場合は false
例外:
SQLException - データベースアクセスエラーが発生した場合

isSearchable

boolean isSearchable(int column)
                     throws SQLException
指定された列を where 節で使用できるかどうかを示します。

パラメータ:
column - 最初の列は 1、2 番目の列は 2、... となる
戻り値:
上記の場合は true、そうでない場合は false
例外:
SQLException - データベースアクセスエラーが発生した場合

isCurrency

boolean isCurrency(int column)
                   throws SQLException
指定された列がキャッシュの値かどうかを示します。

パラメータ:
column - 最初の列は 1、2 番目の列は 2、... となる
戻り値:
上記の場合は true、そうでない場合は false
例外:
SQLException - データベースアクセスエラーが発生した場合

isNullable

int isNullable(int column)
               throws SQLException
指定された列に NULL をセットできるかどうかを示します。

パラメータ:
column - 最初の列は 1、2 番目の列は 2、... となる
戻り値:
指定された列に NULL をセットできるかどうか。columnNoNullscolumnNullablecolumnNullableUnknown のいずれか 1 つ
例外:
SQLException - データベースアクセスエラーが発生した場合

isSigned

boolean isSigned(int column)
                 throws SQLException
指定された列の値が符号付き数値かどうかを示します。

パラメータ:
column - 最初の列は 1、2 番目の列は 2、... となる
戻り値:
上記の場合は true、そうでない場合は false
例外:
SQLException - データベースアクセスエラーが発生した場合

getColumnDisplaySize

int getColumnDisplaySize(int column)
                         throws SQLException
指定された列の通常の最大幅を文字数で示します。

パラメータ:
column - 最初の列は 1、2 番目の列は 2、... となる
戻り値:
指定された列の幅として許可される通常の最大文字数
例外:
SQLException - データベースアクセスエラーが発生した場合

getColumnLabel

String getColumnLabel(int column)
                      throws SQLException
印刷や表示に使用する、指定された列の推奨タイトルを取得します。通常、推奨タイトルは、SQL AS 節として指定されます。SQL AS が指定されない場合、getColumnLabel から返された値は、getColumnName メソッドで返された値と同じになります。

パラメータ:
column - 最初の列は 1、2 番目の列は 2、... となる
戻り値:
列の推奨タイトル
例外:
SQLException - データベースアクセスエラーが発生した場合

getColumnName

String getColumnName(int column)
                     throws SQLException
指定された列の名前を取得します。

パラメータ:
column - 最初の列は 1、2 番目の列は 2、... となる
戻り値:
列名
例外:
SQLException - データベースアクセスエラーが発生した場合

getSchemaName

String getSchemaName(int column)
                     throws SQLException
指定された列のテーブルのスキーマを取得します。

パラメータ:
column - 最初の列は 1、2 番目の列は 2、... となる
戻り値:
スキーマ名。適用不可の場合は、""
例外:
SQLException - データベースアクセスエラーが発生した場合

getPrecision

int getPrecision(int column)
                 throws SQLException
指定された列に指定された列のサイズを取得します。数値データの場合は、最大精度です。文字データの場合は、文字数です。日時データ型の場合は、String 表現の文字数です (小数点以下の秒の構成要素の最大許容精度を仮定)。バイナリデータの場合は、バイト数です。ROWID データ型の場合は、バイト数です。列サイズが適用できないデータ型の場合は、0 が返されます。

パラメータ:
column - 最初の列は 1、2 番目の列は 2、... となる
戻り値:
精度
例外:
SQLException - データベースアクセスエラーが発生した場合

getScale

int getScale(int column)
             throws SQLException
指定された列の小数点以下の桁数を取得します。スケールが適用できないデータ型の場合は、0 が返されます。

パラメータ:
column - 最初の列は 1、2 番目の列は 2、... となる
戻り値:
スケール (桁数)
例外:
SQLException - データベースアクセスエラーが発生した場合

getTableName

String getTableName(int column)
                    throws SQLException
指定された列のテーブル名を取得します。

パラメータ:
column - 最初の列は 1、2 番目の列は 2、... となる
戻り値:
テーブル名。適用不可の場合は、""
例外:
SQLException - データベースアクセスエラーが発生した場合

getCatalogName

String getCatalogName(int column)
                      throws SQLException
指定された列のテーブルのカタログ名を取得します。

パラメータ:
column - 最初の列は 1、2 番目の列は 2、... となる
戻り値:
指定された列が現れるテーブルのカタログ名。適用不可の場合は、""
例外:
SQLException - データベースアクセスエラーが発生した場合

getColumnType

int getColumnType(int column)
                  throws SQLException
指定された列の SQL 型を取得します。

パラメータ:
column - 最初の列は 1、2 番目の列は 2、... となる
戻り値:
java.sql.Types からの SQL 型
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
Types

getColumnTypeName

String getColumnTypeName(int column)
                         throws SQLException
指定された列のデータベース固有の型名を取得します。

パラメータ:
column - 最初の列は 1、2 番目の列は 2、... となる
戻り値:
データベースが使用する型名。列の型がユーザー定義型の場合は、完全指定された型名
例外:
SQLException - データベースアクセスエラーが発生した場合

isReadOnly

boolean isReadOnly(int column)
                   throws SQLException
指定された列が絶対的に書き込み可能でないかどうかを示します。

パラメータ:
column - 最初の列は 1、2 番目の列は 2、... となる
戻り値:
上記の場合は true、そうでない場合は false
例外:
SQLException - データベースアクセスエラーが発生した場合

isWritable

boolean isWritable(int column)
                   throws SQLException
指定された列への書き込みを成功させることができるかどうかを示します。

パラメータ:
column - 最初の列は 1、2 番目の列は 2、... となる
戻り値:
上記の場合は true、そうでない場合は false
例外:
SQLException - データベースアクセスエラーが発生した場合

isDefinitelyWritable

boolean isDefinitelyWritable(int column)
                             throws SQLException
指定された列の書き込みが必ず成功するかどうかを示します。

パラメータ:
column - 最初の列は 1、2 番目の列は 2、... となる
戻り値:
上記の場合は true、そうでない場合は false
例外:
SQLException - データベースアクセスエラーが発生した場合

getColumnClassName

String getColumnClassName(int column)
                          throws SQLException
 

Java クラスの完全指定された名前を返します。 列から値を検索するために ResultSet.getObject メソッドが呼び出されると、この Java クラスのインスタンスが生成されます。ResultSet.getObject は、このメソッドで返されたクラスのサブクラスを返す場合もあります。

パラメータ:
column - 最初の列は 1、2 番目の列は 2、... となる
戻り値:
指定された列の値を取り出すために ResultSet.getObject メソッドによって使用される Java プログラミング言語のクラスの完全指定された名前。カスタムマッピングに使用されるクラス名
例外:
SQLException - データベースアクセスエラーが発生した場合
導入されたバージョン:
1.2

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。