javax.sql.rowset.spi
클래스 SyncProvider

java.lang.Object 
  javax.sql.rowset.spi.SyncProvider

public abstract class SyncProvider
extends Object 

미접속의 RowSet 객체의 읽어내/출력 기능을 제공하는 동기도구 입니다. SyncProvider 구현은, SyncProvider 추상 클래스를 확장하는 클래스입니다.

SyncProvider 구현은 일의의 ID (이 구현의 완전 수식 클래스명)로 식별됩니다. 이 이름을 SyncFactory SPI에 등록해, 모든 RowSet 구현으로 사용할 수 있도록 할 필요가 있습니다. 이 레퍼런스 구현의 팩토리 도구는 이 이름을 사용해 구현을 인스턴스화합니다. 이것에 의해 RowSet 객체와 그 리더 (javax.sql.RowSetReader 객체) 및 라이터 (javax.sql.RowSetWriter 객체)를 제공할 수 있습니다.

JDBC RowSet 구현 사양에서는 SyncProvider 추상 클래스의 2개의 레퍼런스 구현 (RIOptimisticProvider와 RIXMLProvider)을 제공하고 있습니다. RIOptimisticProvider는 RowSetReader 객체와 RowSetWriter 객체에의해 모든 RowSet 구현을 설정할 수 있습니다. 다만, XmlReader 객체와 XmlWriter 객체를 설정할 수 있는 것은, RIXMLProvider 구현 뿐입니다. WebRowSet객체는 XmlReader 객체를 사용해, XML 형식에서 데이터를 읽어내, 데이터를 자신에게 포함합니다. 또, XmlWriter 객체를 사용해, 자신을 XML 형식에서 스트림 또는 java.io.Writer 객체에 자신을 출력합니다.

1.0 구현의 명명 규칙

SyncProvider 구현의 명명시에는 다음의 항목을 고려할 필요가 있습니다.

• SyncProvider 구현의 이름은 완전 수식 클래스명
• 벤더는 SyncProvider 구현을 providers 라는 이름의 패키지에 포함해 제공한다 (추천)

예를 들어 Fred, Inc. (이)라는 이름의 벤더가 제공하는 SyncProvider 구현의 경우, 다음과 같이 됩니다.

 Vendor name:  Fred, Inc.       Domain name of vendor:  com.fred Package name:  com.fred.providers SyncProvider implementation class name:  HighAvailabilityProvider
Fully qualified class name of SyncProvider implementation: com.fred.providers.HighAvailabilityProvider

다음의 예에서는 완전 수식명을 사용해, 이 구현을 SyncFactory 정적 인스턴스에 등록합니다.

 SyncFactory.registerProvider( "com.fred.providers.HighAvailabilityProvider");

레퍼런스 구현에 의해 제공되는 디폴트의 SyncProvider객체는 다음의 이름을 사용합니다.

     com.sun.rowset.providers.RIOptimisticProvider 
 

SyncProvider 구현 클래스명을 Sun Microsystems, Inc.에 등록하고 싶은 벤더는 jdbc@sun.com 까지 전자 메일에서 연락해 주십시오. Sun는 RowSet 준거 구현으로 사용할 수 있는 SyncProvider 구현의 일람을 데이타베이스로 관리하고 있습니다. 이 데이타베이스는 사용 가능한 JDBC 드라이버의 데이타베이스와 자주 닮았습니다.

벤더는 레퍼런스 구현 동기 프로바이더를 참조해, 새로운 SyncProvider 구현의 구현 방법의 상세를 확인해 주세요.

2.0 RowSet 객체가 프로바이더를 얻는 순서

미접속의 Rowset객체는 다음의 몇개의 방법으로SyncProvider 객체의 액세스를 취득할 수 있습니다.

• 생성자를 사용

   CachedRowSet crs = new CachedRowSet( "com.fred.providers.HighAvailabilitySyncProvider");

• setSyncProvider 메서드를 사용

   CachedRowSet crs = new CachedRowSet();  crs.setSyncProvider("com.fred.providers.HighAvailabilitySyncProvider");  

Java 플랫폼에서는 디폴트로RowSet 동기 프로바이더의 레퍼런스 구현을 항상 사용할 수 있습니다. 그 외의 플러그 인 가능한 동기 프로바이더가 정상적으로 등록되지 않은 경우, SyncFactory는 자동적으로 디폴트의 SyncProvider 레퍼런스 구현의 인스턴스를 생성합니다. 이 때문에 상기의 코드의 발췌에서는 SyncFactory인스턴스에 com.fred.providers.HighAvailabilitySyncProvider 라는 이름의 구현이 등록되지 않은 경우, crs 에는 레퍼런스 구현내의 디폴트의 프로바이더 com.sun.rowset.providers.RIOptimisticProvider를 할당할 수 있습니다.

3.0 위반과 동기의 문제

미접속의 RowSet 객체와 데이터 소스간의 갱신이 원의 쿼리또는 부하의 데이터 소스의 제약에 위반했을 경우, 미접속의 모든 RowSet 구현과 지정된 SyncProvider 구현의 동작은 예측 불가능이 됩니다. 이와 같이, 위반이 있었을 때의 동작을 정의하지 않는 것으로SyncProvider 구현은 최선의 대처 방법을 독자적으로 결정할 수 있습니다 .

SyncProvider 구현은 쿼리위반의 부분집합을 처리하는 핸들러를 구현할 수 있습니다 . 그러나, SyncProvider 구현으로 원의 쿼리위반 또는보다 일반적인 데이터 소스 제약 위반이 처리되지 않는 경우, 모든 SyncProvider객체는 SyncProviderException을 Throw 할 필요가 있습니다.

4.0 갱신 가능한 SQL 뷰

미접속 또는 접속 끝난 모든 RowSet객체는 SQL VIEW를 기본으로 작성된 SQL 쿼리로부터 이식 가능합니다. 그러나, 많은 경우, 갱신은 부하의 뷰에 대해서 실행되므로 추가로서 각종 메타데이타가 필요하게 됩니다. SyncProvider 클래스는 구현이 SQL VIEW 갱신을 지원 할지 어떨지를 나타내는 2개의 정수를 제공합니다.

• NONUPDATABLE_VIEW_SYNC - SyncProvider 구현은 부하의 RowSet 객체의 데이터 소스로서 SQL VIEW와 의 동기를 지원 하지 않는다
• UPDATABLE_VIEW_SYNC - SyncProvider 구현은 부하의 데이터 소스로서 SQL VIEW와 의 동기를 지원 한다

SQL VIEW 데이터가 이식되었을 경우, 디폴트로RowSet객체는 갱신 불가능이 됩니다.

5.0 SyncProvider 정수

SyncProvider 클래스는 SyncProvider 메서드의 반환값 또는 파라미터로서 사용되는 3개의 정수를 제공합니다. SyncProvider 객체를 구현해, RowSet 객체와 그 부하의 데이터 소스를 다양한 레벨로 동기 할 수 있습니다 . 최초의 정수 그룹은 동기의 처리 방법을 나타냅니다. 예를 들어, GRADE_NONE는 SyncProvider 객체가 유효한 데이터인지를 확인하지 않고, 단순하게 RowSet 데이터를 데이터 소스에 출력하는 것을 나타냅니다. GRADE_MODIFIED_AT_COMMIT는 프로바이더에의해 변경된 데이터만을 대상으로 타당성 검사를 하는 것을 나타냅니다. 이 외, 모든 데이터의 타당성 검사를 실시하는 그레이드나, 데이터가 변경 또는 로드 되었을 때 락을 적용하는 그레이드가 있습니다.

1. SyncProvider 객체의 동기의 그레이드를 나타내는 정수
   • SyncProvider.GRADE_NONE
   • SyncProvider.GRADE_MODIFIED_AT_COMMIT
   • SyncProvider.GRADE_CHECK_ALL_AT_COMMIT
   • SyncProvider.GRADE_LOCK_WHEN_MODIFIED
   • SyncProvider.GRADE_LOCK_WHEN_LOADED
2. 데이터 소스로 설정하는 락을 나타내는 정수
   • SyncProvider.DATASOURCE_NO_LOCK
   • SyncProvider.DATASOURCE_ROW_LOCK
   • SyncProvider.DATASOURCE_TABLE_LOCK
   • SyncProvider.DATASOURCE_DB_LOCK
3. SyncProvider 객체가 SQL VIEW 갱신을 실행할 수 있을지 어떨지를 나타내는 정수
   이러한 정수에 대해서는 섹션 4.0을 참조
   • SyncProvider.UPDATABLE_VIEW_SYNC
   • SyncProvider.NONUPDATABLE_VIEW_SYNC

관련 항목:

SyncFactory, SyncFactoryException

필드 개요

static int	DATASOURCE_DB_LOCK 이 SyncProvider 객체를 사용하고 있는 RowSet 객체의 데이터 소스가 되어 있는 데이터 전체에 락이 설정되는 것을 나타냅니다.
static int	DATASOURCE_NO_LOCK 원래의 데이터 소스상에 락이 보관 유지되지 않는 것을 나타냅니다.
static int	DATASOURCE_ROW_LOCK 이 SyncProvider 객체를 사용하고 있는 RowSet 객체의 이식에 사용된 원의 SQL 문의 영향을 받는 행에 락이 설정되는 것을 나타냅니다.
static int	DATASOURCE_TABLE_LOCK 이 SyncProvider 객체를 사용하고 있는 RowSet 객체의 이식에 사용된 원의 SQL 문의 영향을 받는 모든 테이블에 락이 설정되는 것을 나타냅니다.
static int	GRADE_CHECK_ALL_AT_COMMIT 원래의 데이터 소스의 고레벨의 오프티미스틱 병행 동기의 그레이드를 나타냅니다.
static int	GRADE_CHECK_MODIFIED_AT_COMMIT 원래의 데이터 소스의 저레벨의 오프티미스틱 병행 동기의 그레이드를 나타냅니다.
static int	GRADE_LOCK_WHEN_LOADED 원래의 데이터 소스의 염세적인 병행 동기의 그레이드를 나타냅니다.
static int	GRADE_LOCK_WHEN_MODIFIED 원래의 데이터 소스의 염세적인 병행 동기의 그레이드를 나타냅니다.
static int	GRADE_NONE 원의 데이터 소스와의 동기가 일절 행해지지 않는 것을 나타냅니다.
static int	NONUPDATABLE_VIEW_SYNC SyncProvider 구현이 RowSet 객체와 그 이식에 사용된 SQL VIEW 간의 동기를 지원 하지 않는것을 나타냅니다.
static int	UPDATABLE_VIEW_SYNC SyncProvider 구현이 RowSet 객체와 그 이식에 사용된 SQL VIEW 간의 동기를 지원하는 것을 나타냅니다.

생성자 개요

SyncProvider ()
디폴트의 SyncProvider 객체를 작성합니다.

메서드 개요

abstract int	getDataSourceLock () 이 SyncProvider 구현내에서 현재 사용되고 있는 데이터 소스 락의 레벨을 리턴합니다.
abstract int	getProviderGrade () 이 SyncProvider 객체가 RowSet 객체에 제공할 수 있는 동기의 그레이드를 나타내는 정수를 리턴합니다.
abstract String	getProviderID () 이 SyncProvider 객체를 나타내는 일의의 식별자를 리턴합니다.
abstract RowSetReader	getRowSetReader () javax.sql.RowSetReader 객체를 리턴합니다.
abstract RowSetWriter	getRowSetWriter () javax.sql.RowSetWriter 객체를 리턴합니다.
abstract String	getVendor () 이 SyncProvider인스턴스의 벤더명을 리턴합니다.
abstract String	getVersion () 이 SyncProvider인스턴스의 릴리스 버전을 리턴합니다.
abstract void	setDataSourceLock (int datasource_lock) 부하의 데이터 소스에 datasource_lock 로 지정된 레벨의 락을 설정합니다.
abstract int	supportsUpdatableView () 이 SyncProvider 구현이 RowSet 객체와 이 RowSet 객체가 데이터의 취득처로서 사용하는 데이터 소스내의 SQL VIEW 동기의 실행이 가능한가 어떤가를 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

필드의 상세

GRADE_NONE

public static int GRADE_NONE

원의 데이터 소스와의 동기가 일절 행해지지 않는 것을 나타냅니다. 이 그레이드를 돌려주는 SyncProvider 구현은, RowSet 객체내의 갱신 내용을 데이터의 타당성 검사를 실시하지 않고 부하의 데이터 소스에 출력합니다.

GRADE_CHECK_MODIFIED_AT_COMMIT

public static int GRADE_CHECK_MODIFIED_AT_COMMIT

원래의 데이터 소스의 저레벨의 오프티미스틱 병행 동기의 그레이드를 나타냅니다.이 그레이드를 돌려주는 SyncProvider 구현은 변경된 행만을 체크합니다.

GRADE_CHECK_ALL_AT_COMMIT

public static int GRADE_CHECK_ALL_AT_COMMIT

원래의 데이터 소스의 고레벨의 오프티미스틱 병행 동기의 그레이드를 나타냅니다.이 그레이드를 돌려주는 SyncProvider 구현은 변경되어 있지 않은 것도 포함해 모든 행을 체크합니다.

GRADE_LOCK_WHEN_MODIFIED

public static int GRADE_LOCK_WHEN_MODIFIED

원래의 데이터 소스의 염세적인 병행 동기의 그레이드를 나타냅니다.이 그레이드를 돌려주는 SyncProvider 구현은 원래의 데이터 소스내의 행을 잠급니다.

GRADE_LOCK_WHEN_LOADED

public static int GRADE_LOCK_WHEN_LOADED

원래의 데이터 소스의 염세적인 병행 동기의 그레이드를 나타냅니다. 무엇보다 염세적인 (비관적)인 그레이드입니다. 이 그레이드를 돌려주는 SyncProvider 구현은, RowSet 객체의 이식에 사용된 원의 문장의 영향을 받는 뷰 및 테이블, 또는 그 어느쪽이든 전체를 잠급니다.

DATASOURCE_NO_LOCK

public static int DATASOURCE_NO_LOCK

원래의 데이터 소스상에 락이 보관 유지되지 않는 것을 나타냅니다. RowSet 객체의 관리하에 있는 것을 제외하는 모든 SyncProvider 구현의 디폴트의 락 설정입니다.

DATASOURCE_ROW_LOCK

public static int DATASOURCE_ROW_LOCK

이 SyncProvider 객체를 사용하고 있는 RowSet 객체의 이식에 사용된 원의 SQL 문의 영향을 받는 행에 락이 설정되는 것을 나타냅니다.

DATASOURCE_TABLE_LOCK

public static int DATASOURCE_TABLE_LOCK

이 SyncProvider 객체를 사용하고 있는 RowSet 객체의 이식에 사용된 원의 SQL 문의 영향을 받는 모든 테이블에 락이 설정되는 것을 나타냅니다.

DATASOURCE_DB_LOCK

public static int DATASOURCE_DB_LOCK

이 SyncProvider 객체를 사용하고 있는 RowSet 객체의 데이터 소스가 되어 있는 데이터 전체에 락이 설정되는 것을 나타냅니다.

UPDATABLE_VIEW_SYNC

public static int UPDATABLE_VIEW_SYNC

SyncProvider 구현이 RowSet 객체와 그 이식에 사용된 SQL VIEW 간의 동기를 지원하는 것을 나타냅니다.

NONUPDATABLE_VIEW_SYNC

public static int NONUPDATABLE_VIEW_SYNC

SyncProvider 구현이 RowSet 객체와 그 이식에 사용된 SQL VIEW 간의 동기를 지원 하지 않는것을 나타냅니다.

생성자 상세

SyncProvider

public SyncProvider()

디폴트의 SyncProvider 객체를 작성합니다.

메서드의 상세

getProviderID

public abstract String  getProviderID()

이 SyncProvider 객체를 나타내는 일의의 식별자를 리턴합니다.

반환값:

이 SyncProvider 객체의 완전 수식 클래스명을 가지는 String 객체

getRowSetReader

public abstract RowSetReader  getRowSetReader()

javax.sql.RowSetReader 객체를 리턴합니다. 이 객체는 RowSet 객체에 데이터를 이식하기 위해서 사용할 수 있습니다.

반환값:

javax.sql.RowSetReader 객체

getRowSetWriter

public abstract RowSetWriter  getRowSetWriter()

javax.sql.RowSetWriter 객체를 리턴합니다. 이 객체는 RowSet 객체의 데이터를 부하의 데이터 소스에 재차 출력하기 위해서 사용할 수 있습니다.

반환값:

javax.sql.RowSetWriter 객체

getProviderGrade

public abstract int getProviderGrade()

이 SyncProvider 객체가 RowSet 객체에 제공할 수 있는 동기의 그레이드를 나타내는 정수를 리턴합니다.

반환값:

SyncProvider.GRADE_NONE, SyncProvider.GRADE_CHECK_MODIFIED_AT_COMMIT, SyncProvider.GRADE_CHECK_ALL_AT_COMMIT, SyncProvider.GRADE_LOCK_WHEN_MODIFIED, SyncProvider.GRADE_LOCK_WHEN_LOADED 몇개의 정수 int

setDataSourceLock

public abstract void setDataSourceLock(int datasource_lock)
                                throws SyncProviderException 

부하의 데이터 소스에 datasource_lock 로 지정된 레벨의 락을 설정합니다. 이것에 의해 SyncProvider는 동기 처리를 정상적으로 완료할 수 있도록 오프티미스틱인 레벨 (낙관도)을 조절해, 그 동작을 조정합니다.

파라미터:

datasource_lock - 필요한 데이터 소스 락의 중요도 레벨을 나타내는 다음의 몇개의 정수

           SyncProvider.DATASOURCE_NO_LOCK,
           SyncProvider.DATASOURCE_ROW_LOCK,
           SyncProvider.DATASOURCE_TABLE_LOCK,
           SyncProvider.DATASOURCE_DB_LOCK,          
 

예외:

SyncProviderException - 설정된 데이터 소스 락의 레벨이 지원 되어 있지 않은 경우

관련 항목:

getDataSourceLock()

getDataSourceLock

public abstract int getDataSourceLock()
                               throws SyncProviderException 

이 SyncProvider 구현내에서 현재 사용되고 있는 데이터 소스 락의 레벨을 리턴합니다.

반환값:

이 SyncProvider 객체로 현재 사용되고 있는 데이터 소스 락의 레벨을 나타내는 정수. 다음의 언젠가된다

           SyncProvider.DATASOURCE_NO_LOCK,
           SyncProvider.DATASOURCE_ROW_LOCK,
           SyncProvider.DATASOURCE_TABLE_LOCK,
           SyncProvider.DATASOURCE_DB_LOCK     
 

예외:

SyncProviderExceptiom - 데이터 소스 락의 레벨의 결정시에 에러가 발생했을 경우

SyncProviderException

관련 항목:

setDataSourceLock(int)

supportsUpdatableView

public abstract int supportsUpdatableView()

이 SyncProvider 구현이 RowSet 객체와 이 RowSet 객체가 데이터의 취득처로서 사용하는 데이터 소스내의 SQL VIEW 동기의 실행이 가능한가 어떤가를 리턴합니다.

반환값:

이 SyncProvider 객체가 SQL VIEW 갱신을 지원 할지 어떨지를 나타내는 int. SyncProvider.UPDATABLE_VIEW_SYNC 또는 SyncProvider.NONUPDATABLE_VIEW_SYNC

getVersion

public abstract String  getVersion()

이 SyncProvider인스턴스의 릴리스 버전을 리턴합니다.

반환값:

SyncProvider 구현의 릴리스 버전을 나타내는 String

getVendor

public abstract String  getVendor()

이 SyncProvider인스턴스의 벤더명을 리턴합니다.

반환값:

SyncProvider 구현의 벤더명을 나타내는 String