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的属性值。
这类由幕后的驱动程序时使用的方法getObject叫做一个结构化的或具有自定义映射不同的类型；一个程序员不会调用SQLInputImpl方法直接。他们都在这里为那些写RowSet实现便利。

的SQLInputImpl类提供了一套阅读方法类似于ResultSet getter方法。这些方法使人们有可能从一个SQLInputImpl对象的值。

方法wasNull用来判断是否读到的最后一个值为SQL NULL。

当方法getObject是所谓的实现接口的SQLData类的一个对象，JDBC驱动程序的调用方法SQLData.getSQLType确定UDT自定义SQL类型映射。司机SQLInputImpl创建实例，填充它的UDT的属性。司机随后通过输入流的方法SQLData.readSQL，进而调用SQLInputImpl读者的方法从输入流中读取属性。

从以下版本开始：

一点五

另请参见：

SQLData

构造方法摘要

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

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`Array`	`readArray()` 从流中读取SQL `ARRAY`值并返回它在java编程语言的一个 `Array`对象。
`InputStream`	`readAsciiStream()` 作为一个ASCII字符流的回报，这 `SQLInputImpl`对象的下一个属性。
`BigDecimal`	`readBigDecimal()` 检索下一个属性在这 `SQLInputImpl`对象作为一个 `java.math.BigDecimal`。
`InputStream`	`readBinaryStream()` 作为一个未解释字节流返回本 `SQLInputImpl`对象的下一个属性。
`Blob`	`readBlob()` 检索 `BLOB`值在这 `SQLInputImpl`对象的头一 `Blob` java编程语言中的对象。
`boolean`	`readBoolean()` 在这 `SQLInputImpl`检索对象的下一个属性作为java编程语言中的一个 `boolean`。
`byte`	`readByte()` 检索下一个属性在这 `SQLInputImpl`对象在java编程语言 `byte`。
`byte[]`	`readBytes()` 检索下一个属性在这 `SQLInputImpl`对象作为字节数组。
`Reader`	`readCharacterStream()` 检索下一个属性在这 `SQLInputImpl`对象作为一个Unicode字符流。
`Clob`	`readClob()` 检索 `CLOB`值在这 `SQLInputImpl`对象的头一 `Clob` java编程语言中的对象。
`Date`	`readDate()` 在这 `SQLInputImpl`检索下一个属性作为一个 `java.sql.Date`对象。
`double`	`readDouble()` 在这 `SQLInputImpl`检索对象的下一个属性作为java编程语言中的一个 `double`。
`float`	`readFloat()` 在这 `SQLInputImpl`检索对象的下一个属性作为java编程语言中的一个 `float`。
`int`	`readInt()` 在这 `SQLInputImpl`检索对象的下一个属性在java编程语言的一个 `int`。
`long`	`readLong()` 在这 `SQLInputImpl`检索对象的下一个属性作为java编程语言中的一个 `long`。
`NClob`	`readNClob()` 从流中读取SQL `NCLOB`值并返回它在java编程语言 `Clob`对象。
`String`	`readNString()` 读取流中的下一个属性并将其作为java编程语言中的一个 `String`。
`Object`	`readObject()` 检索值在这 `SQLInputImpl`对象的头在java编程语言的一个 `Object`。
`Ref`	`readRef()` 检索值在这 `SQLInputImpl`对象的头一 `Ref` java编程语言中的对象。
`RowId`	`readRowId()` 从流中读取SQL `ROWID`值并返回它在java编程语言 `RowId`对象。
`short`	`readShort()` 在这 `SQLInputImpl`检索对象的下一个属性作为java编程语言中的一个 `short`。
`SQLXML`	`readSQLXML()` 从流中读取SQL `XML`值并返回它在java编程语言 `SQLXML`对象。
`String`	`readString()` 在这 `SQLInputImpl`检索对象的下一个属性作为java编程语言中的一个 `String`。
`Time`	`readTime()` 在这 `SQLInputImpl`检索对象的下一个属性作为一个 `java.sql.Time`对象。
`Timestamp`	`readTimestamp()` 检索下一个属性在这 `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

- Constructor Detail
  - SQLInputImpl
```
public SQLInputImpl(Object[] attributes,
                    Map<String,类<?>> map)
             throws SQLException
```
    创建一个 SQLInputImpl对象与给定的属性与给定类型的Map数组初始化。如果属性是一个UDT的名字在Map入口，该属性将根据相应的 SQLData实施。
    
    参数
    
    attributes -一系列的 Object实例中，每个元素是一个UDT的属性。阵列中的属性的顺序是相同的顺序中的属性在UDT定义。
    
    map -包含零个或多个条目，每个条目 java.util.Map对象，由1个 String）给予的UDT和2的完全合格的名称）的 类对象实现的 SQLData如何定义UDT是映射
    
    异常
    
    SQLException -如果 attributes或 map是 null价值
- 方法详细信息
  - readString
```
public String readString()
                  throws SQLException
```
    在这 SQLInputImpl检索对象的下一个属性作为java编程语言中的一个 String。
    此方法不进行类型安全检查以确定是否返回类型是预期的类型；这种责任委托给UDT映射的SQLData实现定义。
    
    Specified by:
    
    readString 接口 SQLInput
    
    结果
    
    在这 SQLInputImpl对象的下一个属性；如果值为 SQL NULL，返回 null
    
    异常
    
    SQLException如果读的位置是位于一个无效的位置或者有没有进一步的价值流。
  - readBoolean
```
public boolean readBoolean()
                    throws SQLException
```
    在这 SQLInputImpl检索对象的下一个属性作为java编程语言中的一个 boolean。
    此方法不进行类型安全检查以确定是否返回类型是预期的类型；这种责任委托给UDT映射的SQLData实现定义。
    
    Specified by:
    
    readBoolean 接口 SQLInput
    
    结果
    
    在这 SQLInputImpl对象的下一个属性；如果值为 SQL NULL，返回 null
    
    异常
    
    SQLException如果读的位置是位于一个无效的位置或者有没有进一步的价值流。
  - readByte
```
public byte readByte()
              throws SQLException
```
    检索下一个属性在这 SQLInputImpl对象在java编程语言 byte。
    此方法不进行类型安全检查以确定是否返回类型是预期的类型；这种责任委托给UDT映射的SQLData实现定义。
    
    Specified by:
    
    readByte 接口 SQLInput
    
    结果
    
    在这 SQLInputImpl对象的下一个属性；如果值为 SQL NULL，返回 null
    
    异常
    
    SQLException如果读的位置是位于一个无效的位置或者有没有进一步的价值流
  - readShort
```
public short readShort()
                throws SQLException
```
    检索下一个属性在这 SQLInputImpl对象在java编程语言 short。
    此方法不进行类型安全检查以确定是否返回类型是预期的类型；这种责任委托给UDT映射的SQLData实现定义。
    
    Specified by:
    
    readShort 接口 SQLInput
    
    结果
    
    在这 SQLInputImpl对象的下一个属性；如果值为 SQL NULL，返回 null
    
    异常
    
    SQLException如果读的位置是位于一个无效的位置或者有没有更多的价值流
  - readInt
```
public int readInt()
            throws SQLException
```
    检索下一个属性在这 SQLInputImpl对象在java编程语言的一个 int。
    此方法不进行类型安全检查以确定是否返回类型是预期的类型；这种责任委托给UDT映射的SQLData实现定义。
    
    Specified by:
    
    readInt 接口 SQLInput
    
    结果
    
    在这 SQLInputImpl对象的下一个属性；如果值为 SQL NULL，返回 null
    
    异常
    
    SQLException如果读的位置是位于一个无效的位置或者有没有更多的价值流
  - readLong
```
public long readLong()
              throws SQLException
```
    检索下一个属性在这 SQLInputImpl对象在java编程语言 long。
    此方法不进行类型安全检查以确定是否返回类型是预期的类型；这种责任委托给UDT映射的SQLData实现定义。
    
    Specified by:
    
    readLong 接口 SQLInput
    
    结果
    
    在这 SQLInputImpl对象的下一个属性；如果值为 SQL NULL，返回 null
    
    异常
    
    SQLException如果读的位置是位于一个无效的位置或者有没有更多的价值流
  - readFloat
```
public float readFloat()
                throws SQLException
```
    在这 SQLInputImpl检索对象的下一个属性作为java编程语言中的一个 float。
    此方法不进行类型安全检查以确定是否返回类型是预期的类型；这种责任委托给UDT映射的SQLData实现定义。
    
    Specified by:
    
    readFloat 接口 SQLInput
    
    结果
    
    在这 SQLInputImpl对象的下一个属性；如果值为 SQL NULL，返回 null
    
    异常
    
    SQLException如果读的位置是位于一个无效的位置或者有没有更多的价值流
  - readDouble
```
public double readDouble()
                  throws SQLException
```
    在这 SQLInputImpl检索对象的下一个属性作为java编程语言中的一个 double。
    此方法不进行类型安全检查以确定是否返回类型是预期的类型；这种责任委托给UDT映射的SQLData实现定义。
    
    Specified by:
    
    readDouble 接口 SQLInput
    
    结果
    
    在这 SQLInputImpl对象的下一个属性；如果值为 SQL NULL，返回 null
    
    异常
    
    SQLException如果读的位置是位于一个无效的位置或者有没有更多的价值流
  - readBigDecimal
```
public BigDecimal readBigDecimal()
                          throws SQLException
```
    在这 SQLInputImpl检索对象的下一个属性作为一个 java.math.BigDecimal。
    此方法不进行类型安全检查以确定是否返回类型是预期的类型；这种责任委托给UDT映射的SQLData实现定义。
    
    Specified by:
    
    readBigDecimal 接口 SQLInput
    
    结果
    
    在这 SQLInputImpl对象的下一个属性；如果值为 SQL NULL，返回 null
    
    异常
    
    SQLException如果读的位置是位于一个无效的位置或者有没有更多的价值流
  - readBytes
```
public byte[] readBytes()
                 throws SQLException
```
    在这 SQLInputImpl检索对象的下一个属性以字节数组。
    此方法不进行类型安全检查以确定是否返回类型是预期的类型；这种责任委托给UDT映射的SQLData实现定义。
    
    Specified by:
    
    readBytes 接口 SQLInput
    
    结果
    
    在这 SQLInputImpl对象的下一个属性；如果值为 SQL NULL，返回 null
    
    异常
    
    SQLException如果读的位置是位于一个无效的位置或者有没有更多的价值流
  - readDate
```
public Date readDate()
              throws SQLException
```
    在这 SQLInputImpl检索下一个属性作为一个 java.sql.Date对象。
    此方法不进行类型安全检查以确定是否返回类型是预期的类型；这种责任委托给UDT映射的SQLData实现定义。
    
    Specified by:
    
    readDate 接口 SQLInput
    
    结果
    
    在这 SQLInputImpl对象的下一个属性；如果值为 SQL NULL，返回 null
    
    异常
    
    SQLException如果读的位置是位于一个无效的位置或者有没有更多的价值流
  - readTime
```
public Time readTime()
              throws SQLException
```
    在这 SQLInputImpl检索对象的下一个属性作为一个 java.sql.Time对象。
    此方法不进行类型安全检查以确定是否返回类型是预期的类型，这种责任委托给UDT映射的SQLData实施实施。
    
    Specified by:
    
    readTime 接口 SQLInput
    
    结果
    
    属性；如果值为 SQL NULL，返回 null
    
    异常
    
    SQLException如果读的位置位于一个无效的位置；如果有任何进一步的价值流。
  - readTimestamp
```
public Timestamp readTimestamp()
                        throws SQLException
```
    在这 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
```
    作为一个ASCII字符流的回报，这 SQLInputImpl对象的下一个属性。
    此方法不进行类型安全检查以确定是否返回类型是预期的类型，这种责任委托给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对象的头在java编程语言的一个 Object。返回的对象的实际类型是由SQL类型的默认映射类型的java编程语言，除非有一个自定义的映射，在这种情况下，返回的对象的类型是由流式图确定。
    JDBC技术使司机注册类型图与前溪流过的应用。
    
    当在流头的基准是一个SQL NULL，此方法返回null。如果数据是一个结构化的或自定义映射不同的类型，这种方法在流头决定数据的SQL类型，构建一个适当的类的对象，并调用方法：对象SQLData.readSQL。的readSQL方法然后调用相应的SQLInputImpl.readXXX方法从流中获取属性值。
    
    Specified by:
    
    readObject 接口 SQLInput
    
    结果
    
    在流的头在java编程语言的一个 Object价值； null如果值为SQL NULL
    
    异常
    
    SQLException如果读的位置位于一个无效的位置；如果有任何进一步的价值流。
  - readRef
```
public Ref readRef()
            throws SQLException
```
    检索值在这 SQLInputImpl对象的头一 Ref java编程语言中的对象。
    
    Specified by:
    
    readRef 接口 SQLInput
    
    结果
    
    一个代表SQL REF价值在流的头 Ref对象；如果值为 SQL NULL返回 null
    
    异常
    
    SQLException如果读的位置位于一个无效的位置；如果有任何进一步的价值流。
  - readBlob
```
public Blob readBlob()
              throws SQLException
```
    检索 BLOB值在这 SQLInputImpl对象的头一 Blob java编程语言中的对象。
    此方法不进行类型安全检查以确定是否返回类型是预期的类型，这种责任委托给UDT映射的SQLData实施实施。
    
    Specified by:
    
    readBlob 接口 SQLInput
    
    结果
    
    一个代表SQL BLOB值在本流的头 Blob对象；如果值为 SQL NULL，返回 null
    
    异常
    
    SQLException如果读的位置位于一个无效的位置；如果有任何进一步的价值流。
  - readClob
```
public Clob readClob()
              throws SQLException
```
    检索 CLOB值在这 SQLInputImpl对象的头一 Clob java编程语言中的对象。
    此方法不进行类型安全检查以确定是否返回类型是预期的类型，这种责任委托给UDT映射的SQLData实施实施。
    
    Specified by:
    
    readClob 接口 SQLInput
    
    结果
    
    一个代表SQL CLOB价值在流的头 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价值流并将其作为一个 URL java编程语言中的对象。
    此方法不进行类型安全检查以确定是否返回类型是预期的类型，这种责任委托给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 -如果一个数据库访问错误发生
    
    从以下版本开始：
    
    一点六
  - readNString
```
public String readNString()
                   throws SQLException
```
    读取流中的下一个属性并将其作为java编程语言中的一个 String。它是专为使用时访问 NCHAR， NVARCHAR和 LONGNVARCHAR柱。
    
    Specified by:
    
    readNString 接口 SQLInput
    
    结果
    
    属性；如果值为SQL NULL，返回 null
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    从以下版本开始：
    
    一点六
  - readSQLXML
```
public SQLXML readSQLXML()
                  throws SQLException
```
    从流中读取SQL XML值并返回它在java编程语言 SQLXML对象。
    
    Specified by:
    
    readSQLXML 接口 SQLInput
    
    结果
    
    一个表示SQL XML值数据在流的头 SQLXML对象； null如果值读取SQL NULL
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    从以下版本开始：
    
    一点六
  - readRowId
```
public RowId readRowId()
                throws SQLException
```
    从流中读取SQL ROWID值并返回它在java编程语言 RowId对象。
    
    Specified by:
    
    readRowId 接口 SQLInput
    
    结果
    
    一个表示SQL ROWID值数据在流的头 RowId对象； null如果值读取SQL NULL
    
    异常
    
    SQLException -如果一个数据库访问错误发生
    
    从以下版本开始：
    
    一点六

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.

Class SQLInputImpl

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Methods inherited from interface java.sql.SQLInput

Constructor Detail

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