SQLOutput (Java Platform SE 6)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM Platform
Standard Ed. 6

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

java.sql
インタフェース SQLOutput

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

public interface SQLOutput

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

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

導入されたバージョン:: 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`	`writeNClob(NClob x)` SQL `NCLOB` 値をストリームに書き込みます。
`void`	`writeNString(String x)` 次の属性を Java プログラミング言語の `String` としてストリームに書き込みます。
`void`	`writeObject(SQLData x)` 指定された `SQLData` オブジェクトに格納されたデータを、ストリームに書き込みます。
`void`	`writeRef(Ref x)` SQL `REF` 値をストリームに書き込みます。
`void`	`writeRowId(RowId x)` SQL `ROWID` 値をストリームに書き込みます。
`void`	`writeShort(short x)` 次の属性を Java の short 型としてストリームに書き込みます。
`void`	`writeSQLXML(SQLXML x)` SQL `XML` 値をストリームに書き込みます。
`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 - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.2

writeBoolean

void writeBoolean(boolean x)
                  throws SQLException

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

パラメータ:: x - データベースに渡す値
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.2

writeByte

void writeByte(byte x)
               throws SQLException

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

パラメータ:: x - データベースに渡す値
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.2

writeShort

void writeShort(short x)
                throws SQLException

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

パラメータ:: x - データベースに渡す値
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.2

writeInt

void writeInt(int x)
              throws SQLException

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

パラメータ:: x - データベースに渡す値
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.2

writeLong

void writeLong(long x)
               throws SQLException

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

パラメータ:: x - データベースに渡す値
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.2

writeFloat

void writeFloat(float x)
                throws SQLException

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

パラメータ:: x - データベースに渡す値
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.2

writeDouble

void writeDouble(double x)
                 throws SQLException

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

パラメータ:: x - データベースに渡す値
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.2

writeBigDecimal

void writeBigDecimal(BigDecimal x)
                     throws SQLException

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

パラメータ:: x - データベースに渡す値
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.2

writeBytes

void writeBytes(byte[] x)
                throws SQLException

次の属性を byte 型の配列としてストリームに書き込みます。次の属性を Java プログラミング言語の String としてストリームに書き込みます。

パラメータ:: x - データベースに渡す値
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.2

writeDate

void writeDate(Date x)
               throws SQLException

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

パラメータ:: x - データベースに渡す値
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.2

writeTime

void writeTime(Time x)
               throws SQLException

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

パラメータ:: x - データベースに渡す値
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.2

writeTimestamp

void writeTimestamp(Timestamp x)
                    throws SQLException

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

パラメータ:: x - データベースに渡す値
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.2

writeCharacterStream

void writeCharacterStream(Reader x)
                          throws SQLException

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

パラメータ:: x - データベースに渡す値
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.2

writeAsciiStream

void writeAsciiStream(InputStream x)
                      throws SQLException

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

パラメータ:: x - データベースに渡す値
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.2

writeBinaryStream

void writeBinaryStream(InputStream x)
                       throws SQLException

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

パラメータ:: x - データベースに渡す値
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.2

writeObject

void writeObject(SQLData x)
                 throws SQLException

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

パラメータ:: x - SQL 構造化型または個別の型のデータを表すオブジェクト
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.2

writeRef

void writeRef(Ref x)
              throws SQLException

SQL REF 値をストリームに書き込みます。

パラメータ:: x - SQL REF 値のデータを表す Ref オブジェクト
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.2

writeBlob

void writeBlob(Blob x)
               throws SQLException

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

パラメータ:: x - SQL BLOB 値のデータを表す Blob オブジェクト
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.2

writeClob

void writeClob(Clob x)
               throws SQLException

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

パラメータ:: x - SQL CLOB 値のデータを表す Clob オブジェクト
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.2

writeStruct

void writeStruct(Struct x)
                 throws SQLException

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

パラメータ:: x - SQL 構造化型のデータを表す Struct オブジェクト
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.2

writeArray

void writeArray(Array x)
                throws SQLException

SQL ARRAY 値をストリームに書き込みます。

パラメータ:: x - SQL ARRAY 型のデータを表す Array オブジェクト
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.2

writeURL

void writeURL(URL x)
              throws SQLException

SQL DATALINK 値をストリームに書き込みます。

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

writeNString

void writeNString(String x)
                  throws SQLException

次の属性を Java プログラミング言語の String としてストリームに書き込みます。ストリームに送るときに、ドライバはこれを SQL NCHAR、NVARCHAR、または LONGNVARCHAR 値 (ドライバの NVARCHAR 値に関する制限に関する引数のサイズに依存) に変換します。

パラメータ:: x - データベースに渡す値
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.6

writeNClob

void writeNClob(NClob x)
                throws SQLException

SQL NCLOB 値をストリームに書き込みます。

パラメータ:: x - SQL NCLOB 値のデータを表す NClob オブジェクト
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.6

writeRowId

void writeRowId(RowId x)
                throws SQLException

SQL ROWID 値をストリームに書き込みます。

パラメータ:: x - SQL ROWID 値のデータを表す RowId オブジェクト。
例外:: SQLException - データベースアクセスエラーが発生した場合; SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.6

writeSQLXML

void writeSQLXML(SQLXML x)
                 throws SQLException

SQL XML 値をストリームに書き込みます。

パラメータ:: x - SQL XML 値のデータを表す SQLXML オブジェクト。
例外:: SQLException - データベースアクセスエラーが発生した場合、java.xml.transform.Result、Writer、または OutputStream が SQLXML オブジェクトに対してクローズされていない場合、または XML 値の処理中にエラーが発生した場合。この例外の getCause メソッドにより、より詳細な例外が提供されることがある (たとえばストリームに有効な XML が含まれていない場合); SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:: 1.6