SerialBlob (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

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

javax.sql.rowset.serial
클래스 SerialBlob

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

모든 구현된 인터페이스:: Serializable, Cloneable, Blob

public class SerialBlob
extends Object
implements Blob, Serializable, Cloneable
extends Object
implements Blob, Serializable, Cloneable

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

SerialBlob 클래스는 Blob 객체로부터 인스턴스를 작성하기 위한 생성자를 제공합니다. Blob객체는 SerialBlob 객체를 구축하기 전에 클라이언트에 SQL BLOB값의 데이터를 건네줄 필요가 있습니다. SQL BLOB값의 데이터는 클라이언트상에서 Blob.getBytes 메서드에 의해 바이트 배열로서 생성됩니다. 또는 Blob.getBinaryStream 메서드에 의해 미해석의 바이트 스트림로서 생성됩니다.

SerialBlob 메서드는 SerialBlob 객체를 바이트 배열 또는 스트림로서 카피할 수 있습니다. 게다가SerialBlob 객체내에서 지정된 바이트 패턴이나 Blob 객체를 검색해, Blob 객체를 갱신 또는 절약할 수도 있습니다.

관련 항목:: 직렬화 된 형식

생성자 개요
`SerialBlob (Blob blob)` 지정된 `Blob` 객체의 직렬화 된 버전 인 `SerialBlob` 객체를 구축합니다.
`SerialBlob (byte[] b)` 지정된 `byte` 배열의 직렬화 된 버전 인 `SerialBlob` 객체를 구축합니다.

메서드 개요
`InputStream`	`getBinaryStream ()` 이 `SerialBlob` 객체를 입력 스트림로서 리턴합니다.
`byte[]`	`getBytes (long pos, int length)` 이 `SerialBlob` 객체의 지정의 위치로부터, 지정된 바이트수를 다른 바이트 배열에 카피합니다.
`long`	`length ()` 이 `SerialBlob` 객체의 바이트 배열의 바이트수를 취득합니다.
`long`	`position (Blob pattern, long start)` 이 `SerialBlob` 객체내에서 지정의 `Blob` 객체가 개시되는 위치를 리턴합니다.
`long`	`position (byte[] pattern, long start)` 이 `SerialBlob` 객체내에서 지정의 바이트 패턴이 개시되는 위치를 리턴합니다.
`OutputStream`	`setBinaryStream (long pos)` 이 `BLOB` 객체가 나타내는 `Blob` 값의 출력을 사용하는 스트림을 취득합니다.
`int`	`setBytes (long pos, byte[] bytes)` 이 `Blob` 객체가 나타내는 `BLOB` 치에 지정된 바이트 배열을 `pos` 위치로부터 출력해, 출력해진 바이트수를 리턴합니다.
`int`	`setBytes (long pos, byte[] bytes, int offset, int length)` 이 `Blob` 객체가 나타내는 `BLOB` 치에 지정된 `byte` 배열의 전부 또는 일부를 출력해, 출력해진 바이트수를 리턴합니다.
`void`	`truncate (long length)` 이 `Blob` 객체가 나타내는 `BLOB`값을 `len` 바이트의 길이에 절약합니다.

클래스 java.lang. Object 로부터 상속된 메서드
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

생성자 상세

SerialBlob

public SerialBlob(byte[] b)
           throws SerialException,

                  SQLException

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

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

파라미터:: b - 직렬화 되는 Blob 객체의 데이터를 포함하는 byte 배열
예외:: SerialException - 직렬화로 에러가 발생했을 경우; SQLException - SQL 에러가 발생했을 경우

SerialBlob

public SerialBlob(Blob  blob)
           throws SerialException,

                  SQLException

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

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

파라미터:: blob - 이 SerialBlob 객체의 구축에 사용되는 Blob 객체. null은 불가
예외:: SerialException - 직렬화로 에러가 발생했을 경우; SQLException - 이 생성자에게 건네진 Blob가 null인 경우
관련 항목:: Blob

메서드의 상세

getBytes

public byte[] getBytes(long pos,
                       int length)
                throws SerialException

이 SerialBlob 객체의 지정의 위치로부터, 지정된 바이트수를 다른 바이트 배열에 카피합니다.

카피되는 바이트수가 이 SerialBlob 객체의 바이트 배열보다 길어지는 경우, 배열의 길이에 맞추어 절약할 수 있습니다.

정의:: 인터페이스 Blob 내의 getBytes

파라미터:: pos - 이 SerialBlob 객체내의 카피되는 최초의 바이트의 위치. 1 으로부터 시작되어 1 보다 작은 값은 되지 않는다. 또, 이 SerialBlob 객체의 길이 이하가 아니면 안되는; length - 카피되는 바이트수
반환값:: 이 SerialBlob 객체의 카피 영역이 되는 바이트 배열. 지정 위치로부터 지정의 바이트 몇분 계속된다
예외:: SerialException - 지정된 개시 위값이 범위외에 있는 경우
관련 항목:: Blob.setBytes(long, byte[])

length

public long length()
            throws SerialException

이 SerialBlob 객체의 바이트 배열의 바이트수를 취득합니다.

정의:: 인터페이스 Blob 내의 length

반환값:: 이 SerialBlob 객체의 바이트 배열의 바이트수를 나타내는 long
예외:: SerialException - 에러가 발생했을 경우

getBinaryStream

public InputStream  getBinaryStream()
                            throws SerialException

이 SerialBlob 객체를 입력 스트림로서 리턴합니다. 관련 메서드 setBinaryStream 과는 달리, SerialBlob가 Blob 객체에 의해 작성되었는지, 또는 byte 배열에 의해 작성되었는지를 관계없이, 스트림이 생성됩니다.

정의:: 인터페이스 Blob 내의 getBinaryStream

반환값:: 이 SerialBlob 바이트 배열을 포함하는 java.io.InputStream 객체
예외:: SerialException - 에러가 발생했을 경우
관련 항목:: setBinaryStream(long)

position

public long position(byte[] pattern,
                     long start)
              throws SerialException,

                     SQLException

이 SerialBlob 객체내에서 지정의 바이트 패턴이 개시되는 위치를 리턴합니다. 검색은 지정의 위치로부터 개시됩니다.

정의:: 인터페이스 Blob 내의 position

파라미터:: pattern - 검색 대상의 바이트 패턴; start - 이 SerialBlob 객체내에서 검색이 개시되는 바이트의 위치. 1 으로부터 시작되어 1 보다 작은 값은 되지 않는다. 또, 이 SerialBlob 객체의 길이 이하가 아니면 안된다
반환값:: 이 SerialBlob 객체내에서 지정된 패턴이 개시되는 위치. 지정 위치로부터 개시된다. 패턴이 발견되지 않는 경우나 지정된 개시 위값이 범위외에 있는 경우는 -1, 반환값의 위치 번호는 1 으로부터 개시된다
예외:: SerialException - blob 직렬화중에 에러가 발생했을 경우; SQLException - 데이타베이스로부터 BLOB 치에 액세스 할 경우에 에러가 발생했을 경우

position

public long position(Blob  pattern,
                     long start)
              throws SerialException,

                     SQLException

이 SerialBlob 객체내에서 지정의 Blob 객체가 개시되는 위치를 리턴합니다. 검색은 지정의 위치로부터 개시됩니다.

정의:: 인터페이스 Blob 내의 position

파라미터:: pattern - 검색 대상의 Blob 객체; start - 이 SerialBlob 객체내에서 검색이 개시되는 바이트의 위치. 1 으로부터 시작되어 1 보다 작은 값은 되지 않는다. 또, 이 SerialBlob 객체의 길이 이하가 아니면 안된다
반환값:: 이 SerialBlob 객체내에서 지정된 Blob 객체가 개시되는 위치. 지정 위치로부터 개시된다. 패턴이 발견되지 않는 경우나 개시 위값이 범위외에 있는 경우는 -1, 반환값의 위치 번호는 1 으로부터 개시된다
예외:: SerialException - blob 직렬화중에 에러가 발생했을 경우; SQLException - 데이타베이스로부터 BLOB 치에 액세스 할 경우에 에러가 발생했을 경우

setBytes

public int setBytes(long pos,
                    byte[] bytes)
             throws SerialException,

                    SQLException

이 Blob 객체가 나타내는 BLOB 치에 지정된 바이트 배열을 pos 위치로부터 출력해, 출력해진 바이트수를 리턴합니다.

정의:: 인터페이스 Blob 내의 setBytes

파라미터:: pos - 출력이 개시되는 SQL BLOB값의 위치. 최초의 위치는 1 이며, 1 이상 또한 SerialBlob 객체의 길이 이하가 아니면 안되는; bytes - 이 Blob 객체가 나타내는 BLOB 치에 출력해지는 바이트 배열
반환값:: 출력해지는 바이트수
예외:: SerialException - BLOB 치에 액세스 할 경우에 에러가 발생했을 경우, 설정된 위값이 무효인 경우, 또는 설정된 오프셋(offset)값이 무효인 경우; SQLException - 데이타베이스로부터 BLOB 치에 액세스 할 경우에 에러가 발생했을 경우
관련 항목:: getBytes(long, int)

setBytes

public int setBytes(long pos,
                    byte[] bytes,
                    int offset,
                    int length)
             throws SerialException,

                    SQLException

이 Blob 객체가 나타내는 BLOB 치에 지정된 byte 배열의 전부 또는 일부를 출력해, 출력해진 바이트수를 리턴합니다. 출력은, BLOB값의 pos 위치로부터 시작되어 출력처의 지정된 바이트 배열로부터 len 바이트 출력해집니다.

정의:: 인터페이스 Blob 내의 setBytes

파라미터:: pos - 출력이 개시되는 BLOB 객체의 위치. 최초의 위치는 1 이며, 1 이상 또한 SerialBlob 객체의 길이 이하가 아니면 안되는; bytes - 이 BLOB 치에 출력해지는 바이트 배열; offset - 바이트의 read를 개시하는 byte 배열의 오프셋(offset). 최초의 오프셋(offset) 위치는 0 이며, 0 이상 byte 배열의 길이 이하가 아니면 안되는; length - 바이트 배열 bytes 로부터 BLOB 치에 출력해지는 바이트수
반환값:: 출력해지는 바이트수
예외:: SerialException - BLOB 치에 액세스 할 경우에 에러가 발생했을 경우, 설정된 위값이 무효인 경우, 설정된 오프셋(offset)값이 무효인 경우, 출력해지는 바이트수가 SerialBlob 길이를 넘고 있는 경우, 또는 길이와 오프셋(offset)를 맞춘 값이 Blob 버퍼보다 큰 경우; SQLException - 데이타베이스로부터 BLOB 치에 액세스 할 경우에 에러가 발생했을 경우
관련 항목:: getBytes(long, int)

setBinaryStream

public OutputStream  setBinaryStream(long pos)
                             throws SerialException,

                                    SQLException

이 BLOB 객체가 나타내는 Blob 값의 출력을 사용하는 스트림을 취득합니다. 스트림은 pos 위치로부터 개시합니다. 이 메서드는 이 SerialBlob 객체가 Blob에 의해 인스턴스화 되고 있는 경우에 setBinaryStream()을 부하의 Blob에 전송 합니다. 이 SerialBlob가 byte 배열에 의해 인스턴스화 되고 있는 경우는 SerialException가 발생 됩니다.

정의:: 인터페이스 Blob 내의 setBinaryStream

파라미터:: pos - BLOB값의 write를 개시하는 위치
반환값:: 데이터가 출력해지는 java.io.OutputStream 객체
예외:: SQLException - BLOB 치에 액세스 할 경우에 에러가 발생했을 경우; SerialException - SerialBlob가 setBinaryStream()를 지원하는 Blob 객체에 의해 인스턴스화되어 있지 않은 경우
관련 항목:: getBinaryStream()

truncate

public void truncate(long length)
              throws SerialException

이 Blob 객체가 나타내는 BLOB값을 len 바이트의 길이에 절약합니다.

정의:: 인터페이스 Blob 내의 truncate

파라미터:: length - 이 Blob 객체가 나타내는 BLOB 값을 절약할 수 있는 길이 (바이트 단위)
예외:: SerialException - Blob 치에 액세스 할 경우에 에러가 발생했을 경우, 또는 절약하는 길이가 SerialBlob 길이보다 긴 경우