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 메소드를 사용해 데이타베이스에 포함할 수 있습니다.

JDBC 드라이버가 그 데이터형을 지원하는 경우는,Ref 인터페이스의 모든 메소드가 완전하게 구현될 필요가 있습니다.

도입된 버젼:

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 - 데이타베이스 액세스 에러가 발생했을 경우

SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.2

getObject

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

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

파라미터:

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

반환값:

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

예외:

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

SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.4

관련 항목:

setObject(java.lang.Object)

getObject

Object  getObject()
                 throws SQLException 

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

반환값:

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

예외:

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

SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.4

관련 항목:

setObject(java.lang.Object)

setObject

void setObject(Object  value)
               throws SQLException 

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

파라미터:

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

예외:

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

SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.4

관련 항목:

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