Java java.sql 接口 SQLInput（JDK5）

138 阅读 0 评论 0 点赞

所有类

概述

软件包

类

使用

树

已过时

索引

帮助

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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 - 如果发生数据库访问错误