java.sql
介面 Ref

所有已知實作類別：

SerialRef

public interface Ref

Java 程式語言中 SQL REF 值的映射關係，它是到資料庫中的 SQL 結構型別值的參考。

SQL REF 值存儲在一個套件含可參考 SQL 結構型別實例的表中，每個 REF 值都是該表中一個實例的唯一標識符。SQL REF 值可用作表中的列值或結構型別中的屬性值，取代它所參考的 SQL 結構型別。

因為 SQL REF 值是一個指向 SQL 結構型別的邏輯指針，所以在預設情況下 Ref 物件也是一個邏輯指針。因此，以 Ref 物件的形式獲取 SQL REF 值不會在客戶端上實作結構型別的屬性。

可以使用 PreparedStatement.setRef 方法在資料庫中存儲 Ref 物件。

如果 JDBC 驅動程序支持資料型別，那麼 Ref 介面上的所有方法必須完全實作。

從以下版本開始：

1.2

另請參見：

Struct

方法摘要

String	getBaseTypeName() 獲取此 Ref 物件所參考 SQL 結構型別的完全限定的 SQL 名稱。
Object	getObject() 獲取此 Ref 物件參考的 SQL 結構型別實例。
Object	getObject(Map<String,Class<?>> map) 獲取參考對象並使用給定型別映射表將其映射到 Java 型別。
void	setObject(Object value) 將此 Ref 物件參考的結構型別值設置為給定的 Object 實例。

方法詳細資訊

getBaseTypeName

String getBaseTypeName()
                       throws SQLException

獲取此 Ref 物件所參考 SQL 結構型別的完全限定的 SQL 名稱。

返回：

SQL 結構型別參考的完全限定的 SQL 名稱

拋出：

SQLException - 如果發生資料庫存取錯誤

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.2

getObject

Object getObject(Map<String,Class<?>> map)
                 throws SQLException

獲取參考對象並使用給定型別映射表將其映射到 Java 型別。

參數：

map - 套件含要使用的映射關係的 java.util.Map 物件（要參考的 SQL 結構型別的完全限定名和將 SQL 結構型別映射到的 SQLData 實作的類別物件）

返回：

Java Object，它是此 Ref 物件參考的 SQL 結構型別的自定義映射關係

拋出：

SQLException - 如果發生資料庫存取錯誤

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

setObject(java.lang.Object)

getObject

Object getObject()
                 throws SQLException

獲取此 Ref 物件參考的 SQL 結構型別實例。如果連接的型別映射具有一個結構型別的項，則實例將被自定義映射到型別映射中指示的 Java 類別。否則，結構型別實例被映射到 Struct 物件。

返回：

Java Object，它是此 Ref 物件參考的 SQL 結構型別的映射關係

拋出：

SQLException - 如果發生資料庫存取錯誤

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

setObject(java.lang.Object)

setObject

void setObject(Object value)
               throws SQLException

將此 Ref 物件參考的結構型別值設置為給定的 Object 實例。在將該值發送到資料庫時，驅動程序將它轉換成一個 SQL 結構型別值。

參數：

value - 一個 Object，表示此 Ref 物件將參考的 SQL 結構型別實例

拋出：

SQLException - 如果發生資料庫存取錯誤

SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法

從以下版本開始：

1.4

另請參見：

getObject(), getObject(Map), PreparedStatement.setObject(int, Object), CallableStatement.setObject(String, Object)