java.sql
인터페이스 ResultSetMetaData

알려진 서브 인터페이스 목록 :

RowSetMetaData

알려진 구현 클래스 목록:

RowSetMetaDataImpl

public interface ResultSetMetaData

ResultSet 객체의 열의 형태와 프로퍼티에 관한 정보를 얻는 데 사용할 수 있는 객체입니다. 다음의 코드 fragment는 ResultSet 객체의 rs를 생성해, ResultSetMetaData 객체의 rsmd를 생성해, rsmd를 사용해, rs가 가지고 있는 열의 수와 rs에 있는 최초의 열을 WHERE 절에 사용할 수 있을지 어떨지를 판별합니다.

ResultSet rs = stmt.executeQuery("SELECT a, b, c FROM TABLE2"); ResultSetMetaData rsmd = rs.getMetaData(); int numberOfColumns = rsmd.getColumnCount(); boolean b = rsmd.isSearchable(1);
 

필드 개요

static int	columnNoNulls 열이 NULL값을 허가하지 않는 것을 나타내는 정수입니다.
static int	columnNullable 열이 NULL값을 허가하는 것을 나타내는 정수입니다.
static int	columnNullableUnknown 열이 NULL 치를 허가할지 어떨지 불명한 것을 나타내는 정수입니다.

메서드 개요

String	getCatalogName (int column) 지정된 열의 테이블의 카탈로그명을 취득합니다.
String	getColumnClassName (int column) Java 클래스의 완전 지정된 이름을 리턴합니다.
int	getColumnCount () 이 ResultSet 객체의 렬수를 리턴합니다.
int	getColumnDisplaySize (int column) 지정된 열의 보통 의 최대넓이를 문자수로 가리킵니다.
String	getColumnLabel (int column) 인쇄나 표시에 사용하는 지정된 열의 추천 타이틀을 취득합니다.
String	getColumnName (int column) 지정된 열의 이름을 취득합니다.
int	getColumnType (int column) 지정된 열의 SQL 형을 취득합니다.
String	getColumnTypeName (int column) 지정된 열의 데이타베이스 고유의 형명을 취득합니다.
int	getPrecision (int column) 지정된 열의 10 진자리수를 취득합니다.
int	getScale (int column) 지정된 열의 소수점 아래의 자리수를 취득합니다.
String	getSchemaName (int column) 지정된 열의 테이블의 schema를 취득합니다.
String	getTableName (int column) 지정된 열의 테이블명을 취득합니다.
boolean	isAutoIncrement (int column) 지정된 열이 자동적으로 번호 붙이고 되어 읽기 전용 으로서 다루어질지 어떨지를 나타냅니다.
boolean	isCaseSensitive (int column) 열의 대문자와 소문자가 구별될지 어떨지를 나타냅니다.
boolean	isCurrency (int column) 지정된 열이 캐쉬의 값인가 어떤가를 나타냅니다.
boolean	isDefinitelyWritable (int column) 지정된 열의 출력이 반드시 성공할지 어떨지를 나타냅니다.
int	isNullable (int column) 지정된 열에 NULL를 세트 할 수 있을지 어떨지를 나타냅니다.
boolean	isReadOnly (int column) 지정된 열이 절대적으로 출력가능하지 않은지 어떤지를 나타냅니다.
boolean	isSearchable (int column) 지정된 열을 where 절로 사용할 수 있을지 어떨지를 나타냅니다.
boolean	isSigned (int column) 지정된 열의 값이 부호 첨부 수치인가 어떤가를 나타냅니다.
boolean	isWritable (int column) 지정된 열에의 write를 성공시킬 수가 있을지 어떨지를 나타냅니다.

필드의 상세

columnNoNulls

static final int columnNoNulls

열이 NULL값을 허가하지 않는 것을 나타내는 정수입니다.

관련 항목:

정수 필드값

columnNullable

static final int columnNullable

열이 NULL값을 허가하는 것을 나타내는 정수입니다.

관련 항목:

정수 필드값

columnNullableUnknown

static final int columnNullableUnknown

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

관련 항목:

정수 필드값

메서드의 상세

getColumnCount

int getColumnCount()
                   throws SQLException 

이 ResultSet 객체의 렬수를 리턴합니다.

반환값:

렬수

예외:

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

isAutoIncrement

boolean isAutoIncrement(int column)
                        throws SQLException 

지정된 열이 자동적으로 번호 붙이고 되어 읽기 전용 으로서 다루어질지 어떨지를 나타냅니다.

파라미터:

column - 최초의 열은 1, 2번째의 열은 2,... 된다

반환값:

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

예외:

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

isCaseSensitive

boolean isCaseSensitive(int column)
                        throws SQLException 

열의 대문자와 소문자가 구별될지 어떨지를 나타냅니다.

파라미터:

column - 최초의 열은 1, 2번째의 열은 2,... 된다

반환값:

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

예외:

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

isSearchable

boolean isSearchable(int column)
                     throws SQLException 

지정된 열을 where 절로 사용할 수 있을지 어떨지를 나타냅니다.

파라미터:

column - 최초의 열은 1, 2번째의 열은 2,... 된다

반환값:

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

예외:

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

isCurrency

boolean isCurrency(int column)
                   throws SQLException 

지정된 열이 캐쉬의 값인가 어떤가를 나타냅니다.

파라미터:

column - 최초의 열은 1, 2번째의 열은 2,... 된다

반환값:

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

예외:

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

isNullable

int isNullable(int column)
               throws SQLException 

지정된 열에 NULL를 세트 할 수 있을지 어떨지를 나타냅니다.

파라미터:

column - 최초의 열은 1, 2번째의 열은 2,... 된다

반환값:

지정된 열에 NULL를 세트 할 수 있을지 어떨지. columnNoNulls, columnNullable, columnNullableUnknown 어떤 것이나 1개

예외:

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

isSigned

boolean isSigned(int column)
                 throws SQLException 

지정된 열의 값이 부호 첨부 수치인가 어떤가를 나타냅니다.

파라미터:

column - 최초의 열은 1, 2번째의 열은 2,... 된다

반환값:

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

예외:

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

getColumnDisplaySize

int getColumnDisplaySize(int column)
                         throws SQLException 

지정된 열의 보통 의 최대넓이를 문자수로 가리킵니다.

파라미터:

column - 최초의 열은 1, 2번째의 열은 2,... 된다

반환값:

지정된 열의 폭으로서 허가되는 보통 의 최대 문자수

예외:

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

getColumnLabel

String  getColumnLabel(int column)
                      throws SQLException 

인쇄나 표시에 사용하는 지정된 열의 추천 타이틀을 취득합니다.

파라미터:

column - 최초의 열은 1, 2번째의 열은 2,... 된다

반환값:

열의 추천 타이틀

예외:

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

getColumnName

String  getColumnName(int column)
                     throws SQLException 

지정된 열의 이름을 취득합니다.

파라미터:

column - 최초의 열은 1, 2번째의 열은 2,... 된다

반환값:

렬명

예외:

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

getSchemaName

String  getSchemaName(int column)
                     throws SQLException 

지정된 열의 테이블의 schema를 취득합니다.

파라미터:

column - 최초의 열은 1, 2번째의 열은 2,... 된다

반환값:

schema명. 적용 불가의 경우는 ""

예외:

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

getPrecision

int getPrecision(int column)
                 throws SQLException 

지정된 열의 10 진자리수를 취득합니다.

파라미터:

column - 최초의 열은 1, 2번째의 열은 2,... 된다

반환값:

정밀도

예외:

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

getScale

int getScale(int column)
             throws SQLException 

지정된 열의 소수점 아래의 자리수를 취득합니다.

파라미터:

column - 최초의 열은 1, 2번째의 열은 2,... 된다

반환값:

스케일 (자리수)

예외:

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

getTableName

String  getTableName(int column)
                    throws SQLException 

지정된 열의 테이블명을 취득합니다.

파라미터:

column - 최초의 열은 1, 2번째의 열은 2,... 된다

반환값:

테이블명. 적용 불가의 경우는 ""

예외:

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

getCatalogName

String  getCatalogName(int column)
                      throws SQLException 

지정된 열의 테이블의 카탈로그명을 취득합니다.

파라미터:

column - 최초의 열은 1, 2번째의 열은 2,... 된다

반환값:

지정된 열이 나타나는 테이블의 카탈로그명. 적용 불가의 경우는 ""

예외:

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

getColumnType

int getColumnType(int column)
                  throws SQLException 

지정된 열의 SQL 형을 취득합니다.

파라미터:

column - 최초의 열은 1, 2번째의 열은 2,... 된다

반환값:

java.sql.Types 로부터의 SQL 형

예외:

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

관련 항목:

Types

getColumnTypeName

String  getColumnTypeName(int column)
                         throws SQLException 

지정된 열의 데이타베이스 고유의 형명을 취득합니다.

파라미터:

column - 최초의 열은 1, 2번째의 열은 2,... 된다

반환값:

데이타베이스가 사용하는 형명. 열의 형태가 사용자 정의형의 경우는 완전 지정된 형명

예외:

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

isReadOnly

boolean isReadOnly(int column)
                   throws SQLException 

지정된 열이 절대적으로 출력가능하지 않은지 어떤지를 나타냅니다.

파라미터:

column - 최초의 열은 1, 2번째의 열은 2,... 된다

반환값:

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

예외:

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

isWritable

boolean isWritable(int column)
                   throws SQLException 

지정된 열에의 write를 성공시킬 수가 있을지 어떨지를 나타냅니다.

파라미터:

column - 최초의 열은 1, 2번째의 열은 2,... 된다

반환값:

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

예외:

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

isDefinitelyWritable

boolean isDefinitelyWritable(int column)
                             throws SQLException 

지정된 열의 출력이 반드시 성공할지 어떨지를 나타냅니다.

파라미터:

column - 최초의 열은 1, 2번째의 열은 2,... 된다

반환값:

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

예외:

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

getColumnClassName

String  getColumnClassName(int column)
                          throws SQLException 

Java 클래스의 완전 지정된 이름을 리턴합니다. 열로부터 값을 검색하기 위해서 ResultSet.getObject 메서드가 불려가 면, 이 Java 클래스의 인스턴스가 생성됩니다. ResultSet.getObject는 이 메서드로 리턴된 클래스의 서브 클래스를 돌려주는 경우도 있습니다.

파라미터:

column - 최초의 열은 1, 2번째의 열은 2,... 된다

반환값:

지정된 열의 값을 꺼내기 위해서 ResultSet.getObject 메서드에 의해 사용되는 Java 프로그램 언어의 클래스의 완전 지정된 이름. 커스텀 매핑에 사용되는 클래스명

예외:

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

도입된 버전 :

1.2