JavaTM 2 Platform
Standard Ed. 5.0

javax.sql
接口 RowSetMetaData

所有超级接口:
ResultSetMetaData
所有已知实现类:
RowSetMetaDataImpl

public interface RowSetMetaData
extends ResultSetMetaData

该对象包含关于 RowSet 对象的列的信息。此接口扩展了 ResultSetMetaData 接口,它增加了一些在 RowSetMetaData 对象中设置值的方法。当 RowSetReader 对象将数据读入 RowSet 对象时,它将创建一个 RowSetMetaData 对象并使用 RowSetMetaData 接口中的方法对其进行初始化。然后,reader 将 RowSetMetaData 对象传递给 rowset。

当应用程序调用 RowSet.execute 方法时,将在内部调用此接口中的方法;应用程序员不直接使用它们。

从以下版本开始:
1.4

字段摘要
 
从接口 java.sql.ResultSetMetaData 继承的字段
columnNoNulls, columnNullable, columnNullableUnknown
 
方法摘要
 void setAutoIncrement(int columnIndex, boolean property)
          设置是否为指定列自动编号,从而使这些列变为只读。
 void setCaseSensitive(int columnIndex, boolean property)
          设置指定列是否区分大小写。
 void setCatalogName(int columnIndex, String catalogName)
          将指定列的表的类别名称(如果有)设置为给定的 String
 void setColumnCount(int columnCount)
          将 RowSet 对象中的列数设置为给定数。
 void setColumnDisplaySize(int columnIndex, int size)
          将指定列的正常最大宽度(以 char 表示)设置为给定的 int
 void setColumnLabel(int columnIndex, String label)
          将建议用于打印输出和显示的列标题(如果有)设置为给定的 String
 void setColumnName(int columnIndex, String columnName)
          将指定列的名称设置为给定的 String
 void setColumnType(int columnIndex, int SQLType)
          将指定列的 SQL 类型设置为给定的类型。
 void setColumnTypeName(int columnIndex, String typeName)
          将指定列的特定于数据源的类型名称(如果有)设置为给定的 String
 void setCurrency(int columnIndex, boolean property)
          设置指定的列是否是现金值。
 void setNullable(int columnIndex, int property)
          设置是否可以将指定列的值设置为 NULL
 void setPrecision(int columnIndex, int precision)
          将指定列的小数位数设置为给定的 int
 void setScale(int columnIndex, int scale)
          将指定列的小数点右边的位数设置为给定的 int
 void setSchemaName(int columnIndex, String schemaName)
          将指定列的表模式的名称(如果有)设置为给定的 String
 void setSearchable(int columnIndex, boolean property)
          设置是否可以在 where 子句中使用指定的列。
 void setSigned(int columnIndex, boolean property)
          设置指定列是否是有符号数字。
 void setTableName(int columnIndex, String tableName)
          将指定列的表名称(如果有)设置为给定的 String
 
从接口 java.sql.ResultSetMetaData 继承的方法
getCatalogName, getColumnClassName, getColumnCount, getColumnDisplaySize, getColumnLabel, getColumnName, getColumnType, getColumnTypeName, getPrecision, getScale, getSchemaName, getTableName, isAutoIncrement, isCaseSensitive, isCurrency, isDefinitelyWritable, isNullable, isReadOnly, isSearchable, isSigned, isWritable
 

方法详细信息

setColumnCount

void setColumnCount(int columnCount)
                    throws SQLException
RowSet 对象中的列数设置为给定数。

参数:
columnCount - RowSet 对象中的列数
抛出:
SQLException - 如果发生数据库访问错误

setAutoIncrement

void setAutoIncrement(int columnIndex,
                      boolean property)
                      throws SQLException
设置是否为指定列自动编号,从而使这些列变为只读。默认值是不对 RowSet 对象的列进行自动编号。

参数:
columnIndex - 第一个列是 1,第二个列是 2,……
property - 如果为列自动编号,则为 true;否则为 false
抛出:
SQLException - 如果发生数据库访问错误

setCaseSensitive

void setCaseSensitive(int columnIndex,
                      boolean property)
                      throws SQLException
设置指定列是否区分大小写。默认值为 false

参数:
columnIndex - 第一个列是 1,第二个列是 2,……
property - 如果该列是区分大小写的,则为 true;否则为 false
抛出:
SQLException - 如果发生数据库访问错误

setSearchable

void setSearchable(int columnIndex,
                   boolean property)
                   throws SQLException
设置是否可以在 where 子句中使用指定的列。默认值为 false

参数:
columnIndex - 第一个列是 1,第二个列是 2,……
property - 如果可以在 WHERE 子句中使用该列,则为 true;否则为 false
抛出:
SQLException - 如果发生数据库访问错误

setCurrency

void setCurrency(int columnIndex,
                 boolean property)
                 throws SQLException
设置指定的列是否是现金值。默认值为 false

参数:
columnIndex - 第一个列是 1,第二个列是 2,……
property - 如果该列是现金值,则为 true;否则为 false
抛出:
SQLException - 如果发生数据库访问错误

setNullable

void setNullable(int columnIndex,
                 int property)
                 throws SQLException
设置是否可以将指定列的值设置为 NULL。默认值为 ResultSetMetaData.columnNullableUnknown

参数:
columnIndex - 第一个列是 1,第二个列是 2,……
property - 以下常量之一:ResultSetMetaData.columnNoNullsResultSetMetaData.columnNullableResultSetMetaData.columnNullableUnknown
抛出:
SQLException - 如果发生数据库访问错误

setSigned

void setSigned(int columnIndex,
               boolean property)
               throws SQLException
设置指定列是否是有符号数字。默认值为 false

参数:
columnIndex - 第一个列是 1,第二个列是 2,……
property - 如果该列是有符号数字,则为 true;否则为 false
抛出:
SQLException - 如果发生数据库访问错误

setColumnDisplaySize

void setColumnDisplaySize(int columnIndex,
                          int size)
                          throws SQLException
将指定列的正常最大宽度(以 char 表示)设置为给定的 int

参数:
columnIndex - 第一个列是 1,第二个列是 2,……
size - 指定列的正常最大字符数
抛出:
SQLException - 如果发生数据库访问错误

setColumnLabel

void setColumnLabel(int columnIndex,
                    String label)
                    throws SQLException
将建议用于打印输出和显示的列标题(如果有)设置为给定的 String

参数:
columnIndex - 第一个列是 1,第二个列是 2,……
label - 列标题
抛出:
SQLException - 如果发生数据库访问错误

setColumnName

void setColumnName(int columnIndex,
                   String columnName)
                   throws SQLException
将指定列的名称设置为给定的 String

参数:
columnIndex - 第一个列是 1,第二个列是 2,……
columnName - 指定列的名称
抛出:
SQLException - 如果发生数据库访问错误

setSchemaName

void setSchemaName(int columnIndex,
                   String schemaName)
                   throws SQLException
将指定列的表模式的名称(如果有)设置为给定的 String

参数:
columnIndex - 第一个列是 1,第二个列是 2,……
schemaName - 模式名
抛出:
SQLException - 如果发生数据库访问错误

setPrecision

void setPrecision(int columnIndex,
                  int precision)
                  throws SQLException
将指定列的小数位数设置为给定的 int

参数:
columnIndex - 第一个列是 1,第二个列是 2,……
precision - 小数位的总数
抛出:
SQLException - 如果发生数据库访问错误

setScale

void setScale(int columnIndex,
              int scale)
              throws SQLException
将指定列的小数点右边的位数设置为给定的 int

参数:
columnIndex - 第一个列是 1,第二个列是 2,……
scale - 小数点右边的位数
抛出:
SQLException - 如果发生数据库访问错误

setTableName

void setTableName(int columnIndex,
                  String tableName)
                  throws SQLException
将指定列的表名称(如果有)设置为给定的 String

参数:
columnIndex - 第一个列是 1,第二个列是 2,……
tableName - 列的表名称
抛出:
SQLException - 如果发生数据库访问错误

setCatalogName

void setCatalogName(int columnIndex,
                    String catalogName)
                    throws SQLException
将指定列的表的类别名称(如果有)设置为给定的 String

参数:
columnIndex - 第一个列是 1,第二个列是 2,……
catalogName - 列的类别名称
抛出:
SQLException - 如果发生数据库访问错误

setColumnType

void setColumnType(int columnIndex,
                   int SQLType)
                   throws SQLException
将指定列的 SQL 类型设置为给定的类型。

参数:
columnIndex - 第一个列是 1,第二个列是 2,……
SQLType - 列的 SQL 类型
抛出:
SQLException - 如果发生数据库访问错误
另请参见:
Types

setColumnTypeName

void setColumnTypeName(int columnIndex,
                       String typeName)
                       throws SQLException
将指定列的特定于数据源的类型名称(如果有)设置为给定的 String

参数:
columnIndex - 第一个列是 1,第二个列是 2,……
typeName - 特定于数据源的类型名称。
抛出:
SQLException - 如果发生数据库访问错误

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策