- java.lang.Object
-
- javax.sql.rowset.serial.SQLInputImpl
-
- 实现的所有接口
-
SQLInput
public class SQLInputImpl extends Object implements SQLInput
用于自定义映射用户定义类型(UDT)的输入流。SQLInputImpl
对象是包含作为UDT属性的值流的输入流。当在具有自定义映射的SQL结构化或不同类型上调用方法
getObject
时,getObject
由驱动程序在幕后使用; 程序员永远不会直接调用SQLInputImpl
方法。 这里提供它们是为了方便那些编写RowSet
实现的人。SQLInputImpl
类提供了一组类似于ResultSet
getter方法的ResultSet
方法。 这些方法可以读取SQLInputImpl
对象中的值。方法
wasNull
用于确定读取的最后一个值是否是SQLNULL
。当该方法
getObject
被调用实现该接口的类的对象SQLData
,JDBC驱动程序调用该方法SQLData.getSQLType
确定UDT的SQL类型而定制映射。 驱动程序创建一个SQLInputImpl
的实例,使用UDT的属性填充它。 然后,驱动程序将输入流传SQLData.readSQL
方法SQLData.readSQL
,方法SQLData.readSQL
又调用SQLInputImpl
读取器方法从输入流中读取属性。- 从以下版本开始:
- 1.5
- 另请参见:
-
SQLData
-
-
构造方法摘要
构造方法 构造器 描述 SQLInputImpl(Object[] attributes, Map<String,类<?>> map)
创建使用给定的属性数组和给定的类型映射初始化的SQLInputImpl
对象。
-
方法摘要
所有方法 实例方法 具体的方法 变量和类型 方法 描述 Array
readArray()
从流中读取SQLARRAY
值并将其作为Java编程语言中的Array
对象返回。InputStream
readAsciiStream()
以ASCII字符流的形式返回此SQLInputImpl
对象中的下一个属性。BigDecimal
readBigDecimal()
获取此的下一个属性SQLInputImpl
对象为java.math.BigDecimal
。InputStream
readBinaryStream()
返回此SQLInputImpl
对象中的下一个属性,作为未解释的字节流。Blob
readBlob()
检索BLOB
这头价值SQLInputImpl
对象为Blob
的Java编程语言对象。boolean
readBoolean()
获取此的下一个属性SQLInputImpl
对象为boolean
的Java编程语言。byte
readByte()
获取此的下一个属性SQLInputImpl
对象为byte
的Java编程语言。byte[]
readBytes()
以字节数组的形式检索此SQLInputImpl
对象中的下一个属性。Reader
readCharacterStream()
以Unicode字符流的形式检索此SQLInputImpl
对象中的下一个属性。Clob
readClob()
检索CLOB
这头价值SQLInputImpl
对象为Clob
的Java编程语言对象。Date
readDate()
以java.sql.Date
对象的形式检索此SQLInputImpl
的下一个属性。double
readDouble()
获取此的下一个属性SQLInputImpl
对象为double
的Java编程语言。float
readFloat()
获取此的下一个属性SQLInputImpl
对象为float
的Java编程语言。int
readInt()
以Java编程语言中的int
检索此SQLInputImpl
对象中的下一个属性。long
readLong()
获取此的下一个属性SQLInputImpl
对象为long
的Java编程语言。NClob
readNClob()
从流中读取SQLNCLOB
值并将其作为Java编程语言中的Clob
对象返回。String
readNString()
读取流中的下一个属性并将其作为Java编程语言中的String
返回。Object
readObject()
以Java编程语言中的Object
检索此SQLInputImpl
对象头部的值。Ref
readRef()
在检索该头价值SQLInputImpl
对象为Ref
的Java编程语言对象。RowId
readRowId()
从流中读取SQLROWID
值并将其作为Java编程语言中的RowId
对象返回。short
readShort()
获取此的下一个属性SQLInputImpl
对象为short
的Java编程语言。SQLXML
readSQLXML()
从流中读取SQLXML
值并将其作为Java编程语言中的SQLXML
对象返回。String
readString()
获取此的下一个属性SQLInputImpl
对象为String
的Java编程语言。Time
readTime()
获取此的下一个属性SQLInputImpl
对象为java.sql.Time
的对象。Timestamp
readTimestamp()
获取此的下一个属性SQLInputImpl
对象为java.sql.Timestamp
的对象。URL
readURL()
从流中读取SQLDATALINK
值并将其作为Java编程语言中的URL
对象返回。boolean
wasNull()
确定从此SQLInputImpl
对象读取的最后一个值是否为null
。-
声明方法的类 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
声明方法的接口 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
对象,每个条目由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
使用Java编程语言中的int
检索此SQLInputImpl
对象中的下一个属性。此方法不执行类型安全检查以确定返回的类型是否为预期类型; 此职责委托给
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
对象中的下一个属性。此方法不执行类型安全检查以确定返回的类型是否为预期类型; 此职责委托给由
SQLData
实现定义的UDT映射。- Specified by:
-
readBytes
在界面SQLInput
- 结果
-
此
SQLInputImpl
对象中的下一个属性; 如果该值为SQL NULL
,请返回null
- 异常
-
SQLException
- 如果读取位置位于无效位置或流中没有更多值
-
readDate
public Date readDate() throws SQLException
以java.sql.Date
对象的形式检索此SQLInputImpl
的下一个属性。此方法不执行类型安全检查以确定返回的类型是否为预期类型; 此职责委托给
SQLData
实现定义的UDT映射。- Specified by:
-
readDate
在界面SQLInput
- 结果
-
此
SQLInputImpl
对象中的下一个属性; 如果该值为SQL NULL
,则返回null
- 异常
-
SQLException
- 如果读取位置位于无效位置或流中没有更多值
-
readTime
public Time readTime() throws SQLException
获取此的下一个属性SQLInputImpl
对象为java.sql.Time
的对象。此方法不执行类型安全检查以确定返回的类型是否为预期类型,因为此职责委托给由
SQLData
实现实现的UDT映射。- 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
以Unicode字符流的形式检索此SQLInputImpl
对象中的下一个属性。此方法不执行类型安全检查以确定返回的类型是否为预期类型,因为此职责委托给由
SQLData
实现实现的UDT映射。- Specified by:
-
readCharacterStream
在界面SQLInput
- 结果
-
属性;
如果值为
SQL NULL
,请返回null
- 异常
-
SQLException
- 如果读取位置位于无效位置; 或者如果流中没有其他值。
-
readAsciiStream
public InputStream readAsciiStream() throws SQLException
以ASCII字符流的形式返回此SQLInputImpl
对象中的下一个属性。此方法不执行类型安全检查以确定返回的类型是否为预期类型,因为此职责委托给由
SQLData
实现实现的UDT映射。- Specified by:
-
readAsciiStream
在界面SQLInput
- 结果
-
属性;
如果该值为
SQL NULL
,则返回null
- 异常
-
SQLException
- 如果读取位置位于无效位置; 或者如果流中没有其他值。
-
readBinaryStream
public InputStream readBinaryStream() throws SQLException
以未解释的字节流的形式返回此SQLInputImpl
对象中的下一个属性。此方法不执行类型安全检查以确定返回的类型是否为预期类型,因为此职责委托给由
SQLData
实现实现的UDT映射。- Specified by:
-
readBinaryStream
在界面SQLInput
- 结果
-
属性;
如果该值为
SQL NULL
,则返回null
- 异常
-
SQLException
- 如果读取位置位于无效位置; 或者如果流中没有其他值。
-
readObject
public Object readObject() throws SQLException
以Java编程语言中的Object
检索此SQLInputImpl
对象头部的值。 返回的对象的实际类型由SQL类型到Java编程语言中的类型的默认映射确定,除非存在自定义映射,在这种情况下,返回的对象的类型由此流的类型映射确定。启用JDBC技术的驱动程序在将流传递给应用程序之前向流注册类型映射。
当流的头部的数据是SQL
NULL
,此方法返回null
。 如果数据是具有自定义映射的SQL结构或不同类型,则此方法确定流头部的数据的SQL类型,构造相应类的对象,并在该对象上调用方法SQLData.readSQL
。 然后,readSQL
方法调用适当的SQLInputImpl.readXXX
方法从流中检索属性值。- Specified by:
-
readObject
在界面SQLInput
- 结果
-
流
Object
的头部的值为Java编程语言中的Object
;null
若值为SQLNULL
- 异常
-
SQLException
- 如果读取位置位于无效位置; 或者如果流中没有其他值。
-
readRef
public Ref readRef() throws SQLException
在检索该头价值SQLInputImpl
对象为Ref
的Java编程语言对象。- Specified by:
-
readRef
在界面SQLInput
- 结果
-
Ref
对象,表示流头部的SQLREF
值; 如果该值为SQL NULL
返回null
- 异常
-
SQLException
- 如果读取位置位于无效位置; 或者如果流中没有其他值。
-
readBlob
public Blob readBlob() throws SQLException
检索BLOB
这头价值SQLInputImpl
对象为Blob
的Java编程语言对象。此方法不执行类型安全检查以确定返回的类型是否为预期类型,因为此职责委托给由
SQLData
实现实现的UDT映射。- Specified by:
-
readBlob
在界面SQLInput
- 结果
-
Blob
对象,表示此流头部的SQLBLOB
值; 如果该值为SQL NULL
,则返回null
- 异常
-
SQLException
- 如果读取位置位于无效位置; 或者如果流中没有其他值。
-
readClob
public Clob readClob() throws SQLException
检索CLOB
这头价值SQLInputImpl
对象为Clob
的Java编程语言对象。此方法不执行类型安全检查以确定返回的类型是否为预期类型,因为此职责委托给由
SQLData
实现实现的UDT映射。- Specified by:
-
readClob
在界面SQLInput
- 结果
-
Clob
对象,表示流头部的SQLCLOB
值; 如果该值为SQL NULL
,则返回null
- 异常
-
SQLException
- 如果读取位置位于无效位置; 或者如果流中没有其他值。
-
readArray
public Array readArray() throws SQLException
从流中读取SQLARRAY
值并将其作为Java编程语言中的Array
对象返回。此方法不执行类型安全检查以确定返回的类型是否为预期类型,因为此职责委托给由
SQLData
实现实现的UDT映射。- Specified by:
-
readArray
在界面SQLInput
- 结果
-
一个
Array
对象,表示流头部的SQLARRAY
值; *如果该值为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
从流中读取SQLDATALINK
值并将其作为Java编程语言中的URL
对象返回。此方法不执行类型安全检查以确定返回的类型是否为预期类型,因为此职责委托给由
SQLData
实现实现的UDT映射。- Specified by:
-
readURL
在界面SQLInput
- 结果
-
一个
URL
对象,表示流头部的SQLDATALINK
值; *如果该值为SQL NULL
,则返回null
- 异常
-
SQLException
- 如果读取位置位于无效位置; 或者如果流中没有其他值。
-
readNClob
public NClob readNClob() throws SQLException
从流中读取SQLNCLOB
值并将其作为Java编程语言中的Clob
对象返回。- Specified by:
-
readNClob
在界面SQLInput
- 结果
-
NClob
对象,表示流头部的SQLNCLOB
值的数据;null
如果读取的值是SQLNULL
- 异常
-
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
从流中读取SQLXML
值并将其作为Java编程语言中的SQLXML
对象返回。- Specified by:
-
readSQLXML
在界面SQLInput
- 结果
-
SQLXML
对象,表示流头部的SQLXML
值的数据;null
如果读取的值是SQLNULL
- 异常
-
SQLException
- 如果发生数据库访问错误 - 从以下版本开始:
- 1.6
-
readRowId
public RowId readRowId() throws SQLException
从流中读取SQLROWID
值并将其作为Java编程语言中的RowId
对象返回。- Specified by:
-
readRowId
在界面SQLInput
- 结果
-
RowId
对象,表示流头部的SQLROWID
值的数据;null
如果读取的值是SQLNULL
- 异常
-
SQLException
- 如果发生数据库访问错误 - 从以下版本开始:
- 1.6
-
-