SerialClob (Java Platform SE 6) - xrath.com 에서 번역됨

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세: 필드 | 생성자 | 메소드

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
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` 객체를 구축합니다.

메소드의 개요
`void`	`free ()` 이 메소드는,`Clob` 객체를 해제해, 보관 유지되고 있는 자원을 해제합니다.
`InputStream`	`getAsciiStream ()` 이 `SerialClob` 객체에 의해 지정된 `CLOB` 치를 ASCII 스트림로서 가져옵니다.
`Reader`	`getCharacterStream ()` 이 `SerialClob` 객체를 Unicode 문자의 입력 스트림로서 돌려줍니다.
`Reader`	`getCharacterStream (long pos, long length)` `Clob` 치의 일부 (문자 위치 pos 로부터 길이 length 문자분 )를 포함한 `Reader` 객체를 돌려줍니다.
`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 객체가 throw 됩니다.

정의:: 인터페이스 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 객체가 throw 됩니다.

정의:: 인터페이스 Clob 내의 setAsciiStream

파라미터:: pos - CLOB 치에의 기입을 개시한다 위치
반환값:: 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 객체가 throw 됩니다.

정의:: 인터페이스 Clob 내의 setCharacterStream

파라미터:: pos - CLOB 치에의 기입을 개시한다 위치
반환값:: 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

getCharacterStream

public Reader  getCharacterStream(long pos,
                                 long length)
                          throws SQLException

인터페이스 Clob 의 기술:

Clob 치의 일부 (문자 위치 pos 로부터 길이 length 문자분 )를 포함한 Reader 객체를 돌려줍니다.

정의:: 인터페이스 Clob 내의 getCharacterStream

파라미터:: pos - 취득하는 부분치의 최초의 문자까지의 오프셋(offset). Clob 내에서 최초의 문자의 위치는 1; length - 취득하는 부분치의 길이 (문자수)
반환값:: Clob 치의 일부를 읽어낼 수 있는 Reader
예외:: SQLException - pos 가 1 보다 작은 경우, pos 가 Clob 내의 문자수보다 큰 경우, 또는 pos + length 가 Clob 내의 문자수보다 큰 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

free

public void free()
          throws SQLException

인터페이스 Clob 의 기술:

이 메소드는,Clob 객체를 해제해, 보관 유지되고 있는 자원을 해제합니다. free 메소드가 한 번 불려 간 뒤는, 객체는 무효가 됩니다.

free 가 불려 가면(자),free 이외의 메소드를 호출하려고 해도,SQLException 가 throw 됩니다. free 를 여러 차례 호출했을 경우, 2 번째 이후의 free 호출은 아무것도 실시하지 않는 것으로서 다루어집니다.

정의:: 인터페이스 Clob 내의 free

예외:: SQLException - Clob 의 자원을 해제할 경우에 에러가 발생했을 경우; SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세: 필드 | 생성자 | 메소드

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

javax.sql.rowset.serial 클래스 SerialClob

SerialClob

SerialClob

length

getCharacterStream

getAsciiStream

getSubString

position

position

setString

setString

setAsciiStream

setCharacterStream

truncate

getCharacterStream

free

javax.sql.rowset.serial
클래스 SerialClob