SQLInput (Java Platform SE 8 )

所有已知实现类：

SQLInputImpl
```
public interface SQLInput
```
包含表示SQL结构化类型或SQL不同类型实例的值的流的输入流。该界面仅用于自定义映射，由驱动程序在幕后使用，程序员从不直接调用SQLInput方法。 读取器的方法（ readLong ， readBytes ，等等）为的实现提供了一种方法SQLData接口以读取值SQLInput对象。并且如SQLData中SQLData ，必须按照它们对应的属性出现在类型的SQL定义中的顺序进行读取方法的调用。方法wasNull用于确定最后读取的值是否为SQL NULL 。
当该方法getObject被调用实现该接口的类的对象SQLData ，JDBC驱动程序调用该方法SQLData.getSQLType ，以确定用户定义的类型（UDT）的SQL类型而定制映射。驱动程序创建一个SQLInput的实例，用UDT的属性填充它。然后，驱动程序将输入流传SQLData.readSQL方法SQLData.readSQL ，该方法又在其实现中调用SQLInput读取器方法来从输入流读取属性。

从以下版本开始：

1.2

方法摘要

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

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