ResultSetMetaData
public interface ResultSetMetaData
implements Wrapper
java.sql.ResultSetMetaData |
Known Indirect Subclasses
|
一个对象,可用于获取有关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);
Summary
Constants
columnNoNulls
int columnNoNulls
该常数指示列不允许 NULL
值。
常量值:0(0x00000000)
columnNullable
int columnNullable
表示列允许 NULL
值的常量。
常数值:1(0x00000001)
columnNullableUnknown
int columnNullableUnknown
表示列值的可空性未知的常量。
常量值:2(0x00000002)
Public methods
getCatalogName
String getCatalogName (int column)
获取指定列的表格的目录名称。
Parameters |
column |
int : the first column is 1, the second is 2, ... |
Returns |
String |
the name of the catalog for the table in which the given column appears or "" if not applicable |
getColumnClassName
String getColumnClassName (int column)
如果调用方法ResultSet.getObject
以从列中检索值,则返回实例制造的Java类的完全限定名称。 ResultSet.getObject
可能会返回此方法返回的类的子类。
Parameters |
column |
int : the first column is 1, the second is 2, ... |
Returns |
String |
the fully-qualified name of the class in the Java programming language that would be used by the method ResultSet.getObject to retrieve the value in the specified column. This is the class name used for custom mapping. |
getColumnCount
int getColumnCount ()
返回此 ResultSet
对象中的列数。
Returns |
int |
the number of columns |
getColumnDisplaySize
int getColumnDisplaySize (int column)
以字符表示指定列的正常最大宽度。
Parameters |
column |
int : the first column is 1, the second is 2, ... |
Returns |
int |
the normal maximum number of characters allowed as the width of the designated column |
getColumnLabel
String getColumnLabel (int column)
获取指定列的建议标题以用于打印输出和显示。 建议的标题通常由SQL AS
子句指定。 如果未指定SQL AS
,则从getColumnLabel
返回的值将与由getColumnName
方法返回的值相同。
Parameters |
column |
int : the first column is 1, the second is 2, ... |
Returns |
String |
the suggested column title |
getColumnName
String getColumnName (int column)
获取指定列的名称。
Parameters |
column |
int : the first column is 1, the second is 2, ... |
getColumnType
int getColumnType (int column)
检索指定列的SQL类型。
Parameters |
column |
int : the first column is 1, the second is 2, ... |
Returns |
int |
SQL type from java.sql.Types |
getColumnTypeName
String getColumnTypeName (int column)
检索指定列的特定于数据库的类型名称。
Parameters |
column |
int : the first column is 1, the second is 2, ... |
Returns |
String |
type name used by the database. If the column type is a user-defined type, then a fully-qualified type name is returned. |
getPrecision
int getPrecision (int column)
获取指定列的指定列大小。 对于数字数据,这是最高精度。 对于字符数据,这是以字符为单位的长度。 对于datetime数据类型,这是字符串表示的字符长度(假设小数秒组件的最大允许精度)。 对于二进制数据,这是以字节为单位的长度。 对于ROWID数据类型,这是以字节为单位的长度。 对于列大小不适用的数据类型,返回0。
Parameters |
column |
int : the first column is 1, the second is 2, ... |
getScale
int getScale (int column)
获取小数点右侧指定列的位数。 针对比例不适用的数据类型返回0。
Parameters |
column |
int : the first column is 1, the second is 2, ... |
getSchemaName
String getSchemaName (int column)
获取指定列的表格模式。
Parameters |
column |
int : the first column is 1, the second is 2, ... |
Returns |
String |
schema name or "" if not applicable |
getTableName
String getTableName (int column)
获取指定列的表名。
Parameters |
column |
int : the first column is 1, the second is 2, ... |
Returns |
String |
table name or "" if not applicable |
isAutoIncrement
boolean isAutoIncrement (int column)
指示指定的列是否自动编号。
Parameters |
column |
int : the first column is 1, the second is 2, ... |
Returns |
boolean |
true if so; false otherwise |
isCaseSensitive
boolean isCaseSensitive (int column)
指示列的大小写是否重要。
Parameters |
column |
int : the first column is 1, the second is 2, ... |
Returns |
boolean |
true if so; false otherwise |
isCurrency
boolean isCurrency (int column)
指示指定的列是否为现金价值。
Parameters |
column |
int : the first column is 1, the second is 2, ... |
Returns |
boolean |
true if so; false otherwise |
isDefinitelyWritable
boolean isDefinitelyWritable (int column)
指示指定列上的写入是否一定会成功。
Parameters |
column |
int : the first column is 1, the second is 2, ... |
Returns |
boolean |
true if so; false otherwise |
isNullable
int isNullable (int column)
指示指定列中值的可空性。
Parameters |
column |
int : the first column is 1, the second is 2, ... |
Returns |
int |
the nullability status of the given column; one of columnNoNulls , columnNullable or columnNullableUnknown |
isReadOnly
boolean isReadOnly (int column)
指示指定的列是否绝对不可写。
Parameters |
column |
int : the first column is 1, the second is 2, ... |
Returns |
boolean |
true if so; false otherwise |
isSearchable
boolean isSearchable (int column)
指示是否可以在where子句中使用指定的列。
Parameters |
column |
int : the first column is 1, the second is 2, ... |
Returns |
boolean |
true if so; false otherwise |
isSigned
boolean isSigned (int column)
指示指定列中的值是否为有符号数字。
Parameters |
column |
int : the first column is 1, the second is 2, ... |
Returns |
boolean |
true if so; false otherwise |
isWritable
boolean isWritable (int column)
指示指定列上的写入是否可以成功。
Parameters |
column |
int : the first column is 1, the second is 2, ... |
Returns |
boolean |
true if so; false otherwise |