JavaTM 2 Platform
Standard Ed. 5.0

java.sql
インタフェース SQLOutput

既知の実装クラスの一覧:
SQLOutputImpl

public interface SQLOutput

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

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

導入されたバージョン:
1.2

メソッドの概要
 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 オブジェクトとしてストリームに書き込みます。
 void writeURL(URL x)
          SQL DATALINK 値をストリームに書き込みます。
 

メソッドの詳細

writeString

void writeString(String x)
                 throws SQLException
次の属性を Java プログラミング言語の String としてストリームに書き込みます。

パラメータ:
x - データベースに渡す値
例外:
SQLException - データベースアクセスエラーが発生した場合

writeBoolean

void writeBoolean(boolean x)
                  throws SQLException
次の属性を Java の boolean 型としてストリームに書き込みます。次の属性を Java プログラミング言語の String としてストリームに書き込みます。

パラメータ:
x - データベースに渡す値
例外:
SQLException - データベースアクセスエラーが発生した場合

writeByte

void writeByte(byte x)
               throws SQLException
次の属性を Java の byte 型としてストリームに書き込みます。次の属性を Java プログラミング言語の String としてストリームに書き込みます。

パラメータ:
x - データベースに渡す値
例外:
SQLException - データベースアクセスエラーが発生した場合

writeShort

void writeShort(short x)
                throws SQLException
次の属性を Java の short 型としてストリームに書き込みます。次の属性を Java プログラミング言語の String としてストリームに書き込みます。

パラメータ:
x - データベースに渡す値
例外:
SQLException - データベースアクセスエラーが発生した場合

writeInt

void writeInt(int x)
              throws SQLException
次の属性を Java の int 型としてストリームに書き込みます。次の属性を Java プログラミング言語の String としてストリームに書き込みます。

パラメータ:
x - データベースに渡す値
例外:
SQLException - データベースアクセスエラーが発生した場合

writeLong

void writeLong(long x)
               throws SQLException
次の属性を Java の long 型としてストリームに書き込みます。次の属性を Java プログラミング言語の String としてストリームに書き込みます。

パラメータ:
x - データベースに渡す値
例外:
SQLException - データベースアクセスエラーが発生した場合

writeFloat

void writeFloat(float x)
                throws SQLException
次の属性を Java の float 型としてストリームに書き込みます。次の属性を Java プログラミング言語の String としてストリームに書き込みます。

パラメータ:
x - データベースに渡す値
例外:
SQLException - データベースアクセスエラーが発生した場合

writeDouble

void writeDouble(double x)
                 throws SQLException
次の属性を Java の double 型としてストリームに書き込みます。次の属性を Java プログラミング言語の String としてストリームに書き込みます。

パラメータ:
x - データベースに渡す値
例外:
SQLException - データベースアクセスエラーが発生した場合

writeBigDecimal

void writeBigDecimal(BigDecimal x)
                     throws SQLException
次の属性を java.math.BigDecimal オブジェクトとしてストリームに書き込みます。次の属性を Java プログラミング言語の String としてストリームに書き込みます。

パラメータ:
x - データベースに渡す値
例外:
SQLException - データベースアクセスエラーが発生した場合

writeBytes

void writeBytes(byte[] x)
                throws SQLException
次の属性を byte 型の配列としてストリームに書き込みます。次の属性を Java プログラミング言語の String としてストリームに書き込みます。

パラメータ:
x - データベースに渡す値
例外:
SQLException - データベースアクセスエラーが発生した場合

writeDate

void writeDate(Date x)
               throws SQLException
次の属性を java.sql.Date オブジェクトとしてストリームに書き込みます。次の属性を Java プログラミング言語の java.sql.Date オブジェクトとしてストリームに書き込みます。

パラメータ:
x - データベースに渡す値
例外:
SQLException - データベースアクセスエラーが発生した場合

writeTime

void writeTime(Time x)
               throws SQLException
次の属性を java.sql.Time オブジェクトとしてストリームに書き込みます。次の属性を Java プログラミング言語の java.sql.Date オブジェクトとしてストリームに書き込みます。

パラメータ:
x - データベースに渡す値
例外:
SQLException - データベースアクセスエラーが発生した場合

writeTimestamp

void writeTimestamp(Timestamp x)
                    throws SQLException
次の属性を java.sql.Timestamp オブジェクトとしてストリームに書き込みます。次の属性を Java プログラミング言語の java.sql.Date オブジェクトとしてストリームに書き込みます。

パラメータ:
x - データベースに渡す値
例外:
SQLException - データベースアクセスエラーが発生した場合

writeCharacterStream

void writeCharacterStream(Reader x)
                          throws SQLException
次の属性を Unicode 文字のストリームとしてストリームに書き込みます。

パラメータ:
x - データベースに渡す値
例外:
SQLException - データベースアクセスエラーが発生した場合

writeAsciiStream

void writeAsciiStream(InputStream x)
                      throws SQLException
次の属性を ASCII 文字のストリームとしてストリームに書き込みます。

パラメータ:
x - データベースに渡す値
例外:
SQLException - データベースアクセスエラーが発生した場合

writeBinaryStream

void writeBinaryStream(InputStream x)
                       throws SQLException
次の属性を未解釈のバイトストリームとしてストリームに書き込みます。

パラメータ:
x - データベースに渡す値
例外:
SQLException - データベースアクセスエラーが発生した場合

writeObject

void writeObject(SQLData x)
                 throws SQLException
指定された SQLData オブジェクトに格納されているデータをストリームに書き込みます。SQLData オブジェクトが null の場合、このメソッドは SQL NULL をストリームに書き込みます。null でない場合は、オブジェクトの属性をストリームに書き込む、指定されたオブジェクトの SQLData.writeSQL メソッドを呼び出します。SQLData.writeSQL メソッドの実装は、オブジェクトの各属性を正しい順序で書き込むための適切な SQLOutput writer メソッド (複数可) を呼び出します。属性は、SQLInput 入力ストリームから読み込まれ、ユーザ定義型の SQL 定義にリストされたときと同じ順序で SQLOutput 出力ストリームに書き込まれる必要があります。

パラメータ:
x - SQL 構造化型または個別の型のデータを表すオブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合

writeRef

void writeRef(Ref x)
              throws SQLException
SQL REF 値をストリームに書き込みます。

パラメータ:
x - SQL REF 値のデータを表す Ref オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合

writeBlob

void writeBlob(Blob x)
               throws SQLException
SQL BLOB 値をストリームに書き込みます。

パラメータ:
x - SQL BLOB 値のデータを表す Blob オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合

writeClob

void writeClob(Clob x)
               throws SQLException
SQL CLOB 値をストリームに書き込みます。

パラメータ:
x - SQL CLOB 値のデータを表す Clob オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合

writeStruct

void writeStruct(Struct x)
                 throws SQLException
SQL 構造化型値をストリームに書き込みます。

パラメータ:
x - SQL 構造化型のデータを表す Struct オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合

writeArray

void writeArray(Array x)
                throws SQLException
SQL ARRAY 値をストリームに書き込みます。

パラメータ:
x - SQL ARRAY 型のデータを表す Array オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合

writeURL

void writeURL(URL x)
              throws SQLException
SQL DATALINK 値をストリームに書き込みます。

パラメータ:
x - SQL DATALINK 型のデータを表す java.net.URL オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合
導入されたバージョン:
1.4

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。