패키지 javax.sql

서버측의 데이터 소스 액세스에 대해, Java^TM 프로그램 언어로부터 처리하는 API 를 제공합니다.

참조:
설명

인터페이스의 개요

ConnectionEventListener	PooledConnection 오브젝트에 의해 생성된 이벤트가 통지되도록(듯이) 등록하는 오브젝트입니다.
ConnectionPoolDataSource	PooledConnection 오브젝트의 팩토리입니다.
DataSource	이 DataSource 오브젝트가 나타내는 물리 데이터 소스에의 접속에 대한 팩토리입니다.
PooledConnection	접속 풀 관리의 훅을 제공하는 오브젝트입니다.
RowSet	JavaBeansTM 컴퍼넌트 모델의 JDBC API 로 서포트되게 된 인터페이스입니다.
RowSetInternal	RowSet 오브젝트가 자신을 RowSetReader 오브젝트나 RowSetWriter 오브젝트에 건네주기 위해서(때문에) 구현하는 인터페이스입니다.
RowSetListener	RowSet 오브젝트의 유효기간중에 중요한 이벤트가 발생했을 때에 통지를 희망하는 컴퍼넌트에 의해 구현되고 있는 인터페이스입니다.
RowSetMetaData	RowSet 오브젝트의 열에 관한 정보를 저장하는 오브젝트입니다.
RowSetReader	절단 된 RowSet 오브젝트가, 열데이터 첨부로 자기 자신을 생성하기 위해서 호출하는 기능입니다.
RowSetWriter	RowSetWriter 인터페이스를 구현하는 오브젝트로, 「라이터」라고 불립니다.
XAConnection	분산 트랜잭션(transaction)를 서포트하는 오브젝트입니다.
XADataSource	내부에서 사용되는 XAConnection 오브젝트의 팩토리입니다.

클래스의 개요

ConnectionEvent	접속 관련의 이벤트의 소스에 관한 정보를 제공하는 Event 오브젝트입니다.
RowSetEvent	RowSet 오브젝트에 이벤트가 발생했을 때에 생성되는 Event 오브젝트입니다.

패키지 javax.sql 의 설명

서버측의 데이터 소스 액세스에 대해, Java^TM 프로그램 언어로부터 처리하는 API 를 제공합니다. 이 패키지에서는 java.sql 패키지를 보충해, 버젼 1.4 릴리스에서는 Java^TM 2 SDK 의 Standard Edition 에 포함되어 있습니다. 또, 여전히 Java 2 SDK, Enterprise Edition (J2EE^TM)의 필수 부분입니다.

java.sql 패키지는 다음의 용도의 API 를 제공합니다.

1. 데이터 소스와의 접속을 확립하기 위한 ,DriverManager 의 대체가 되는 DataSource 인터페이스
2. 접속 풀
3. 분산 트랜잭션(transaction)
4. 행 세트

어플리케이션에서는 DataSource API 와 RowSet API 를 직접 사용합니다만, 접속 풀 API 와 분산 트랜잭션(transaction) API 는 중간층 인프라스트럭쳐에 의해 내부적으로 사용됩니다.

DataSource 오브젝트를 사용한 접속의 작성

javax.sql 패키지에서는 데이터 소스와의 접속을 작성하기 위한 바람직한 방법을 제공하고 있습니다. 원의 기구인 DriverManager 클래스도 유효한 그대로여,DriverManager 클래스를 사용한 코드도 여전히 실행할 수 있습니다. 다만,DriverManager 기구보다 많은 이점이 있기 (위해)때문에, 새로운 DataSource 기구의 사용이 추천 되고 있습니다.

접속을 확립할 때에,DataSource 를 사용하는 주된 이점을 듭니다.

• 어플리케이션은 드라이버 클래스를 하드 코딩 할 필요가 없다
• 변경은 데이터 소스의 프로퍼티에 가세하면 좋다. 즉, 데이터 소스나 드라이버에 관한 변경이 맞았을 때에, 어플리케이션 코드를 변경할 필요가 없다
• 접속 풀과 분산 트랜잭션(transaction)는 중간층 인프라스트럭쳐로 동작하도록(듯이) 구현된 DataSource 오브젝트를 통해서 이용할 수 있다. DriverManager 에 의해 작성된 접속에는 접속 풀이나 분산 트랜잭션(transaction)라고 하는 기능이 없다

드라이버 벤더는 DataSource 의 구현을 제공합니다. DataSource 오브젝트안에는 특정의 물리 데이터 소스를 나타내는 것이 있어, 그러한 DataSource 오브젝트가 작성한 접속은 그 물리 데이터 소스에의 접속이 됩니다.

데이터 소스의 논리명은 통상 시스템 관리 책임자나 시스템 관리 책임자 작업을 실시하는 유저에 의해, Java Naming and Directory Interface^TM (JNDI) API 를 사용하는 네임 서비스로 등록됩니다. 등록된 논리명을 look 올라가는 것으로, 어플리케이션에서는 필요한 DataSource 오브젝트를 취득할 수 있습니다. 그리고, 취득한 DataSource 오브젝트를 사용해, 이 DataSource 오브젝트가 나타내는 물리 데이터 소스에의 접속을 작성합니다.

DataSource 오브젝트가 작성한 접속을 재이용하기 위해서 풀 할 수 있도록,DataSource 오브젝트는 중간층 인프라스트럭쳐로 동작하도록(듯이) 구현되고 있습니다. 그러한 DataSource 구현을 사용하는 어플리케이션에서는 접속 풀에 있는 접속을 자동적으로 취득합니다. 또,DataSource 오브젝트가 작성한 접속이 특별한 코딩을 하지 않아도 분산 트랜잭션(transaction)로 사용할 수 있게 하기 위해서도,DataSource 오브젝트가 중간층 인프라스트럭쳐로 동작하도록(듯이) 구현되고 있습니다.

접속 풀

중간층 접속 풀 관리 프로그램으로 동작하도록(듯이) 구현된 DataSource 오브젝트에 의해 작성된 접속은 접속 풀에 속합니다. 새로운 접속의 작성은 매우 부하가 큰 작업이기 (위해)때문에, 이것에 의해 퍼포먼스가 비약적으로 향상합니다. 접속 풀에서는 접속의 이용 및 재이용이 가능합니다. 그 때문에, 작성할 필요가 있는 신규 접속의 수는 실질적으로 삭감됩니다.

접속 풀은 완전하게 투과적입니다. J2EE 구성의 중간층으로 자동적으로 행해져 어플리케이션의 관점으로부터는 코드를 변경할 필요는 없습니다. 어플리케이션에서는 단지 DataSource.getConnection 메소드를 사용해 풀 된 접속을 취득해,Connection 오브젝트를 사용하는 것과 같은 방법으로 사용합니다.

접속 풀에 사용되는 클래스와 인터페이스는 다음과 같습니다.

• ConnectionPoolDataSource
• PooledConnection
• ConnectionEvent
• ConnectionEventListener

접속 풀 관리 프로그램은 3 층 아키텍쳐의 중간층으로 기능해, 이러한 클래스나 인터페이스를 배후에서 사용합니다. PooledConnection 오브젝트를 작성하기 위해서 ConnectionPoolDataSource 가 불려 가면(자), 접속 풀 관리 프로그램에 의해 새로운 PooledConnection 오브젝트가 ConnectionEventListener 오브젝트로서 등록됩니다. 접속이 닫혀질까 에러가 발생하면(자), 접속 풀 관리 프로그램 (청취자)이 ConnectionEvent 오브젝트를 포함한 통지를 받습니다.

분산 트랜잭션(transaction)

풀 된 접속과 같게, 중간층 인프라스트럭쳐로 동작하도록(듯이) 구현된 DataSource 오브젝트로 작성된 접속은 분산 트랜잭션(transaction)에도 참가합니다. 이것에 의해, 어플리케이션에서는 단일 트랜잭션(transaction)로 복수 서버상의 데이터 소스에 액세스 할 수 있게 됩니다.

분산 트랜잭션(transaction)에 사용되는 클래스와 인터페이스는 다음과 같습니다.

• XADataSource
• XAConnection

이러한 인터페이스는 트랜잭션(transaction) 매니저에 의해 사용되어 어플리케이션이 직접 사용할 것은 없습니다.

XAConnection 인터페이스는 PooledConnection 인터페이스로부터 파생하고 있기 (위해)때문에, 풀 된 접속에 들어맞는 것은 분산 트랜잭션(transaction)를 구성하는 접속에도 들어맞읍니다. 중간층에 있는 트랜잭션(transaction) 매니저는 모든 것을 투과적으로 처리합니다. 어플리케이션 코드를 변경한 것 만으로는 어플리케이션은 트랜잭션(transaction) 매니저에 의한 트랜잭션(transaction) 처리를 방해할 수 없습니다. 특히, 어플리케이션에서는 Connection.commit 메소드나 Connection.rollback 메소드를 호출할 수가 없습니다. 또, 접속을 자동 위탁 모드로 설정할 수도 있습니다 (즉,Connection.setAutoCommit(true) 를 호출할 수가 없다).

분산 트랜잭션(transaction)에 참가하기 위해서, 어플리케이션으로 특별히 실시할 필요가 있을 것은 없습니다. 통상 대로, 사용하는 데이터 소스에의 접속을 DataSource.getConnection 메소드로 작성하는 것만으로 끝납니다. 트랜잭션(transaction) 매니저는 트랜잭션(transaction)를 배후에서 관리합니다. XADataSource 인터페이스는 XAConnection 오브젝트를 작성해, 각 XAConnection 오브젝트는 트랜잭션(transaction) 매니저가 접속을 관리하기 위해서 사용하는 XAResource 오브젝트를 작성합니다.

행 세트

RowSet 인터페이스는 다른 다양한 클래스나 인터페이스와 함께 배후에서 동작합니다. 이러한 클래스나 인터페이스는 3 개의 카테고리로 나눌 수 있습니다.

1. 이벤트 통지
   • RowSetListener
RowSet 오브젝트는 JavaBeans 이벤트 통지 기구의 프로퍼티를 보관 유지해 이것에 참가하기 위해(때문에), JavaBeans^TM 의 컴퍼넌트이다고 말할 수 있습니다. RowSetListener 인터페이스는 특정의 RowSet 오브젝트에 발생하는 이벤트를 통지하는 컴퍼넌트에 의해 구현됩니다. 이런 종류의 컴퍼넌트는 자신을 청취자로 해,RowSet.addRowSetListener 메소드를 사용해 행 세트에 등록합니다.

     RowSet 오브젝트가 1 행을 변경, 전행을 변경, 또는 커서 위치를 이동하면(자), 이 RowSet 오브젝트로 등록된 각 청취자에게도 통지됩니다. 청취자는 불려 간 통지 메소드의 구현을 실행합니다.

   • RowSetEvent
     내부 통지 프로세스의 일부로서RowSet 오브젝트에서는 RowSetEvent 의 인스턴스를 작성해 청취자에게 건네줍니다. 청취자는 건네받은 RowSetEvent 오브젝트를 사용해, 어느 행 세트에 이벤트가 있는지를 검출합니다.

2. Metadata
   • RowSetMetaData
     이 인터페이스는 ResultSetMetaData 인터페이스로부터 파생하고 있어,RowSet 오브젝트의 열에 관한 정보를 제공합니다. 어플리케이션에서는 RowSetMetaData 메소드를 사용해, 행 세트에 포함되는 렬수나 각 열에 포함되는 데이터의 종류를 검출합니다.

     RowSetMetaData 인터페이스에서는 열에 관한 정보를 설정하는 메소드를 제공합니다만, 어플리케이션이 사용하는 것은 통상 없습니다. 어플리케이션이 RowSet 의 execute 메소드를 호출하면(자),RowSet 오브젝트는 행의 새로운 세트를 저장해,RowSetMetaData 오브젝트는 내부적으로 갱신되어, 새로운 열에 관한 정보를 포함하게 됩니다.

3. 리더/라이터 기능
   RowSetInternal 인터페이스를 구현하는 RowSet 오브젝트에서는 관련하는 RowSetReader 오브젝트로 호출하는 것으로, 데이터를 가지는 자신을 생성할 수가 있습니다. 또, 관련하는 RowSetWriter 로 호출하는 것으로, 행에 가세한 변경을, 그 행을 원래 취득했는데로부터 데이터 소스로 써 되돌릴 수가 있습니다. 데이터 소스에 접속한 채로의 행 세트에서는 데이터 소스를 직접 조작할 수가 있기 (위해)때문에, 리더나 라이터를 사용할 필요는 없습니다.
   • RowSetInternal
RowSetInternal 인터페이스를 구현하는 것으로,RowSet 오브젝트에서는 내부 상태에 액세스 할 수가 있어 리더나 라이터상에서 호출할 수가 있게 됩니다. 행 세트는 현재의 행과 원의 값으로 해서 참조되는 현재의 행의 직전에 있는 행의 값을 추적합니다. 또 (1) 커멘드용으로 설정된 파라미터와(2) 행 세트에게 건네진 접속 (존재하는 경우)도 추적합니다. 행 세트는 RowSetInternal 메소드를 배후에서 사용하는 것으로 이러한 정보에 액세스 합니다. 어플리케이션이 이러한 메소드를 직접 호출할 것은 없습니다.

   • RowSetReader
RowSetInternal 인터페이스를 구현하는 절단 된 RowSet 오브젝트는 리더 (RowSet 오브젝트에 관련지을 수 있었던 RowSetReader 오브젝트) 상에서 호출해, 데이터 첨부로 생성할 수 있습니다. 어플리케이션이 RowSet.execute 메소드를 호출하면(자), 이 메소드에 의해 행 세트의 리더가 불려 가 대부분의 작업을 실시합니다. 리더의 구현은 여러가지입니다만, 일반적으로는 데이터 소스에의 접속을 작성해, 데이터 소스로부터 데이터를 읽어들여, 그 데이터로 행 세트를 생성해, 접속을 닫습니다. 또, 리더는 RowSetMetaData 오브젝트를 행 세트에 대해서 갱신합니다. 행 세트의 내부 상태도, 리더인가,RowSet.execute 메소드에 의해 직접 갱신됩니다.
   • RowSetWriter
RowSetInternal 인터페이스를 구현하는 절단 된 RowSet 오브젝트는 라이터 (RowSet 오브젝트에 관련지을 수 있었던 RowSetWriter 오브젝트) 상에서 호출해, 변경을 기본이 되는 데이터 소스에 써 되돌립니다. 라이터의 구현은 여러가지입니다만, 일반적으로는 다음과 같이 동작합니다.
     • 데이터 소스에의 접속을 작성한다
     • 모순이 있을지 어떨지 즉, 행 세트내의 변경된 값이 데이터 소스라도 변경되고 있는지 어떤지를 확인한다
     • 모순이 없는 경우는 새로운 값을 데이터 소스에 기입한다
     • 접속을 닫는다

RowSet 인터페이스는 많은 방법으로 구현할 수 있어 누구나가 구현을 작성할 수 있습니다. 개발자는 자유롭게 상상력을 일하게 해 행 세트의 새로운 사용 방법을 찾아내는 것이 추천 되고 있습니다.

중요: 「도입된 버젼: 1.4」(이)라고 표시된 API 를 사용하는 코드는 JDBC 3.0 API 를 구현하는 JDBC 테크놀러지 드라이버를 사용해 실행할 필요가 있습니다. 사용하려고 하는 특정의 기능을 드라이버가 구현하고 있을지 어떨지를, 드라이버의 문서로 확인해 주세요.

패키지의 사양

• 「JDBC 3.0 API 의 사양」

관련 항목

Addison-Wesley Longman 로부터 출판되고 있는 Java Series 북에서는 javax.sql 패키지의 클래스나 인터페이스에 관한 상세한 정보를 참조할 수 있습니다.

• 「JDBC^TM API Tutorial and Reference, Second Edition: Universal Data Access for the Java 2 Platform」

도입된 버젼:

1.4