패키지 javax.sql.rowset

JDBC RowSet 구현의 표준 인터페이스와 base class입니다.

참조처:
설명

인터페이스 개요

CachedRowSet	CachedRowSet의 모든 표준 구현이 구현해야 하는 인터페이스입니다.
FilteredRowSet	FilteredRowSet 모든 표준 구현이 구현해야 하는 표준 인터페이스입니다.
JdbcRowSet	JdbcRowSet 모든 표준 구현이 구현해야 하는 표준 인터페이스입니다.
Joinable	1.0 배경 Joinable인터페이스는 일치열의 취득과 설정의 메서드를 제공합니다.
JoinRowSet	JoinRowSet인터페이스는 다른 RowSet 객체의 관련 데이터를, SQL JOIN를 나타내는 1개의 JoinRowSet 객체에 정리하는 도구를 제공합니다.
Predicate	모든 FilteredRowSet 객체에 필터를 기술하는 체제를 제공하는 표준 인터페이스입니다.
WebRowSet	WebRowSet 모든 구현이 구현해야 하는 표준 인터페이스입니다.

클래스 개요

BaseRowSet	RowSet 객체와 그 기본 기능을 제공하는 추상 클래스입니다.
RowSetMetaDataImpl	RowSet 객체의 열에 관한 메타데이타 정보를 설정 및 얻는 메서드의 구현을 제공합니다.

예외 개요

RowSetWarning

RowSet 객체로 설정된 데이타베이스 경고에 관한 정보를 제공하는 SQLException 확장입니다.

패키지 javax.sql.rowset 설명

JDBC RowSet 구현의 표준 인터페이스와 base class입니다. 이 패키지에는 표준 RowSet 구현이 구현 또는 확장하는 인터페이스와 클래스가 포함되어 있습니다.

목차

• 1.0 패키지의 사양
• 2.0 표준 RowSet 정의
• 3.0 구현 가이드
• 4.0 관련 사양
• 5.0 관련 항목

1.0 패키지의 사양

이 패키지는 5개의 표준 JDBC RowSet인터페이스를 지정합니다. 이러한 5개의 인터페이스는 모두, JDBC 3.0 사양에 기술되고 있는 RowSet 인터페이스를 확장합니다. 이 테크놀러지의 발달과 함께, 보다 전문화된 JDBC RowSet 형의 추가 정의가 추가될 예정입니다. 장래의 정의는 이 사양과 같이, 상속을 이용해 서브 인터페이스로서 지정되게 되어 있습니다.

주: 이 패키지로 제공되는 인터페이스 정의는 이것에 준거한 모든 JDBC RowSet 구현의 기반이 됩니다. 벤더나 개발자가 정의에 준거한 독자적인 RowSet 구현을 제공하고 싶은 경우는 사양 인터페이스에 상술되고 있는 assertion에 주의할 필요가 있습니다.

2.0 표준 RowSet 정의

• JdbcRowSet - 결과 세트를 JavaBeans^TM 컴퍼넌트로서 사용할 수 있도록 하는 ResultSet 객체의 래퍼입니다. JdbcRowSet 객체는 모든 툴로 컴퍼넌트 베이스의 아키텍쳐의 일부로서 어플리케이션을 어셈블(assemble) 하기 위해서 사용할 수 있는 Bean가 됩니다. JdbcRowSet 객체는 접속된 RowSet 객체입니다. 즉, JDBC 테크놀러지를 사용 가능한 드라이버 (JDBC 드라이버)를 사용해 데이터 소스와의 접속을 계속해 보관 유지할필요가 있습니다. 게다가JdbcRowSet객체는 JDBC 3.0 사양의 정의에 따라, 완전하게 갱신 가능해 스크롤 가능한 겉(표) 데이터 구조를 제공합니다.

• CachedRowSet^TM - CachedRowSet 객체는 스크롤, 갱신, 직렬화가 가능해, 일반적으로 데이터 소스로부터 절단 된 JavaBeans^TM 컴퍼넌트입니다. CachedRowSet 객체에는 보통, 결과 세트의 행이 포함됩니다만, 스프레드쉬트 등, 겉(표) 형식의 모든 파일의 행을 포함할 수도 있습니다. CachedRowSet 구현은 미접속의 RowSet 객체와 원의 데이터 소스의 동기를 취하기 때문에 SyncFactory를 사용해, 플러그 인 가능한 SyncProvider 객체를 관리 및 취득할필요가 있습니다. 보통, SyncProvider 구현은 JDBC 드라이버를 이용해 특정의 데이터 소스에 접속합니다. 이 도구 의 상세한 것에 대하여는 javax.sql.rowset.spi 패키지 사양을 참조하십시오.

• WebRowSet - WebRowSet객체는 정형식의 XML 로 RowSet 객체의 독해와 write를 실시할 수 있는 CachedRowSet 확장입니다. 이 클래스는 XmlReader 객체 (RowSetReader 인터페이스의 확장)를 호출해, XML 형식에서 행 세트를 읽어냅니다. 또한, XmlWriter 객체 (RowSetWriter 인터페이스의 확장)를 호출해, XML 형식에서 행 세트를 출력합니다. WebRowSet 객체가 필요로 하는 리더 및 라이터는 SyncFactory에 의해 SyncProvider 구현의 형식에서 제공됩니다. 확실히 정형식의 XML를 사용할 수 있도록, http://java.sun.com/xml/ns/jdbc/webrowset.xsd 에 표준의 범용 XML schema가 정의되어 공개되고 있습니다.

• FilteredRowSet - FilteredRowSet 객체는 프로그램을 사용한 확장 가능한 방식의 필터링 기능을 제공합니다. RowSet object이 미접속의 환경을 희생하는 일 없이 컨텐츠에 필터링을 적용할 필요가 있는 경우는 다수 존재합니다. 이것은 데이터 소스에의 접속을 작성하는 코스트의 삭감을 위해입니다. 이 요구의 솔루션은 다방면에 건너고 있어 매우 무거운 전면적의 SQL 쿼리기능을 제공하는 방법으로부터, 이식 가능한 컴퍼넌트를 제공하는 방법, 보다 경량인 방법이 준비되어 있습니다. FilteredRowSet객체는 실행시에 필터를정의할 수 있는 프레디케이트 인터페이스의 구현을 사용합니다. 또, FilteredRowSet객체는 독해와 출력의 조작의 착신 및 송신에 세트 필터를 적용하는 처리를 부과되고 있습니다. 따라서, 모든 필터는 쌍방향이라고 보여집니다. 표준 필터는 미정도리입니다. 다만, 필요한 필터를 실시하기 위해서 충분한 도구가 지정됩니다.

• JoinRowSet - JoinRowSet 인터페이스는 복수의 표준 RowSet 구현의 관계를 확립하는 도구를 기술합니다. RowSet 객체가 SQL JOIN 방식에서 관련짓고 가능한 경우, JoinRowSet 객체에 추가할 수 있는 RowSet 객체의 수에 제한은 없습니다. 정의에의하면 SQL JOIN 문은 공통의 속성에 기반해 복수의 RDB 테이블내의 데이터를 결합하기 위해서 사용됩니다. 열의 매칭을 작성해, 시행하는 것으로써, JoinRowSet 객체는 원의 데이터 소스는 그대로RowSet 인스턴스끼리의 관계를 확립합니다.

3.0 구현 가이드

JDBC RowSet 구현의 준거 구현은 이 사양에 기술된 assertion에 따를필요가 있습니다. Java Community Process 규정에 따라, 사양과의 호환성을 확보하기 위해, Test Compatibility Kit (TCK)를 허가할 수 있습니다. 아래의 단락에서는 표준 JDBC RowSet 정의의 구현의 개시점에 대해 개설합니다. SyncProvider 구현의 가이드 라인에 대해서는 javax.sql.rowset.spi 패키지의 「Implementer's Guide」도 참조하십시오.

• 3.1 BaseRowSet 클래스의 역할

  준거한 JDBC RowSet 구현은 이 패키지로 지정된 표준 인터페이스를 1개 이상 구현할필요가 있습니다. 또한, BaseRowSet 추상 클래스를 확장할 수가있습니다. 예를 들어, CachedRowSet 구현은, CachedRowSet인터페이스를 구현해, BaseRowSet 추상 클래스를 확장할 필요가 있습니다. BaseRowSet 클래스는 RowSet 객체가 접속 환경에 있을까 미접속의 환경에 있을까에 관계없이, 모든 RowSet 구현의 구축에 사용되는 표준 아키텍쳐를 제공합니다. BaseRowSet 추상 클래스는 RowSet에 프로퍼티의 조작이나 이벤트 통지로 대표되는 JavaBeans 컴퍼넌트 요건에 완전 준거한 기본 기능을 제공합니다. 예를 들어, com.sun.rowset 패키지내의 레퍼런스 구현으로 제공되는 모든 구현은, BaseRowSet 클래스를 구현의 기반으로서 사용합니다.

  아래의 겉(표)에 BaseRowSet 추상 클래스의 기능을 나타냅니다.

  기능	상세
  프로퍼티	어플리케이션에 RowSet 커멘드나 프로퍼티치의 취득 및 설정을 제공하는 표준 JavaBeans 프로퍼티 조작 도구를 제공한다. 표준 RowSet 프로퍼티의 상세한 것에 대하여는 javax.sql.RowSet 인터페이스의 메뉴얼 (JDBC 3.0 사양에서 제공)을 참조
  이벤트 통지	등록을 마친 이벤트 리스너에게 표준 JavaBeans 이벤트 통지를 제공한다. 준거 구현에 의해 생성된 표준 RowSet 이벤트의 등록 및 처리 방법의 상세한 것에 대하여는 javax.sql.RowSetEvent 인터페이스의 메뉴얼 (JDBC 3.0 사양에서 제공)을 참조
  RowSet 객체의 커멘드의 설정	RowSet 커멘드 파라미터를 설정하는 설정 메서드의 완전한 세트를 제공한다
  스트림	스트림형을 지정하기 위한 일련의 정수외, 스트림 인스턴스의 포함 필드를 제공한다

• 3.2 접속된 RowSet 요건

  JdbcRowSet는 항상 원의 데이터 소스에 접속하고 있을필요가 있는 RowSet 객체를 기술합니다. JdbcRowSet 구현은 이 접속이 JDBC 드라이버에만 따라 제공되고 있는 것을 확인할 필요가 있습니다. 또, JdbcRowSet인터페이스의 구현이 되어 있어, 접속 환경에서 동작하는 RowSet객체는 RowSetReader 객체나 RowSetWriter 객체의 취득에 SyncFactory를 사용하지 않습니다. 이것들은 부하의 갱신 및 스크롤 가능한 ResultSet 구현에의해 JDBC 드라이버를 이용해 요구를 채울 수가 있습니다.

• 3.3 미접속의 RowSet 요건

  CachedRowSet 객체 등, 미접속의 RowSet객체는 SyncFactory에 의해 제공되는 SyncProvider 객체에 접속 관리를 위양 할필요가 있습니다. 완전하게 미접속으로 하기 위해서는 모든 미접속의 RowSet객체는 RowSet 객체의 생성에 이용된 원의 데이터 소스 접속이 클로우즈 해, 가비지 컬렉터가 자원을 복원 및 해방할 수 있는 상태가 되어 있는 것을 확인할필요가 있습니다. SyncProvider객체는 동기가 필요한 때에 데이터 소스 접속을 재차 확립하기 위해, 중요한 JDBC 프로퍼티가 보관 유지되고 있는 것을 확인합니다. 따라서, 미접속의 RowSet객체는 Connection 객체상에 외부 참조가 없는 것을 확인할 필요가 있습니다.

• 3.4 RowSetMetaDataImpl 역할

  RowsetMetaDataImpl 클래스는 RowSetMetaData 인터페이스의 구현을 제공하는 유틸리티 클래스이며, 접속되고 있을까 미접속일지 어떨지에 관계없이, 모든 RowSet 객체의 메타데이타에 표준의 설정 메서드 구현을 제공합니다. 모든 구현은 이 표준 구현을 자유롭게 이용할 수 있습니다만, 반드시 이용할 필요는 없습니다.

• 3.5 RowSetWarning 클래스

  RowSetWarning 클래스는 RowSet 구현으로 설정 가능한 경고를 제공합니다. SQLWarning 객체와 같게, RowSetWarning객체는 메세지를 표시하지 않고, 경고를 Throw 하는 메서드를 가지는 객체에 체인 됩니다. 모든 RowSet 구현은 경고가 생성되었을 경우에 이 체인이 발생하는 것으로JdbcRowSet인터페이스나 CachedRowSet인터페이스에 정의된 getRowSetWarnings 메서드로부터 경고를 사용할 수 있는 것을 확인할필요가 있습니다. getRowSetWarnings 메서드를 사용해 경고를 취득한 뒤, RowSetWarning 메서드 getNextWarning를 호출해, 체인 되는 경고를 취득할 수 있습니다 . 경고가 돌려주고졌을 경우는 그 이상 경고가 표시되지 않게 될 때까지, 반복 getNextWarning를 호출할 수 있습니다 .

• 3.6 조인 가능한 인터페이스

  Joinable인터페이스는 접속되고 있을까 미접속일까에 관계없이, 모든 RowSet 객체를, SQL JOIN 조작으로 JoinRowSet 객체에 추가할 수 있습니다 . Joinable인터페이스를 구현하고 있는 RowSet객체는 일치열의 설정, 일치열의 취득, 또는 일치열의 설정 해제를 실시할 수 있습니다 . JoinRowSet객체는 RowSet 객체의 일치열을 RowSet 객체를 추가하기 위한 기반으로서 이용할 수 있습니다 .

4.0 관련 사양

• JDBC 3.0 사양
• XML schema
• SyncML

5.0 관련 항목

• JDBC RowSet 튜토리얼