概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 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)
          如果調用方法 ResultSet.getObject 從列中獲取值，則返回建構其實例的 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，……
返回：
如果是這樣，則返回 true；否則返回 false
拋出：
SQLException - 如果發生資料庫存取錯誤

isCaseSensitive

boolean isCaseSensitive(int column)
                        throws SQLException
指示列的大小寫是否有關係。

參數：
column - 第一列是 1，第二個列是 2，……
返回：
如果是這樣，則返回 true；否則返回 false
拋出：
SQLException - 如果發生資料庫存取錯誤

isSearchable

boolean isSearchable(int column)
                     throws SQLException
指示是否可以在 where 子句中使用指定的列。

參數：
column - 第一列是 1，第二個列是 2，……
返回：
如果是這樣，則返回 true；否則返回 false
拋出：
SQLException - 如果發生資料庫存取錯誤

isCurrency

boolean isCurrency(int column)
                   throws SQLException
指示指定的列是否是一個雜湊程式碼值。

參數：
column - 第一列是 1，第二個列是 2，……
返回：
如果是這樣，則返回 true；否則返回 false
拋出：
SQLException - 如果發生資料庫存取錯誤

isNullable

int isNullable(int column)
               throws SQLException
指示指定列中的值是否可以為 null。

參數：
column - 第一列是 1，第二個列是 2，……
返回：
給定列的狀態是否可以為 null 的判斷，此狀態值是 columnNoNulls、columnNullable 或 columnNullableUnknown 之一
拋出：
SQLException - 如果發生資料庫存取錯誤

isSigned

boolean isSigned(int column)
                 throws SQLException
指示指定列中的值是否帶正負號。

參數：
column - 第一列是 1，第二個列是 2，……
返回：
如果是這樣，則返回 true；否則返回 false
拋出：
SQLException - 如果發生資料庫存取錯誤

getColumnDisplaySize

int getColumnDisplaySize(int column)
                         throws SQLException
指示指定列的最大標準寬度，以字元為單位。

參數：
column - 第一列是 1，第二個列是 2，……
返回：
允許作為指定列寬度的最大標準字元數
拋出：
SQLException - 如果發生資料庫存取錯誤

getColumnLabel

String getColumnLabel(int column)
                      throws SQLException
獲取用於列印輸出和顯示的指定列的建議標題。建議標題通常由 SQL AS 子句來指定。如果未指定 SQL AS，則從 getColumnLabel 返回的值將和 getColumnName 方法返回的值相同。

參數：
column - 第一列是 1，第二個列是 2，……
返回：
建立列標題
拋出：
SQLException - 如果發生資料庫存取錯誤

getColumnName

String getColumnName(int column)
                     throws SQLException
獲取指定列的名稱。

參數：
column - 第一列是 1，第二個列是 2，……
返回：
列名稱
拋出：
SQLException - 如果發生資料庫存取錯誤

getSchemaName

String getSchemaName(int column)
                     throws SQLException
獲取指定列的表網要。

參數：
column - 第一列是 1，第二個列是 2，……
返回：
網要名稱；如果沒有可應用的名稱，則返回 ""
拋出：
SQLException - 如果發生資料庫存取錯誤

getPrecision

int getPrecision(int column)
                 throws SQLException
獲取指定列的指定列寬。對於數值型資料，是指最大精度。對於字元型資料，是指字元串長度。對於日期時間的資料型別，是指 String 表示形式的字元串長度（假定為最大允許的小數秒元件）。對於二進制型資料，是指位元組長度。對於 ROWID 資料型別，是指位元組長度。對於其列大小不可用的資料型別，則返回 0。

參數：
column - 第一列是 1，第二個列是 2，……
返回：
精度
拋出：
SQLException - 如果發生資料庫存取錯誤

getScale

int getScale(int column)
             throws SQLException
獲取指定列的小數點右邊的位數。對於其標度不可用的資料型別，則返回 0。

參數：
column - 第一列是 1，第二個列是 2，……
返回：
標度
拋出：
SQLException - 如果發生資料庫存取錯誤

getTableName

String getTableName(int column)
                    throws SQLException
獲取指定列的名稱。

參數：
column - 第一列是 1，第二個列是 2，……
返回：
表名稱；如果沒有可應用的名稱，則返回 ""
拋出：
SQLException - 如果發生資料庫存取錯誤

getCatalogName

String getCatalogName(int column)
                      throws SQLException
獲取指定列的表目錄名稱。

參數：
column - 第一列是 1，第二個列是 2，……
返回：
在其中顯示給定列的表的目錄名稱；如果可應用的名稱，則返回 ""
拋出：
SQLException - 如果發生資料庫存取錯誤

getColumnType

int getColumnType(int column)
                  throws SQLException
獲取指定列的 SQL 型別。

參數：
column - 第一列是 1，第二個列是 2，……
返回：
來自 java.sql.Types 的 SQL 型別
拋出：
SQLException - 如果發生資料庫存取錯誤
另請參見：
Types

getColumnTypeName

String getColumnTypeName(int column)
                         throws SQLException
獲取指定列的資料庫特定的型別名稱。

參數：
column - 第一列是 1，第二個列是 2，……
返回：
資料庫使用的型別名稱。如果列型別是使用者定義的型別，則返回完全限定的型別名稱。
拋出：
SQLException - 如果發生資料庫存取錯誤

isReadOnly

boolean isReadOnly(int column)
                   throws SQLException
指示指定的列是否明確不可寫入。

參數：
column - 第一列是 1，第二個列是 2，……
返回：
如果是這樣，則返回 true；否則返回 false
拋出：
SQLException - 如果發生資料庫存取錯誤

isWritable

boolean isWritable(int column)
                   throws SQLException
指示在指定的列上進行寫操作是否可以獲得成功。

參數：
column - 第一列是 1，第二個列是 2，……
返回：
如果是這樣，則返回 true；否則返回 false
拋出：
SQLException - 如果發生資料庫存取錯誤

isDefinitelyWritable

boolean isDefinitelyWritable(int column)
                             throws SQLException
指示在指定的列上進行寫操作是否明確可以獲得成功。

參數：
column - 第一列是 1，第二個列是 2，……
返回：
如果是這樣，則返回 true；否則返回 false
拋出：
SQLException - 如果發生資料庫存取錯誤

getColumnClassName

String getColumnClassName(int column)
                          throws SQLException

如果調用方法 ResultSet.getObject 從列中獲取值，則返回建構其實例的 Java 類別的完全限定名稱。ResultSet.getObject 可能返回此方法所返回的類別的子類別。

參數：
column - 第一列是 1，第二個列是 2，……
返回：
Java 程式語言中類別的完全限定名稱，方法 ResultSet.getObject 將使用該名稱獲取指定列中的值。此名稱為用於自定義映射關係的類別名稱。
拋出：
SQLException - 如果發生資料庫存取錯誤
從以下版本開始：
1.2
概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法
提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。