Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| JavaTM 2 Platform Std. Ed. v1.4.1
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## java.sql
Interface SQLOutput

public interface SQLOutput

The output stream for writing the attributes of a user-defined type back to the database. This interface, used only for custom mapping, is used by the driver, and its methods are never directly invoked by a programmer.

When an object of a class implementing the interface `SQLData` is passed as an argument to an SQL statement, the JDBC driver calls the method `SQLData.getSQLType` to determine the kind of SQL datum being passed to the database. The driver then creates an instance of `SQLOutput` and passes it to the method `SQLData.writeSQL`. The method `writeSQL` in turn calls the appropriate `SQLOutput` writer methods `writeBoolean`, `writeCharacterStream`, and so on) to write data from the `SQLData` object to the `SQLOutput` output stream as the representation of an SQL user-defined type.

Since:
  1.2

Method Summary
`void` | `writeArray(Array x)` Writes an SQL `ARRAY` value to the stream.
`void` | `writeAsciiStream(InputStream x)` Writes the next attribute to the stream as a stream of ASCII characters.
`void` | `writeBigDecimal(BigDecimal x)` Writes the next attribute to the stream as a java.math.BigDecimal object.
`void` | `writeBinaryStream(InputStream x)` Writes the next attribute to the stream as a stream of uninterpreted bytes.
`void` | `writeBlob(Blob x)` Writes an SQL `BLOB` value to the stream.
`void` | `writeBoolean(boolean x)` Writes the next attribute to the stream as a Java boolean.
`void` | `writeByte(byte x)` Writes the next attribute to the stream as a Java byte.
`void` | `writeBytes(byte[] x)` Writes the next attribute to the stream as an array of bytes.
`void` | `writeCharacterStream(Reader x)` Writes the next attribute to the stream as a stream of Unicode characters.
`void` | `writeClob(Clob x)` Writes an SQL `CLOB` value to the stream.
`void` | `writeDate(Date x)` Writes the next attribute to the stream as a java.sql.Date object.
`void` | `writeDouble(double x)` Writes the next attribute to the stream as a Java double.
`void` | `writeFloat(float x)` Writes the next attribute to the stream as a Java float.
`void` | `writeInt(int x)` Writes the next attribute to the stream as a Java int.
`void` | `writeLong(long x)` Writes the next attribute to the stream as a Java long.
`void` | `writeObject(SQLData x)` Writes to the stream the data contained in the given `SQLData` object.
`void` | `writeRef(Ref x)` Writes an SQL `REF` value to the stream.
`void` | `writeShort(short x)` Writes the next attribute to the stream as a Java short.
`void` | `writeString(String x)` Writes the next attribute to the stream as a `String` in the Java programming language.
`void` | `writeStruct(Struct x)` Writes an SQL structured type value to the stream.
`void` | `writeTime(Time x)` Writes the next attribute to the stream as a java.sql.Time object.
`void` | `writeTimestamp(Timestamp x)` Writes the next attribute to the stream as a java.sql.Timestamp object.
`void` | `writeURL(URL x)` Writes a SQL `DATALINK` value to the stream.

Method Detail

### writeString

    public void writeString(String x)
                     throws SQLException

  Writes the next attribute to the stream as a `String` in the Java programming language.

  Parameters:
    `x` - the value to pass to the database
  Throws:
    `SQLException` - if a database access error occurs

### writeBoolean

    public void writeBoolean(boolean x)
                      throws SQLException

  Writes the next attribute to the stream as a Java boolean. Writes the next attribute to the stream as a `String` in the Java programming language.

  Parameters:
    `x` - the value to pass to the database
  Throws:
    `SQLException` - if a database access error occurs

### writeByte

    public void writeByte(byte x)
                   throws SQLException

  Writes the next attribute to the stream as a Java byte. Writes the next attribute to the stream as a `String` in the Java programming language.

  Parameters:
    `x` - the value to pass to the database
  Throws:
    `SQLException` - if a database access error occurs

### writeShort

    public void writeShort(short x)
                    throws SQLException

  Writes the next attribute to the stream as a Java short. Writes the next attribute to the stream as a `String` in the Java programming language.

  Parameters:
    `x` - the value to pass to the database
  Throws:
    `SQLException` - if a database access error occurs

### writeInt

    public void writeInt(int x)
                  throws SQLException

  Writes the next attribute to the stream as a Java int. Writes the next attribute to the stream as a `String` in the Java programming language.

  Parameters:
    `x` - the value to pass to the database
  Throws:
    `SQLException` - if a database access error occurs

### writeLong

    public void writeLong(long x)
                   throws SQLException

  Writes the next attribute to the stream as a Java long. Writes the next attribute to the stream as a `String` in the Java programming language.

  Parameters:
    `x` - the value to pass to the database
  Throws:
    `SQLException` - if a database access error occurs

### writeFloat

    public void writeFloat(float x)
                    throws SQLException

  Writes the next attribute to the stream as a Java float. Writes the next attribute to the stream as a `String` in the Java programming language.

  Parameters:
    `x` - the value to pass to the database
  Throws:
    `SQLException` - if a database access error occurs

### writeDouble

    public void writeDouble(double x)
                     throws SQLException

  Writes the next attribute to the stream as a Java double. Writes the next attribute to the stream as a `String` in the Java programming language.

  Parameters:
    `x` - the value to pass to the database
  Throws:
    `SQLException` - if a database access error occurs

### writeBigDecimal

    public void writeBigDecimal(BigDecimal x)
                         throws SQLException

  Writes the next attribute to the stream as a java.math.BigDecimal object. Writes the next attribute to the stream as a `String` in the Java programming language.

  Parameters:
    `x` - the value to pass to the database
  Throws:
    `SQLException` - if a database access error occurs

### writeBytes

    public void writeBytes(byte[] x)
                    throws SQLException

  Writes the next attribute to the stream as an array of bytes. Writes the next attribute to the stream as a `String` in the Java programming language.

  Parameters:
    `x` - the value to pass to the database
  Throws:
    `SQLException` - if a database access error occurs

### writeDate

    public void writeDate(Date x)
                   throws SQLException

  Writes the next attribute to the stream as a java.sql.Date object. Writes the next attribute to the stream as a `java.sql.Date` object in the Java programming language.

  Parameters:
    `x` - the value to pass to the database
  Throws:
    `SQLException` - if a database access error occurs

### writeTime

    public void writeTime(Time x)
                   throws SQLException

  Writes the next attribute to the stream as a java.sql.Time object. Writes the next attribute to the stream as a `java.sql.Date` object in the Java programming language.

  Parameters:
    `x` - the value to pass to the database
  Throws:
    `SQLException` - if a database access error occurs

### writeTimestamp

    public void writeTimestamp(Timestamp x)
                        throws SQLException

  Writes the next attribute to the stream as a java.sql.Timestamp object. Writes the next attribute to the stream as a `java.sql.Date` object in the Java programming language.

  Parameters:
    `x` - the value to pass to the database
  Throws:
    `SQLException` - if a database access error occurs

### writeCharacterStream

    public void writeCharacterStream(Reader x)
                              throws SQLException

  Writes the next attribute to the stream as a stream of Unicode characters.

  Parameters:
    `x` - the value to pass to the database
  Throws:
    `SQLException` - if a database access error occurs

### writeAsciiStream

    public void writeAsciiStream(InputStream x)
                          throws SQLException

  Writes the next attribute to the stream as a stream of ASCII characters.

  Parameters:
    `x` - the value to pass to the database
  Throws:
    `SQLException` - if a database access error occurs

### writeBinaryStream

    public void writeBinaryStream(InputStream x)
                           throws SQLException

  Writes the next attribute to the stream as a stream of uninterpreted bytes.

  Parameters:
    `x` - the value to pass to the database
  Throws:
    `SQLException` - if a database access error occurs

### writeObject

    public void writeObject(SQLData x)
                     throws SQLException

  Writes to the stream the data contained in the given `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 `SQLOutput` writer 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 `SQLOutput` output stream in the same order in which they were listed in the SQL definition of the user-defined type.

  Parameters:
    `x` - the object representing data of an SQL structured or distinct type
  Throws:
    `SQLException` - if a database access error occurs

### writeRef

    public void writeRef(Ref x)
                  throws SQLException

  Writes an SQL `REF` value to the stream.

  Parameters:
    `x` - a `Ref` object representing data of an SQL `REF` value
  Throws:
    `SQLException` - if a database access error occurs

### writeBlob

    public void writeBlob(Blob x)
                   throws SQLException

  Writes an SQL `BLOB` value to the stream.

  Parameters:
    `x` - a `Blob` object representing data of an SQL `BLOB` value
  Throws:
    `SQLException` - if a database access error occurs

### writeClob

    public void writeClob(Clob x)
                   throws SQLException

  Writes an SQL `CLOB` value to the stream.

  Parameters:
    `x` - a `Clob` object representing data of an SQL `CLOB` value
  Throws:
    `SQLException` - if a database access error occurs

### writeStruct

    public void writeStruct(Struct x)
                     throws SQLException

  Writes an SQL structured type value to the stream.

  Parameters:
    `x` - a `Struct` object representing data of an SQL structured type
  Throws:
    `SQLException` - if a database access error occurs

### writeArray

    public void writeArray(Array x)
                    throws SQLException

  Writes an SQL `ARRAY` value to the stream.

  Parameters:
    `x` - an `Array` object representing data of an SQL `ARRAY` type
  Throws:
    `SQLException` - if a database access error occurs

### writeURL

    public void writeURL(URL x)
                  throws SQLException

  Writes a SQL `DATALINK` value to the stream.

  Parameters:
    `x` - a `java.net.URL` object representing the data of SQL DATALINK type
  Throws:
    `SQLException` - if a database access error occurs
  Since:
    1.4

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| JavaTM 2 Platform Std. Ed. v1.4.1
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.