所有已知实现类：

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

从以下版本开始：

1.2

方法摘要

所有方法实例方法抽象方法 Default Methods
变量和类型	方法	描述
`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()`	读取流中的下一个属性并将其作为 `boolean`以Java编程语言返回。
`byte`	`readByte()`	读取流中的下一个属性并将其作为 `byte`以Java编程语言返回。
`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()`	读取流中的下一个属性并将其作为 `int`以Java编程语言返回。
`long`	`readLong()`	读取流中的下一个属性，并以Java编程语言将其作为 `long`返回。
`NClob`	`readNClob()`	从流中读取SQL `NCLOB`值并将其作为Java编程语言中的 `NClob`对象返回。
`String`	`readNString()`	读取流中的下一个属性并将其作为Java编程语言中的 `String`返回。
`Object`	`readObject()`	读取流头部的数据并将其作为Java编程语言中的 `Object`返回。
`default <T> T`	`readObject(类<T> type)`	读取流中的下一个属性并将其作为 `Object`以Java编程语言返回。
`Ref`	`readRef()`	从流中读取SQL `REF`值并将其作为Java编程语言中的 `Ref`对象返回。
`RowId`	`readRowId()`	从流中读取SQL `ROWID`值并将其作为Java编程语言中的 `RowId`对象返回。
`short`	`readShort()`	读取流中的下一个属性，并以Java编程语言将其作为 `short`返回。
`SQLXML`	`readSQLXML()`	从流中读取SQL `XML`值并将其作为Java编程语言中的 `SQLXML`对象返回。
`String`	`readString()`	读取流中的下一个属性并将其作为 `String`以Java编程语言返回。
`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
```
    读取流中的下一个属性并将其作为 boolean以Java编程语言返回。
    
    结果
    
    属性; 如果值为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
```
    读取流中的下一个属性并将其作为 int以Java编程语言返回。
    
    结果
    
    属性; 如果值为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
```
    读取流中的下一个属性并将其作为 float以Java编程语言返回。
    
    结果
    
    属性; 如果值为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
```
    读取流头部的数据并将其作为Java编程语言中的Object返回。返回的对象的实际类型由默认类型映射以及此流的类型映射中存在的任何自定义项确定。
    在将流传递给应用程序之前，JDBC驱动程序会在流中注册类型映射。
    
    当流的头部的数据是SQL NULL ，该方法返回null 。如果数据是SQL结构或不同类型，则它确定流头部的数据的SQL类型。如果流的类型映射具有该SQL类型的条目，则驱动程序构造相应类的对象，并在该对象上调用方法SQLData.readSQL ，该方法使用为该方法描述的协议从流中读取其他数据。
    
    结果
    
    作为Java编程语言中的Object ，流头部的数据; 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对象返回。
    
    结果
    
    RowId对象，表示流头部的SQL ROWID值的数据; null如果读取的值是SQL NULL
    
    异常
    
    SQLException - 如果发生数据库访问错误
    
    SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
    
    从以下版本开始：
    
    1.6
  - readObject
```
default <T> T readObject(类<T> type)
                  throws SQLException
```
    读取流中的下一个属性并将其作为Java编程语言中的Object返回。返回的对象的实际类型由指定的Java数据类型以及此流的类型映射中存在的任何自定义项确定。
    在将流传递给应用程序之前，JDBC驱动程序会在流中注册类型映射。
    
    当流头部的属性是SQL NULL该方法返回null 。如果属性是SQL结构或不同类型，则它确定流头部的属性的SQL类型。如果流的类型映射具有该SQL类型的条目，则驱动程序构造相应类的对象，并在该对象上调用方法SQLData.readSQL ，该方法使用为该方法描述的协议从流中读取其他数据。
    
    默认实现将抛出SQLFeatureNotSupportedException
    
    参数类型
    
    T - 此Class对象建模的类的类型
    
    参数
    
    type - 表示要将属性转换为的Java数据类型的类。
    
    结果
    
    流的头部属性为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