|
Préférences
Moteurs de recherche
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
JavaTM 2 Platform Std. Ed. v1.6.0
javax.sql.rowset.serial
|
Constructor Summary | |
---|---|
SQLOutputImpl(Vector<?> attributes,
Map<String,?> map)
Creates a new SQLOutputImpl object
initialized with the given vector of attributes and
type map. |
Method Summary | |
---|---|
void |
writeArray(Array x)
Writes an Array object in the Java
programming language to this SQLOutputImpl
object. |
void |
writeAsciiStream(InputStream x)
Writes a stream of ASCII characters to this SQLOutputImpl object. |
void |
writeBigDecimal(BigDecimal x)
Writes a java.math.BigDecimal object in the Java programming
language to this SQLOutputImpl object. |
void |
writeBinaryStream(InputStream x)
Writes a stream of uninterpreted bytes to this SQLOutputImpl
object. |
void |
writeBlob(Blob x)
Writes a Blob object in the Java programming language
to this SQLOutputImpl object. |
void |
writeBoolean(boolean x)
Writes a boolean in the Java programming language
to this SQLOutputImpl object. |
void |
writeByte(byte x)
Writes a byte in the Java programming language
to this SQLOutputImpl object. |
void |
writeBytes(byte[] x)
Writes an array of bytes in the Java programming language
to this SQLOutputImpl object. |
void |
writeCharacterStream(Reader x)
Writes a stream of Unicode characters to this SQLOutputImpl object. |
void |
writeClob(Clob x)
Writes a Clob object in the Java programming language
to this SQLOutputImpl object. |
void |
writeDate(Date x)
Writes a java.sql.Date object in the Java programming
language to this SQLOutputImpl object. |
void |
writeDouble(double x)
Writes a double in the Java programming language
to this SQLOutputImpl object. |
void |
writeFloat(float x)
Writes a float in the Java programming language
to this SQLOutputImpl object. |
void |
writeInt(int x)
Writes an int in the Java programming language
to this SQLOutputImpl object. |
void |
writeLong(long x)
Writes a long in the Java programming language
to this SQLOutputImpl object. |
void |
writeNClob(NClob x)
Writes an SQL NCLOB value to the stream. |
void |
writeNString(String x)
Writes the next attribute to the stream as a String
in the Java programming language. |
void |
writeObject(SQLData x)
Writes to the stream the data contained in the given SQLData object. |
void |
writeRef(Ref x)
Writes a Ref object in the Java programming language
to this SQLOutputImpl object. |
void |
writeRowId(RowId x)
Writes an SQL ROWID value to the stream. |
void |
writeShort(short x)
Writes a short in the Java programming language
to this SQLOutputImpl object. |
void |
writeSQLXML(SQLXML x)
Writes an SQL XML value to the stream. |
void |
writeString(String x)
Writes a String in the Java programming language
to this SQLOutputImpl object. |
void |
writeStruct(Struct x)
Writes a Struct object in the Java
programming language to this SQLOutputImpl
object. |
void |
writeTime(Time x)
Writes a java.sql.Time object in the Java programming
language to this SQLOutputImpl object. |
void |
writeTimestamp(Timestamp x)
Writes a java.sql.Timestamp object in the Java programming
language to this SQLOutputImpl object. |
void |
writeURL(URL url)
Writes an java.sql.Type.DATALINK object in the Java
programming language to this SQLOutputImpl object. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public SQLOutputImpl(Vector<?> attributes, Map<String,?> map) throws SQLException
SQLOutputImpl
object
initialized with the given vector of attributes and
type map. The driver will use the type map to determine
which SQLData.writeSQL
method to invoke.
This method will then call the appropriate
SQLOutputImpl
writer methods in order and
thereby write the attributes to the new output stream.
attributes
- a Vector
object containing the attributes of
the UDT to be mapped to one or more objects in the Java
programming languagemap
- a java.util.Map
object containing zero or
more entries, with each entry consisting of 1) a String
giving the fully qualified name of a 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 void writeString(String x) throws SQLException
String
in the Java programming language
to this SQLOutputImpl
object. The driver converts
it to an SQL CHAR
, VARCHAR
, or
LONGVARCHAR
before returning it to the database.
writeString
in interface SQLOutput
x
- the value to pass to the database
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeBoolean(boolean x) throws SQLException
boolean
in the Java programming language
to this SQLOutputImpl
object. The driver converts
it to an SQL BIT
before returning it to the database.
writeBoolean
in interface SQLOutput
x
- the value to pass to the database
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeByte(byte x) throws SQLException
byte
in the Java programming language
to this SQLOutputImpl
object. The driver converts
it to an SQL BIT
before returning it to the database.
x
- the value to pass to the database
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeShort(short x) throws SQLException
short
in the Java programming language
to this SQLOutputImpl
object. The driver converts
it to an SQL SMALLINT
before returning it to the database.
writeShort
in interface SQLOutput
x
- the value to pass to the database
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeInt(int x) throws SQLException
int
in the Java programming language
to this SQLOutputImpl
object. The driver converts
it to an SQL INTEGER
before returning it to the database.
x
- the value to pass to the database
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeLong(long x) throws SQLException
long
in the Java programming language
to this SQLOutputImpl
object. The driver converts
it to an SQL BIGINT
before returning it to the database.
x
- the value to pass to the database
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeFloat(float x) throws SQLException
float
in the Java programming language
to this SQLOutputImpl
object. The driver converts
it to an SQL REAL
before returning it to the database.
writeFloat
in interface SQLOutput
x
- the value to pass to the database
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeDouble(double x) throws SQLException
double
in the Java programming language
to this SQLOutputImpl
object. The driver converts
it to an SQL DOUBLE
before returning it to the database.
writeDouble
in interface SQLOutput
x
- the value to pass to the database
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeBigDecimal(BigDecimal x) throws SQLException
java.math.BigDecimal
object in the Java programming
language to this SQLOutputImpl
object. The driver converts
it to an SQL NUMERIC
before returning it to the database.
writeBigDecimal
in interface SQLOutput
x
- the value to pass to the database
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeBytes(byte[] x) throws SQLException
bytes
in the Java programming language
to this SQLOutputImpl
object. The driver converts
it to an SQL VARBINARY
or LONGVARBINARY
before returning it to the database.
writeBytes
in interface SQLOutput
x
- the value to pass to the database
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeDate(Date x) throws SQLException
java.sql.Date
object in the Java programming
language to this SQLOutputImpl
object. The driver converts
it to an SQL DATE
before returning it to the database.
x
- the value to pass to the database
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeTime(Time x) throws SQLException
java.sql.Time
object in the Java programming
language to this SQLOutputImpl
object. The driver converts
it to an SQL TIME
before returning it to the database.
x
- the value to pass to the database
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeTimestamp(Timestamp x) throws SQLException
java.sql.Timestamp
object in the Java programming
language to this SQLOutputImpl
object. The driver converts
it to an SQL TIMESTAMP
before returning it to the database.
writeTimestamp
in interface SQLOutput
x
- the value to pass to the database
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeCharacterStream(Reader x) throws SQLException
SQLOutputImpl
object. The driver will do any necessary
conversion from Unicode to the database CHAR
format.
writeCharacterStream
in interface SQLOutput
x
- the value to pass to the database
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeAsciiStream(InputStream x) throws SQLException
SQLOutputImpl
object. The driver will do any necessary
conversion from ASCII to the database CHAR
format.
writeAsciiStream
in interface SQLOutput
x
- the value to pass to the database
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeBinaryStream(InputStream x) throws SQLException
SQLOutputImpl
object.
writeBinaryStream
in interface SQLOutput
x
- the value to pass to the database
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeObject(SQLData x) throws SQLException
SQLData
object.
When the SQLData
object is null
, this
method writes an SQL NULL
to the stream.
Otherwise, it calls the SQLData.writeSQL
method of the given object, which
writes the object's attributes to the stream.
The implementation of the method SQLData.writeSQ
calls the appropriate SQLOutputImpl.writeXXX
method(s)
for writing each of the object's attributes in order.
The attributes must be read from an SQLInput
input stream and written to an SQLOutputImpl
output stream in the same order in which they were
listed in the SQL definition of the user-defined type.
writeObject
in interface SQLOutput
x
- the object representing data of an SQL structured or
distinct type
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeRef(Ref x) throws SQLException
Ref
object in the Java programming language
to this SQLOutputImpl
object. The driver converts
it to a serializable SerialRef
SQL REF
value
before returning it to the database.
x
- an object representing an SQL REF
value
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeBlob(Blob x) throws SQLException
Blob
object in the Java programming language
to this SQLOutputImpl
object. The driver converts
it to a serializable SerialBlob
SQL BLOB
value
before returning it to the database.
x
- an object representing an SQL BLOB
value
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeClob(Clob x) throws SQLException
Clob
object in the Java programming language
to this SQLOutputImpl
object. The driver converts
it to a serializable SerialClob
SQL CLOB
value
before returning it to the database.
x
- an object representing an SQL CLOB
value
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeStruct(Struct x) throws SQLException
Struct
object in the Java
programming language to this SQLOutputImpl
object. The driver converts this value to an SQL structured type
before returning it to the database.
This method should be used when an SQL structured type has been
mapped to a Struct
object in the Java programming
language (the standard mapping). The method
writeObject
should be used if an SQL structured type
has been custom mapped to a class in the Java programming language.
writeStruct
in interface SQLOutput
x
- an object representing the attributes of an SQL structured type
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeArray(Array x) throws SQLException
Array
object in the Java
programming language to this SQLOutputImpl
object. The driver converts this value to a serializable
SerialArray
SQL ARRAY
value before returning it to the database.
writeArray
in interface SQLOutput
x
- an object representing an SQL ARRAY
value
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeURL(URL url) throws SQLException
java.sql.Type.DATALINK
object in the Java
programming language to this SQLOutputImpl
object. The
driver converts this value to a serializable SerialDatalink
SQL DATALINK
value before return it to the database.
url
- an object representing a SQL DATALINK
value
SQLException
- if the SQLOutputImpl
object is in
use by a SQLData
object attempting to write the attribute
values of a UDT to the database.public void writeNString(String x) throws SQLException
String
in the Java programming language. The driver converts this to a
SQL NCHAR
or
NVARCHAR
or LONGNVARCHAR
value
(depending on the argument's
size relative to the driver's limits on NVARCHAR
values)
when it sends it to the stream.
writeNString
in interface SQLOutput
x
- the value to pass to the database
SQLException
- if a database access error occurspublic void writeNClob(NClob x) throws SQLException
NCLOB
value to the stream.
writeNClob
in interface SQLOutput
x
- a NClob
object representing data of an SQL
NCLOB
value
SQLException
- if a database access error occurspublic void writeRowId(RowId x) throws SQLException
ROWID
value to the stream.
writeRowId
in interface SQLOutput
x
- a RowId
object representing data of an SQL
ROWID
value
SQLException
- if a database access error occurspublic void writeSQLXML(SQLXML x) throws SQLException
XML
value to the stream.
writeSQLXML
in interface SQLOutput
x
- a SQLXML
object representing data of an SQL
XML
value
SQLException
- if a database access error occurs