SQLInputImpl (Java Platform SE 8 )

java.lang.Object
- javax.sql.rowset.serial.SQLInputImpl

All Implemented Interfaces:

SQLInput
```
public class SQLInputImpl
extends Object
implements SQLInput
```
用于自定义映射用户定义类型（UDT）的输入流。 SQLInputImpl对象是包含作为UDT的属性的值的流的输入流。
当在具有自定义映射的SQL结构化或不同类型上调用方法getObject时，此类由驱动程序使用; 程序员从不直接调用SQLInputImpl方法。他们在这里提供给那些写RowSet实现的人的方便。

SQLInputImpl类提供了一组ResultSet吸气剂方法的读取器方法。这些方法可以读取SQLInputImpl对象中的值。

方法wasNull用于确定最后读取的值是否为SQL NULL 。

当该方法getObject被调用实现该接口的类的对象SQLData ，JDBC驱动程序调用该方法SQLData.getSQLType确定UDT的SQL类型而定制映射。驱动程序创建一个SQLInputImpl的实例，并使用UDT的属性进行填充。然后，驱动程序将输入流传SQLData.readSQL方法SQLData.readSQL ，该方法又调用SQLInputImpl读取器方法从输入流读取属性。

从以下版本开始：

1.5

另请参见：

SQLData

构造方法摘要

构造方法
Constructor and Description
`SQLInputImpl(Object[] attributes, Map<String,类<?>> map)` 创建一个 `SQLInputImpl`对象，该对象使用给定的属性数组和给定的类型映射进行初始化。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`Array`	`readArray()` 从流中读取SQL `ARRAY`值，并将其作为Java编程语言中的 `Array`对象返回。
`InputStream`	`readAsciiStream()` 将此 `SQLInputImpl`对象中的下一个属性作为ASCII字符流返回。
`BigDecimal`	`readBigDecimal()` 将此 `SQLInputImpl`对象中的下一个属性 `SQLInputImpl`为 `java.math.BigDecimal` 。
`InputStream`	`readBinaryStream()` 将此 `SQLInputImpl`对象中的下一个属性作为未解释的字节流返回。
`Blob`	`readBlob()` 在 `SQLInputImpl`对象的头部 `BLOB`值，作为Java编程语言中的 `Blob`对象。
`boolean`	`readBoolean()` 获取此的下一个属性 `SQLInputImpl`对象为 `boolean`的Java编程语言。
`byte`	`readByte()` 获取此的下一个属性 `SQLInputImpl`对象为 `byte`的Java编程语言。
`byte[]`	`readBytes()` 将此 `SQLInputImpl`对象中的下一个属性作为字节数组 `SQLInputImpl` 。
`Reader`	`readCharacterStream()` 将此 `SQLInputImpl`对象中的下一个属性作为Unicode字符流检索。
`Clob`	`readClob()` 在 `SQLInputImpl`对象的头部 `CLOB`值作为Java编程语言中的 `Clob`对象。
`Date`	`readDate()` 获取此的下一个属性 `SQLInputImpl`为 `java.sql.Date`的对象。
`double`	`readDouble()` 获取此的下一个属性 `SQLInputImpl`对象为 `double`的Java编程语言。
`float`	`readFloat()` 获取此的下一个属性 `SQLInputImpl`对象为 `float`的Java编程语言。
`int`	`readInt()` 获取此的下一个属性 `SQLInputImpl`对象为 `int`的Java编程语言。
`long`	`readLong()` 获取此的下一个属性 `SQLInputImpl`对象为 `long`的Java编程语言。
`NClob`	`readNClob()` 从流中读取SQL `NCLOB`值，并将其作为Java编程语言中的 `Clob`对象返回。
`String`	`readNString()` 读取流中的下一个属性，并将其作为Java编程语言中的 `String`返回。
`Object`	`readObject()` 以 `SQLInputImpl`对象的头部的 `Object`获取Java编程语言中的Object的值。
`Ref`	`readRef()` 以该Java编程语言的 `SQLInputImpl`对象的形式 `Ref`此 `SQLInputImpl`对象的头部的值。
`RowId`	`readRowId()` 从流中读取SQL `ROWID`值，并将其作为Java编程语言中的 `RowId`对象返回。
`short`	`readShort()` 获取此的下一个属性 `SQLInputImpl`对象为 `short`的Java编程语言。
`SQLXML`	`readSQLXML()` 从流中读取SQL `XML`值，并将其作为Java编程语言中的 `SQLXML`对象返回。
`String`	`readString()` 获取此的下一个属性 `SQLInputImpl`对象为 `String`的Java编程语言。
`Time`	`readTime()` 将此 `SQLInputImpl`对象中的下一个属性 `SQLInputImpl`为 `java.sql.Time`对象。
`Timestamp`	`readTimestamp()` 将此 `SQLInputImpl`对象中的下一个属性 `SQLInputImpl`为 `java.sql.Timestamp`对象。
`URL`	`readURL()` 从流中读取SQL `DATALINK`值，并将其作为Java编程语言中的 `URL`对象返回。
`boolean`	`wasNull()` 确定从此 `SQLInputImpl`对象读取的最后一个值是否为 `null` 。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.sql.SQLInput
readObject

- 构造方法详细信息
  - SQLInputImpl
```
public SQLInputImpl(Object[] attributes,
                    Map<String,类<?>> map)
             throws SQLException
```
    创建一个SQLInputImpl对象，该对象使用给定的属性数组和给定的类型映射进行初始化。如果任何属性是一个UDT在类型映射中的条目，其名称是，则该属性将根据相应的映射SQLData实现。
    
    参数
    
    attributes - 一个Object实例的数组，其中每个元素都是UDT的属性。数组中属性的顺序与UDT定义中定义属性的顺序相同。
    
    map - 一个 java.util.Map零个或多个条目的 java.util.Map对象，其中每个条目包括1） String给出UDT的完全限定名称; 2） 类实现的 SQLData对象，定义如何映射UDT
    
    异常
    
    SQLException - 如果 attributes或 map是 null价值
- 方法详细信息
  - readString
```
public String readString()
                  throws SQLException
```
    获取此的下一个属性SQLInputImpl对象为String的Java编程语言。
    此方法不执行类型安全检查以确定返回的类型是否为预期类型; 这个责任被委托给由SQLData实现定义的UDT映射。
    
    Specified by:
    
    readString在界面 SQLInput
    
    结果
    
    这个SQLInputImpl对象的下一个属性; 如果值为SQL NULL ，返回null
    
    异常
    
    SQLException - 如果读取位置位于无效位置，或者流中没有其他值。
  - readBoolean
```
public boolean readBoolean()
                    throws SQLException
```
    获取此的下一个属性SQLInputImpl对象为boolean的Java编程语言。
    此方法不执行类型安全检查以确定返回的类型是否为预期类型; 这个责任被委托给由SQLData实现定义的UDT映射。
    
    Specified by:
    
    readBoolean在界面 SQLInput
    
    结果
    
    这个SQLInputImpl对象的下一个属性; 如果是SQL NULL ，返回null
    
    异常
    
    SQLException - 如果读取位置位于无效位置，或者流中没有更多值。
  - readByte
```
public byte readByte()
              throws SQLException
```
    获取此的下一个属性SQLInputImpl对象为byte的Java编程语言。
    此方法不执行类型安全检查以确定返回的类型是否为预期类型; 这个责任被委托给由SQLData实现定义的UDT映射。
    
    Specified by:
    
    readByte在界面 SQLInput
    
    结果
    
    这个SQLInputImpl对象的下一个属性; 如果是SQL NULL ，返回null
    
    异常
    
    SQLException - 如果读取位置位于无效位置，或者流中没有其他值
  - readShort
```
public short readShort()
                throws SQLException
```
    获取此的下一个属性SQLInputImpl对象为short的Java编程语言。
    此方法不执行类型安全检查以确定返回的类型是否为预期类型; 这个责任被委托给由SQLData实现定义的UDT映射。
    
    Specified by:
    
    readShort在界面 SQLInput
    
    结果
    
    这个SQLInputImpl对象的下一个属性; 如果是SQL NULL ，返回null
    
    异常
    
    SQLException - 如果读取位置位于无效位置，或者流中没有更多值
  - readInt
```
public int readInt()
            throws SQLException
```
    检索此SQLInputImpl对象中的下一个int为Java编程语言中的int。
    此方法不执行类型安全检查以确定返回的类型是否为预期类型; 这个责任被委托给由SQLData实现定义的UDT映射。
    
    Specified by:
    
    readInt在界面 SQLInput
    
    结果
    
    这个SQLInputImpl对象的下一个属性; 如果是SQL NULL ，返回null
    
    异常
    
    SQLException - 如果读取位置位于无效位置，或者流中没有更多值
  - readLong
```
public long readLong()
              throws SQLException
```
    获取此的下一个属性SQLInputImpl对象为long的Java编程语言。
    此方法不执行类型安全检查以确定返回的类型是否为预期类型; 这个责任被委托给由SQLData实现定义的UDT映射。
    
    Specified by:
    
    readLong在界面 SQLInput
    
    结果
    
    这个SQLInputImpl对象的下一个属性; 如果是SQL NULL ，返回null
    
    异常
    
    SQLException - 如果读取位置位于无效位置，或者流中没有更多值
  - readFloat
```
public float readFloat()
                throws SQLException
```
    获取此的下一个属性SQLInputImpl对象为float的Java编程语言。
    此方法不执行类型安全检查以确定返回的类型是否为预期类型; 这个责任被委托给由SQLData实现定义的UDT映射。
    
    Specified by:
    
    readFloat在界面 SQLInput
    
    结果
    
    这个SQLInputImpl对象的下一个属性; 如果值为SQL NULL ，则返回null
    
    异常
    
    SQLException - 如果读取位置位于无效位置，或者流中没有更多值
  - readDouble
```
public double readDouble()
                  throws SQLException
```
    获取此的下一个属性SQLInputImpl对象为double的Java编程语言。
    此方法不执行类型安全检查以确定返回的类型是否为预期类型; 这个责任被委托给由SQLData实现定义的UDT映射。
    
    Specified by:
    
    readDouble在界面 SQLInput
    
    结果
    
    这个SQLInputImpl对象的下一个属性; 如果值为SQL NULL ，则返回null
    
    异常
    
    SQLException - 如果读取位置位于无效位置，或者流中没有更多值
  - readBigDecimal
```
public BigDecimal readBigDecimal()
                          throws SQLException
```
    检索此SQLInputImpl对象中的下一个属性为java.math.BigDecimal 。
    此方法不执行类型安全检查以确定返回的类型是否为预期类型; 这个责任被委托给由SQLData实现定义的UDT映射。
    
    Specified by:
    
    readBigDecimal在界面 SQLInput
    
    结果
    
    这个SQLInputImpl对象的下一个属性; 如果值为SQL NULL ，返回null
    
    异常
    
    SQLException - 如果读取位置位于无效位置，或者流中没有更多值
  - readBytes
```
public byte[] readBytes()
                 throws SQLException
```
    将此SQLInputImpl对象中的下一个属性作为字节数组SQLInputImpl 。
    此方法不执行类型安全检查以确定返回的类型是否为预期类型; 这个责任被委托给由SQLData实现定义的UDT映射。
    
    Specified by:
    
    readBytes在界面 SQLInput
    
    结果
    
    这个SQLInputImpl对象的下一个属性; 如果值为SQL NULL ，返回null
    
    异常
    
    SQLException - 如果读取位置位于无效位置，或者流中没有更多值
  - readDate
```
public Date readDate()
              throws SQLException
```
    将此SQLInputImpl中的下一个属性SQLInputImpl为java.sql.Date对象。
    此方法不执行类型安全检查以确定返回的类型是否为预期类型; 这个责任被委托给由SQLData实现定义的UDT映射。
    
    Specified by:
    
    readDate在界面 SQLInput
    
    结果
    
    这个SQLInputImpl对象的下一个属性; 如果值为SQL NULL ，返回null
    
    异常
    
    SQLException - 如果读取位置位于无效位置，或者流中没有更多值
  - readTime
```
public Time readTime()
              throws SQLException
```
    将此SQLInputImpl对象中的下一个属性SQLInputImpl为java.sql.Time对象。
    此方法不执行类型安全检查，以确定是否返回的类型有这个责任交给了UDT映射为由实现所期望的类型SQLData实施。
    
    Specified by:
    
    readTime在界面 SQLInput
    
    结果
    
    属性; 如果是SQL NULL ，返回null
    
    异常
    
    SQLException - 如果读取位置位于无效位置; 或者如果流中没有其他值。
  - readTimestamp
```
public Timestamp readTimestamp()
                        throws SQLException
```
    将此 SQLInputImpl对象中的下一个属性 SQLInputImpl为 java.sql.Timestamp对象。
    
    Specified by:
    
    readTimestamp在界面 SQLInput
    
    结果
    
    属性; 如果值为SQL NULL ，返回null
    
    异常
    
    SQLException - 如果读取位置位于无效位置; 或者如果流中没有其他值。
  - readCharacterStream
```
public Reader readCharacterStream()
                           throws SQLException
```
    将此SQLInputImpl对象中的下一个属性作为Unicode字符流检索。
    此方法不执行类型安全检查，以确定是否返回的类型有这个责任交给了UDT映射为由实现所期望的类型SQLData实施。
    
    Specified by:
    
    readCharacterStream在界面 SQLInput
    
    结果
    
    属性; 如果是SQL NULL ，返回null
    
    异常
    
    SQLException - 如果读取位置位于无效位置; 或者如果流中没有其他值。
  - readAsciiStream
```
public InputStream readAsciiStream()
                            throws SQLException
```
    将此SQLInputImpl对象中的下一个属性作为ASCII字符流返回。
    此方法不执行类型安全检查，以确定是否返回的类型有这个责任交给了UDT映射为由实现所期望的类型SQLData实施。
    
    Specified by:
    
    readAsciiStream在界面 SQLInput
    
    结果
    
    属性; 如果是SQL NULL ，返回null
    
    异常
    
    SQLException - 如果读取位置位于无效位置; 或者如果流中没有其他值。
  - readBinaryStream
```
public InputStream readBinaryStream()
                             throws SQLException
```
    将此SQLInputImpl对象中的下一个属性返回为未解释的字节流。
    此方法不执行类型安全检查，以确定是否返回的类型有这个责任交给了UDT映射为由实现所期望的类型SQLData实施。
    
    Specified by:
    
    readBinaryStream在界面 SQLInput
    
    结果
    
    属性; 如果值为SQL NULL ，返回null
    
    异常
    
    SQLException - 如果读取位置位于无效位置; 或者如果流中没有其他值。
  - readObject
```
public Object readObject()
                  throws SQLException
```
    以SQLInputImpl对象的头部的Object获取Java编程语言中的Object的值。返回的对象的实际类型由SQL编程语言中的类型的默认映射确定，除非有自定义映射，在这种情况下，返回的对象的类型由此流的类型映射决定。
    启用JDBC技术的驱动程序在将流传送到应用程序之前，先注册一个类型映射。
    
    当流头的数据是SQL NULL时，此方法返回null 。如果基准是具有自定义映射的SQL结构或不同类型，则此方法确定流头上的基准的SQL类型，构造适当类的对象，并调用该对象上的方法SQLData.readSQL 。然后， readSQL方法调用相应的SQLInputImpl.readXXX方法从流中检索属性值。
    
    Specified by:
    
    readObject在界面 SQLInput
    
    结果
    
    在流作为头部的值Object在Java编程语言; null如果值为SQL NULL
    
    异常
    
    SQLException - 如果读取位置位于无效位置; 或者如果流中没有其他值。
  - readRef
```
public Ref readRef()
            throws SQLException
```
    以 SQLInputImpl对象作为 Ref对象在Java编程语言中检索该值。
    
    Specified by:
    
    readRef在界面 SQLInput
    
    结果
    
    一个Ref对象，表示流的头部的SQL REF值; 如果值为SQL NULL返回null
    
    异常
    
    SQLException - 如果读取位置位于无效位置; 或者如果流中没有其他值。
  - readBlob
```
public Blob readBlob()
              throws SQLException
```
    在SQLInputImpl对象的头部BLOB值，作为Java编程语言中的Blob对象。
    此方法不执行类型安全检查，以确定是否返回的类型有这个责任交给了UDT映射为由实现所期望的类型SQLData实施。
    
    Specified by:
    
    readBlob在界面 SQLInput
    
    结果
    
    一个Blob对象，表示此流的头部的SQL BLOB值; 如果是SQL NULL ，返回null
    
    异常
    
    SQLException - 如果读取位置位于无效位置; 或者如果流中没有其他值。
  - readClob
```
public Clob readClob()
              throws SQLException
```
    在SQLInputImpl对象的头部CLOB值作为Java编程语言中的Clob对象。
    此方法不执行类型安全检查，以确定是否返回的类型有这个责任交给了UDT映射为由实现所期望的类型SQLData实施。
    
    Specified by:
    
    readClob在界面 SQLInput
    
    结果
    
    一个Clob对象，表示流的头部的SQL CLOB值; 如果值为SQL NULL ，返回null
    
    异常
    
    SQLException - 如果读取位置位于无效位置; 或者如果流中没有其他值。
  - readArray
```
public Array readArray()
                throws SQLException
```
    从流中读取SQL ARRAY值，并将其作为Java编程语言中的Array对象返回。
    此方法不执行类型安全检查，以确定是否返回的类型有这个责任交给了UDT映射为由实现所期望的类型SQLData实施。
    
    Specified by:
    
    readArray在界面 SQLInput
    
    结果
    
    一个Array对象，表示流头部的SQL ARRAY值; *如果值为SQL NULL ，返回null
    
    异常
    
    SQLException - 如果读取位置位于无效位置; 或者如果流中没有其他值。
  - wasNull
```
public boolean wasNull()
                throws SQLException
```
    确定从此 SQLInputImpl对象读取的最后一个值是否为 null 。
    
    Specified by:
    
    wasNull在界面 SQLInput
    
    结果
    
    true如果最近读取的SQL值是null ; 否则， false ; 默认情况下将返回false
    
    异常
    
    SQLException - 如果发生错误，确定最后读取的 null值;
  - readURL
```
public URL readURL()
            throws SQLException
```
    从流中读取SQL DATALINK值，并将其作为Java编程语言中的URL对象返回。
    此方法不执行类型安全检查，以确定是否返回的类型有这个责任交给了UDT映射为由实现所期望的类型SQLData实施。
    
    Specified by:
    
    readURL在界面 SQLInput
    
    结果
    
    一个URL对象，表示流头部的SQL DATALINK值; *如果值为SQL NULL ，返回null
    
    异常
    
    SQLException - 如果读取位置位于无效位置; 或者如果流中没有其他值。
  - readNClob
```
public NClob readNClob()
                throws SQLException
```
    从流中读取SQL NCLOB值，并将其作为Java编程语言中的 Clob对象返回。
    
    Specified by:
    
    readNClob在界面 SQLInput
    
    结果
    
    表示数据头的SQL NCLOB值的NClob对象; null如果读取的值是SQL NULL
    
    异常
    
    SQLException - 如果发生数据库访问错误
    
    从以下版本开始：
    
    1.6
  - readNString
```
public String readNString()
                   throws SQLException
```
    读取流中的下一个属性，并将其作为Java编程语言中的String返回。访问时，它适用于使用NCHAR ， NVARCHAR和LONGNVARCHAR列。
    
    Specified by:
    
    readNString在界面 SQLInput
    
    结果
    
    属性; 如果值为SQL NULL ，则返回null
    
    异常
    
    SQLException - 如果发生数据库访问错误
    
    从以下版本开始：
    
    1.6
  - readSQLXML
```
public SQLXML readSQLXML()
                  throws SQLException
```
    从流中读取SQL XML值，并将其作为Java编程语言中的 SQLXML对象返回。
    
    Specified by:
    
    readSQLXML在界面 SQLInput
    
    结果
    
    一个SQLXML数据头的SQL XML值的SQLXML对象; null如果读取的值是SQL NULL
    
    异常
    
    SQLException - 如果发生数据库访问错误
    
    从以下版本开始：
    
    1.6
  - readRowId
```
public RowId readRowId()
                throws SQLException
```
    从流中读取SQL ROWID值，并将其作为Java编程语言中的 RowId对象返回。
    
    Specified by:
    
    readRowId在接口 SQLInput
    
    结果
    
    一个RowId对象，表示数据头的SQL ROWID值; null如果读取的值是SQL NULL
    
    异常
    
    SQLException - 如果发生数据库访问错误
    
    从以下版本开始：
    
    1.6

Class SQLInputImpl

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Methods inherited from interface java.sql.SQLInput

构造方法详细信息

SQLInputImpl

方法详细信息

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