java.sql
인터페이스 ParameterMetaData

모든 슈퍼 인터페이스:

Wrapper

public interface ParameterMetaData
extends Wrapper 

PreparedStatement 객체내의 각 파라미터 마커의 형태와 프로퍼티에 대한 정보의 취득에 사용하는 객체입니다. 쿼리나 드라이버 구현에 따라서는,ParameterMetaData 객체에 의해 반환되는 데이터는,PreparedStatement 의 실행이 완료할 때까지 이용할 수 없는 것이 있습니다.

드라이버 구현에 따라서는,CallableStatement 객체내의 각 파라미터 마커의 형태와 프로퍼티에 대한 정보를 제공할 수 없는 것이 있습니다.

도입된 버젼:

1.4

필드의 개요

static int	parameterModeIn 파라미터의 모드가 IN 인 것을 나타내는 정수입니다.
static int	parameterModeInOut 파라미터의 모드가 INOUT 인 것을 나타내는 정수입니다.
static int	parameterModeOut 파라미터의 모드가 OUT 인 것을 나타내는 정수입니다.
static int	parameterModeUnknown 파라미터의 모드가 불명한 것을 나타내는 정수입니다.
static int	parameterNoNulls 파라미터가 NULL 치를 허가하지 않는 것을 나타내는 정수입니다.
static int	parameterNullable 파라미터가 NULL 치를 허가하는 것을 나타내는 정수입니다.
static int	parameterNullableUnknown 파라미터가 NULL 치를 허가할지 어떨지 불명한 것을 나타내는 정수입니다.

메소드의 개요

String	getParameterClassName (int param) 인스턴스가 PreparedStatement.setObject 메소드에게 건네지는 Java 클래스의 완전한 이름(FQN)을 가져옵니다.
int	getParameterCount () 이 ParameterMetaData 객체가 정보를 포함한 PreparedStatement 내의 파라미터의 수를 가져옵니다.
int	getParameterMode (int param) 지정된 파라미터의 모드를 가져옵니다.
int	getParameterType (int param) 지정된 파라미터의 SQL 형을 가져옵니다.
String	getParameterTypeName (int param) 지정된 파라미터의 데이타베이스 고유의 형명을 가져옵니다.
int	getPrecision (int param) 지정된 파라미터로 지정된 열의 사이즈를 가져옵니다.
int	getScale (int param) 지정된 파라미터의 소수점 이하의 자리수를 가져옵니다.
int	isNullable (int param) 지정된 파라미터로 null 치가 허가될지 어떨지를 가져옵니다.
boolean	isSigned (int param) 지정된 파라미터의 값이 부호 첨부 수치인가 어떤가를 가져옵니다.

인터페이스 java.sql. Wrapper 로부터 상속된 메소드

isWrapperFor , unwrap

필드의 상세

parameterNoNulls

static final int parameterNoNulls

파라미터가 NULL 치를 허가하지 않는 것을 나타내는 정수입니다.

관련 항목:

정수 필드치

parameterNullable

static final int parameterNullable

파라미터가 NULL 치를 허가하는 것을 나타내는 정수입니다.

관련 항목:

정수 필드치

parameterNullableUnknown

static final int parameterNullableUnknown

파라미터가 NULL 치를 허가할지 어떨지 불명한 것을 나타내는 정수입니다.

관련 항목:

정수 필드치

parameterModeUnknown

static final int parameterModeUnknown

파라미터의 모드가 불명한 것을 나타내는 정수입니다.

관련 항목:

정수 필드치

parameterModeIn

static final int parameterModeIn

파라미터의 모드가 IN 인 것을 나타내는 정수입니다.

관련 항목:

정수 필드치

parameterModeInOut

static final int parameterModeInOut

파라미터의 모드가 INOUT 인 것을 나타내는 정수입니다.

관련 항목:

정수 필드치

parameterModeOut

static final int parameterModeOut

파라미터의 모드가 OUT 인 것을 나타내는 정수입니다.

관련 항목:

정수 필드치

메소드의 상세

getParameterCount

int getParameterCount()
                      throws SQLException 

이 ParameterMetaData 객체가 정보를 포함한 PreparedStatement 내의 파라미터의 수를 가져옵니다.

반환값:

파라미터의 수

예외:

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

도입된 버젼:

1.4

isNullable

int isNullable(int param)
               throws SQLException 

지정된 파라미터로 null 치가 허가될지 어떨지를 가져옵니다.

파라미터:

param - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 된다

반환값:

지정된 파라미터의 null 치 상태. ParameterMetaData.parameterNoNulls,ParameterMetaData.parameterNullable, 또는 ParameterMetaData.parameterNullableUnknown 가운데 1 개

예외:

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

도입된 버젼:

1.4

isSigned

boolean isSigned(int param)
                 throws SQLException 

지정된 파라미터의 값이 부호 첨부 수치인가 어떤가를 가져옵니다.

파라미터:

param - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 된다

반환값:

상기의 경우는 true, 그렇지 않은 경우는 false

예외:

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

도입된 버젼:

1.4

getPrecision

int getPrecision(int param)
                 throws SQLException 

지정된 파라미터로 지정된 열의 사이즈를 가져옵니다.

반환값은, 그 파라미터로 지정된 열의 최대 사이즈를 나타냅니다. 수치 데이터의 경우는, 최대 정밀도입니다. 문자 데이터의 경우는, 문자수입니다. 일시 데이터형의 경우는, String 표현의 문자수입니다 (소수점 이하의 초의 원가요소의 최대 허용 정밀도를 가정). 바이너리 데이터의 경우는, 바이트수입니다. ROWID 데이터형의 경우는, 바이트수입니다. 열사이즈를 적용할 수 없는 데이터형의 경우는, 0 이 돌려주어집니다.

파라미터:

param - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 된다

반환값:

정밀도

예외:

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

도입된 버젼:

1.4

getScale

int getScale(int param)
             throws SQLException 

지정된 파라미터의 소수점 이하의 자리수를 가져옵니다. 스케일을 적용할 수 없는 데이터형의 경우는, 0 이 돌려주어집니다.

파라미터:

param - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 된다

반환값:

스케일 (자리수)

예외:

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

도입된 버젼:

1.4

getParameterType

int getParameterType(int param)
                     throws SQLException 

지정된 파라미터의 SQL 형을 가져옵니다.

파라미터:

param - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 된다

반환값:

java.sql.Types 로부터의 SQL 형

예외:

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

도입된 버젼:

1.4

관련 항목:

Types

getParameterTypeName

String  getParameterTypeName(int param)
                            throws SQLException 

지정된 파라미터의 데이타베이스 고유의 형명을 가져옵니다.

파라미터:

param - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 된다

반환값:

데이타베이스가 사용하는 형명. 파라미터의 형태가 사용자 정의형의 경우는, 완전 지정된 형명

예외:

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

도입된 버젼:

1.4

getParameterClassName

String  getParameterClassName(int param)
                             throws SQLException 

인스턴스가 PreparedStatement.setObject 메소드에게 건네지는 Java 클래스의 완전한 이름(FQN)을 가져옵니다.

파라미터:

param - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 된다

반환값:

지정된 파라미터의 값을 설정하기 위해서 PreparedStatement.setObject 메소드에 의해 사용되는 Java 프로그램 언어의 클래스의 완전한 이름(FQN). 커스텀 매핑에 사용되는 클래스명

예외:

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

도입된 버젼:

1.4

getParameterMode

int getParameterMode(int param)
                     throws SQLException 

지정된 파라미터의 모드를 가져옵니다.

파라미터:

param - 최초의 파라미터는 1, 2 번째의 파라미터는 2,... 된다

반환값:

지정된 파라미터의 모드. ParameterMetaData.parameterModeIn,ParameterMetaData.parameterModeOut,ParameterMetaData.parameterModeInOut, 또는 ParameterMetaData.parameterModeUnknown 가운데 1 개

예외:

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

도입된 버젼:

1.4