java.sql
인터페이스 Blob

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

public long length()
            throws SQLException 

이 Blob 오브젝트에 의해 지정된 BLOB 치의 바이트수를 돌려줍니다.

반환값:

BLOB 의 길이 (바이트 단위)

예외:

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

도입된 버젼:

1.2

getBytes

public 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

public InputStream  getBinaryStream()
                            throws SQLException 

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

반환값:

BLOB 데이터를 저장하는 스트림

예외:

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

도입된 버젼:

1.2

관련 항목:

setBinaryStream(long)

position

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

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

파라미터:

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

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

반환값:

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

예외:

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

도입된 버젼:

1.2

position

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

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

파라미터:

pattern - 검색 대상의 BLOB 치를 지정하는 Blob 오브젝트

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

반환값:

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

예외:

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

도입된 버젼:

1.2

setBytes

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

이 Blob 오브젝트가 나타내는 BLOB 치에 지정된 바이트 배열을 pos 의 위치로부터 기입해, 기입해진 바이트수를 돌려줍니다.

파라미터:

pos - BLOB 오브젝트의 기입을 개시하는 위치

bytes - 이 Blob 오브젝트가 나타내는 BLOB 치에 기입해지는 바이트 배열

반환값:

기입해지는 바이트수

예외:

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

도입된 버젼:

1.4

관련 항목:

getBytes(long, int)

setBytes

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

이 Blob 오브젝트가 나타내는 BLOB 치에 지정된 byte 배열의 전부 또는 일부를 기입합니다. 기입은 BLOB 치의 pos 의 위치로부터 개시되어 지정된 바이트 배열의 len 바이트가 기입해집니다.

파라미터:

pos - Blob 오브젝트의 기입을 개시하는 위치

bytes - 이 BLOB 오브젝트에 기입해지는 바이트 배열

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

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

반환값:

기입해지는 바이트수

예외:

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

도입된 버젼:

1.4

관련 항목:

getBytes(long, int)

setBinaryStream

public OutputStream  setBinaryStream(long pos)
                             throws SQLException 

이 Blob 오브젝트가 나타내는 BLOB 치에의 기입해에 사용하는 스트림을 취득합니다. 스트림은 pos 의 위치로부터 개시합니다.

파라미터:

pos - BLOB 치의 기입을 개시하는 위치

반환값:

데이터가 기입해지는 java.io.OutputStream 오브젝트

예외:

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

도입된 버젼:

1.4

관련 항목:

getBinaryStream()

truncate

public void truncate(long len)
              throws SQLException 

이 Blob 오브젝트가 나타내는 BLOB 치를 len 바이트의 길이에 절약합니다.

파라미터:

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

예외:

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

도입된 버젼:

1.4