java.sql
インタフェース SQLOutput

public abstract interface SQLOutput

JDBC 2.0

ユーザ定義型の属性をデータベースに書き戻すための出力ストリームです。カスタムマッピングにだけ使用されるこのインタフェースはドライバによって使用され、そのメソッドをプログラマが直接呼び出すことはできません。

SQLData インタフェースを実装するクラスのオブジェクトが引数として SQL 文に渡されると、JDBC ドライバはデータベースに渡される SQL データの種類を判別するために SQLData.getSQLType を呼び出します。次に、ドライバは SQLOutput のインスタンスを生成し、それを SQLData.writeSQL メソッドに渡します。writeSQL メソッドは、SQLData オブジェクトから SQLOutput 出力ストリームにデータを SQL ユーザ定義型の表現として書き込むための適切な SQLOutput.writeXXX メソッドを呼び出します。

メソッドの概要

void	writeArray(Array x) 配列をストリームに書き込みます。
void	writeAsciiStream(InputStream x) 次の属性を ASCII 文字のストリームとしてストリームに返します。
void	writeBigDecimal(BigDecimal x) 次の属性を java.math.BigDecimal オブジェクトとしてストリームに書き込みます。
void	writeBinaryStream(InputStream x) 次の属性を未解釈のバイトストリームとしてストリームに返します。
void	writeBlob(Blob x) BLOB をストリームに書き込みます。
void	writeBoolean(boolean x) 次の属性を Java の boolean としてストリームに書き込みます。
void	writeByte(byte x) 次の属性を Java の byte としてストリームに書き込みます。
void	writeBytes(byte[] x) 次の属性をバイトの配列としてストリームに書き込みます。
void	writeCharacterStream(Reader x) 次の属性を Unicode 文字のストリームとしてストリームに返します。
void	writeClob(Clob x) CLOB をストリームに書き込みます。
void	writeDate(Date x) 次の属性を java.sql.Date オブジェクトとしてストリームに書き込みます。
void	writeDouble(double x) 次の属性を Java の double としてストリームに書き込みます。
void	writeFloat(float x) 次の属性を Java の float としてストリームに書き込みます。
void	writeInt(int x) 次の属性を Java の int としてストリームに書き込みます。
void	writeLong(long x) 次の属性を Java の long としてストリームに書き込みます。
void	writeObject(SQLData x) 指定された SQLData オブジェクトに格納されているデータをストリームに書き込みます。
void	writeRef(Ref x) REF(<構造化型>) をストリームに書き込みます。
void	writeShort(short x) 次の属性を Java の short としてストリームに書き込みます。
void	writeString(String x) 次の属性を Java の String としてストリームに書き込みます。
void	writeStruct(Struct x) 構造化型をストリームに書き込みます。
void	writeTime(Time x) 次の属性を java.sql.Time オブジェクトとしてストリームに書き込みます。
void	writeTimestamp(Timestamp x) 次の属性を java.sql.Timestamp オブジェクトとしてストリームに書き込みます。

メソッドの詳細

writeString

public void writeString(String x)
                 throws SQLException

次の属性を Java の String としてストリームに書き込みます。

パラメータ:

x - データベースに渡す値

例外:

SQLException - データベースアクセスエラーが発生した場合

writeBoolean

public void writeBoolean(boolean x)
                  throws SQLException

次の属性を Java の boolean としてストリームに書き込みます。

パラメータ:

x - データベースに渡す値

例外:

SQLException - データベースアクセスエラーが発生した場合

writeByte

public void writeByte(byte x)
               throws SQLException

次の属性を Java の byte としてストリームに書き込みます。

パラメータ:

x - データベースに渡す値

例外:

SQLException - データベースアクセスエラーが発生した場合

writeShort

public void writeShort(short x)
                throws SQLException

次の属性を Java の short としてストリームに書き込みます。

パラメータ:

x - データベースに渡す値

例外:

SQLException - データベースアクセスエラーが発生した場合

writeInt

public void writeInt(int x)
              throws SQLException

次の属性を Java の int としてストリームに書き込みます。

パラメータ:

x - データベースに渡す値

例外:

SQLException - データベースアクセスエラーが発生した場合

writeLong

public void writeLong(long x)
               throws SQLException

次の属性を Java の long としてストリームに書き込みます。

パラメータ:

x - データベースに渡す値

例外:

SQLException - データベースアクセスエラーが発生した場合

writeFloat

public void writeFloat(float x)
                throws SQLException

次の属性を Java の float としてストリームに書き込みます。

パラメータ:

x - データベースに渡す値

例外:

SQLException - データベースアクセスエラーが発生した場合

writeDouble

public void writeDouble(double x)
                 throws SQLException

次の属性を Java の double としてストリームに書き込みます。

パラメータ:

x - データベースに渡す値

例外:

SQLException - データベースアクセスエラーが発生した場合

writeBigDecimal

public void writeBigDecimal(BigDecimal x)
                     throws SQLException

次の属性を java.math.BigDecimal オブジェクトとしてストリームに書き込みます。

パラメータ:

x - データベースに渡す値

例外:

SQLException - データベースアクセスエラーが発生した場合

writeBytes

public void writeBytes(byte[] x)
                throws SQLException

次の属性をバイトの配列としてストリームに書き込みます。

パラメータ:

x - データベースに渡す値

例外:

SQLException - データベースアクセスエラーが発生した場合

writeDate

public void writeDate(Date x)
               throws SQLException

次の属性を java.sql.Date オブジェクトとしてストリームに書き込みます。

パラメータ:

x - データベースに渡す値

例外:

SQLException - データベースアクセスエラーが発生した場合

writeTime

public void writeTime(Time x)
               throws SQLException

次の属性を java.sql.Time オブジェクトとしてストリームに書き込みます。

パラメータ:

x - データベースに渡す値

例外:

SQLException - データベースアクセスエラーが発生した場合

writeTimestamp

public void writeTimestamp(Timestamp x)
                    throws SQLException

次の属性を java.sql.Timestamp オブジェクトとしてストリームに書き込みます。

パラメータ:

x - データベースに渡す値

例外:

SQLException - データベースアクセスエラーが発生した場合

writeCharacterStream

public void writeCharacterStream(Reader x)
                          throws SQLException

次の属性を Unicode 文字のストリームとしてストリームに返します。

パラメータ:

x - データベースに渡す値

例外:

SQLException - データベースアクセスエラーが発生した場合

writeAsciiStream

public void writeAsciiStream(InputStream x)
                      throws SQLException

次の属性を ASCII 文字のストリームとしてストリームに返します。

パラメータ:

x - データベースに渡す値

例外:

SQLException - データベースアクセスエラーが発生した場合

writeBinaryStream

public void writeBinaryStream(InputStream x)
                       throws SQLException

次の属性を未解釈のバイトストリームとしてストリームに返します。

パラメータ:

x - データベースに渡す値

例外:

SQLException - データベースアクセスエラーが発生した場合

writeObject

public void writeObject(SQLData x)
                 throws SQLException

指定された SQLData オブジェクトに格納されているデータをストリームに書き込みます。SQLData オブジェクトが null の場合、このメソッドは SQL NULL をストリームに書き込みます。null ではない場合は、オブジェクトの属性をストリームに書き込む、指定されたオブジェクトの SQLData.writeSQL メソッドを呼び出します。SQLData.writeSQ メソッドの実装は、オブジェクトの各属性を正しい順序で書き込むための適切な SQLOutput.writeXXX メソッドを呼び出します。属性は、SQLInput 入力ストリームから読み込まれ、ユーザ定義型の SQL 定義にリスト表示された順序で SQLOutput 出力ストリームに書き込まれなくてはなりません。

パラメータ:

x - SQL 構造化型または個別の型のデータを表すオブジェクト

例外:

SQLException - データベースアクセスエラーが発生した場合

writeRef

public void writeRef(Ref x)
              throws SQLException

REF(<構造化型>) をストリームに書き込みます。

パラメータ:

x - SQL REF 型のデータを表すオブジェクト

例外:

SQLException - データベースアクセスエラーが発生した場合

writeBlob

public void writeBlob(Blob x)
               throws SQLException

BLOB をストリームに書き込みます。

パラメータ:

x - BLOB を表すオブジェクト

例外:

SQLException - データベースアクセスエラーが発生した場合

writeClob

public void writeClob(Clob x)
               throws SQLException

CLOB をストリームに書き込みます。

パラメータ:

x - CLOB を表すオブジェクト

例外:

SQLException - データベースアクセスエラーが発生した場合

writeStruct

public void writeStruct(Struct x)
                 throws SQLException

構造化型をストリームに書き込みます。

パラメータ:

x - 構造化型のデータを表すオブジェクト

例外:

SQLException - データベースアクセスエラーが発生した場合

writeArray

public void writeArray(Array x)
                throws SQLException

配列をストリームに書き込みます。

パラメータ:

x - SQL 配列を表すオブジェクト

例外:

SQLException - データベースアクセスエラーが発生した場合