java.sql
인터페이스 Ref

알려진 구현 클래스 목록:

SerialRef

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 <String, Class <? >> map) 참조되는 객체를 취득해, 그 객체가 지정된 형태 맵을 사용해 Java 형에 맵 합니다.
void	setObject (Object value) 이 Ref 객체가 참조하는 구조화형치를 Object 지정된 인스턴스로 설정합니다.

메서드의 상세

getBaseTypeName

String  getBaseTypeName()
                       throws SQLException 

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

반환값:

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

예외:

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

도입된 버전 :

1.2

getObject

Object  getObject(Map <String,
Class <? >> map)
                 throws SQLException 

참조되는 객체를 취득해, 그 객체가 지정된 형태 맵을 사용해 Java 형에 맵 합니다.

파라미터:

map - 사용하는 매핑이 포함되고 있는 java.util.Map 객체 (참조되는 SQL 구조화형의 완전 지정명과 SQL 구조화형이 맵 되는 SQLData 구현의 클래스 객체)

반환값:

이 Ref 객체가 참조하는 SQL 구조화형의 커스텀 매핑인 Java Object

예외:

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

도입된 버전 :

1.4

관련 항목:

setObject(java.lang.Object)

getObject

Object  getObject()
                 throws SQLException 

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

반환값:

이 Ref 객체가 참조하는 SQL 구조화형의 매핑인 Java Object

예외:

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

도입된 버전 :

1.4

관련 항목:

setObject(java.lang.Object)

setObject

void setObject(Object  value)
               throws SQLException 

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

파라미터:

value - 이 Ref 객체가 참조하는 SQL 구조화형 인스턴스를 나타내는 Object

예외:

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

도입된 버전 :

1.4

관련 항목:

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