-
- 所有已知实现类:
-
SQLInputImpl
public interface SQLInput
一个输入流,包含表示SQL结构类型或SQL不同类型实例的值流。 此接口仅用于自定义映射,由驱动程序在后台使用,程序员永远不会直接调用SQLInput
方法。 读取器的方法(readLong
,readBytes
,等等)为的实现提供了一种方法SQLData
接口以读取值SQLInput
对象。 并且如SQLData
,对读取器方法的调用必须按其相应属性出现在类型的SQL定义中的顺序进行。 方法wasNull
用于确定读取的最后一个值是否是SQLNULL
。当该方法
getObject
被调用实现该接口的类的对象SQLData
,JDBC驱动程序调用该方法SQLData.getSQLType
,以确定用户定义的类型(UDT)的SQL类型而定制映射。 驱动程序创建一个SQLInput
的实例,并使用UDT的属性填充它。 然后,驱动程序将输入流传SQLData.readSQL
方法SQLData.readSQL
,方法SQLData.readSQL
在其实现中调用SQLInput
读取器方法,以从输入流中读取属性。- 从以下版本开始:
- 1.2
-
-
方法摘要
所有方法 实例方法 抽象方法 Default Methods 变量和类型 方法 描述 Array
readArray()
从流中读取SQLARRAY
值并将其作为Java编程语言中的Array
对象返回。InputStream
readAsciiStream()
读取流中的下一个属性并将其作为ASCII字符流返回。BigDecimal
readBigDecimal()
读取流中的下一个属性,并将其作为Java编程语言中的java.math.BigDecimal
对象返回。InputStream
readBinaryStream()
读取流中的下一个属性并将其作为未解释的字节流返回。Blob
readBlob()
从流中读取SQLBLOB
值并将其作为Java编程语言中的Blob
对象返回。boolean
readBoolean()
读取流中的下一个属性并将其作为boolean
以Java编程语言返回。byte
readByte()
读取流中的下一个属性并将其作为byte
以Java编程语言返回。byte[]
readBytes()
读取流中的下一个属性,并将其作为Java编程语言中的字节数组返回。Reader
readCharacterStream()
读取流中的下一个属性并将其作为Unicode字符流返回。Clob
readClob()
从流中读取SQLCLOB
值,并将其作为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()
从流中读取SQLNCLOB
值并将其作为Java编程语言中的NClob
对象返回。String
readNString()
读取流中的下一个属性并将其作为Java编程语言中的String
返回。Object
readObject()
读取流头部的数据并将其作为Java编程语言中的Object
返回。default <T> T
readObject(类<T> type)
读取流中的下一个属性并将其作为Object
以Java编程语言返回。Ref
readRef()
从流中读取SQLREF
值并将其作为Java编程语言中的Ref
对象返回。RowId
readRowId()
从流中读取SQLROWID
值并将其作为Java编程语言中的RowId
对象返回。short
readShort()
读取流中的下一个属性,并以Java编程语言将其作为short
返回。SQLXML
readSQLXML()
从流中读取SQLXML
值并将其作为Java编程语言中的SQLXML
对象返回。String
readString()
读取流中的下一个属性并将其作为String
以Java编程语言返回。Time
readTime()
读取流中的下一个属性并将其作为java.sql.Time
对象返回。Timestamp
readTimestamp()
读取流中的下一个属性并将其作为java.sql.Timestamp
对象返回。URL
readURL()
从流中读取SQLDATALINK
值并将其作为Java编程语言中的java.net.URL
对象返回。boolean
wasNull()
检索读取的最后一个值是否为SQLNULL
。
-
-
-
方法详细信息
-
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
如果数据是SQLNULL
- 异常
-
SQLException
- 如果发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
readRef
Ref readRef() throws SQLException
从流中读取SQLREF
值并将其作为Java编程语言中的Ref
对象返回。- 结果
-
一个
Ref
对象,表示流头部的SQLREF
值;null
如果读取的值是SQLNULL
- 异常
-
SQLException
- 如果发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
readBlob
Blob readBlob() throws SQLException
从流中读取SQLBLOB
值并将其作为Java编程语言中的Blob
对象返回。- 结果
-
Blob
对象,表示流头部的SQLBLOB
值的数据;null
如果读取的值是SQLNULL
- 异常
-
SQLException
- 如果发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
readClob
Clob readClob() throws SQLException
从流中读取SQLCLOB
值并将其作为Java编程语言中的Clob
对象返回。- 结果
-
Clob
对象,表示流头部的SQLCLOB
值的数据;null
如果读取的值是SQLNULL
- 异常
-
SQLException
- 如果发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
readArray
Array readArray() throws SQLException
从流中读取SQLARRAY
值并将其作为Java编程语言中的Array
对象返回。- 结果
-
一个
Array
对象,表示流头部的SQLARRAY
值的数据;null
如果读取的值是SQLNULL
- 异常
-
SQLException
- 如果发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
wasNull
boolean wasNull() throws SQLException
检索读取的最后一个值是否为SQLNULL
。- 结果
-
true
如果最近读取的SQL值是SQLNULL
; 否则为false
- 异常
-
SQLException
- 如果发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
readURL
URL readURL() throws SQLException
从流中读取SQLDATALINK
值并将其作为Java编程语言中的java.net.URL
对象返回。- 结果
-
一个
java.net.URL
对象。 - 异常
-
SQLException
- 如果发生数据库访问错误,或者URL格式错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.4
-
readNClob
NClob readNClob() throws SQLException
从流中读取SQLNCLOB
值并将其作为Java编程语言中的NClob
对象返回。- 结果
-
一个
NClob
对象,表示流头部的SQLNCLOB
值的数据;null
如果读取的值是SQLNULL
- 异常
-
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
从流中读取SQLXML
值并将其作为Java编程语言中的SQLXML
对象返回。- 结果
-
SQLXML
对象,表示流头部的SQLXML
值的数据;null
如果读取的值是SQLNULL
- 异常
-
SQLException
- 如果发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
readRowId
RowId readRowId() throws SQLException
从流中读取SQLROWID
值并将其作为Java编程语言中的RowId
对象返回。- 结果
-
RowId
对象,表示流头部的SQLROWID
值的数据;null
如果读取的值是SQLNULL
- 异常
-
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
如果属性是SQLNULL
- 异常
-
SQLException
- 如果发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.8
-
-