SQLInput (Java Platform SE 8 )

所有已知实现类：

SQLInputImpl
```
public interface SQLInput
```
一个输入流包含一个价值流代表一个SQL结构化类型或一个SQL的不同类型的一个实例。该接口仅用于自定义映射，是由幕后的司机，和一个程序员不能直接调用 SQLInput方法。的读者方法（ readLong， readBytes，等等）提供的 SQLData接口来读取一 SQLInput对象的价值实现方式。和描述 SQLData调用方法，读者必须按其对应的属性出现在该类型的SQL定义。方法 wasNull用来确定是否读到的最后一个值为SQL NULL。
当方法getObject是所谓的实现接口的SQLData类的一个对象，JDBC驱动程序的调用方法SQLData.getSQLType确定用户定义类型的SQL类型（UDT）被自定义映射。司机SQLInput创建实例，填充它的UDT的属性。司机随后通过输入流的方法SQLData.readSQL，反过来要求实施SQLInput读者的方法从输入流中读取属性。

从以下版本开始：

一点二

方法摘要

所有方法接口方法抽象方法 Default Methods
Modifier and Type	Method and Description
`Array`	`readArray()` 从流中读取SQL `ARRAY`值并返回它在java编程语言的一个 `Array`对象。
`InputStream`	`readAsciiStream()` 读取流中的下一个属性并将其作为一个ASCII字符流。
`BigDecimal`	`readBigDecimal()` 读取流中的下一个属性并将其作为一个 `java.math.BigDecimal` java编程语言中的对象。
`InputStream`	`readBinaryStream()` 读取流中的下一个属性并将其作为未解释的字节流。
`Blob`	`readBlob()` 读取SQL `BLOB`价值流并将其作为一个 `Blob` java编程语言中的对象。
`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`。
`NClob`	`readNClob()` 从流中读取SQL `NCLOB`值并返回它在java编程语言 `NClob`对象。
`String`	`readNString()` 读取流中的下一个属性并将其作为java编程语言中的一个 `String`。
`Object`	`readObject()` 读在流头的数据并返回它在java编程语言的一个 `Object`。
`default <T> T`	`readObject(类<T> type)` 读取流中的下一个属性并返回它在java编程语言的一个 `Object`。
`Ref`	`readRef()` 从流中读取SQL `REF`值并返回它在java编程语言 `Ref`对象。
`RowId`	`readRowId()` 从流中读取SQL `ROWID`值并返回它在java编程语言 `RowId`对象。
`short`	`readShort()` 读取流中的下一个属性并将其作为java编程语言中的一个 `short`。
`SQLXML`	`readSQLXML()` 从流中读取SQL `XML`值并返回它在java编程语言 `SQLXML`对象。
`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 -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点二
  - readBoolean
```
boolean readBoolean()
             throws SQLException
```
    读取流中的下一个属性并将其作为java编程语言中的一个 boolean。
    
    结果
    
    属性；如果值为SQL NULL，返回 false
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点二
  - readByte
```
byte readByte()
       throws SQLException
```
    读取流中的下一个属性并将其作为java编程语言中的一个 byte。
    
    结果
    
    属性；如果值为SQL NULL，返回 0
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点二
  - readShort
```
short readShort()
         throws SQLException
```
    读取流中的下一个属性并将其作为java编程语言中的一个 short。
    
    结果
    
    属性；如果值为SQL NULL，返回 0
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点二
  - readInt
```
int readInt()
     throws SQLException
```
    读取流中的下一个属性并返回它在java编程语言的一个 int。
    
    结果
    
    属性；如果值为SQL NULL，返回 0
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点二
  - readLong
```
long readLong()
       throws SQLException
```
    读取流中的下一个属性并将其作为java编程语言中的一个 long。
    
    结果
    
    属性；如果值为SQL NULL，返回 0
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点二
  - readFloat
```
float readFloat()
         throws SQLException
```
    读取流中的下一个属性并将其作为java编程语言中的一个 float。
    
    结果
    
    属性；如果值为SQL NULL，返回 0
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点二
  - readDouble
```
double readDouble()
           throws SQLException
```
    读取流中的下一个属性并将其作为java编程语言中的一个 double。
    
    结果
    
    属性；如果值为SQL NULL，返回 0
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点二
  - readBigDecimal
```
BigDecimal readBigDecimal()
                   throws SQLException
```
    读取流中的下一个属性并将其作为一个 java.math.BigDecimal java编程语言中的对象。
    
    结果
    
    属性；如果值为SQL NULL，返回 null
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点二
  - readBytes
```
byte[] readBytes()
          throws SQLException
```
    读取流中的下一个属性并将其作为一个数组java编程语言中的字节。
    
    结果
    
    属性；如果值为SQL NULL，返回 null
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点二
  - readDate
```
Date readDate()
       throws SQLException
```
    读取流中的下一个属性并将其作为 java.sql.Date对象。
    
    结果
    
    属性；如果值为SQL NULL，返回 null
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点二
  - readTime
```
Time readTime()
       throws SQLException
```
    读取流中的下一个属性并将其作为 java.sql.Time对象。
    
    结果
    
    属性；如果值为SQL NULL，返回 null
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点二
  - readTimestamp
```
Timestamp readTimestamp()
                 throws SQLException
```
    读取流中的下一个属性并将其作为 java.sql.Timestamp对象。
    
    结果
    
    属性；如果值为SQL NULL，返回 null
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点二
  - readCharacterStream
```
Reader readCharacterStream()
                    throws SQLException
```
    读取流中的下一个属性并将其作为一个Unicode字符流。
    
    结果
    
    属性；如果值为SQL NULL，返回 null
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点二
  - readAsciiStream
```
InputStream readAsciiStream()
                     throws SQLException
```
    读取流中的下一个属性并将其作为一个ASCII字符流。
    
    结果
    
    属性；如果值为SQL NULL，返回 null
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点二
  - readBinaryStream
```
InputStream readBinaryStream()
                      throws SQLException
```
    读取流中的下一个属性并将其作为未解释的字节流。
    
    结果
    
    属性；如果值为SQL NULL，返回 null
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点二
  - readObject
```
Object readObject()
           throws SQLException
```
    读在流头的数据并返回它在java编程语言的一个 Object。对象的实际类型返回的默认类型映射确定，和任何自定义该流的类型映射。
    一种Map注册通过JDBC驱动程序的流在流传递到应用程序。
    
    当在流头的基准是一个SQL NULL，方法返回null。如果数据是一个结构化的或不同的类型，它决定了数据的SQL类型的流头。如果流的类型图为SQL类型的一个入口，司机构建一个适当的类的对象，调用对象的方法，SQLData.readSQL，从流读取额外数据，使用该协议的描述方法。
    
    结果
    
    数据在流的头在java编程语言的一个 Object； null如果数据是SQL NULL
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点二
  - readRef
```
Ref readRef()
     throws SQLException
```
    从流中读取SQL REF值并返回它在java编程语言 Ref对象。
    
    结果
    
    一个代表SQL REF价值在流的头 Ref对象； null如果值读取SQL NULL
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点二
  - readBlob
```
Blob readBlob()
       throws SQLException
```
    从流中读取SQL BLOB值并返回它在java编程语言 Blob对象。
    
    结果
    
    一个表示SQL BLOB值数据在流的头 Blob对象； null如果值读取SQL NULL
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点二
  - readClob
```
Clob readClob()
       throws SQLException
```
    从流中读取SQL CLOB值并返回它在java编程语言 Clob对象。
    
    结果
    
    一个表示SQL CLOB值数据在流的头 Clob对象； null如果值读取SQL NULL
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点二
  - readArray
```
Array readArray()
         throws SQLException
```
    从流中读取SQL ARRAY值并返回它在java编程语言的一个 Array对象。
    
    结果
    
    一个 Array表示SQL ARRAY值数据的流头； null如果值读取SQL NULL
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点二
  - wasNull
```
boolean wasNull()
         throws SQLException
```
    检索是否读到的最后一个值为SQL NULL。
    
    结果
    
    true如果最近读取SQL值为SQL NULL； false否则
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点二
  - readURL
```
URL readURL()
     throws SQLException
```
    读取SQL DATALINK价值流并将其作为一个 java.net.URL java编程语言中的对象。
    
    结果
    
    一个 java.net.URL对象。
    
    异常
    
    SQLException -如果一个数据库访问错误发生，或者如果一个URL格式不正确
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点四
  - readNClob
```
NClob readNClob()
         throws SQLException
```
    从流中读取SQL NCLOB值并返回它在java编程语言 NClob对象。
    
    结果
    
    一个表示SQL NCLOB值数据在流的头 NClob对象； null如果值读取SQL NULL
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点六
  - readNString
```
String readNString()
            throws SQLException
```
    读取流中的下一个属性并将其作为java编程语言中的一个 String。它是专为使用时访问 NCHAR， NVARCHAR和 LONGNVARCHAR柱。
    
    结果
    
    属性；如果值为SQL NULL，返回 null
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点六
  - readSQLXML
```
SQLXML readSQLXML()
           throws SQLException
```
    从流中读取SQL XML值并返回它在java编程语言 SQLXML对象。
    
    结果
    
    一个表示SQL XML值数据在流的头 SQLXML对象； null如果值读取SQL NULL
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点六
  - readRowId
```
RowId readRowId()
         throws SQLException
```
    从流中读取SQL ROWID值并返回它在java编程语言 RowId对象。
    
    结果
    
    一个表示SQL ROWID值数据在流的头 RowId对象； null如果值读取SQL NULL
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点六
  - readObject
```
default <T> T readObject(类<T> type)
                  throws SQLException
```
    读取流中的下一个属性并返回它在java编程语言的一个 Object。对象的实际类型返回由指定的java数据类型的确定，和任何自定义该流的类型映射。
    一种Map注册通过JDBC驱动程序的流在流传递到应用程序。
    
    当在流头的属性是一个SQL NULL方法返回null。如果属性是一个结构化的或不同的类型，它决定了属性的SQL类型的流头。如果流的类型图为SQL类型的一个入口，司机构建一个适当的类的对象，调用对象的方法，SQLData.readSQL，从流读取额外数据，使用该协议的描述方法。
    
    默认实现将SQLFeatureNotSupportedException
    
    参数类型
    
    T -类仿照这个类对象的类型
    
    参数
    
    type级代表java数据类型转换的属性。
    
    结果
    
    属性在流的头在java编程语言的一个 Object； null如果属性是SQL NULL
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    一点八

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Interface SQLInput

方法摘要

方法详细信息

readString

readBoolean

readByte

readShort

readInt

readLong

readFloat

readDouble

readBigDecimal

readBytes

readDate

readTime

readTimestamp

readCharacterStream

readAsciiStream

readBinaryStream

readObject

readRef

readBlob

readClob

readArray

wasNull

readURL

readNClob

readNString

readSQLXML

readRowId

readObject