JavaTM 2
Platform
Std.  Ed.  v1. 4.0

java.sql
인터페이스 ResultSetMetaData

기존의 서브 인터페이스의 일람:
RowSetMetaData

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)
          지정된 열이 자동적으로 번호 붙이고 되어 read 전용으로서 다루어질지 어떨지를 나타냅니다.
 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)
          지정된 열에의 기입을 성공시킬 수가 있을지 어떨지를 나타냅니다.
 

필드의 상세

columnNoNulls

public static final int columnNoNulls
열이 NULL 치를 허가하지 않는 것을 나타내는 정수입니다.

관련 항목:
정수 필드치

columnNullable

public static final int columnNullable
열이 NULL 치를 허가하는 것을 나타내는 정수입니다.

관련 항목:
정수 필드치

columnNullableUnknown

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

관련 항목:
정수 필드치
메소드의 상세

getColumnCount

public int getColumnCount()
                   throws SQLException 
ResultSet 오브젝트의 렬수를 돌려줍니다.

반환값:
렬수
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우

isAutoIncrement

public boolean isAutoIncrement(int column)
                        throws SQLException 
지정된 열이 자동적으로 번호 붙이고 되어 read 전용으로서 다루어질지 어떨지를 나타냅니다.

파라미터:
column - 최초의 열은 1, 2 번째의 열은 2, 등으로 한다
반환값:
상기의 경우는 true, 그렇지 않은 경우는 false
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우

isCaseSensitive

public boolean isCaseSensitive(int column)
                        throws SQLException 
열의 대문자 소문자가 구별될지 어떨지를 나타냅니다.

파라미터:
column - 최초의 열은 1, 2 번째의 열은 2, 등으로 한다
반환값:
상기의 경우는 true, 그렇지 않은 경우는 false
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우

isSearchable

public boolean isSearchable(int column)
                     throws SQLException 
지정된 열을 where 절로 사용할 수 있을지 어떨지를 나타냅니다.

파라미터:
column - 최초의 열은 1, 2 번째의 열은 2, 등으로 한다
반환값:
상기의 경우는 true, 그렇지 않은 경우는 false
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우

isCurrency

public boolean isCurrency(int column)
                   throws SQLException 
지정된 열이 캐쉬의 값인가 어떤가를 나타냅니다.

파라미터:
column - 최초의 열은 1, 2 번째의 열은 2, 등으로 한다
반환값:
상기의 경우는 true, 그렇지 않은 경우는 false
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우

isNullable

public int isNullable(int column)
               throws SQLException 
지정된 열에 NULL 를 세트 할 수 있을지 어떨지를 나타냅니다.

파라미터:
column - 최초의 열은 1, 2 번째의 열은 2, 등으로 한다
반환값:
지정된 열에 NULL 를 세트 할 수 있을지 어떨지. columnNoNulls,columnNullable,columnNullableUnknown 의 어떤 것이나 1 개
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우

isSigned

public boolean isSigned(int column)
                 throws SQLException 
지정된 열의 값이 부호 첨부 수치인가 어떤가를 나타냅니다.

파라미터:
column - 최초의 열은 1, 2 번째의 열은 2, 등으로 한다
반환값:
상기의 경우는 true, 그렇지 않은 경우는 false
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우

getColumnDisplaySize

public int getColumnDisplaySize(int column)
                         throws SQLException 
지정된 열의 통상의 최대폭을 캐릭터수로 가리킵니다.

파라미터:
column - 최초의 열은 1, 2 번째의 열은 2, 등으로 한다
반환값:
지정된 열의 폭으로서 허가되는 통상의 최대 캐릭터수
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우

getColumnLabel

public String  getColumnLabel(int column)
                      throws SQLException 
인쇄나 표시에 사용하는 지정된 열의 추천 타이틀을 취득합니다.

파라미터:
column - 최초의 열은 1, 2 번째의 열은 2, 등으로 한다
반환값:
열의 추천 타이틀
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우

getColumnName

public String  getColumnName(int column)
                     throws SQLException 
지정된 열의 이름을 취득합니다.

파라미터:
column - 최초의 열은 1, 2 번째의 열은 2, 등으로 한다
반환값:
렬명
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우

getSchemaName

public String  getSchemaName(int column)
                     throws SQLException 
지정된 열의 테이블의 schema를 취득합니다.

파라미터:
column - 최초의 열은 1, 2 번째의 열은 2, 등으로 한다
반환값:
schema명. 적용 불가의 경우는 ""
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우

getPrecision

public int getPrecision(int column)
                 throws SQLException 
지정된 열의 10 진자리수를 취득합니다.

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

getScale

public int getScale(int column)
             throws SQLException 
지정된 열의 소수점 이하의 자리수를 취득합니다.

파라미터:
column - 최초의 열은 1, 2 번째의 열은 2, 등으로 한다
반환값:
스케일 (자리수)
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우

getTableName

public String  getTableName(int column)
                    throws SQLException 
지정된 열의 테이블명을 취득합니다.

파라미터:
column - 최초의 열은 1, 2 번째의 열은 2, 등으로 한다
반환값:
테이블명. 적용 불가의 경우는 ""
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우

getCatalogName

public String  getCatalogName(int column)
                      throws SQLException 
지정된 열의 테이블의 카탈로그명을 취득합니다.

파라미터:
column - 최초의 열은 1, 2 번째의 열은 2, 등으로 한다
반환값:
지정된 열이 나타나는 테이블의 카탈로그명. 적용 불가의 경우는 ""
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우

getColumnType

public int getColumnType(int column)
                  throws SQLException 
지정된 열의 SQL 형을 취득합니다.

파라미터:
column - 최초의 열은 1, 2 번째의 열은 2, 등으로 한다
반환값:
java.sql.Types 로부터의 SQL 형
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
관련 항목:
Types

getColumnTypeName

public String  getColumnTypeName(int column)
                         throws SQLException 
지정된 열의 데이타베이스 고유의 형명을 취득합니다.

파라미터:
column - 최초의 열은 1, 2 번째의 열은 2, 등으로 한다
반환값:
데이타베이스가 사용하는 형명. 열의 형태가 유저 정의형의 경우는 완전 지정된 형명
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우

isReadOnly

public boolean isReadOnly(int column)
                   throws SQLException 
지정된 열이 절대적으로 기입해 가능하지 않은지 어떤지를 나타냅니다.

파라미터:
column - 최초의 열은 1, 2 번째의 열은 2, 등으로 한다
반환값:
상기의 경우는 true, 그렇지 않은 경우는 false
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우

isWritable

public boolean isWritable(int column)
                   throws SQLException 
지정된 열에의 기입을 성공시킬 수가 있을지 어떨지를 나타냅니다.

파라미터:
column - 최초의 열은 1, 2 번째의 열은 2, 등으로 한다
반환값:
상기의 경우는 true, 그렇지 않은 경우는 false
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우

isDefinitelyWritable

public boolean isDefinitelyWritable(int column)
                             throws SQLException 
지정된 열의 기입이 반드시 성공할지 어떨지를 나타냅니다.

파라미터:
column - 최초의 열은 1, 2 번째의 열은 2, 등으로 한다
반환값:
상기의 경우는 true, 그렇지 않은 경우는 false
예외:
SQLException - 데이타베이스 액세스 에러가 발생했을 경우

getColumnClassName

public String  getColumnClassName(int column)
                          throws SQLException 

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

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

JavaTM 2
Platform
Std.  Ed.  v1. 4.0

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

Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc. 의 상표 혹은 등록상표입니다.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.