java.sql
인터페이스 Blob

알려진 구현 클래스 목록:

SerialBlob

public interface Blob

SQL BLOB값의 Java^TM 프로그램 언어에서의 표현 (매핑)입니다. SQL BLOB는 바이너리 라지 객체를 데이타베이스 테이블의 행에 렬값으로 포함하는 빌트인형입니다. 디폴트에서는 드라이버는 SQL locator(BLOB)를 사용해 Blob를 구현합니다. 즉, Blob객체는 데이터 그 자체가 아니고, SQL BLOB 데이터에의 논리 포인터를 포함합니다. Blob객체는 그것이 생성된 트랜잭션(transaction)의 기간중에 유효합니다.

ResultSet, CallableStatement, PreparedStatement 각 인터페이스의 메서드 (getBlob 나 setBlob 등)를 사용하면, 프로그래머는 SQL BLOB 치에 액세스 할 수 있습니다. Blob인터페이스는 SQL BLOB (바이너리 라지 객체) 치의 길이를 취득하기 위한 메서드, 클라이언트로 BLOB값을 생성하기 위한 메서드 및 BLOB 치에서의 바이트 패턴의 위치를 판정하기 위한 메서드를 제공합니다. 또한 이 인터페이스는 BLOB값을 갱신하기 위한 메서드를 갖추고 있습니다.

도입된 버전 :

1.2

메서드 개요

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

메서드의 상세

length

long length()
            throws SQLException 

이 Blob 객체에 의해 지정된 BLOB값의 바이트수를 리턴합니다.

반환값:

BLOB 길이 (바이트 단위)

예외:

SQLException - BLOB 길이에 액세스 할 경우에 에러가 발생했을 경우

도입된 버전 :

1.2

getBytes

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

이 Blob 객체가 나타내는 BLOB값의 전부 또는 일부를 바이트 배열로서 꺼냅니다. byte 배열에는 pos 위치로부터 length가 연속하는 바이트수가 포함됩니다.

파라미터:

pos - BLOB 치내의 최초로 추출되는 바이트의 위치 (서수). 최초의 바이트의 위치는 1

length - 카피 대상이 연속하는 바이트의 수

반환값:

이 Blob 객체에 의해 지정된 BLOB 치내의, pos 위치로부터 length가 연속하는 바이트수가 포함되고 있는 배열

예외:

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

도입된 버전 :

1.2

관련 항목:

setBytes(long, byte[])

getBinaryStream

InputStream  getBinaryStream()
                            throws SQLException 

이 Blob인스턴스에 의해 지정된 BLOB값을 스트림로서 꺼냅니다.

반환값:

BLOB 데이터를 포함하는 스트림

예외:

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

도입된 버전 :

1.2

관련 항목:

setBinaryStream(long)

position

long position(byte[] pattern,
              long start)
              throws SQLException 

이 Blob 객체가 나타내는 BLOB 치내에서 지정된 바이트 pattern가 시작되는 바이트 위치를 취득합니다. pattern 검색은, start 위치로부터 개시됩니다.

파라미터:

pattern - 검색 대상의 바이트 배열

start - 검색을 개시하는 위치. 최초의 위치는 1

반환값:

패턴이 발견된 위치. 발견되지 않았던 경우는 -1

예외:

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

도입된 버전 :

1.2

position

long position(Blob  pattern,
              long start)
              throws SQLException 

이 Blob 객체에 의해 지정된 BLOB 치내에서 pattern가 시작되는 바이트 위치를 취득합니다. 검색은, start 위치에서 개시됩니다.

파라미터:

pattern - 검색 대상의 BLOB값을 지정하는 Blob 객체

start - 검색을 개시하는 BLOB 치내의 위치. 최초의 위치는 1

반환값:

패턴을 개시하는 위치. 그 이외는 -1

예외:

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

도입된 버전 :

1.2

setBytes

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

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

파라미터:

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

bytes - 이 Blob 객체가 나타내는 BLOB 치에 출력해지는 바이트 배열

반환값:

출력해지는 바이트수

예외:

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

도입된 버전 :

1.4

관련 항목:

getBytes(long, int)

setBytes

int setBytes(long pos,
             byte[] bytes,
             int offset,
             int len)
             throws SQLException 

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

파라미터:

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

bytes - 이 BLOB 객체에 출력해지는 바이트 배열

offset - 설정하는 바이트의 read를 개시하는 배열 bytes에 의 오프셋(offset)

len - 바이트 배열 bytes로 부터 BLOB 치에 출력해지는 바이트수

반환값:

출력해지는 바이트수

예외:

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

도입된 버전 :

1.4

관련 항목:

getBytes(long, int)

setBinaryStream

OutputStream  setBinaryStream(long pos)
                             throws SQLException 

이 Blob 객체가 나타내는 BLOB 값의 출력을 사용하는 스트림을 취득합니다. 스트림은 pos 위치로부터 개시합니다.

파라미터:

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

반환값:

데이터가 출력해지는 java.io.OutputStream 객체

예외:

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

도입된 버전 :

1.4

관련 항목:

getBinaryStream()

truncate

void truncate(long len)
              throws SQLException 

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

파라미터:

len - 이 Blob 객체가 나타내는 BLOB 값을 절약할 수 있는 길이 (바이트 단위)

예외:

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

도입된 버전 :

1.4