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

java.sql
介面 SQLOutput

所有已知實作類別：
SQLOutputImpl
public interface SQLOutput

用於將使用者定義型別的屬性寫回資料庫的輸出串流。此介面（僅用於自定義映射關係）供應用程序使用，開發人員永遠不能直接調用其方法。

將實作介面 SQLData 的類別的物件作為參數傳遞給 SQL 語句時，JDBC 驅動程序將調用方法 SQLData.getSQLType 來確定要傳遞到資料庫的 SQL 資料的種類別。然後，驅動程序創建 SQLOutput 的實例並將其傳遞給方法 SQLData.writeSQL。方法 writeSQL 依次調用適當的 SQLOutput writer 方法（writeBoolean、writeCharacterStream 等），將資料作為 SQL 使用者定義型別的表示形式從 SQLData 物件寫入 SQLOutput 輸出串流。

從以下版本開始：
1.2

方法摘要
 void writeArray(Array x)
          將 SQL ARRAY 值寫入串流中。
 void writeAsciiStream(InputStream x)
          將下一個屬性作為 ASCII 字元串流寫入串流中。
 void writeBigDecimal(BigDecimal x)
          將下一個屬性作為 java.math.BigDecimal 物件寫入串流中。
 void writeBinaryStream(InputStream x)
          將下一個屬性作為未解釋位元組串流寫入串流中。
 void writeBlob(Blob x)
          將 SQL BLOB 值寫入串流中。
 void writeBoolean(boolean x)
          將下一個屬性作為 Java boolean 值寫入串流。
 void writeByte(byte x)
          將下一個屬性作為 Java byte 值寫入串流中。
 void writeBytes(byte[] x)
          將下一個屬性作為位元組陣列寫入串流中。
 void writeCharacterStream(Reader x)
          將下一個屬性作為 Unicode 字元的串流寫入串流中。
 void writeClob(Clob x)
          將 SQL CLOB 值寫入串流中。
 void writeDate(Date x)
          將下一個屬性作為 java.sql.Date 物件寫入串流中。
 void writeDouble(double x)
          將下一個屬性作為 Java double 值寫入串流中。
 void writeFloat(float x)
          將下一個屬性作為 Java float 值寫入串流中。
 void writeInt(int x)
          將下一個屬性作為 Java int 值寫入串流中。
 void writeLong(long x)
          將下一個屬性作為 Java long 值寫入串流中。
 void writeNClob(NClob x)
          將 SQL NCLOB 值寫入串流中。
 void writeNString(String x)
          將下一個屬性以 Java 程式語言中 String 的形式寫入串流中。
 void writeObject(SQLData x)
          將給定 SQLData 物件中包含的資料寫入串流中。
 void writeRef(Ref x)
          將 SQL REF 值寫入串流中。
 void writeRowId(RowId x)
          將 SQL ROWID 值寫入串流中。
 void writeShort(short x)
          將下一個屬性作為 Java short 值寫入串流中。
 void writeSQLXML(SQLXML x)
          將 SQL XML 值寫入串流中。
 void writeString(String x)
          將下一個屬性作為 Java 程式語言中的 String 寫入串流中。
 void writeStruct(Struct x)
          將 SQL 結構型別值寫入串流中。
 void writeTime(Time x)
          將下一個屬性作為 java.sql.Time 物件寫入串流中。
 void writeTimestamp(Timestamp x)
          將下一個屬性作為 java.sql.Timestamp 物件寫入串流中。
 void writeURL(URL x)
          將 SQL DATALINK 值寫入串流中。
 

方法詳細資訊

writeString

void writeString(String x)
                 throws SQLException
將下一個屬性作為 Java 程式語言中的 String 寫入串流中。

參數：
x - 傳遞給資料庫的值
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

writeBoolean

void writeBoolean(boolean x)
                  throws SQLException
將下一個屬性作為 Java boolean 值寫入串流。將下一個屬性作為 Java 程式語言中的 String 寫入串流中。

參數：
x - 傳遞給資料庫的值
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

writeByte

void writeByte(byte x)
               throws SQLException
將下一個屬性作為 Java byte 值寫入串流中。將下一個屬性作為 Java 程式語言中的 String 寫入串流中。

參數：
x - 傳遞給資料庫的值
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

writeShort

void writeShort(short x)
                throws SQLException
將下一個屬性作為 Java short 值寫入串流中。將下一個屬性作為 Java 程式語言中的 String 寫入串流中。

參數：
x - 傳遞給資料庫的值
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

writeInt

void writeInt(int x)
              throws SQLException
將下一個屬性作為 Java int 值寫入串流中。將下一個屬性作為 Java 程式語言中的 String 寫入串流中。

參數：
x - 傳遞給資料庫的值
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

writeLong

void writeLong(long x)
               throws SQLException
將下一個屬性作為 Java long 值寫入串流中。將下一個屬性作為 Java 程式語言中的 String 寫入串流中。

參數：
x - 傳遞給資料庫的值
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

writeFloat

void writeFloat(float x)
                throws SQLException
將下一個屬性作為 Java float 值寫入串流中。將下一個屬性作為 Java 程式語言中的 String 寫入串流中。

參數：
x - 傳遞給資料庫的值
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

writeDouble

void writeDouble(double x)
                 throws SQLException
將下一個屬性作為 Java double 值寫入串流中。將下一個屬性作為 Java 程式語言中的 String 寫入串流中。

參數：
x - 傳遞給資料庫的值
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

writeBigDecimal

void writeBigDecimal(BigDecimal x)
                     throws SQLException
將下一個屬性作為 java.math.BigDecimal 物件寫入串流中。將下一個屬性作為 Java 程式語言中的 String 寫入串流中。

參數：
x - 傳遞給資料庫的值
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

writeBytes

void writeBytes(byte[] x)
                throws SQLException
將下一個屬性作為位元組陣列寫入串流中。將下一個屬性作為 Java 程式語言中的 String 寫入串流中。

參數：
x - 傳遞給資料庫的值
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

writeDate

void writeDate(Date x)
               throws SQLException
將下一個屬性作為 java.sql.Date 物件寫入串流中。將下一個屬性作為 Java 程式語言中的 java.sql.Date 物件寫入串流中。

參數：
x - 傳遞給資料庫的值
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

writeTime

void writeTime(Time x)
               throws SQLException
將下一個屬性作為 java.sql.Time 物件寫入串流中。將下一個屬性作為 Java 程式語言中的 java.sql.Date 物件寫入串流中。

參數：
x - 傳遞給資料庫的值
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

writeTimestamp

void writeTimestamp(Timestamp x)
                    throws SQLException
將下一個屬性作為 java.sql.Timestamp 物件寫入串流中。將下一個屬性作為 Java 程式語言中的 java.sql.Date 物件寫入串流中。

參數：
x - 傳遞給資料庫的值
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

writeCharacterStream

void writeCharacterStream(Reader x)
                          throws SQLException
將下一個屬性作為 Unicode 字元的串流寫入串流中。

參數：
x - 傳遞給資料庫的值
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

writeAsciiStream

void writeAsciiStream(InputStream x)
                      throws SQLException
將下一個屬性作為 ASCII 字元串流寫入串流中。

參數：
x - 傳遞給資料庫的值
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

writeBinaryStream

void writeBinaryStream(InputStream x)
                       throws SQLException
將下一個屬性作為未解釋位元組串流寫入串流中。

參數：
x - 傳遞給資料庫的值
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

writeObject

void writeObject(SQLData x)
                 throws SQLException
將給定 SQLData 物件中包含的資料寫入串流中。當 SQLData 物件為 null 時，此方法將 SQL NULL 寫入串流中。否則，它將調用給定物件的 SQLData.writeSQL 方法，該方法將物件的屬性寫入串流中。方法 SQLData.writeSQ 的實作調用適當的 SQLOutput writer 方法，依次寫入物件的每個屬性。從 SQLInput 輸入串流讀取屬性和將屬性寫入 SQLOutput 輸出串流都必須按照在使用者定義型別的 SQL 定義中將它們列出的順序進行。

參數：
x - 表示 SQL 結構或不同型別的資料的物件
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

writeRef

void writeRef(Ref x)
              throws SQLException
將 SQL REF 值寫入串流中。

參數：
x - 表示 SQL 的資料的 Ref 物件 REF value
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

writeBlob

void writeBlob(Blob x)
               throws SQLException
將 SQL BLOB 值寫入串流中。

參數：
x - 表示 SQL BLOB 值的資料的 Blob 物件
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

writeClob

void writeClob(Clob x)
               throws SQLException
將 SQL CLOB 值寫入串流中。

參數：
x - 表示 SQL CLOB 值的資料的 Clob 物件
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

writeStruct

void writeStruct(Struct x)
                 throws SQLException
將 SQL 結構型別值寫入串流中。

參數：
x - 表示 SQL 結構型別的資料的 Struct 物件
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

writeArray

void writeArray(Array x)
                throws SQLException
將 SQL ARRAY 值寫入串流中。

參數：
x - 表示 SQL ARRAY 型別的資料的 Array 物件
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.2

writeURL

void writeURL(URL x)
              throws SQLException
將 SQL DATALINK 值寫入串流中。

參數：
x - 表示 SQL DATALINK 型別的資料的 java.net.URL 物件
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4

writeNString

void writeNString(String x)
                  throws SQLException
將下一個屬性以 Java 程式語言中 String 的形式寫入串流中。在將該屬性發送給串流時，驅動程序將其轉換為 SQL NCHAR、NVARCHAR 或 LONGNVARCHAR 值（具體取決於該參數相對於驅動程序在 NVARCHAR 值上的限制的大小）。

參數：
x - 傳遞給資料庫的值
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

writeNClob

void writeNClob(NClob x)
                throws SQLException
將 SQL NCLOB 值寫入串流中。

參數：
x - 表示 SQL NCLOB 值資料的 NClob 物件
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

writeRowId

void writeRowId(RowId x)
                throws SQLException
將 SQL ROWID 值寫入串流中。

參數：
x - 表示 SQL ROWID 值的資料的 RowId 物件
拋出：
SQLException - 如果發生資料庫存取錯誤
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

writeSQLXML

void writeSQLXML(SQLXML x)
                 throws SQLException
將 SQL XML 值寫入串流中。

參數：
x - 表示 SQL XML 值資料的 SQLXML 物件
拋出：
SQLException - 如果發生資料庫存取錯誤，如果沒有為 SQLXML 物件關閉 java.xml.transform.Result、Writer 或 OutputStream，或者在處理 XML 值的過程中發生錯誤。異常的 getCause 方法可以提供更詳細的異常資訊，例如，如果該串流不包含有效的 XML。
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6
概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法
提交錯誤或意見

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