javax.sql.rowset.serial
클래스 SQLOutputImpl

java.lang.Object 
  javax.sql.rowset.serial.SQLOutputImpl

모든 구현된 인터페이스:

SQLOutput

public class SQLOutputImpl
extends Object 
implements SQLOutput 

커스텀 맵 된 사용자 정의형 (UDT)의 속성을 데이타베이스에 재차 출력하기 위한 출력 스트림입니다. 드라이버는 이 인터페이스를 내부에서 사용합니다. 이 인터페이스의 메서드가 어플리케이션 프로그래머에 의해 직접 불려 갈 것은 없습니다.

어플리케이션이 PreparedStatement.setObject 메서드를 호출하면, 드라이버는 커스텀 매핑을 이용해, 출력해지는 값이 UDT 형일지 어떨지를 확인합니다. UDT 형이면, 이 UDT SQLData를 구현하는 클래스의 Class 객체를 포함하는 형태 맵내에 엔트리가 존재합니다. 출력해지는 값이 SQLData 인스턴스인 경우, 드라이버는 SQLOutputImpl 인스턴스를 작성해, SQLData.writeSQL 메서드에 건네줍니다. 그러자(면), writeSQL 메서드에 의해 적절한 SQLOutputImpl.writeXXX 메서드가 불려가 SQLData 객체로부터 SQLOutputImpl 출력 스트림에 SQL 사용자 정의형의 표현으로서 데이터가 출력해집니다.

생성자 개요

SQLOutputImpl (Vector <? > attributes, Map <String, ? > map)
지정의 속성 및 형태 맵의 벡터로 초기화된 새로운 SQLOutputImpl 객체를 작성합니다.

메서드 개요

void	writeArray (Array x) 이 SQLOutputImpl 객체에 Java 프로그램 언어의 Array 객체를 출력합니다.
void	writeAsciiStream (InputStream x) 이 SQLOutputImpl 객체에 ASCII 문자 스트림을 출력합니다.
void	writeBigDecimal (BigDecimal x) 이 SQLOutputImpl 객체에 Java 프로그램 언어의 java.math.BigDecimal 객체를 출력합니다.
void	writeBinaryStream (InputStream x) 이 SQLOutputImpl 객체에 미해석의 바이트 스트림을 출력합니다.
void	writeBlob (Blob x) 이 SQLOutputImpl 객체에 Java 프로그램 언어의 Blob 객체를 출력합니다.
void	writeBoolean (boolean x) 이 SQLOutputImpl 객체에 Java 프로그램 언어의 boolean을 출력합니다.
void	writeByte (byte x) 이 SQLOutputImpl 객체에 Java 프로그램 언어의 byte를 출력합니다.
void	writeBytes (byte[] x) 이 SQLOutputImpl 객체에 Java 프로그램 언어의 bytes 배열을 출력합니다.
void	writeCharacterStream (Reader x) 이 SQLOutputImpl 객체에 Unicode 문자 스트림을 출력합니다.
void	writeClob (Clob x) 이 SQLOutputImpl 객체에 Java 프로그램 언어의 Clob 객체를 출력합니다.
void	writeDate (Date x) 이 SQLOutputImpl 객체에 Java 프로그램 언어의 java.sql.Date 객체를 출력합니다.
void	writeDouble (double x) 이 SQLOutputImpl 객체에 Java 프로그램 언어의 double를 출력합니다.
void	writeFloat (float x) 이 SQLOutputImpl 객체에 Java 프로그램 언어의 float를 출력합니다.
void	writeInt (int x) 이 SQLOutputImpl 객체에 Java 프로그램 언어의 int를 출력합니다.
void	writeLong (long x) 이 SQLOutputImpl 객체에 Java 프로그램 언어의 long를 출력합니다.
void	writeObject (SQLData x) 지정된 SQLData 객체에 포함된 데이터를, 스트림에 출력합니다.
void	writeRef (Ref x) 이 SQLOutputImpl 객체에 Java 프로그램 언어의 Ref 객체를 출력합니다.
void	writeShort (short x) 이 SQLOutputImpl 객체에 Java 프로그램 언어의 short를 출력합니다.
void	writeString (String x) 이 SQLOutputImpl 객체에 Java 프로그램 언어의 String를 출력합니다.
void	writeStruct (Struct x) 이 SQLOutputImpl 객체에 Java 프로그램 언어의 Struct 객체를 출력합니다.
void	writeTime (Time x) 이 SQLOutputImpl 객체에 Java 프로그램 언어의 java.sql.Time 객체를 출력합니다.
void	writeTimestamp (Timestamp x) 이 SQLOutputImpl 객체에 Java 프로그램 언어의 java.sql.Timestamp 객체를 출력합니다.
void	writeURL (URL url) 이 SQLOutputImpl 객체에 Java 프로그램 언어의 java.sql.Type.DATALINK 객체를 출력합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

생성자 상세

SQLOutputImpl

public SQLOutputImpl(Vector <? > attributes,
                     Map <String,
? > map)
              throws SQLException 

지정의 속성 및 형태 맵의 벡터로 초기화된 새로운 SQLOutputImpl 객체를 작성합니다. 드라이버는 형태 맵을 사용해, 어느 SQLData.writeSQL 메서드를 호출할까를 결정합니다. 이 메서드에 의해 적절한 SQLOutputImpl 라이터 메서드가 불려가 새로운 출력 스트림에 속성이 출력해집니다.

파라미터:

attributes - JDT 속성을 포함하는 Vector 객체. Java 프로그램 언어의 1개 이상의 객체에 맵 되는

map - 0 개 이상의 엔트리를 가지는 java.util.Map 객체. 각 엔트리는 (1) UDT 완전 수식명을 지정하는 String 객체와(2) UDT 매핑 방법을 정의하는 SQLData 구현의 Class 객체로 구성된다

예외:

SQLException - attributes 또는 map가 null인 경우

메서드의 상세

writeString

public void writeString(String  x)
                 throws SQLException 

이 SQLOutputImpl 객체에 Java 프로그램 언어의 String를 출력합니다. 드라이버는 이것을 SQL CHAR, VARCHAR, 또는 LONGVARCHAR로 변환하고 나서, 데이타베이스에 건네줍니다.

정의:

인터페이스 SQLOutput 내의 writeString

파라미터:

x - 데이타베이스에 건네주는 값

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우

writeBoolean

public void writeBoolean(boolean x)
                  throws SQLException 

이 SQLOutputImpl 객체에 Java 프로그램 언어의 boolean을 출력합니다. 드라이버는 이것을 SQL BIT로 변환하고 나서, 데이타베이스에 건네줍니다.

정의:

인터페이스 SQLOutput 내의 writeBoolean

파라미터:

x - 데이타베이스에 건네주는 값

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우

writeByte

public void writeByte(byte x)
               throws SQLException 

이 SQLOutputImpl 객체에 Java 프로그램 언어의 byte를 출력합니다. 드라이버는 이것을 SQL BIT로 변환하고 나서, 데이타베이스에 건네줍니다.

정의:

인터페이스 SQLOutput 내의 writeByte

파라미터:

x - 데이타베이스에 건네주는 값

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우

writeShort

public void writeShort(short x)
                throws SQLException 

이 SQLOutputImpl 객체에 Java 프로그램 언어의 short를 출력합니다. 드라이버는 이것을 SQL SMALLINT로 변환하고 나서, 데이타베이스에 건네줍니다.

정의:

인터페이스 SQLOutput 내의 writeShort

파라미터:

x - 데이타베이스에 건네주는 값

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우

writeInt

public void writeInt(int x)
              throws SQLException 

이 SQLOutputImpl 객체에 Java 프로그램 언어의 int를 출력합니다. 드라이버는 이것을 SQL INTEGER로 변환하고 나서, 데이타베이스에 건네줍니다.

정의:

인터페이스 SQLOutput 내의 writeInt

파라미터:

x - 데이타베이스에 건네주는 값

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우

writeLong

public void writeLong(long x)
               throws SQLException 

이 SQLOutputImpl 객체에 Java 프로그램 언어의 long를 출력합니다. 드라이버는 이것을 SQL BIGINT로 변환하고 나서, 데이타베이스에 건네줍니다.

정의:

인터페이스 SQLOutput 내의 writeLong

파라미터:

x - 데이타베이스에 건네주는 값

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우

writeFloat

public void writeFloat(float x)
                throws SQLException 

이 SQLOutputImpl 객체에 Java 프로그램 언어의 float를 출력합니다. 드라이버는 이것을 SQL REAL로 변환하고 나서, 데이타베이스에 건네줍니다.

정의:

인터페이스 SQLOutput 내의 writeFloat

파라미터:

x - 데이타베이스에 건네주는 값

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우

writeDouble

public void writeDouble(double x)
                 throws SQLException 

이 SQLOutputImpl 객체에 Java 프로그램 언어의 double를 출력합니다. 드라이버는 이것을 SQL DOUBLE로 변환하고 나서, 데이타베이스에 건네줍니다.

정의:

인터페이스 SQLOutput 내의 writeDouble

파라미터:

x - 데이타베이스에 건네주는 값

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우

writeBigDecimal

public void writeBigDecimal(BigDecimal  x)
                     throws SQLException 

이 SQLOutputImpl 객체에 Java 프로그램 언어의 java.math.BigDecimal 객체를 출력합니다. 드라이버는 이것을 SQL NUMERIC로 변환하고 나서, 데이타베이스에 건네줍니다.

정의:

인터페이스 SQLOutput 내의 writeBigDecimal

파라미터:

x - 데이타베이스에 건네주는 값

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우

writeBytes

public void writeBytes(byte[] x)
                throws SQLException 

이 SQLOutputImpl 객체에 Java 프로그램 언어의 bytes 배열을 출력합니다. 드라이버는 이것을 SQL VARBINARY 또는 LONGVARBINARY로 변환하고 나서, 데이타베이스에 건네줍니다.

정의:

인터페이스 SQLOutput 내의 writeBytes

파라미터:

x - 데이타베이스에 건네주는 값

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우

writeDate

public void writeDate(Date  x)
               throws SQLException 

이 SQLOutputImpl 객체에 Java 프로그램 언어의 java.sql.Date 객체를 출력합니다. 드라이버는 이것을 SQL DATE로 변환하고 나서, 데이타베이스에 건네줍니다.

정의:

인터페이스 SQLOutput 내의 writeDate

파라미터:

x - 데이타베이스에 건네주는 값

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우

writeTime

public void writeTime(Time  x)
               throws SQLException 

이 SQLOutputImpl 객체에 Java 프로그램 언어의 java.sql.Time 객체를 출력합니다. 드라이버는 이것을 SQL TIME로 변환하고 나서, 데이타베이스에 건네줍니다.

정의:

인터페이스 SQLOutput 내의 writeTime

파라미터:

x - 데이타베이스에 건네주는 값

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우

writeTimestamp

public void writeTimestamp(Timestamp  x)
                    throws SQLException 

이 SQLOutputImpl 객체에 Java 프로그램 언어의 java.sql.Timestamp 객체를 출력합니다. 드라이버는 이것을 SQL TIMESTAMP로 변환하고 나서, 데이타베이스에 건네줍니다.

정의:

인터페이스 SQLOutput 내의 writeTimestamp

파라미터:

x - 데이타베이스에 건네주는 값

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우

writeCharacterStream

public void writeCharacterStream(Reader  x)
                          throws SQLException 

이 SQLOutputImpl 객체에 Unicode 문자 스트림을 출력합니다. 드라이버는 필요에 따라서, Unicode 로부터 데이타베이스의 CHAR 형식에의 변환을 실시합니다.

정의:

인터페이스 SQLOutput 내의 writeCharacterStream

파라미터:

x - 데이타베이스에 건네주는 값

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우

writeAsciiStream

public void writeAsciiStream(InputStream  x)
                      throws SQLException 

이 SQLOutputImpl 객체에 ASCII 문자 스트림을 출력합니다. 드라이버는 필요에 따라서, ASCII 로부터 데이타베이스의 CHAR 형식에의 변환을 실시합니다.

정의:

인터페이스 SQLOutput 내의 writeAsciiStream

파라미터:

x - 데이타베이스에 건네주는 값

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우

writeBinaryStream

public void writeBinaryStream(InputStream  x)
                       throws SQLException 

이 SQLOutputImpl 객체에 미해석의 바이트 스트림을 출력합니다.

정의:

인터페이스 SQLOutput 내의 writeBinaryStream

파라미터:

x - 데이타베이스에 건네주는 값

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우

writeObject

public void writeObject(SQLData  x)
                 throws SQLException 

지정된 SQLData 객체에 포함된 데이터를, 스트림에 출력합니다. 이 메서드는 SQLData 객체가 null인 경우, 스트림에 SQL NULL를 출력합니다. 그렇지 않은 경우는 지정된 객체의 SQLData.writeSQL 메서드를 호출합니다. 그러자(면), 불려 간 메서드에의해 객체의 속성이 스트림에 출력해집니다.

SQLData.writeSQ 메서드의 구현은 객체의 각 속성을 순서 올바르게 출력하기 때문에 적절한 SQLOutputImpl.writeXXX 메서드 (복수가능)를 호출합니다. 속성은 SQLInput 입력 스트림로부터 읽어내진뒤 사용자 정의형의 SQL 정의의 일람과 같은 줄서 순서로 SQLOutputImpl 출력 스트림에 출력해지지 않으면 안됩니다.

정의:

인터페이스 SQLOutput 내의 writeObject

파라미터:

x - SQL 구조화형 또는 개별의 형태의 데이터를 나타내는 객체

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우

writeRef

public void writeRef(Ref  x)
              throws SQLException 

이 SQLOutputImpl 객체에 Java 프로그램 언어의 Ref 객체를 출력합니다. 드라이버는 이것을 직렬화 가능한 SerialRef SQL REF값으로 변환하고 나서, 데이타베이스에 건네줍니다.

정의:

인터페이스 SQLOutput 내의 writeRef

파라미터:

x - SQL REF값을 나타내는 객체

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우

writeBlob

public void writeBlob(Blob  x)
               throws SQLException 

이 SQLOutputImpl 객체에 Java 프로그램 언어의 Blob 객체를 출력합니다. 드라이버는 이것을 직렬화 가능한 SerialBlob SQL BLOB값으로 변환하고 나서, 데이타베이스에 건네줍니다.

정의:

인터페이스 SQLOutput 내의 writeBlob

파라미터:

x - SQL BLOB값을 나타내는 객체

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우

writeClob

public void writeClob(Clob  x)
               throws SQLException 

이 SQLOutputImpl 객체에 Java 프로그램 언어의 Clob 객체를 출력합니다. 드라이버는 이것을 직렬화 가능한 SerialClob SQL CLOB값으로 변환하고 나서, 데이타베이스에 건네줍니다.

정의:

인터페이스 SQLOutput 내의 writeClob

파라미터:

x - SQL CLOB값을 나타내는 객체

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우

writeStruct

public void writeStruct(Struct  x)
                 throws SQLException 

이 SQLOutputImpl 객체에 Java 프로그램 언어의 Struct 객체를 출력합니다. 드라이버는 이 값을 SQL 구조형으로 변환하고 나서, 데이타베이스에 건네줍니다.

이 메서드는 SQL 구조형이 Java 프로그램 언어의 Struct 객체에 맵 되고 있는 경우 (표준 매핑)에 사용합니다. SQL 구조형이 Java 프로그램 언어의 클래스에 커스텀 맵 되고 있는 경우는 writeObject 메서드를 사용합니다.

정의:

인터페이스 SQLOutput 내의 writeStruct

파라미터:

x - SQL 구조형의 속성을 나타내는 객체

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우

writeArray

public void writeArray(Array  x)
                throws SQLException 

이 SQLOutputImpl 객체에 Java 프로그램 언어의 Array 객체를 출력합니다. 드라이버는 이 값을 직렬화 가능한 SerialArray SQL ARRAY값으로 변환하고 나서, 데이타베이스에 건네줍니다.

정의:

인터페이스 SQLOutput 내의 writeArray

파라미터:

x - SQL ARRAY값을 나타내는 객체

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우

writeURL

public void writeURL(URL  url)
              throws SQLException 

이 SQLOutputImpl 객체에 Java 프로그램 언어의 java.sql.Type.DATALINK 객체를 출력합니다. 드라이버는 이 값을 직렬화 가능한 SerialDatalink SQL DATALINK값으로 변환하고 나서, 데이타베이스에 건네줍니다.

정의:

인터페이스 SQLOutput 내의 writeURL

파라미터:

url - SQL DATALINK값을 나타내는 객체

예외:

SQLException - UDT 속성값을 데이타베이스에 출력하기 때문에 SQLData 객체에 의해 SQLOutputImpl 객체가 사용되고 있는 경우