java.sql.SQLOutput |
The interface for an output stream used to write attributes of an SQL User Defined Type (UDT) to the database. This interface is used for custom mapping of types and is called by the JDBC driver. It is not intended to be used by applications.
When an object which implements the SQLData
interface is used as an
argument to an SQL statement, the JDBC driver calls the method SQLData.getSQLType
to establish the type of the SQL UDT that is being
passed. The driver then creates an SQLOutput
stream and passes it to
the SQLData.writeSQL
method, which in turn uses the appropriate
SQLOutput
writer methods to write the data from the SQLData
object into the stream according to the defined mapping.
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Write an SQL
Array value into the output stream. | |||||||||||
Write a stream of ASCII characters into the output stream.
| |||||||||||
Write a
java.math.BigDecimal value into the output stream. | |||||||||||
Write a stream of uninterpreted bytes into the output stream.
| |||||||||||
Write an SQL
Blob value into the output stream. | |||||||||||
Write a
boolean value into the output stream. | |||||||||||
Write a
byte value into the output stream. | |||||||||||
Write an array of bytes into the output stream.
| |||||||||||
Write a stream of unicode characters into the output stream.
| |||||||||||
Write an SQL
Clob value into the output stream. | |||||||||||
Write a
java.sql.Date value into the output stream. | |||||||||||
Write a
double value into the output stream. | |||||||||||
Write a
float value into the output stream. | |||||||||||
Write an
int value into the output stream. | |||||||||||
Write a
long value into the output stream. | |||||||||||
Write a
Clob into the output stream as an SQL NCLOB. | |||||||||||
Write a
String into the output stream as an SQL NCHAR, NVARCHAR,
or LONGNVARCHAR. | |||||||||||
Write an
SQLData object into the output stream. | |||||||||||
Write an SQL
Ref value into the output stream. | |||||||||||
Write a
RowId into the output stream as an SQL ROWID. | |||||||||||
Write a
SQLXML into the output stream as an SQL XML. | |||||||||||
Write a
short value into the output stream. | |||||||||||
Write a
String value into the output stream. | |||||||||||
Write an SQL
Struct value into the output stream. | |||||||||||
Write a
java.sql.Time value into the output stream. | |||||||||||
Write a
java.sql.Timestamp value into the output stream. | |||||||||||
Write a
URL into the output stream as an SQL DATALINK. |
Write an SQL Array
value into the output stream.
theArray | the java.sql.Array object to write. |
---|
SQLException | if a database error occurs. |
---|
Write a stream of ASCII characters into the output stream.
theStream | the stream of ASCII characters to write, as a java.io.InputStream object |
---|
SQLException | if a database error occurs. |
---|
Write a java.math.BigDecimal
value into the output stream.
theBigDecimal | the BigDecimal value to write. |
---|
SQLException | if a database error occurs. |
---|
Write a stream of uninterpreted bytes into the output stream.
theStream | the stream of bytes to write, as a java.io.InputStream
object |
---|
SQLException | if a database error occurs. |
---|
Write an SQL Blob
value into the output stream.
theBlob | the java.sql.Blob object to write. |
---|
SQLException | if a database error occurs. |
---|
Write a boolean
value into the output stream.
theFlag | the boolean value to write. |
---|
SQLException | if a database error occurs. |
---|
Write a byte
value into the output stream.
theByte | the byte value to write. |
---|
SQLException | if a database error occurs. |
---|
Write an array of bytes into the output stream.
theBytes | the array of bytes to write. |
---|
SQLException | if a database error occurs. |
---|
Write a stream of unicode characters into the output stream.
theStream | the stream of unicode characters to write, as a java.io.Reader object. |
---|
SQLException | if a database error occurs. |
---|
Write an SQL Clob
value into the output stream.
theClob | the java.sql.Clob object to write. |
---|
SQLException | if a database error occurs. |
---|
Write a java.sql.Date
value into the output stream.
theDate | the Date value to write. |
---|
SQLException | if a database error occurs. |
---|
Write a double
value into the output stream.
theDouble | the double value to write. |
---|
SQLException | if a database error occurs. |
---|
Write a float
value into the output stream.
theFloat | the float value to write. |
---|
SQLException | if a database error occurs. |
---|
Write an int
value into the output stream.
theInt | the int value to write. |
---|
SQLException | if a database error occurs. |
---|
Write a long
value into the output stream.
theLong | the long value to write. |
---|
SQLException | if a database error occurs. |
---|
Write a Clob
into the output stream as an SQL NCLOB.
theNClob | the java.sql.Clob object to write. |
---|
SQLException | if a database error occurs. |
---|
Write a String
into the output stream as an SQL NCHAR, NVARCHAR,
or LONGNVARCHAR.
theString | the String to write. |
---|
SQLException | if a database error occurs. |
---|
Write an SQLData
object into the output stream.
If the SQLData
object is null, writes NULL
to the stream.
Otherwise, calls the SQLData.writeSQL
method of the object, which
writes the object's attributes to the stream by calling the appropriate
SQLOutput writer methods for each attribute, in order. The order of the
attributes is the order they are listed in the SQL definition of the User
Defined Type.
theObject | the SQLData object to write. |
---|
SQLException | if a database error occurs. |
---|
Write an SQL Ref
value into the output stream.
theRef | the java.sql.Ref object to write. |
---|
SQLException | if a database error occurs. |
---|
Write a RowId
into the output stream as an SQL ROWID.
theRowId | the java.sql.RowId object to write. |
---|
SQLException | if a database error occurs. |
---|
Write a SQLXML
into the output stream as an SQL XML.
theXml | the java.sql.SQLXML object to write. |
---|
SQLException | if a database error occurs. |
---|
Write a short
value into the output stream.
theShort | the short value to write. |
---|
SQLException | if a database error occurs. |
---|
Write a String
value into the output stream.
theString | the String to write. |
---|
SQLException | if a database error occurs. |
---|
Write an SQL Struct
value into the output stream.
theStruct | the java.sql.Struct object to write. |
---|
SQLException | if a database error occurs. |
---|
Write a java.sql.Time
value into the output stream.
theTime | the Time value to write. |
---|
SQLException | if a database error occurs. |
---|
Write a java.sql.Timestamp
value into the output stream.
theTimestamp | the Timestamp value to write. |
---|
SQLException | if a database error occurs. |
---|
Write a URL
into the output stream as an SQL DATALINK.
theURL | the datalink value as a java.net.URL to write. |
---|
SQLException | if a database error occurs. |
---|