|
Préférences
Moteurs de recherche
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
JavaTM 2 Platform Std. Ed. v1.6.0
javax.sql.rowset.serial
|
Constructor Summary | |
---|---|
SQLInputImpl(Object[] attributes,
Map<String,Class<?>> map)
Creates an SQLInputImpl object initialized with the
given array of attributes and the given type map. |
Method Summary | |
---|---|
Array |
readArray()
Reads an SQL ARRAY value from the stream and
returns it as an Array object in the Java programming
language. |
InputStream |
readAsciiStream()
Returns the next attribute in this SQLInputImpl object
as a stream of ASCII characters. |
BigDecimal |
readBigDecimal()
Retrieves the next attribute in this SQLInputImpl object
as a java.math.BigDecimal . |
InputStream |
readBinaryStream()
Returns the next attribute in this SQLInputImpl object
as a stream of uninterpreted bytes. |
Blob |
readBlob()
Retrieves the BLOB value at the head of this
SQLInputImpl object as a Blob object
in the Java programming language. |
boolean |
readBoolean()
Retrieves the next attribute in this SQLInputImpl object as
a boolean in the Java programming language. |
byte |
readByte()
Retrieves the next attribute in this SQLInputImpl object as
a byte in the Java programming language. |
byte[] |
readBytes()
Retrieves the next attribute in this SQLInputImpl object
as an array of bytes. |
Reader |
readCharacterStream()
Retrieves the next attribute in this SQLInputImpl object
as a stream of Unicode characters. |
Clob |
readClob()
Retrieves the CLOB value at the head of this
SQLInputImpl object as a Clob object
in the Java programming language. |
Date |
readDate()
Retrieves the next attribute in this SQLInputImpl as
a java.sql.Date object. |
double |
readDouble()
Retrieves the next attribute in this SQLInputImpl object
as a double in the Java programming language. |
float |
readFloat()
Retrieves the next attribute in this SQLInputImpl object
as a float in the Java programming language. |
int |
readInt()
Retrieves the next attribute in this SQLInputImpl object
as an int in the Java programming language. |
long |
readLong()
Retrieves the next attribute in this SQLInputImpl object
as a long in the Java programming language. |
NClob |
readNClob()
Reads an SQL NCLOB value from the stream and returns it as a
Clob object in the Java programming language. |
String |
readNString()
Reads the next attribute in the stream and returns it as a String
in the Java programming language. |
Object |
readObject()
Retrieves the value at the head of this SQLInputImpl
object as an Object in the Java programming language. |
Ref |
readRef()
Retrieves the value at the head of this SQLInputImpl object
as a Ref object in the Java programming language. |
RowId |
readRowId()
Reads an SQL ROWID value from the stream and returns it as a
RowId object in the Java programming language. |
short |
readShort()
Retrieves the next attribute in this SQLInputImpl object
as a short in the Java programming language. |
SQLXML |
readSQLXML()
Reads an SQL XML value from the stream and returns it as a
SQLXML object in the Java programming language. |
String |
readString()
Retrieves the next attribute in this SQLInputImpl object as
a String in the Java programming language. |
Time |
readTime()
Retrieves the next attribute in this SQLInputImpl object as
a java.sql.Time object. |
Timestamp |
readTimestamp()
Retrieves the next attribute in this SQLInputImpl object as
a java.sql.Timestamp object. |
URL |
readURL()
Reads an SQL DATALINK value from the stream and
returns it as an URL object in the Java programming
language. |
boolean |
wasNull()
Ascertains whether the last value read from this SQLInputImpl object was null . |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public SQLInputImpl(Object[] attributes, Map<String,Class<?>> map) throws SQLException
SQLInputImpl
object initialized with the
given array of attributes and the given type map. If any of the
attributes is a UDT whose name is in an entry in the type map,
the attribute will be mapped according to the corresponding
SQLData
implementation.
attributes
- an array of Object
instances in which
each element is an attribute of a UDT. The order of the
attributes in the array is the same order in which
the attributes were defined in the UDT definition.map
- a java.util.Map
object containing zero or more
entries, with each entry consisting of 1) a String
giving the fully
qualified name of the UDT and 2) the Class
object
for the SQLData
implementation that defines how
the UDT is to be mapped
SQLException
- if the attributes
or the map
is a null
valueMethod Detail |
---|
public String readString() throws SQLException
SQLInputImpl
object as
a String
in the Java programming language.
This method does not perform type-safe checking to determine if the
returned type is the expected type; this responsibility is delegated
to the UDT mapping as defined by a SQLData
implementation.
readString
in interface SQLInput
SQLInputImpl
object;
if the value is SQL NULL
, return null
SQLException
- if the read position is located at an invalid
position or if there are no further values in the stream.public boolean readBoolean() throws SQLException
SQLInputImpl
object as
a boolean
in the Java programming language.
This method does not perform type-safe checking to determine if the
returned type is the expected type; this responsibility is delegated
to the UDT mapping as defined by a SQLData
implementation.
readBoolean
in interface SQLInput
SQLInputImpl
object;
if the value is SQL NULL
, return null
SQLException
- if the read position is located at an invalid
position or if there are no further values in the stream.public byte readByte() throws SQLException
SQLInputImpl
object as
a byte
in the Java programming language.
This method does not perform type-safe checking to determine if the
returned type is the expected type; this responsibility is delegated
to the UDT mapping as defined by a SQLData
implementation.
SQLInputImpl
object;
if the value is SQL NULL
, return null
SQLException
- if the read position is located at an invalid
position or if there are no further values in the streampublic short readShort() throws SQLException
SQLInputImpl
object
as a short
in the Java programming language.
This method does not perform type-safe checking to determine if the
returned type is the expected type; this responsibility is delegated
to the UDT mapping as defined by a SQLData
implementation.
SQLInputImpl
object;
if the value is SQL NULL
, return null
SQLException
- if the read position is located at an invalid
position or if there are no more values in the streampublic int readInt() throws SQLException
SQLInputImpl
object
as an int
in the Java programming language.
This method does not perform type-safe checking to determine if the
returned type is the expected type; this responsibility is delegated
to the UDT mapping as defined by a SQLData
implementation.
SQLInputImpl
object;
if the value is SQL NULL
, return null
SQLException
- if the read position is located at an invalid
position or if there are no more values in the streampublic long readLong() throws SQLException
SQLInputImpl
object
as a long
in the Java programming language.
This method does not perform type-safe checking to determine if the
returned type is the expected type; this responsibility is delegated
to the UDT mapping as defined by a SQLData
implementation.
SQLInputImpl
object;
if the value is SQL NULL
, return null
SQLException
- if the read position is located at an invalid
position or if there are no more values in the streampublic float readFloat() throws SQLException
SQLInputImpl
object
as a float
in the Java programming language.
This method does not perform type-safe checking to determine if the
returned type is the expected type; this responsibility is delegated
to the UDT mapping as defined by a SQLData
implementation.
SQLInputImpl
object;
if the value is SQL NULL
, return null
SQLException
- if the read position is located at an invalid
position or if there are no more values in the streampublic double readDouble() throws SQLException
SQLInputImpl
object
as a double
in the Java programming language.
This method does not perform type-safe checking to determine if the
returned type is the expected type; this responsibility is delegated
to the UDT mapping as defined by a SQLData
implementation.
readDouble
in interface SQLInput
SQLInputImpl
object;
if the value is SQL NULL
, return null
SQLException
- if the read position is located at an invalid
position or if there are no more values in the streampublic BigDecimal readBigDecimal() throws SQLException
SQLInputImpl
object
as a java.math.BigDecimal
.
This method does not perform type-safe checking to determine if the
returned type is the expected type; this responsibility is delegated
to the UDT mapping as defined by a SQLData
implementation.
readBigDecimal
in interface SQLInput
SQLInputImpl
object;
if the value is SQL NULL
, return null
SQLException
- if the read position is located at an invalid
position or if there are no more values in the streampublic byte[] readBytes() throws SQLException
SQLInputImpl
object
as an array of bytes.
This method does not perform type-safe checking to determine if the
returned type is the expected type; this responsibility is delegated
to the UDT mapping as defined by a SQLData
implementation.
SQLInputImpl
object;
if the value is SQL NULL
, return null
SQLException
- if the read position is located at an invalid
position or if there are no more values in the streampublic Date readDate() throws SQLException
SQLInputImpl
as
a java.sql.Date
object.
This method does not perform type-safe checking to determine if the
returned type is the expected type; this responsibility is delegated
to the UDT mapping as defined by a SQLData
implementation.
SQLInputImpl
object;
if the value is SQL NULL
, return null
SQLException
- if the read position is located at an invalid
position or if there are no more values in the streampublic Time readTime() throws SQLException
SQLInputImpl
object as
a java.sql.Time
object.
This method does not perform type-safe checking to determine if the
returned type is the expected type as this responsibility is delegated
to the UDT mapping as implemented by a SQLData
implementation.
SQL NULL
, return
null
SQLException
- if the read position is located at an invalid
position; or if there are no further values in the stream.public Timestamp readTimestamp() throws SQLException
SQLInputImpl
object as
a java.sql.Timestamp
object.
readTimestamp
in interface SQLInput
SQL NULL
, return
null
SQLException
- if the read position is located at an invalid
position; or if there are no further values in the stream.public Reader readCharacterStream() throws SQLException
SQLInputImpl
object
as a stream of Unicode characters.
This method does not perform type-safe checking to determine if the
returned type is the expected type as this responsibility is delegated
to the UDT mapping as implemented by a SQLData
implementation.
readCharacterStream
in interface SQLInput
SQL NULL
, return null
SQLException
- if the read position is located at an invalid
position; or if there are no further values in the stream.public InputStream readAsciiStream() throws SQLException
SQLInputImpl
object
as a stream of ASCII characters.
This method does not perform type-safe checking to determine if the
returned type is the expected type as this responsibility is delegated
to the UDT mapping as implemented by a SQLData
implementation.
readAsciiStream
in interface SQLInput
SQL NULL
,
return null
SQLException
- if the read position is located at an invalid
position; or if there are no further values in the stream.public InputStream readBinaryStream() throws SQLException
SQLInputImpl
object
as a stream of uninterpreted bytes.
This method does not perform type-safe checking to determine if the
returned type is the expected type as this responsibility is delegated
to the UDT mapping as implemented by a SQLData
implementation.
readBinaryStream
in interface SQLInput
SQL NULL
, return
null
SQLException
- if the read position is located at an invalid
position; or if there are no further values in the stream.public Object readObject() throws SQLException
SQLInputImpl
object as an Object
in the Java programming language. The
actual type of the object returned is determined by the default
mapping of SQL types to types in the Java programming language unless
there is a custom mapping, in which case the type of the object
returned is determined by this stream's type map.
The JDBC technology-enabled driver registers a type map with the stream before passing the stream to the application.
When the datum at the head of the stream is an SQL NULL
,
this method returns null
. If the datum is an SQL
structured or distinct type with a custom mapping, this method
determines the SQL type of the datum at the head of the stream,
constructs an object of the appropriate class, and calls the method
SQLData.readSQL
on that object. The readSQL
method then calls the appropriate SQLInputImpl.readXXX
methods to retrieve the attribute values from the stream.
readObject
in interface SQLInput
Object
in the Java programming language; null
if
the value is SQL NULL
SQLException
- if the read position is located at an invalid
position; or if there are no further values in the stream.public Ref readRef() throws SQLException
SQLInputImpl
object
as a Ref
object in the Java programming language.
Ref
object representing the SQL
REF
value at the head of the stream; if the value
is SQL NULL
return null
SQLException
- if the read position is located at an invalid
position; or if there are no further values in the stream.public Blob readBlob() throws SQLException
BLOB
value at the head of this
SQLInputImpl
object as a Blob
object
in the Java programming language.
This method does not perform type-safe checking to determine if the
returned type is the expected type as this responsibility is delegated
to the UDT mapping as implemented by a SQLData
implementation.
Blob
object representing the SQL
BLOB
value at the head of this stream;
if the value is SQL NULL
, return
null
SQLException
- if the read position is located at an invalid
position; or if there are no further values in the stream.public Clob readClob() throws SQLException
CLOB
value at the head of this
SQLInputImpl
object as a Clob
object
in the Java programming language.
This method does not perform type-safe checking to determine if the
returned type is the expected type as this responsibility is delegated
to the UDT mapping as implemented by a SQLData
implementation.
Clob
object representing the SQL
CLOB
value at the head of the stream;
if the value is SQL NULL
, return
null
SQLException
- if the read position is located at an invalid
position; or if there are no further values in the stream.public Array readArray() throws SQLException
ARRAY
value from the stream and
returns it as an Array
object in the Java programming
language.
This method does not perform type-safe checking to determine if the
returned type is the expected type as this responsibility is delegated
to the UDT mapping as implemented by a SQLData
implementation.
Array
object representing the SQL
ARRAY
value at the head of the stream; *
if the value is SQL NULL
, return
null
SQLException
- if the read position is located at an invalid
position; or if there are no further values in the stream.public boolean wasNull() throws SQLException
SQLInputImpl
object was null
.
true
if the SQL value read most recently was
null
; otherwise, false
; by default it
will return false
SQLException
- if an error occurs determining the last value
read was a null
value or not;public URL readURL() throws SQLException
DATALINK
value from the stream and
returns it as an URL
object in the Java programming
language.
This method does not perform type-safe checking to determine if the
returned type is the expected type as this responsibility is delegated
to the UDT mapping as implemented by a SQLData
implementation.
URL
object representing the SQL
DATALINK
value at the head of the stream; *
if the value is SQL NULL
, return
null
SQLException
- if the read position is located at an invalid
position; or if there are no further values in the stream.public NClob readNClob() throws SQLException
NCLOB
value from the stream and returns it as a
Clob
object in the Java programming language.
NClob
object representing data of the SQL NCLOB
value
at the head of the stream; null
if the value read is
SQL NULL
SQLException
- if a database access error occurspublic String readNString() throws SQLException
String
in the Java programming language. It is intended for use when
accessing NCHAR
,NVARCHAR
and LONGNVARCHAR
columns.
readNString
in interface SQLInput
NULL
, returns null
SQLException
- if a database access error occurspublic SQLXML readSQLXML() throws SQLException
XML
value from the stream and returns it as a
SQLXML
object in the Java programming language.
readSQLXML
in interface SQLInput
SQLXML
object representing data of the SQL XML
value
at the head of the stream; null
if the value read is
SQL NULL
SQLException
- if a database access error occurspublic RowId readRowId() throws SQLException
ROWID
value from the stream and returns it as a
RowId
object in the Java programming language.
RowId
object representing data of the SQL ROWID
value
at the head of the stream; null
if the value read is
SQL NULL
SQLException
- if a database access error occurs