SQLOutput (Java Platform SE 8 )

所有已知实现类：

SQLOutputImpl
```
public interface SQLOutput
```
用于将用户定义类型的属性写入数据库的输出流。此接口仅用于自定义映射，由驱动程序使用，其方法从不直接由程序员调用。
在实现接口的类的对象SQLData作为参数传递给一个SQL语句传递，JDBC驱动程序调用该方法SQLData.getSQLType ，以确定被传递到数据库的SQL类型的数据的。然后，驱动程序创建一个SQLOutput的实例，并将其传递给方法SQLData.writeSQL 。该方法writeSQL依次调用适当SQLOutput 作家方法writeBoolean ， writeCharacterStream ，等等），以写入从数据SQLData对象到SQLOutput输出流作为SQL用户定义类型的表示。

从以下版本开始：

1.2

方法摘要

所有方法接口方法抽象方法 Default Methods
Modifier and Type	Method and Description
`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布尔值写入流。
`void`	`writeByte(byte x)` 将下一个属性作为Java字节写入流。
`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写入流。
`void`	`writeNClob(NClob x)` 将SQL `NCLOB`值写入流。
`void`	`writeNString(String x)` 接下来的属性写入流为 `String`的Java编程语言。
`default void`	`writeObject(Object x, SQLType targetSqlType)` 将包含在给定对象中的数据写入流。
`void`	`writeObject(SQLData x)` 向流中写入包含在给定的 `SQLData`对象中的数据。
`void`	`writeRef(Ref x)` 将SQL `REF`值写入流。
`void`	`writeRowId(RowId x)` 将SQL `ROWID`值写入流。
`void`	`writeShort(short x)` 将下一个属性写入流作为Java短。
`void`	`writeSQLXML(SQLXML x)` 将SQL `XML`值写入流。
`void`	`writeString(String x)` 接下来的属性写入流为 `String`的Java编程语言。
`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
```
    接下来的属性写入流为 String的Java编程语言。
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果发生数据库访问错误
    
    SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    1.2
  - writeBoolean
```
void writeBoolean(boolean x)
           throws SQLException
```
    将下一个属性作为Java布尔值写入流。接下来的属性写入流为String的Java编程语言。
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果发生数据库访问错误
    
    SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    1.2
  - writeByte
```
void writeByte(byte x)
        throws SQLException
```
    将下一个属性作为Java字节写入流。接下来的属性写入流为String的Java编程语言。
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果发生数据库访问错误
    
    SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    1.2
  - writeShort
```
void writeShort(short x)
         throws SQLException
```
    将下一个属性写入流作为Java短。接下来的属性写入流为String的Java编程语言。
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果发生数据库访问错误
    
    SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    1.2
  - writeInt
```
void writeInt(int x)
       throws SQLException
```
    将下一个属性作为Java int写入流。接下来的属性写入流为String的Java编程语言。
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果发生数据库访问错误
    
    SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    1.2
  - writeLong
```
void writeLong(long x)
        throws SQLException
```
    将下一个属性作为Java写入流。接下来的属性写入流为String的Java编程语言。
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果发生数据库访问错误
    
    SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    1.2
  - writeFloat
```
void writeFloat(float x)
         throws SQLException
```
    将下一个属性作为Java float写入流。接下来的属性写入流为String的Java编程语言。
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果发生数据库访问错误
    
    SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    1.2
  - writeDouble
```
void writeDouble(double x)
          throws SQLException
```
    将下一个属性作为Java double写入流。接下来的属性写入流为String的Java编程语言。
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果发生数据库访问错误
    
    SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    1.2
  - writeBigDecimal
```
void writeBigDecimal(BigDecimal x)
              throws SQLException
```
    将下一个属性作为java.math.BigDecimal对象写入流。接下来的属性写入流为String的Java编程语言。
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果发生数据库访问错误
    
    SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    1.2
  - writeBytes
```
void writeBytes(byte[] x)
         throws SQLException
```
    将下一个属性写入流作为字节数组。接下来的属性写入流为String的Java编程语言。
    
    参数
    
    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.writeSQL调用适当的SQLOutput写入器方法来按顺序写入每个对象的属性。这些属性必须从SQLInput输入流中读取，并以与用户定义类型的SQL定义相同的顺序写入SQLOutput输出流。
    
    参数
    
    x - 表示SQL结构化或不同类型数据的对象
    
    异常
    
    SQLException - 如果发生数据库访问错误
    
    SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    1.2
  - writeRef
```
void writeRef(Ref x)
       throws SQLException
```
    将SQL REF值写入流。
    
    参数
    
    x - 表示SQL REF值的数据的 Ref对象
    
    异常
    
    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
```
    接下来的属性写入流为String的Java编程语言。驱动程序将其转换为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 -如果发生数据库访问错误， java.xml.transform.Result ， Writer或OutputStream尚未收为SQLXML对象或者如果存在一个错误处理XML值。 getCause方法可以提供更详细的异常，例如，如果流不包含有效的XML。
    
    SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    1.6
  - writeObject
```
default void writeObject(Object x,
                         SQLType targetSqlType)
                  throws SQLException
```
    将包含在给定对象中的数据写入流。在发送到流之前，该对象将转换为指定的targetSqlType。
    当object为null时，此方法将SQL NULL写入流中。
    
    如果对象具有自定义映射（是实现接口的类的SQLData ），JDBC驱动程序应该调用方法SQLData.writeSQL将其写入到SQL数据流。如果，在另一方面，对象是实现一类Ref ， Blob ， Clob ， NClob ， Struct ， java.net.URL ，或Array ，则驱动程序应当将它传递给数据库作为相应SQL类型的值。
    
    默认实现将抛出SQLFeatureNotSupportedException
    
    参数
    
    x - 包含输入参数值的对象
    
    targetSqlType - 要发送到数据库的SQL类型。
    
    异常
    
    SQLException - 如果发生数据库访问错误，或者x指定的Java对象是InputStream或Reader对象，并且scale参数的值小于零
    
    SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此数据类型
    
    从以下版本开始：
    
    1.8
    
    另请参见：
    
    JDBCType ， SQLType

Interface SQLOutput

方法摘要

方法详细信息

writeString

writeBoolean

writeByte

writeShort

writeInt

writeLong

writeFloat

writeDouble

writeBigDecimal

writeBytes

writeDate

writeTime

writeTimestamp

writeCharacterStream

writeAsciiStream

writeBinaryStream

writeObject

writeRef

writeBlob

writeClob

writeStruct

writeArray

writeURL

writeNString

writeNClob

writeRowId

writeSQLXML

writeObject