JavaTM 2 Platform
Std. Ed. v1.3

java.sql
インタフェース SQLOutput


public interface SQLOutput

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

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

導入されたバージョン:
1.2
関連項目:
「JDBC 2.0 API に含まれるもの」

メソッドの概要
 void writeArray(Array x)
          SQL ARRAY 値をストリームに書き込みます。
 void writeAsciiStream(InputStream x)
          次の属性を ASCII 文字のストリームとしてストリームに書き込みます。
 void writeBigDecimal(BigDecimal x)
          次の属性を java.math.BigDecimal オブジェクトとしてストリームに書き込みます。
 void writeBinaryStream(InputStream x)
          次の属性を未解釈のバイトストリームとしてストリームに書き込みます。
 void writeBlob(Blob x)
          SQL BLOB 値をストリームに書き込みます。
 void writeBoolean(boolean x)
          次の属性を Java の boolean 型としてストリームに書き込みます。
 void writeByte(byte x)
          次の属性を Java の byte 型としてストリームに書き込みます。
 void writeBytes(byte[] x)
          次の属性を byte 型の配列としてストリームに書き込みます。
 void writeCharacterStream(Reader x)
          次の属性を Unicode 文字のストリームとしてストリームに書き込みます。
 void writeClob(Clob x)
          SQL 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)
          SQL REF 値をストリームに書き込みます。
 void writeShort(short x)
          次の属性を Java の short 型としてストリームに書き込みます。
 void writeString(String x)
          次の属性を Java プログラミング言語の String としてストリームに書き込みます。
 void writeStruct(Struct x)
          SQL 構造化型値をストリームに書き込みます。
 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
次の属性を byte 型の配列としてストリームに書き込みます。
パラメータ:
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.writeSQL メソッドの実装は、オブジェクトの各属性を正しい順序で書き込むための適切な SQLOutput.writeXXX メソッド (複数可) を呼び出します。属性は、SQLInput 入力ストリームから読み込まれ、ユーザ定義型の SQL 定義にリストされたときと同じ順序で SQLOutput 出力ストリームに書き込まれる必要があります
パラメータ:
x - SQL 構造化型または個別の型のデータを表すオブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合

writeRef

public void writeRef(Ref x)
              throws SQLException
SQL REF 値をストリームに書き込みます。
パラメータ:
x - SQL REF 値のデータを表す Ref オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合

writeBlob

public void writeBlob(Blob x)
               throws SQLException
SQL BLOB 値をストリームに書き込みます。
パラメータ:
x - SQL BLOB 値のデータを表す Blob オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合

writeClob

public void writeClob(Clob x)
               throws SQLException
SQL CLOB 値をストリームに書き込みます。
パラメータ:
x - SQL CLOB 値のデータを表す Clob オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合

writeStruct

public void writeStruct(Struct x)
                 throws SQLException
SQL 構造化型値をストリームに書き込みます。
パラメータ:
x - SQL 構造化型のデータを表す Struct オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合

writeArray

public void writeArray(Array x)
                throws SQLException
SQL ARRAY 値をストリームに書き込みます。
パラメータ:
x - SQL ARRAY 型のデータを表す Array オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.