概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法

java.sql
介面 SQLInput

所有已知實作類別：
SQLInputImpl
public interface SQLInput

一個輸入串流，它包含表示 SQL 結構化型別或 SQL 不同型別的實例的值組成的串流。此介面（僅用於自定義映射關係）供應用程序在後台使用，開發人員永遠不能直接調用 SQLInput 方法。reader 方法（readLong、readBytes 等）為 SQLData 介面的實作提供了讀取 SQLInput 物件值的一種方式。根據 SQLData 中的描述，必須按照其相應屬性在型別的 SQL 定義中出現的順序調用 reader 方法。方法 wasNull 用於確定讀取的最後一個值是否是 SQL NULL。

當用實作介面 SQLData 的類別的物件調用方法 getObject 時，JDBC 驅動程序調用方法 SQLData.getSQLType 來確定要自定義映射的使用者定義型別 (UDT) 的 SQL 型別。驅動程序創建一個 SQLInput 實例，並用 UDT 的屬性填充它。然後，驅動程序將輸入串流傳遞給方法 SQLData.readSQL，而該方法在其從輸入串流讀取屬性的實作中依次調用 SQLInput reader 方法。

從以下版本開始：
1.2

方法摘要
 Array readArray()
          從串流中讀取 SQL ARRAY 值並將其作為 Java 程式語言中的 Array 物件返回。
 InputStream readAsciiStream()
          讀取串流中的下一個屬性並將其作為 ASCII 字元串流返回。
 BigDecimal readBigDecimal()
          讀取串流中的下一個屬性並將其作為 Java 程式語言中的 java.math.BigDecimal 物件返回。
 InputStream readBinaryStream()
          讀取串流中的下一個屬性並將其作為未解釋的位元組串流返回。
 Blob readBlob()
          從串流中讀取 SQL BLOB 值並將其作為 Java 程式語言中的 Blob 物件返回。
 boolean readBoolean()
          讀取串流中的下一個屬性並將其作為 Java 程式語言中的 boolean 返回。
 byte readByte()
          讀取串流中的下一個屬性並將其作為 Java 程式語言中的 byte 返回。
 byte[] readBytes()
          讀取串流中的下一個屬性並將其作為 Java 程式語言中的位元組陣列返回。
 Reader readCharacterStream()
          讀取串流中的下一個屬性並將其作為 Unicode 字元串流返回。
 Clob readClob()
          從串流中讀取 SQL CLOB 值並將其作為 Java 程式語言中的 Clob 物件返回。
 Date readDate()
          讀取串流中的下一個屬性並將其作為 java.sql.Date 物件返回。
 double readDouble()
          讀取串流中的下一個屬性並將其作為 Java 程式語言中的 double 返回。
 float readFloat()
          讀取串流中的下一個屬性並將其作為 Java 程式語言中的 float 返回。
 int readInt()
          讀取串流中的下一個屬性並將其作為 Java 程式語言中的 int 返回。
 long readLong()
          讀取串流中的下一個屬性並將其作為 Java 程式語言中的 long 返回。
 NClob readNClob()
          從串流中讀取一個 SQL NCLOB 值，並以 Java 程式語言中 NCLOB 物件的形式返回。
 String readNString()
          讀取串流中的下一個屬性，並以 Java 程式語言中 String 的形式返回。
 Object readObject()
          讀取串流頭中的下一個屬性並將其作為 Java 程式語言中的 Object 返回。
 Ref readRef()
          從串流讀取 SQL REF 值並將其作為 Java 程式語言中的 Ref 物件返回。
 RowId readRowId()
          從串流中讀取一個 SQL ROWID 值，並以 Java 程式語言中 RowId 物件的形式返回。
 short readShort()
          讀取串流中的下一個屬性並將其作為 Java 程式語言中的 short 返回。
 SQLXML readSQLXML()
          從串流中讀取一個 SQL XML 值，並以 Java 程式語言中 SQLXML 物件的形式返回。
 String readString()
          讀取串流中的下一個屬性並將其作為 Java 程式語言中的 String 返回。
 Time readTime()
          讀取串流中的下一個屬性並將其作為 java.sql.Time 物件返回。
 Timestamp readTimestamp()
          讀取串流中的下一個屬性並將其作為 java.sql.Timestamp 物件返回。
 URL readURL()
          從串流中讀取 SQL DATALINK 值並將其作為 Java 程式語言中的 java.net.URL 物件返回。
 boolean wasNull()
          獲取最後一個讀取的值是否為 SQL NULL。
 

方法詳細資訊

readString

String readString()
                  throws SQLException
讀取串流中的下一個屬性並將其作為 Java 程式語言中的 String 返回。

返回：
屬性；如果值為 SQL NULL，則返回 null
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

readBoolean

boolean readBoolean()
                    throws SQLException
讀取串流中的下一個屬性並將其作為 Java 程式語言中的 boolean 返回。

返回：
屬性；如果值為 SQL NULL，則返回 false
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

readByte

byte readByte()
              throws SQLException
讀取串流中的下一個屬性並將其作為 Java 程式語言中的 byte 返回。

返回：
屬性；如果值為 SQL NULL，則返回 0
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

readShort

short readShort()
                throws SQLException
讀取串流中的下一個屬性並將其作為 Java 程式語言中的 short 返回。

返回：
屬性；如果值為 SQL NULL，則返回 0
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

readInt

int readInt()
            throws SQLException
讀取串流中的下一個屬性並將其作為 Java 程式語言中的 int 返回。

返回：
屬性；如果值為 SQL NULL，則返回 0
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

readLong

long readLong()
              throws SQLException
讀取串流中的下一個屬性並將其作為 Java 程式語言中的 long 返回。

返回：
屬性；如果值為 SQL NULL，則返回 0
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

readFloat

float readFloat()
                throws SQLException
讀取串流中的下一個屬性並將其作為 Java 程式語言中的 float 返回。

返回：
屬性；如果值為 SQL NULL，則返回 0
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

readDouble

double readDouble()
                  throws SQLException
讀取串流中的下一個屬性並將其作為 Java 程式語言中的 double 返回。

返回：
屬性；如果值為 SQL NULL，則返回 0
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

readBigDecimal

BigDecimal readBigDecimal()
                          throws SQLException
讀取串流中的下一個屬性並將其作為 Java 程式語言中的 java.math.BigDecimal 物件返回。

返回：
屬性；如果值為 SQL NULL，則返回 null
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

readBytes

byte[] readBytes()
                 throws SQLException
讀取串流中的下一個屬性並將其作為 Java 程式語言中的位元組陣列返回。

返回：
屬性；如果值為 SQL NULL，則返回 null
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

readDate

Date readDate()
              throws SQLException
讀取串流中的下一個屬性並將其作為 java.sql.Date 物件返回。

返回：
屬性；如果值為 SQL NULL，則返回 null
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

readTime

Time readTime()
              throws SQLException
讀取串流中的下一個屬性並將其作為 java.sql.Time 物件返回。

返回：
屬性；如果值為 SQL NULL，則返回 null
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

readTimestamp

Timestamp readTimestamp()
                        throws SQLException
讀取串流中的下一個屬性並將其作為 java.sql.Timestamp 物件返回。

返回：
屬性；如果值為 SQL NULL，則返回 null
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

readCharacterStream

Reader readCharacterStream()
                           throws SQLException
讀取串流中的下一個屬性並將其作為 Unicode 字元串流返回。

返回：
屬性；如果值為 SQL NULL，則返回 null
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

readAsciiStream

InputStream readAsciiStream()
                            throws SQLException
讀取串流中的下一個屬性並將其作為 ASCII 字元串流返回。

返回：
屬性；如果值為 SQL NULL，則返回 null
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

readBinaryStream

InputStream readBinaryStream()
                             throws SQLException
讀取串流中的下一個屬性並將其作為未解釋的位元組串流返回。

返回：
屬性；如果值為 SQL NULL，則返回 null
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

readObject

Object readObject()
                  throws SQLException
讀取串流頭中的下一個屬性並將其作為 Java 程式語言中的 Object 返回。返回物件的實際型別由預設型別映射關係和此串流的型別映射表中存在的自定義設置來確定。

型別映射表在將串流傳遞給應用程序前通過 JDBC 驅動程序在串流中註冊。

當串流的頭 (head of the stream) 中的資料為 SQL NULL 時，該方法返回 null。如果資料為 SQL 結構化型別或不同型別，則該方法確定了串流的頭中的資料的 SQL 型別。如果串流的型別映射表具有該 SQL 型別的項，則驅動程序將建構相應類別的物件，並對該物件調用 SQLData.readSQL 方法，該方法使用為它描述的協議從串流讀取其他資料。

返回：
作為 Java 程式語言中的 Object 返回串流的頭中的資料；如果資料為 SQL NULL，則返回 null
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

readRef

Ref readRef()
            throws SQLException
從串流讀取 SQL REF 值並將其作為 Java 程式語言中的 Ref 物件返回。

返回：
表示串流的頭中的 SQL REF 值的 Ref 物件；如果讀取的值為 SQL NULL，則返回 null
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

readBlob

Blob readBlob()
              throws SQLException
從串流中讀取 SQL BLOB 值並將其作為 Java 程式語言中的 Blob 物件返回。

返回：
表示串流的頭中的 SQL BLOB 值資料的 Blob 物件；如果讀取的值為 SQL NULL，則返回 null
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

readClob

Clob readClob()
              throws SQLException
從串流中讀取 SQL CLOB 值並將其作為 Java 程式語言中的 Clob 物件返回。

返回：
表示串流的頭中的 SQL CLOB 值資料的 Clob 物件；如果讀取的值為 SQL NULL，則返回 null
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

readArray

Array readArray()
                throws SQLException
從串流中讀取 SQL ARRAY 值並將其作為 Java 程式語言中的 Array 物件返回。

返回：
表示串流的頭中的 SQL ARRAY 值資料的 Array 物件；如果讀取的值為 SQL NULL，則返回 null
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

wasNull

boolean wasNull()
                throws SQLException
獲取最後一個讀取的值是否為 SQL NULL。

返回：
如果最近讀取的 SQL 值為 SQL NULL，則返回 true；否則返回 false
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

readURL

URL readURL()
            throws SQLException
從串流中讀取 SQL DATALINK 值並將其作為 Java 程式語言中的 java.net.URL 物件返回。

返回：
java.net.URL 物件。
拋出：
SQLException - 如果發生資料庫存取錯誤或者 URL 是錯誤的
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4

readNClob

NClob readNClob()
                throws SQLException
從串流中讀取一個 SQL NCLOB 值，並以 Java 程式語言中 NCLOB 物件的形式返回。

返回：
表示串流的頭中的 SQL NCLOB 值資料的 NClob 物件；如果讀取的值為 SQL NULL，則返回 null
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

readNString

String readNString()
                   throws SQLException
讀取串流中的下一個屬性，並以 Java 程式語言中 String 的形式返回。此方法用於存取 NCHAR、NVARCHAR 和 LONGNVARCHAR 列時。

返回：
屬性；如果該值為 SQL NULL，則返回 null
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

readSQLXML

SQLXML readSQLXML()
                  throws SQLException
從串流中讀取一個 SQL XML 值，並以 Java 程式語言中 SQLXML 物件的形式返回。

返回：
表示串流的頭中的 SQL XML 值資料的 SQLXML 物件；如果讀取的值為 SQL NULL，則返回 null
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

readRowId

RowId readRowId()
                throws SQLException
從串流中讀取一個 SQL ROWID 值，並以 Java 程式語言中 RowId 物件的形式返回。

返回：
表示串流的頭中的 SQL ROWID 值資料的 RowId 物件；如果讀取的值為 SQL NULL，則返回 null
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6
概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法
提交錯誤或意見

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