JavaTM 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, 또는 OutputStreamSQLXML 객체에 대해서 클로즈되어 있지 않은 경우, 또는 XML 치의 처리중에 에러가 발생했을 경우. 이 예외의 getCause 메소드에 의해, 보다 상세한 예외가 제공되는 일이 있다 (예를 들어 스트림에 유효한 XML 가 포함되지 않은 경우)
SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우
도입된 버젼:
1.6

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.