SQLOutputImpl (Java Platform SE 8 )

java.lang.Object
- javax.sql.rowset.serial.SQLOutputImpl

All Implemented Interfaces:

SQLOutput
```
public class SQLOutputImpl
extends Object
implements SQLOutput
```
用于将自定义映射的用户定义类型（UDT）的属性写入数据库的输出流。驱动程序在内部使用此接口，并且其方法从不直接由应用程序编程器调用。
当应用程序调用方法PreparedStatement.setObject时，驱动程序将检查要写入的值是否是具有自定义映射的UDT。如果是，在类型映射中将包含一个条目，该条目包含该UDT实现SQLData的类的类对象。要写入的值为SQLData的实例，驱动程序将创建一个SQLOutputImpl的实例， SQLOutputImpl其传递给方法SQLData.writeSQL 。方法writeSQL依次调用适当的SQLOutputImpl.writeXXX方法，将数据从SQLData对象写入SQLOutputImpl输出流，作为SQL用户定义类型的表示形式。

构造方法摘要

构造方法
Constructor and Description
`SQLOutputImpl(Vector<?> attributes, Map<String,?> map)` 创建一个新的 `SQLOutputImpl`对象，用给定的属性向量初始化并输入map。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`writeArray(Array x)` 将Java编程语言中的 `Array`对象写入此 `SQLOutputImpl`对象。
`void`	`writeAsciiStream(InputStream x)` 将ASCII字符串写入此 `SQLOutputImpl`对象。
`void`	`writeBigDecimal(BigDecimal x)` 将Java编程语言中的 `java.math.BigDecimal`对象写入此 `SQLOutputImpl`对象。
`void`	`writeBinaryStream(InputStream x)` 将一串未解释的字节写入此 `SQLOutputImpl`对象。
`void`	`writeBlob(Blob x)` 将Java编程语言中的 `Blob`对象写入此 `SQLOutputImpl`对象。
`void`	`writeBoolean(boolean x)` 写一个 `boolean`在Java编程语言中此 `SQLOutputImpl`对象。
`void`	`writeByte(byte x)` 写一个 `byte`在Java编程语言中此 `SQLOutputImpl`对象。
`void`	`writeBytes(byte[] x)` 写入数组 `bytes`在Java编程语言中此 `SQLOutputImpl`对象。
`void`	`writeCharacterStream(Reader x)` 将Unicode字符串写入此 `SQLOutputImpl`对象。
`void`	`writeClob(Clob x)` 将Java编程语言中的 `Clob`对象写入此 `SQLOutputImpl`对象。
`void`	`writeDate(Date x)` 将Java编程语言中的 `java.sql.Date`对象写入此 `SQLOutputImpl`对象。
`void`	`writeDouble(double x)` 写一个 `double`在Java编程语言中此 `SQLOutputImpl`对象。
`void`	`writeFloat(float x)` 写一个 `float`在Java编程语言中此 `SQLOutputImpl`对象。
`void`	`writeInt(int x)` 写入一个 `int`在Java编程语言中此 `SQLOutputImpl`对象。
`void`	`writeLong(long x)` 写一个 `long`在Java编程语言中此 `SQLOutputImpl`对象。
`void`	`writeNClob(NClob x)` 写入SQL `NCLOB`值到流。
`void`	`writeNString(String x)` 接下来的属性写入流为 `String`的Java编程语言。
`void`	`writeObject(SQLData x)` 将数据写入给定的 `SQLData`对象中包含的数据。
`void`	`writeRef(Ref x)` 将Java编程语言中的 `Ref`对象写入此 `SQLOutputImpl`对象。
`void`	`writeRowId(RowId x)` 写入SQL `ROWID`值到流。
`void`	`writeShort(short x)` 写一个 `short`在Java编程语言中此 `SQLOutputImpl`对象。
`void`	`writeSQLXML(SQLXML x)` 将SQL `XML`值写入流。
`void`	`writeString(String x)` 写一个 `String`在Java编程语言中此 `SQLOutputImpl`对象。
`void`	`writeStruct(Struct x)` 将Java编程语言中的 `Struct`对象写入此 `SQLOutputImpl`对象。
`void`	`writeTime(Time x)` 将Java编程语言中的 `java.sql.Time`对象写入此 `SQLOutputImpl`对象。
`void`	`writeTimestamp(Timestamp x)` 将Java编程语言中的 `java.sql.Timestamp`对象写入此 `SQLOutputImpl`对象。
`void`	`writeURL(URL url)` 将Java编程语言中的 `java.sql.Type.DATALINK`对象写入此 `SQLOutputImpl`对象。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.sql.SQLOutput
writeObject

- 构造方法详细信息
  - SQLOutputImpl
```
public SQLOutputImpl(Vector<?> attributes,
                     Map<String,?> map)
              throws SQLException
```
    创建一个新的SQLOutputImpl对象，用给定的属性向量初始化并输入map。驱动程序将使用类型映射来确定要调用哪个SQLData.writeSQL方法。然后，该方法将按顺序调用相应的SQLOutputImpl写入器方法，从而将属性写入新的输出流。
    
    参数
    
    attributes -一个 Vector包含UDT的属性对象被映射到一个或多个对象中的Java编程语言
    
    map - 一个 java.util.Map零个或多个条目的 java.util.Map对象，每个条目包括1） String给出UDT的完全限定名称，以及2） 类实现的 SQLData对象，定义如何映射UDT
    
    异常
    
    SQLException - 如果 attributes或 map是 null价值
- 方法详细信息
  - writeString
```
public void writeString(String x)
                 throws SQLException
```
    写一个String在Java编程语言中此SQLOutputImpl对象。驱动程序将它转换为SQL CHAR ， VARCHAR ，或LONGVARCHAR将其返回到数据库之前。
    
    Specified by:
    
    writeString在界面 SQLOutput
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在由 SQLData将UDT的属性值写入数据库的 SQLData对象使用。
  - writeBoolean
```
public void writeBoolean(boolean x)
                  throws SQLException
```
    写一个boolean在Java编程语言中此SQLOutputImpl对象。驱动程序将其转换为SQL BIT然后将其返回到数据库。
    
    Specified by:
    
    writeBoolean在界面 SQLOutput
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在尝试将UDT的属性值写入数据库的 SQLData对象使用。
  - writeByte
```
public void writeByte(byte x)
               throws SQLException
```
    写一个byte在Java编程语言中此SQLOutputImpl对象。驱动程序将其转换为SQL BIT然后将其返回到数据库。
    
    Specified by:
    
    writeByte在界面 SQLOutput
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在尝试将UDT的属性值写入数据库的 SQLData对象使用。
  - writeShort
```
public void writeShort(short x)
                throws SQLException
```
    写一个short在Java编程语言中此SQLOutputImpl对象。驱动程序将其转换为SQL SMALLINT然后将其返回到数据库。
    
    Specified by:
    
    writeShort在界面 SQLOutput
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在由 SQLData将UDT的属性值写入数据库的 SQLData对象使用。
  - writeInt
```
public void writeInt(int x)
              throws SQLException
```
    写入一个int在Java编程语言中此SQLOutputImpl对象。驱动程序将其转换为SQL INTEGER然后将其返回到数据库。
    
    Specified by:
    
    writeInt在界面 SQLOutput
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在由 SQLData将UDT的属性值写入数据库的 SQLData对象使用。
  - writeLong
```
public void writeLong(long x)
               throws SQLException
```
    写一个long在Java编程语言中此SQLOutputImpl对象。驱动程序将其转换为SQL BIGINT然后将其返回到数据库。
    
    Specified by:
    
    writeLong在界面 SQLOutput
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在由 SQLData将UDT的属性值写入数据库的 SQLData对象使用。
  - writeFloat
```
public void writeFloat(float x)
                throws SQLException
```
    写一个float在Java编程语言中此SQLOutputImpl对象。驱动程序将其转换为SQL REAL然后将其返回到数据库。
    
    Specified by:
    
    writeFloat在界面 SQLOutput
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在由 SQLData将UDT的属性值写入数据库的 SQLData对象使用。
  - writeDouble
```
public void writeDouble(double x)
                 throws SQLException
```
    写一个double在Java编程语言中此SQLOutputImpl对象。驱动程序将其转换为SQL DOUBLE然后将其返回到数据库。
    
    Specified by:
    
    writeDouble在界面 SQLOutput
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在尝试将UDT的属性值写入数据库的 SQLData对象使用。
  - writeBigDecimal
```
public void writeBigDecimal(BigDecimal x)
                     throws SQLException
```
    将Java编程语言中的java.math.BigDecimal对象写入此SQLOutputImpl对象。驱动程序将其转换为SQL NUMERIC然后将其返回到数据库。
    
    Specified by:
    
    writeBigDecimal在界面 SQLOutput
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在由 SQLData将UDT的属性值写入数据库的 SQLData对象使用。
  - writeBytes
```
public void writeBytes(byte[] x)
                throws SQLException
```
    写入数组bytes在Java编程语言中此SQLOutputImpl对象。驱动程序将其转换为SQL VARBINARY或LONGVARBINARY然后将其返回到数据库。
    
    Specified by:
    
    writeBytes在界面 SQLOutput
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在尝试将UDT的属性值写入数据库的 SQLData对象使用。
  - writeDate
```
public void writeDate(Date x)
               throws SQLException
```
    将Java编程语言中的java.sql.Date对象写入此SQLOutputImpl对象。驱动程序将其转换为SQL DATE然后将其返回到数据库。
    
    Specified by:
    
    writeDate在界面 SQLOutput
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在尝试将UDT的属性值写入数据库的 SQLData对象使用。
  - writeTime
```
public void writeTime(Time x)
               throws SQLException
```
    将Java编程语言中的java.sql.Time对象写入此SQLOutputImpl对象。驱动程序将其转换为SQL TIME然后将其返回到数据库。
    
    Specified by:
    
    writeTime在界面 SQLOutput
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在由 SQLData将UDT的属性值写入数据库的 SQLData对象使用。
  - writeTimestamp
```
public void writeTimestamp(Timestamp x)
                    throws SQLException
```
    将Java编程语言中的java.sql.Timestamp对象写入此SQLOutputImpl对象。驱动程序将其转换为SQL TIMESTAMP然后将其返回到数据库。
    
    Specified by:
    
    writeTimestamp在界面 SQLOutput
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在尝试将UDT的属性值写入数据库的 SQLData对象使用。
  - writeCharacterStream
```
public void writeCharacterStream(Reader x)
                          throws SQLException
```
    将Unicode字符串写入此SQLOutputImpl对象。驱动程序将从Unicode到数据库CHAR格式进行任何CHAR转换。
    
    Specified by:
    
    writeCharacterStream在界面 SQLOutput
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在由 SQLData将UDT的属性值写入数据库的 SQLData对象使用。
  - writeAsciiStream
```
public void writeAsciiStream(InputStream x)
                      throws SQLException
```
    将ASCII字符串写入此SQLOutputImpl对象。驱动程序将从ASCII到数据库CHAR格式进行任何CHAR转换。
    
    Specified by:
    
    writeAsciiStream在界面 SQLOutput
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在尝试将UDT的属性值写入数据库的 SQLData对象使用。
  - writeBinaryStream
```
public void writeBinaryStream(InputStream x)
                       throws SQLException
```
    将一串未解释的字节写入此 SQLOutputImpl对象。
    
    Specified by:
    
    writeBinaryStream在界面 SQLOutput
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在由 SQLData将UDT的属性值写入数据库的 SQLData对象使用。
  - writeObject
```
public void writeObject(SQLData x)
                 throws SQLException
```
    向流中写入包含在给定的SQLData对象中的数据。当SQLData对象为null时，此方法将SQL NULL写入流。否则，它调用给定对象的SQLData.writeSQL方法，该方法将对象的属性写入流。
    方法SQLData.writeSQ调用适当的SQLOutputImpl.writeXXX方法来按顺序写入每个对象的属性。属性必须从SQLInput输入流中读取，并以与用户定义类型的SQL定义相同的顺序写入SQLOutputImpl输出流。
    
    Specified by:
    
    writeObject在界面 SQLOutput
    
    参数
    
    x - 表示SQL结构化或不同类型数据的对象
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在尝试将UDT的属性值写入数据库的 SQLData对象使用。
  - writeRef
```
public void writeRef(Ref x)
              throws SQLException
```
    将Java编程语言中的Ref对象写入此SQLOutputImpl对象。驱动程序将其转换为可序列化的SerialRef SQL REF值，然后将其返回到数据库。
    
    Specified by:
    
    writeRef在界面 SQLOutput
    
    参数
    
    x - 表示SQL REF值的对象
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在尝试将UDT的属性值写入数据库的 SQLData对象使用。
  - writeBlob
```
public void writeBlob(Blob x)
               throws SQLException
```
    将Java编程语言中的Blob对象写入此SQLOutputImpl对象。驱动程序将其转换为可序列化的SerialBlob SQL BLOB值，然后将其返回到数据库。
    
    Specified by:
    
    writeBlob在界面 SQLOutput
    
    参数
    
    x - 表示SQL BLOB值的对象
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在由 SQLData将UDT的属性值写入数据库的 SQLData对象使用。
  - writeClob
```
public void writeClob(Clob x)
               throws SQLException
```
    将Java编程语言中的Clob对象写入此SQLOutputImpl对象。驱动程序将其转换为可序列化的SerialClob SQL CLOB值，然后将其返回到数据库。
    
    Specified by:
    
    writeClob在界面 SQLOutput
    
    参数
    
    x - 表示SQL CLOB值的对象
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在由 SQLData将UDT的属性值写入数据库的 SQLData对象使用。
  - writeStruct
```
public void writeStruct(Struct x)
                 throws SQLException
```
    将Java编程语言中的Struct对象写入此SQLOutputImpl对象。驱动程序将此值转换为SQL结构类型，然后将其返回到数据库。
    当SQL结构类型已被映射到Java编程语言（标准映射）中的Struct对象时，应使用此方法。如果SQL结构化类型已经被自定义映射到Java编程语言中的类，则应使用方法writeObject 。
    
    Specified by:
    
    writeStruct在界面 SQLOutput
    
    参数
    
    x - 表示SQL结构化类型属性的对象
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在由 SQLData将UDT的属性值写入数据库的 SQLData对象使用。
  - writeArray
```
public void writeArray(Array x)
                throws SQLException
```
    将Java编程语言中的Array对象写入此SQLOutputImpl对象。驱动程序将此值转换为可序列化的SerialArray SQL ARRAY值，然后将其返回到数据库。
    
    Specified by:
    
    writeArray在界面 SQLOutput
    
    参数
    
    x - 表示SQL ARRAY值的对象
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在尝试将UDT的属性值写入数据库的 SQLData对象使用。
  - writeURL
```
public void writeURL(URL url)
              throws SQLException
```
    将Java编程语言中的java.sql.Type.DATALINK对象写入此SQLOutputImpl对象。驱动程序将此值转换为可序列化的SerialDatalink SQL DATALINK值，然后将其返回到数据库。
    
    Specified by:
    
    writeURL在界面 SQLOutput
    
    参数
    
    url - 表示SQL DATALINK值的对象
    
    异常
    
    SQLException - 如果 SQLOutputImpl对象正在尝试将UDT的属性值写入数据库的 SQLData对象使用。
  - writeNString
```
public void writeNString(String x)
                  throws SQLException
```
    接下来的属性写入流为String的Java编程语言。驱动程序将其转换为SQL NCHAR或NVARCHAR或LONGNVARCHAR值（取决于相对于NVARCHAR值的驱动程序限制的参数大小）将其发送到流时。
    
    Specified by:
    
    writeNString在界面 SQLOutput
    
    参数
    
    x - 传递给数据库的值
    
    异常
    
    SQLException - 如果发生数据库访问错误
    
    从以下版本开始：
    
    1.6
  - writeNClob
```
public void writeNClob(NClob x)
                throws SQLException
```
    将SQL NCLOB值写入流。
    
    Specified by:
    
    writeNClob在界面 SQLOutput
    
    参数
    
    x - 表示SQL NCLOB值的数据的 NClob对象
    
    异常
    
    SQLException - 如果发生数据库访问错误
    
    从以下版本开始：
    
    1.6
  - writeRowId
```
public void writeRowId(RowId x)
                throws SQLException
```
    将SQL ROWID值写入流。
    
    Specified by:
    
    writeRowId在界面 SQLOutput
    
    参数
    
    x - 表示SQL ROWID值的数据的 RowId对象
    
    异常
    
    SQLException - 如果发生数据库访问错误
    
    从以下版本开始：
    
    1.6
  - writeSQLXML
```
public void writeSQLXML(SQLXML x)
                 throws SQLException
```
    将SQL XML值写入流。
    
    Specified by:
    
    writeSQLXML在界面 SQLOutput
    
    参数
    
    x - 表示SQL XML值的数据的 SQLXML对象
    
    异常
    
    SQLException - 如果发生数据库访问错误
    
    从以下版本开始：
    
    1.6

Class SQLOutputImpl

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Methods inherited from interface java.sql.SQLOutput

构造方法详细信息

SQLOutputImpl

方法详细信息

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