java.sql
인터페이스 Ref

public interface Ref

Java 프로그램 언어에서의 SQL REF 치의 매핑으로, 데이타베이스의 SQL 구조화형의 값에의 참조가 됩니다.

SQL REF 치는 참조 가능 SQL 구조화형의 인스턴스를 포함한 테이블에 저장되어 각 REF 치는 그 테이블의 1 개의 인스턴스에 대한 일의의 식별자가 됩니다. 인스턴스가 참조하는 SQL 구조화형 대신에, 테이블의 렬치 또는 구조화형의 속성치의 어느 쪽일까하고 해 SQL REF 치를 사용할 수 있습니다.

SQL REF 치는 SQL 구조화형에의 논리 포인터이기 (위해)때문에,Ref 오브젝트도 또 디폴트에서는 논리 포인터입니다. 따라서, SQL REF 치를 Ref 오브젝트로서 취득해도, 클라이언트의 구조화형의 속성을 생성하지 않습니다.

Ref 오브젝트는 PreparedStatement.setRef 메소드를 사용해 데이타베이스에 저장할 수 있습니다.

도입된 버젼:

1.2

관련 항목:

Struct

메소드의 개요

String	getBaseTypeName () 이 Ref 오브젝트가 참조하는 완전 지정된 SQL 구조화형의 SQL 명을 취득합니다.
Object	getObject () 이 Ref 오브젝트에 의해 참조되는 SQL 구조화형 인스턴스를 취득합니다.
Object	getObject (Map map) 참조되는 오브젝트를 취득해, 그 오브젝트가 지정된 형태 MAP를 사용해 Java 형에 MAP 합니다.
void	setObject (Object value) 이 Ref 오브젝트가 참조하는 구조화형치를 Object 의 지정된 인스턴스로 설정합니다.

메소드의 상세

getBaseTypeName

public String  getBaseTypeName()
                       throws SQLException 

이 Ref 오브젝트가 참조하는 완전 지정된 SQL 구조화형의 SQL 명을 취득합니다.

반환값:

참조되는 SQL 구조화형의, 완전 지정된 SQL 명

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

도입된 버젼:

1.2

getObject

public Object  getObject(Map  map)
                 throws SQLException 

참조되는 오브젝트를 취득해, 그 오브젝트가 지정된 형태 MAP를 사용해 Java 형에 MAP 합니다.

파라미터:

map - 사용하는 매핑이 저장되고 있는 java.util.Map 오브젝트 (참조되는 SQL 구조화형의 완전 지정명과 SQL 구조화형이 MAP 되는 SQLData 구현의 클래스 오브젝트)

반환값:

이 Ref 오브젝트가 참조하는 SQL 구조화형의 커스텀 매핑인 Java 의 Object

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

도입된 버젼:

1.4

관련 항목:

setObject(java.lang.Object)

getObject

public Object  getObject()
                 throws SQLException 

이 Ref 오브젝트에 의해 참조되는 SQL 구조화형 인스턴스를 취득합니다. 접속의 형태 MAP가 구조화형의 엔트리를 가지는 경우, 인스턴스는 그 형태 MAP로 나타나는 Java 의 클래스에 커스텀 매핑 됩니다. 그렇지 않은 경우는 구조화형 인스턴스는 Struct 오브젝트에 MAP 됩니다.

반환값:

이 Ref 오브젝트가 참조하는 SQL 구조화형의 매핑인 Java 의 Object

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

도입된 버젼:

1.4

관련 항목:

setObject(java.lang.Object)

setObject

public void setObject(Object  value)
               throws SQLException 

이 Ref 오브젝트가 참조하는 구조화형치를 Object 의 지정된 인스턴스로 설정합니다. 데이타베이스에 보낼 때에, 드라이버는 이것을 SQL 구조화형으로 변환합니다.

파라미터:

value - 이 Ref 오브젝트가 참조하는 SQL 구조화형 인스턴스를 나타내는 Object

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

도입된 버젼:

1.4

관련 항목:

getObject() , getObject(Map) , PreparedStatement.setObject(int, Object) , PreparedStatement#setObject(String, Object)