ResultSetMetaData (Java Platform SE 6) - xrath.com 에서 번역됨

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 클래스의 완전한 이름(FQN)을 돌려줍니다.
`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)` 지정된 열로 지정된 열의 사이즈를 가져옵니다.
`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)` 지정된 열에의 기입을 성공시킬 수가 있을지 어떨지를 나타냅니다.

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

필드의 상세

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

인쇄나 표시에 사용하는, 지정된 열의 추천 타이틀을 가져옵니다. 일반적으로, 추천 타이틀은, SQL AS 절로서 지정됩니다. SQL AS 가 지정되지 않는 경우,getColumnLabel 로부터 반환된 값은,getColumnName 메소드로 반환된 값과 같게 됩니다.

파라미터:: 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

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

파라미터:: column - 최초의 열은 1, 2 번째의 열은 2,... 된다
반환값:: 정밀도
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우

getScale

int getScale(int column)
             throws SQLException

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

파라미터:: 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

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

파라미터:: 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 클래스의 완전한 이름(FQN)을 돌려줍니다. 열로부터 값을 검색하기 위해서 ResultSet.getObject 메소드가 불려 가면(자), 이 Java 클래스의 인스턴스가 생성됩니다. ResultSet.getObject 는, 이 메소드로 반환된 클래스의 서브 클래스를 돌려주는 경우도 있습니다.

파라미터:: column - 최초의 열은 1, 2 번째의 열은 2,... 된다
반환값:: 지정된 열의 값을 꺼내기 위해서(때문에) ResultSet.getObject 메소드에 의해 사용되는 Java 프로그램 언어의 클래스의 완전한 이름(FQN). 커스텀 매핑에 사용되는 클래스명
예외:: SQLException - 데이타베이스 액세스 에러가 발생했을 경우
도입된 버젼:: 1.2

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

전의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세 : 필드 | 생성자 | 메소드

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

java.sql 인터페이스 ResultSetMetaData