Java javax.sql.rowset.serial 类 SQLOutputImpl（JDK5）

所有类

概述  软件包   类  使用  树  已过时  索引  帮助
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

javax.sql.rowset.serial
类 SQLOutputImpl

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

所有已实现的接口：

SQLOutput

---

public class SQLOutputImpl
   
   
   
   
   
extends Object
   
   
   
   
   
   
   
   
   
   
implements SQLOutput
   
   
   
   
   

用于将自定义映射的用户定义类型 (UDT) 的属性写回数据库的输出流。驱动程序在内部使用此接口，应用程序员决不能直接调用其方法。

当应用程序调用 PreparedStatement.setObject 方法时，驱动程序将检查要写入的值是否具有自定义映射关系的 UDT。如果是，则在类型映射表中将存在一个条目，该条目包含 Class 对象，用于为此 UDT 实现 SQLData 的类。如果要写入的值是 SQLData 的实例，则驱动程序将创建 SQLOutputImpl 的实例并将其传递给 SQLData.writeSQL 方法。writeSQL 方法依次调用适当的 SQLOutputImpl.writeXXX 方法，从 SQLData 对象以 SQL 用户定义类型的表示形式将数据写入 SQLOutputImpl 输出流。

---

构造方法摘要
SQLOutputImpl(Vector<?> attributes, Map<String,?> map)           创建一个新的 SQLOutputImpl 对象，并使用给定的属性向量和类型映射表进行初始化。

 

方法摘要
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)           将 Java 编程语言中的 boolean 写入此 SQLOutputImpl 对象。
void	writeByte(byte x)           将 Java 编程语言中的 byte 写入此 SQLOutputImpl 对象。
void	writeBytes(byte[] x)           将 Java 编程语言中的 byte 数组写入此 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)           将 Java 编程语言中的 double 写入此 SQLOutputImpl 对象。
void	writeFloat(float x)           将 Java 编程语言中的 float 写入此 SQLOutputImpl 对象。
void	writeInt(int x)           将 Java 编程语言中的 int 写入此 SQLOutputImpl 对象。
void	writeLong(long x)           将 Java 编程语言中的 long 写入此 SQLOutputImpl 对象。
void	writeObject(SQLData x)           将包含在给定 SQLData 对象中的数据写入流中。
void	writeRef(Ref x)           将 Java 编程语言中的 Ref 对象写入此 SQLOutputImpl 对象。
void	writeShort(short x)           将 Java 编程语言中的 short 写入此 SQLOutputImpl 对象。
void	writeString(String x)           将 Java 编程语言中的 String 写入此 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 对象。

 

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

构造方法详细信息

SQLOutputImpl

public SQLOutputImpl(Vector<?> attributes,
                     Map<String,?> map)
              throws SQLException

创建一个新的 SQLOutputImpl 对象，并使用给定的属性向量和类型映射表进行初始化。驱动程序将使用类型映射表来确定要调用的 SQLData.writeSQL 方法。然后，此方法将调用适当的 SQLOutputImpl 写入方法，以便能够将属性写入新输出流。

参数：

attributes - Vector 对象，该对象包含要映射为 Java 编程语言中一个或多个对象的 UDT 属性

map - 包含零个或多个条目的 java.util.Map 对象，其中每个条目包含：1) 给出 UDT 完全限定名的 String 2) 用于定义 UDT 映射方式的 SQLData 实现的 Class 对象

抛出：

SQLException - 如果 attributes 或 map 的值为 null

方法详细信息

writeString

public void writeString(String x)
                 throws SQLException

将 Java 编程语言中的 String 写入此 SQLOutputImpl 对象。在此值返回到数据库之前，驱动程序首先将它转换为 SQL CHAR、VARCHAR 或 LONGVARCHAR。

指定者：

接口 SQLOutput 中的 writeString

参数：

x - 要传递到数据库的值

抛出：

SQLException - 如果尝试将 UDT 的属性值写入数据库的 SQLData 对象正在使用 SQLOutputImpl 对象。

---

writeBoolean

public void writeBoolean(boolean x)
                  throws SQLException

将 Java 编程语言中的 boolean 写入此 SQLOutputImpl 对象。在此值返回到数据库之前，驱动程序首先将它转换为 SQL BIT。

指定者：

接口 SQLOutput 中的 writeBoolean

参数：

x - 要传递到数据库的值

抛出：

SQLException - 如果尝试将 UDT 的属性值写入数据库的 SQLData 对象正在使用 SQLOutputImpl 对象。

---

writeByte

public void writeByte(byte x)
               throws SQLException

将 Java 编程语言中的 byte 写入此 SQLOutputImpl 对象。在此值返回到数据库之前，驱动程序首先将它转换为 SQL BIT。

指定者：

接口 SQLOutput 中的 writeByte

参数：

x - 要传递到数据库的值

抛出：

SQLException - 如果尝试将 UDT 的属性值写入数据库的 SQLData 对象正在使用 SQLOutputImpl 对象。

---

writeShort

public void writeShort(short x)
                throws SQLException

将 Java 编程语言中的 short 写入此 SQLOutputImpl 对象。在此值返回到数据库之前，驱动程序首先将它转换为 SQL SMALLINT。

指定者：

接口 SQLOutput 中的 writeShort

参数：

x - 要传递到数据库的值

抛出：

SQLException - 如果尝试将 UDT 的属性值写入数据库的 SQLData 对象正在使用 SQLOutputImpl 对象。

---

writeInt

public void writeInt(int x)
              throws SQLException

将 Java 编程语言中的 int 写入此 SQLOutputImpl 对象。在此值返回到数据库之前，驱动程序首先将它转换为 SQL INTEGER。

指定者：

接口 SQLOutput 中的 writeInt

参数：

x - 要传递到数据库的值

抛出：

SQLException - 如果尝试将 UDT 的属性值写入数据库的 SQLData 对象正在使用 SQLOutputImpl 对象。

---

writeLong

public void writeLong(long x)
               throws SQLException

将 Java 编程语言中的 long 写入此 SQLOutputImpl 对象。在此值返回到数据库之前，驱动程序首先将它转换为 SQL BIGINT。

指定者：

接口 SQLOutput 中的 writeLong

参数：

x - 要传递到数据库的值

抛出：

SQLException - 如果尝试将 UDT 的属性值写入数据库的 SQLData 对象正在使用 SQLOutputImpl 对象。

---

writeFloat

public void writeFloat(float x)
                throws SQLException

将 Java 编程语言中的 float 写入此 SQLOutputImpl 对象。在此值返回到数据库之前，驱动程序首先将它转换为 SQL REAL。

指定者：

接口 SQLOutput 中的 writeFloat

参数：

x - 要传递到数据库的值

抛出：

SQLException - 如果尝试将 UDT 的属性值写入数据库的 SQLData 对象正在使用 SQLOutputImpl 对象。