-
- 所有已知实现类:
-
SQLInputImpl
public interface SQLInput
包含表示SQL结构化类型或SQL不同类型实例的值的流的输入流。 该界面仅用于自定义映射,由驱动程序在幕后使用,程序员从不直接调用SQLInput
方法。 读取器的方法(readLong
,readBytes
,等等)为的实现提供了一种方法SQLData
接口以读取值SQLInput
对象。 并且如SQLData
,必须按照它们对应的属性出现在类型的SQL定义中的顺序进行对reader方法的调用。 方法wasNull
用于确定最后读取的值是否为SQLNULL
。当方法
getObject
与实现接口SQLData
的类的对象SQLData
调用时,JDBC驱动程序调用方法SQLData.getSQLType
来确定自定义映射的用户定义类型(UDT)的SQL类型。 驱动程序创建一个SQLInput
的实例,并使用UDT的属性进行填充。 然后,驱动程序将输入流传SQLData.readSQL
方法SQLData.readSQL
,方法SQLData.readSQL
又在其实现中调用SQLInput
读取器方法来从输入流读取属性。- 从以下版本开始:
- 1.2
-
-
方法摘要
所有方法 接口方法 抽象方法 Default Methods Modifier and Type 方法 描述 Array
readArray()
从流中读取SQLARRAY
值,并将其作为Java编程语言中的Array
对象返回。InputStream
readAsciiStream()
读取流中的下一个属性并将其作为ASCII字符流返回。BigDecimal
readBigDecimal()
读取流中的下一个属性,并将其作为Java编程语言中的一个java.math.BigDecimal
对象返回。InputStream
readBinaryStream()
读取流中的下一个属性并将其作为未解释的字节流返回。Blob
readBlob()
从流中读取SQLBLOB
值,并将其作为Java编程语言中的Blob
对象返回。boolean
readBoolean()
读取流中的下一个属性,并将其作为Java编程语言中的boolean
返回。byte
readByte()
读取流中的下一个属性,并将其作为Java编程语言中的一个byte
返回。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()
读取流中的下一个属性,并将其作为Java编程语言中的一个int
返回。long
readLong()
读取流中的下一个属性,并将其作为Java编程语言中的long
返回。NClob
readNClob()
从流中读取SQLNCLOB
值,并将其作为Java编程语言中的NClob
对象返回。String
readNString()
读取流中的下一个属性,并将其作为Java编程语言中的一个String
返回。Object
readObject()
读取流的头部的数据,并将其作为Java编程语言中的一个Object
返回。default <T> T
readObject(Class<T> type)
读取流中的下一个属性,并将其作为Java编程语言中的一个Object
返回。Ref
readRef()
从流中读取SQLREF
值,并将其作为Java编程语言中的Ref
对象返回。RowId
readRowId()
从流中读取SQLROWID
值,并将其作为Java编程语言中的RowId
对象返回。short
readShort()
读取流中的下一个属性,并将其作为Java编程语言中的一个short
返回。SQLXML
readSQLXML()
从流中读取SQLXML
值,并将其作为Java编程语言中的SQLXML
对象返回。String
readString()
读取流中的下一个属性,并将其作为Java编程语言中的String
返回。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
String
- 结果
-
属性;
NULL
null
- 异常
-
SQLException
- 如果发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.2
-
readBoolean
boolean readBoolean() throws SQLException
读取流中的下一个属性,并将其作为Java编程语言中的一个boolean
返回。- 结果
-
属性;
如果值为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
读取流中的下一个属性,并将其作为Java编程语言中的一个int
返回。- 结果
-
属性;
如果值为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
读取流中的下一个属性,并将其作为Java编程语言中的一个float
返回。- 结果
-
属性;
如果值为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
- 如果发生数据库访问错误,或者网址格式错误 -
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
对象返回。- 结果
-
一个表示数据头的SQL
XML
值的数据的SQLXML
对象;null
如果读取的值是SQLNULL
- 异常
-
SQLException
- 如果发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
readRowId
RowId readRowId() throws SQLException
从流中读取SQLROWID
值,并将其作为Java编程语言中的RowId
对象返回。- 结果
-
一个表示数据头的SQL
ROWID
值的数据的RowId
对象;null
如果读取的值是SQLNULL
- 异常
-
SQLException
- 如果发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 从以下版本开始:
- 1.6
-
readObject
default <T> T readObject(Class<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
-
-