javax.sql.rowset.serial
클래스 SerialClob

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

모든 구현된 인터페이스:

Serializable, Cloneable, Clob

public class SerialClob
extends Object 
implements Clob,
 Serializable,
 Cloneable 

Java 프로그램 언어에서의 SQL CLOB값의 직렬화 매핑입니다.

SerialClob 클래스는 Clob 객체로부터 인스턴스를 작성하기 위한 생성자를 제공합니다. Clob객체는 SerialClob 객체를 구축하기 전에 클라이언트에 SQL CLOB값을 건네줄 필요가 있습니다. SQL CLOB값의 데이터는 클라이언트상에서 Unicode 문자의 스트림로서 생성됩니다.

SerialClob 메서드는 SerialClob 객체로부터 부분 캐릭터 라인을 취득하거나 문자 패턴의 개시 위치를 검색하거나 하는 기능을 제공합니다.

관련 항목:

직렬화 된 형식

생성자 개요

SerialClob (char[] ch)
지정된 char 배열의 직렬화 된 버전 인 SerialClob 객체를 구축합니다.

SerialClob (Clob clob)
지정된 Clob 객체의 직렬화 된 버전 인 SerialClob 객체를 구축합니다.

메서드 개요

InputStream	getAsciiStream () 이 SerialClob 객체에 의해 지정된 CLOB값을 ASCII 스트림로서 취득합니다.
Reader	getCharacterStream () 이 SerialClob 객체를 Unicode 문자의 입력 스트림로서 리턴합니다.
String	getSubString (long pos, int length) 이 SerialClob 객체에 포함된, 지정의 위치로부터 개시되고 지정의 문자 몇분 계속되는 부분 캐릭터 라인의 복사본을 리턴합니다.
long	length () 이 SerialClob 객체의 문자 배열의 문자수를 취득합니다.
long	position (Clob searchStr, long start) 이 SerialClob 객체내에서 지정의 Clob 시그니쳐가 개시되는 위치를 리턴합니다.
long	position (String searchStr, long start) 이 SerialClob 객체내에서 지정의 String 객체가 개시되는 위치를 리턴합니다.
OutputStream	setAsciiStream (long pos) 이 SerialClob 객체가 나타내는 CLOB 치에 ASCII 문자의 출력을 사용하는 스트림을 취득합니다.
Writer	setCharacterStream (long pos) 이 SerialClob 객체가 나타내는 CLOB 값의 Unicode 스트림의 출력을 사용하는 pos 위치의 스트림을 취득합니다.
int	setString (long pos, String str) 이 SerialClob 객체가 나타내는 CLOB 치에 지정된 Java String를 pos 위치에 출력합니다.
int	setString (long pos, String str, int offset, int length) 이 Clob가 나타내는 CLOB 치에 offset 문자로부터 시작되는 str len 문자를 출력합니다.
void	truncate (long length) 이 SerialClob 객체가 나타내는 CLOB값을 len 문자의 길이에 절약합니다.

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

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

생성자 상세

SerialClob

public SerialClob(char[] ch)
           throws SerialException,

                  SQLException 

지정된 char 배열의 직렬화 된 버전 인 SerialClob 객체를 구축합니다.

새로운 SerialClob객체는 char 배열의 데이터로 초기화됩니다. 이 때문에 미접속의 RowSet객체는 데이터 소스에 손보지 않고 직렬화 된 Clob 객체를 작성할 수 있습니다.

파라미터:

ch - 직렬화 되는 Clob 객체를 나타내는 char 배열

예외:

SerialException - 직렬화로 에러가 발생했을 경우

SQLException - SQL 에러가 발생했을 경우

SerialClob

public SerialClob(Clob  clob)
           throws SerialException,

                  SQLException 

지정된 Clob 객체의 직렬화 된 버전 인 SerialClob 객체를 구축합니다.

새로운 SerialClob객체는 Clob 객체의 데이터로 초기화됩니다. 이 때문에 Clob객체는 미리 데이타베이스로부터 클라이언트에 SQL CLOB값의 데이터를 건네주어 둘 필요가 있습니다. 그렇게 하지 않으면 새로운 SerialClob객체는 데이터를 가지지 않는 객체가 됩니다.

주: 이 생성자 으로 지정된 Clob객체는 Clob.getCharacterStream() 메서드 및 Clob.getAsciiStream 메서드에 대해서 null을 돌려줄 수 없습니다. 이 SerialClob 생성자는 이 인스턴스의 Clob 객체를 직렬화하지 못하고, SQLException 객체를 Throw 합니다.

파라미터:

clob - 이 SerialClob 객체의 구축에 사용되는 Clob 객체. null은 불가

예외:

SerialException - 직렬화로 에러가 발생했을 경우

SQLException - CLOB 읽어들이기시에 SQL 에러가 발생했을 경우, Clob 객체가 null인 경우, 또는　Clob로 Clob.getCharacterStream() 메서드와 Clob.getAsciiStream() 메서드의 양쪽 모두가 null을 돌려주었을 경우

관련 항목:

Clob

메서드의 상세

length

public long length()
            throws SerialException 

이 SerialClob 객체의 문자 배열의 문자수를 취득합니다.

정의:

인터페이스 Clob 내의 length

반환값:

이 SerialClob 객체의 문자 배열의 문자수를 나타내는 long

예외:

SerialException - 에러가 발생했을 경우

getCharacterStream

public Reader  getCharacterStream()
                          throws SerialException 

이 SerialClob 객체를 Unicode 문자의 입력 스트림로서 리턴합니다. 관련 메서드 getAsciiStream 과는 달리, SerialClob 객체가 Clob 객체에 의해 작성되었는지, 또는 char 배열에 의해 작성되었는지를 관계없이, 스트림이 생성됩니다.

정의:

인터페이스 Clob 내의 getCharacterStream

반환값:

이 SerialClob 객체의 데이터를 포함하는 java.io.Reader 객체

예외:

SerialException - 에러가 발생했을 경우

관련 항목:

Clob.setCharacterStream(long)

getAsciiStream

public InputStream  getAsciiStream()
                           throws SerialException,

                                  SQLException 

이 SerialClob 객체에 의해 지정된 CLOB값을 ASCII 스트림로서 취득합니다. 이 메서드는 이 SerialClob 객체가 Clob 객체에 의해 인스턴스화 되고 있는 경우에 getAsciiStream 호출을 부하의 Clob 객체에 전송 합니다. 이 SerialClob 객체가 char 배열에 의해 인스턴스화 되고 있는 경우는 SerialException 객체가 발생 됩니다.

정의:

인터페이스 Clob 내의 getAsciiStream

반환값:

이 SerialClob 데이터를 포함하는 java.io.InputStream 객체

예외:

SerialException - 이 SerialClob 객체가 Clob 객체에 의해 인스턴스화되어 있지 않은 경우

SQLException - 이 SerialClob 객체의 작성에 사용된 CLOB 객체에 의해 표현되는 Clob 치에 액세스 할 경우에 에러가 발생했을 경우

관련 항목:

Clob.setAsciiStream(long)

getSubString

public String  getSubString(long pos,
                           int length)
                    throws SerialException 

이 SerialClob 객체에 포함된, 지정의 위치로부터 개시되고 지정의 문자 몇분 계속되는 부분 캐릭터 라인의 복사본을 리턴합니다.

정의:

인터페이스 Clob 내의 getSubString

파라미터:

pos - 카피되는 부분 캐릭터 라인내의 최초의 문자의 위치. SerialClob 객체의 최초의 문자의 위치는 1 이며, 1 보다 작은 값은 되지 않는다. 또, 개시 위치와 부분 캐릭터 라인의 길이의 화는 이 SerialClob 객체의 길이보다 짧지 않으면 안 되는

length - 리턴된 부분 캐릭터 라인내의 문자수. 이 SerialClob 객체의 길이를 넘지 않는다. 또, 개시 위치와 부분 캐릭터 라인의 길이의 화는 이 SerialClob 객체의 길이보다 짧지 않으면 안 된다

반환값:

이 SerialClob 객체의 부분 캐릭터 라인 (지정의 위치로부터 지정된 문자 몇분 계속된다)을 포함하는 String 객체

예외:

SerialException - 몇개의 인수가 범위외에 있는 경우

position

public long position(String  searchStr,
                     long start)
              throws SerialException,

                     SQLException 

이 SerialClob 객체내에서 지정의 String 객체가 개시되는 위치를 리턴합니다. 검색은 지정 위치로부터 개시됩니다. 패턴이 발견되지 않는 경우, 이 메서드는 -1을 리턴합니다.

정의:

인터페이스 Clob 내의 position

파라미터:

searchStr - 검색 대상의 String 객체

start - 검색이 개시되는 이 SerialClob 객체의 위치. 최초의 위치는 1 이며, 1 이상으로 한편 이 SerialClob 객체의 길이 이하가 아니면 안된다

반환값:

지정의 String 객체의 개시 위치. 검색은 지정 위치로부터 개시된다. 지정의 String 객체가 발견되지 않는 경우나 개시 위값이 범위외에 있는 경우는 -1. 반환값의 위치 번호는 1 으로부터 개시된다

예외:

SerialException - String 시그니쳐의 검색중에 에러가 발생했을 경우

SQLException - 데이타베이스로부터 Blob 치에 액세스 할 경우에 에러가 발생했을 경우

position

public long position(Clob  searchStr,
                     long start)
              throws SerialException,

                     SQLException 

이 SerialClob 객체내에서 지정의 Clob 시그니쳐가 개시되는 위치를 리턴합니다. 검색은 지정 위치로부터 개시됩니다. 패턴이 발견되지 않는 경우, 이 메서드는 -1을 리턴합니다.

정의:

인터페이스 Clob 내의 position

파라미터:

searchStr - 검색 대상의 Clob 객체

start - 검색이 개시되는 이 SerialClob 객체의 위치. 최초의 위치는 1 이며, 1 이상으로 한편 이 SerialClob 객체의 길이 이하가 아니면 안된다

반환값:

이 SerialClob 객체내에서 지정의 Clob 객체가 개시되는 위치. 지정의 개시 위치 또는 그 직후

예외:

SerialException - Clob 시그니쳐의 검색중에 에러가 발생했을 경우

SQLException - 데이타베이스로부터 Blob 치에 액세스 할 경우에 에러가 발생했을 경우

setString

public int setString(long pos,
                     String  str)
              throws SerialException 

이 SerialClob 객체가 나타내는 CLOB 치에 지정된 Java String를 pos 위치에 출력합니다.

정의:

인터페이스 Clob 내의 setString

파라미터:

pos - 이 SerialClob 객체가 표현하는 CLOB 값의 출력이 개시되는 위치. 최초의 위치는 1 이며, 1 이상으로 한편 이 SerialClob 객체의 길이 이하가 아니면 안되는

str - 이 SerialClob 객체가 나타내는 CLOB 치에 출력해지는 캐릭터 라인

반환값:

출력해지는 문자수

예외:

SerialException - CLOB 치에 액세스 할 경우에 에러가 발생했을 경우, 설정된 위값이 무효인 경우, 설정된 오프셋(offset)값이 무효인 경우, 출력해지는 바이트수가 SerialClob 길이를 넘고 있는 경우, 또는 길이와 오프셋(offset)를 조합한 값이 Clob 버퍼보다 큰 경우

setString

public int setString(long pos,
                     String  str,
                     int offset,
                     int length)
              throws SerialException 

이 Clob가 나타내는 CLOB 치에 offset 문자로부터 시작되는 str len 문자를 출력합니다.

정의:

인터페이스 Clob 내의 setString

파라미터:

pos - 이 SerialClob 객체가 표현하는 CLOB 값의 출력이 개시되는 위치. 최초의 위치는 1 이며, 1 이상으로 한편 이 SerialClob 객체의 길이 이하가 아니면 안되는

str - 이 Clob 객체가 나타내는 CLOB 치에 출력해지는 캐릭터 라인

offset - 출력해지는 문자의 read를 개시하는 str 내의 오프셋(offset)

length - 출력해지는 문자수

반환값:

출력해지는 문자수

예외:

SerialException - CLOB 치에 액세스 할 경우에 에러가 발생했을 경우, 설정된 위값이 무효인 경우, 설정된 오프셋(offset)값이 무효인 경우, 출력해지는 바이트수가 SerialClob 길이를 넘고 있는 경우, 또는 길이와 오프셋(offset)를 조합한 값이 Clob 버퍼보다 큰 경우

setAsciiStream

public OutputStream  setAsciiStream(long pos)
                            throws SerialException,

                                   SQLException 

이 SerialClob 객체가 나타내는 CLOB 치에 ASCII 문자의 출력을 사용하는 스트림을 취득합니다. 스트림은 pos 위치로부터 개시합니다. 이 메서드는 이 SerialClob 객체가 Clob 객체에 의해 인스턴스화 되고 있는 경우에 setAsciiStream() 호출을 부하의 Clob 객체에 전송 합니다. 이 SerialClob 객체가 char 배열에 의해 인스턴스화 되고 있는 경우는 SerialException 객체가 발생 됩니다.

정의:

인터페이스 Clob 내의 setAsciiStream

파라미터:

pos - CLOB 객체에의 write를 개시하는 위치

반환값:

ASCII encode 문자가 출력해지는 스트림

예외:

SerialException - SerialClob가 setAsciiStream를 지원하는 Clob 객체에 의해 인스턴스화되어 있지 않은 경우

SQLException - CLOB 치에 액세스 할 경우에 에러가 발생했을 경우

관련 항목:

getAsciiStream()

setCharacterStream

public Writer  setCharacterStream(long pos)
                          throws SerialException,

                                 SQLException 

이 SerialClob 객체가 나타내는 CLOB 값의 Unicode 스트림의 출력을 사용하는 pos 위치의 스트림을 취득합니다. 이 메서드는 이 SerialClob 객체가 Clob 객체에 의해 인스턴스화 되고 있는 경우에 setCharacterStream() 호출을 부하의 Clob 객체에 전송 합니다. 이 SerialClob 객체가 char 배열에 의해 인스턴스화 되고 있는 경우는 SerialException 객체가 발생 됩니다.

정의:

인터페이스 Clob 내의 setCharacterStream

파라미터:

pos - CLOB 값의 write를 개시하는 위치

반환값:

Unicode encode 문자가 출력해지는 스트림

예외:

SerialException - SerialClob가 setCharacterStream를 지원하는 Clob 객체에 의해 인스턴스화되어 있지 않은 경우

SQLException - CLOB 치에 액세스 할 경우에 에러가 발생했을 경우

관련 항목:

getCharacterStream()

truncate

public void truncate(long length)
              throws SerialException 

이 SerialClob 객체가 나타내는 CLOB값을 len 문자의 길이에 절약합니다.

SerialClob 객체의 길이를 0에 절약하면 그 컨텐츠가 소거됩니다.

정의:

인터페이스 Clob 내의 truncate

파라미터:

length - CLOB 값을 절약할 수 있는 길이 (바이트 단위)

예외:

SQLException - CLOB 치에 액세스 할 경우에 에러가 발생했을 경우

SerialException