Java java.sql 接口 SQLInput（JDK5）

所有类

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

---

java.sql
接口 SQLInput

所有已知实现类：

SQLInputImpl

---

public interface SQLInput

一个输入流，它包含表示 SQL 结构化类型或 SQL 不同类型的实例的值组成的流。此接口（仅用于自定义映射关系）供应用程序在后台使用，程序员永远不能直接调用 SQLInput 方法。reader 方法（readLong、readBytes 等）提供了读取 SQLInput 对象中的值的一种方式。方法 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 返回。
Object	readObject()           读取流头中的下一个属性并将其作为 Java 编程语言中的 Object 返回。
Ref	readRef()           从流读取 SQL REF 值并将其作为 Java 编程语言中的 Ref 对象返回。
short	readShort()           读取流中的下一个属性并将其作为 Java 编程语言中的 short 返回。
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 - 如果发生数据库访问错误

---

readBoolean

boolean readBoolean()
                    throws SQLException

读取流中的下一个属性并将其作为 Java 编程语言中的 boolean 返回。

返回：

属性；如果值为 SQL NULL，则返回 false

抛出：

SQLException - 如果发生数据库访问错误

---

readByte

byte readByte()
              throws SQLException

读取流中的下一个属性并将其作为 Java 编程语言中的 byte 返回。

返回：

属性；如果值为 SQL NULL，则返回 0

抛出：

SQLException - 如果发生数据库访问错误

---

readShort

short readShort()
                throws SQLException

读取流中的下一个属性并将其作为 Java 编程语言中的 short 返回。

返回：

属性；如果值为 SQL NULL，则返回 0

抛出：

SQLException - 如果发生数据库访问错误

---

readInt

int readInt()
            throws SQLException

读取流中的下一个属性并将其作为 Java 编程语言中的 int 返回。

返回：

属性；如果值为 SQL NULL，则返回 0

抛出：

SQLException - 如果发生数据库访问错误

---

readLong

long readLong()
              throws SQLException

读取流中的下一个属性并将其作为 Java 编程语言中的 long 返回。

返回：

属性；如果值为 SQL NULL，则返回 0

抛出：

SQLException - 如果发生数据库访问错误

---

readFloat

float readFloat()
                throws SQLException

读取流中的下一个属性并将其作为 Java 编程语言中的 float 返回。

返回：

属性；如果值为 SQL NULL，则返回 0

抛出：

SQLException - 如果发生数据库访问错误