| 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. |
|---|