JavaTM Platform
Standard Ed. 6

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 writeNClob (NClob  x)
          SQL NCLOB 치를 스트림에 기입합니다.
 void writeNString (String  x)
          다음의 속성을 Java 프로그램 언어의 String 로서 스트림에 기입합니다.
 void writeObject (SQLData  x)
          지정된 SQLData 객체에 포함된 데이터를, 스트림에 기입합니다.
 void writeRef (Ref  x)
          이 SQLOutputImpl 객체에 Java 프로그램 언어의 Ref 객체를 기입합니다.
 void writeRowId (RowId  x)
          SQL ROWID 치를 스트림에 기입합니다.
 void writeShort (short x)
          이 SQLOutputImpl 객체에 Java 프로그램 언어의 short 를 기입합니다.
 void writeSQLXML (SQLXML  x)
          SQL XML 치를 스트림에 기입합니다.
 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 - UDT 의 속성을 포함하는 Vector 객체. Java 프로그램 언어의 1 개 이상의 객체에 맵 되는
map - 0 개 이상의 엔트리를 가지는 java.util.Map 객체. 각 엔트리는, (1) UDT 의 완전 수식명을 지정하는 String 객체와 (2) UDT 의 매핑 방법을 정의한다 SQLData 구현의 Class 객체로 구성된다
예외:
SQLException - attributes 또는 mapnull 치의 경우
메소드의 상세

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 객체가 사용되고 있는 경우

writeNString

public void writeNString(String  x)
                  throws SQLException 
다음의 속성을 Java 프로그램 언어의 String 로서 스트림에 기입합니다. 스트림에 보낼 때에, 드라이버는 이것을 SQL NCHAR,NVARCHAR, 또는 LONGNVARCHAR 치 (드라이버의 NVARCHAR 치에 관한 제한에 관한 인수의 사이즈에 의존)로 변환합니다.

정의:
인터페이스 SQLOutput 내의 writeNString
파라미터:
x - 데이타베이스에 건네주는 값
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
도입된 버젼:
1.6

writeNClob

public void writeNClob(NClob  x)
                throws SQLException 
SQL NCLOB 치를 스트림에 기입합니다.

정의:
인터페이스 SQLOutput 내의 writeNClob
파라미터:
x - SQL NCLOB 치의 데이터를 나타내는 NClob 객체
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
도입된 버젼:
1.6

writeRowId

public void writeRowId(RowId  x)
                throws SQLException 
SQL ROWID 치를 스트림에 기입합니다.

정의:
인터페이스 SQLOutput 내의 writeRowId
파라미터:
x - SQL ROWID 치의 데이터를 나타내는 RowId 객체
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
도입된 버젼:
1.6

writeSQLXML

public void writeSQLXML(SQLXML  x)
                 throws SQLException 
SQL XML 치를 스트림에 기입합니다.

정의:
인터페이스 SQLOutput 내의 writeSQLXML
파라미터:
x - SQL XML 치의 데이터를 나타내는 SQLXML 객체
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
도입된 버젼:
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 도 참조해 주세요.