インタフェース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);
- 導入されたバージョン:
- 1.1
-
フィールドのサマリー
フィールド修飾子と型フィールド説明static final int列がNULL値を許可しないことを示す定数です。static final int列がNULL値を許可することを示す定数です。static final int列がNULL値を許可するかどうか不明であることを示す定数です。 -
メソッドのサマリー
修飾子と型メソッド説明getCatalogName(int column) 指定された列の表のカタログ名を取得します。getColumnClassName(int column) Javaクラスの完全指定された名前を返します。列から値を検索するためにResultSet.getObjectメソッドが呼び出されると、このJavaクラスのインスタンスが生成されます。intこのResultSetオブジェクトの列数を返します。intgetColumnDisplaySize(int column) 指定された列の通常の最大幅を文字数で示します。getColumnLabel(int column) 印刷や表示に使用する、指定された列の推奨タイトルを取得します。getColumnName(int column) 指定された列の名前を取得します。intgetColumnType(int column) 指定された列のSQL型を取得します。getColumnTypeName(int column) 指定された列のデータベース固有の型名を取得します。intgetPrecision(int column) 指定された列に指定された列のサイズを取得します。intgetScale(int column) 指定された列の小数点以下の桁数を取得します。スケールが適用できないデータ型の場合は、0が返されます。getSchemaName(int column) 指定された列の表のスキーマを取得します。getTableName(int column) 指定された列の表名を取得します。booleanisAutoIncrement(int column) 指定された列が自動的に番号付けされるかどうかを示します。booleanisCaseSensitive(int column) 列の大文字小文字が区別されるかどうかを示します。booleanisCurrency(int column) 指定された列がキャッシュの値かどうかを示します。booleanisDefinitelyWritable(int column) 指定された列の書込みが必ず成功するかどうかを示します。intisNullable(int column) 指定された列にNULL値が許可されるかどうかを示します。booleanisReadOnly(int column) 指定された列が絶対的に書込み可能でないかどうかを示します。booleanisSearchable(int column) 指定された列をwhere節で使用できるかどうかを示します。booleanisSigned(int column) 指定された列の値が符号付き数値かどうかを示します。booleanisWritable(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値が許可されるかどうか。
columnNoNulls、columnNullable、columnNullableUnknownのいずれか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
印刷や表示に使用する、指定された列の推奨タイトルを取得します。 通常、推奨タイトルは、SQLAS節として指定されます。 SQLASが指定されていない場合、getColumnLabelから返される値は、getColumnNameメソッドによって返される値と同じになります。- パラメータ:
column- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 列の推奨タイトル
- スロー:
SQLException- データベース・アクセス・エラーが発生した場合
-
getColumnName
指定された列の名前を取得します。- パラメータ:
column- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 列名
- スロー:
SQLException- データベース・アクセス・エラーが発生した場合
-
getSchemaName
指定された列の表のスキーマを取得します。- パラメータ:
column- 最初の列は1、2番目の列は2、... となる- 戻り値:
- スキーマ名。適用不可の場合は""
- スロー:
SQLException- データベース・アクセス・エラーが発生した場合
-
getPrecision
int getPrecision(int column) throws SQLException 指定された列に指定された列のサイズを取得します。 数値データの場合は、最大精度です。 文字データの場合は、文字数です。 日時データ型の場合は、String表現の文字数です(小数点以下の秒の構成要素の最大許容精度を仮定)。 バイナリ・データの場合は、バイト数です。 ROWIDデータ型の場合は、バイト数です。列サイズが適用できないデータ型の場合は、0が返されます。- パラメータ:
column- 最初の列は1、2番目の列は2、... となる- 戻り値:
- precision
- スロー:
SQLException- データベース・アクセス・エラーが発生した場合
-
getScale
int getScale(int column) throws SQLException 指定された列の小数点以下の桁数を取得します。スケールが適用できないデータ型の場合は、0が返されます。- パラメータ:
column- 最初の列は1、2番目の列は2、... となる- 戻り値:
- scale
- スロー:
SQLException- データベース・アクセス・エラーが発生した場合
-
getTableName
指定された列の表名を取得します。- パラメータ:
column- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 表名。適用不可の場合は""
- スロー:
SQLException- データベース・アクセス・エラーが発生した場合
-
getCatalogName
指定された列の表のカタログ名を取得します。- パラメータ:
column- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 指定された列が現れる表のカタログ名。適用不可の場合は""
- スロー:
SQLException- データベース・アクセス・エラーが発生した場合
-
getColumnType
int getColumnType(int column) throws SQLException 指定された列のSQL型を取得します。- パラメータ:
column- 最初の列は1、2番目の列は2、... となる- 戻り値:
- java.sql.TypesからのSQL型
- スロー:
SQLException- データベース・アクセス・エラーが発生した場合- 関連項目:
-
getColumnTypeName
指定された列のデータベース固有の型名を取得します。- パラメータ:
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
Javaクラスの完全指定された名前を返します。列から値を検索するために
ResultSet.getObjectメソッドが呼び出されると、このJavaクラスのインスタンスが生成されます。ResultSet.getObjectは、このメソッドによって返されたクラスのサブクラスを返すことがあります。- パラメータ:
column- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 指定された列の値を取り出すために
ResultSet.getObjectメソッドによって使用されるJavaプログラミング言語のクラスの完全指定された名前。 カスタム・マッピングに使用されるクラス名 - スロー:
SQLException- データベース・アクセス・エラーが発生した場合- 導入されたバージョン:
- 1.2
-