javax.sql.rowset.spi
클래스 SyncFactory

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

public class SyncFactory
extends Object 

미접속의 RowSet객체에 의해 사용되는 SyncProvider인스탄 스를 생성하는 서비스 프로바이더 인터페이스 (Service Provider Interface, SPI) 도구 입니다. SyncProvider이 스탄스는 RowSet객체가 자신에게 데이터를 이식하기 위해서 필요한 javax.sql.RowSetReader오 브제크트라고 변경된 데이터를 부하의 데이터 소스에 건네주기 위해서 필요한 javax.sql.RowSetWriter오 브제크트를 제공합니다.

SyncFactory 클래스의 메서드는 모두 static 이므로 Java VM 마다 동시에 복수의 SyncFactory 객체가 존재할 수 없습니다. 이 때문에 RowSet 구현은 항상 단일의 소스로부터 SyncProvider 구현을 취득하게 됩니다.

1.0 개요

SyncFactory클래스는 사용 가능한 동기 프로바이더 구현 (SyncProvider오 브제크트) 의 내부 레지스트리를 제공합니다. 이 레지스트리를 조회하는 것으로 사용 가능한 동기 프로바이더를 확인할 수 있습니다. 이하는 현재 등록되어 있는 프로바이더를 열거 하는 코드입니다.

 java.util.Enumeration e = SyncFactory.getRegisteredProviders();

모든 표준 RowSet구현은 적어도 다음의 2개의 프로바이더를 제공할 필요가 있습니다.

• CachedRowSet 구현 또는 이 구현으로부터 파생한 구현용의 최적의 프로바이더
• XML 독해와 출력에 사용되는 XML 프로바이더 (WebRowSet 객체 등)

JDBC RowSet 구현에는 이 요건을 채우는 SyncProvider구현 RIOptimisticProvider 불러 RIXmlProvider가 포함되는 점에 주의해 주세요.

SyncFactory 클래스는 어플리케이션이 현재 SyncFactory에 등록되어 있는 동기 프로바이더를 확인하기 위해서 도움이 되는 액세스용 메서드를 제공합니다.

그 외의 메서드에는 RowSet 지속 프로바이더를 팩토리 도구에 등록하거나 등록을 해제하거나 하는 기능이 있습니다. 이 때문에 RowSet 객체는 실행시에 그 외의 동기 프로바이더 구현도 사용할 수 있습니다 .

어플리케이션은 필터링의 단계를 적용하는 것으로SyncProvider 구현이 제공하는 동기의 레벨을 확정할 수 있습니다. RowSet 객체가 프로바이더를 사용할 수 있을지 어떨지는 다음의 기준으로 결정됩니다.

1. RowSet 객체에 의해 지정된 특정의 프로바이더의 참조가SyncFactory에 포함되지 않는 경우, 동기 프로바이더가 발견되지 않는 것을 나타내는 SyncFactoryException가 Throw 된다

2. RowSet 구현이 등록을 마친 특정의 프로바이더에 의해 인스턴스화 되는 경우, 요구된 프로바이더가 제공된다. 그렇지 않은 경우는 SyncFactoryException 하지만 Throw 된다

3. RowSet 객체가 SyncProvider 구현을 지정하지 않고, 그 외에 이용 가능한 SyncProvider 구현이 존재하지 않는 경우, 레퍼런스 구현 프로바이더가 제공된다

2.0 SyncProvider 구현의 등록

벤더도 개발자도, 다음의 몇개의 도구를 사용해 SyncProvider 구현을 등록할 수 있습니다.

• 커멘드행의 사용
  커멘드행에 프로바이더명을 지정해, 시스템 프로퍼티에 프로바이더를 추가할 수 있습니다 . 이하에 예를 나타냅니다.

    -Drowset.provider.classname=com.fred.providers.HighAvailabilityProvider

• 표준 프로퍼티 파일의 사용
  레퍼런스 구현은 J2SE 5.0에 부속되어 출시되게 되어 있습니다. 이것에는 수동으로 편집 가능한 그 외의 resource file도 포함됩니다. 이하에 레퍼런스 구현에 포함되는 프로파 티파일의 예를 나타냅니다.

   #Default JDBC RowSet sync providers listing #
  
  # Optimistic synchronization provider rowset.provider.classname. 0=com.sun.rowset.providers.RIOptimisticProvider rowset.provider.vendor. 0=Sun Microsystems Inc rowset.provider.version. 0=1. 0    # XML Provider using standard XML schema rowset.provider.classname. 1=com.sun.rowset.providers.RIXMLProvider rowset.provider.vendor. 1=Sun Microsystems Inc.  rowset.provider.version. 1=1. 0

  SyncFactory는 이 파일을 체크해, 거기에 포함되는 SyncProvider 구현을 등록합니다. 개발자나 벤더는 이 파일에 그 외의 구현을 추가할 수 있습니다. 이하에 예를 나타냅니다.

   rowset.provider.classname. 2=com.fred.providers.HighAvailabilityProvider rowset.provider.vendor. 2=Fred, Inc.  rowset.provider.version. 2=1. 0 

• JNDI 컨텍스트 의 사용
  사용 가능한 프로바이더를 JNDI 컨텍스트에 등록하면, SyncFactory는 이 JNDI 컨텍스트 으로부터 SyncProvider 구현을 로드하려고 합니다. 예를 들어이하에 JNDI 컨텍스트에 프로바이더 구현을 1개 등록하는 코드의 발췌를 나타냅니다. 보통, 이 처리는 데프로이야가 실시합니다. 이 예에서는 J2EE 자원에 의해 사용되는 CosNaming 네임 스페이스에 MyProvider가 등록됩니다.

   import javax.naming. *;
       Hashtable svrEnv = new  Hashtable();
   srvEnv.put(Context.INITIAL_CONTEXT_FACTORY, "CosNaming");
  
  Context ctx = new InitialContext(svrEnv); com.fred.providers.MyProvider = new MyProvider(); ctx.rebind("providers/MyProvider", syncProvider);

다음에 어플리케이션에의해 JNDI 컨텍스트이 SyncFactory인스턴스에 등록됩니다. 이것에, SyncFactory는 JNDI 컨텍스트 내를 브라우즈 해, SyncProvider열매 장을 검색할 수 있게 됩니다.

 Hashtable appEnv = new Hashtable();
 appEnv.put(Context.INITIAL_CONTEXT_FACTORY, "CosNaming");
 appEnv.put(Context.PROVIDER_URL, "iiop://hostname/providers");
 Context ctx = new InitialContext(appEnv);

SyncFactory.registerJNDIContext(ctx);

RowSet객체가 MyProvider객체의 취득을 시도하는 경우, SyncFactory는이것을 검출하려고 합니다. 최초로 시스템 프로퍼티내를 검색해, 다음에 resource file내를 검색해, 최종적으로는 설정되어 있는 JNDI 컨텍스트를 체크합니다. SyncFactory인스턴스는 요구된 프로바이더가 SyncProvider추 코끼리 클래스의 유효한 확장인 것을 확인해, RowSet객체에 건네줍니다. 아래의 코드의 발췌에서는 새로운 CachedRowSet오 브제크트를 작성해, MyProvider의 바인딩을 포함한 env로 초기화합니다.

 Hashtable env = new Hashtable();
 env.put(SyncFactory.ROWSET_SYNC_PROVIDER, "com.fred.providers.MyProvider");
 CachedRowSet crs = new com.sun.rowset.CachedRowSetImpl(env);

이러한 도구 의 상세한 것에 대하여는 javax.sql.rowset.spi패키지의 사양을 참조하십시오.

관련 항목:

SyncProvider, SyncFactoryException

필드 개요

static String	ROWSET_SYNC_PROVIDER 동기 프로바이더의 구현명을 나타내는 표준 프로퍼티 ID 입니다.
static String	ROWSET_SYNC_PROVIDER_VERSION 동기 프로바이더의 구현의 버전 태그를 나타내는 표준 프로퍼티 ID 입니다.
static String	ROWSET_SYNC_VENDOR 동기 프로바이더의 벤더명을 나타내는 표준 프로퍼티 ID 입니다.

메서드 개요

static SyncProvider	getInstance (String providerID) providerID로 식별되는 SyncProvider인스턴스를 리턴합니다.
static Logger	getLogger () 어플리케이션이 SyncProvider 구현에 의해 표시된 동기 이벤트를 취득하기 위해서 필요한 로그 객체를 리턴합니다.
static Enumeration <SyncProvider >	getRegisteredProviders () 현재 등록되어 있는 동기 프로바이더를 열거합니다.
static SyncFactory	getSyncFactory () SyncFactory싱글 톤을 리턴합니다.
static void	registerProvider (String providerID) 지정된 동기 프로바이더를 팩토리 레지스터에 추가합니다.
static void	setJNDIContext (Context ctx) JNDI 이름 공간으로부터 SyncProvider 구현을 얻는 초기 JNDI 컨텍스트를 설정합니다.
static void	setLogger (Logger logger) SyncFactory이 제공하는 SyncProvider구현에 의해 사용되는 로그오 브제크트를 설정합니다.
static void	setLogger (Logger logger, Level level) SyncFactorySPI가 제공하는 SyncProvider구현에 의해 사용되고 로그 객체를 설정합니다.
static void	unregisterProvider (String providerID) 현재 등록되어 있는 지정의 동기 프로바이더를 팩토리 SPI 레지스터로부터 삭제합니다.

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

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

필드의 상세

ROWSET_SYNC_PROVIDER

public static String  ROWSET_SYNC_PROVIDER

동기 프로바이더의 구현명을 나타내는 표준 프로퍼티 ID 입니다.

ROWSET_SYNC_VENDOR

public static String  ROWSET_SYNC_VENDOR

동기 프로바이더의 벤더명을 나타내는 표준 프로퍼티 ID 입니다.

ROWSET_SYNC_PROVIDER_VERSION

public static String  ROWSET_SYNC_PROVIDER_VERSION

동기 프로바이더의 구현의 버전 태그를 나타내는 표준 프로퍼티 ID 입니다.

메서드의 상세

registerProvider

public static void registerProvider(String  providerID)
                             throws SyncFactoryException 

지정된 동기 프로바이더를 팩토리 레지스터에 추가합니다. SyncProvider구현이 필요로 하는 명명 규칙의 가이드라이에 대해서는 SyncProvider사양을 참조하십시오.

JNDI 컨텍스트에 바인드 된 동기 프로바이더를 등록하려면, SyncProvider 인스턴스를 JNDI이름 공간에 바인드 합니다.

 SyncProvider p = new MySyncProvider();
 InitialContext ic = new InitialContext();
 ic.bind ("jdbc/rowset/MySyncProvider", p);
 

게다가 JNDI 컨텍스트은, setJNDIContext메서드에 의해 SyncFactory에 초기설정 됩니다. SyncFactory는 이 컨텍스트를 이용해, JNDI 컨텍스트과 그자식 노드에 바인드 된 사용 가능한 SyncProvider객체를 검색합니다.

파라미터:

providerID - 등록되는 동기 프로바이더의 일의의 ID를 가지는 String 객체

예외:

SyncFactoryException - 공백 또는 null 프로바이더명을 돌려주는 처리가 시행되었을 경우

관련 항목:

setJNDIContext(javax.naming.Context)

getSyncFactory

public static SyncFactory  getSyncFactory()

SyncFactory싱글 톤을 리턴합니다.

반환값:

SyncFactory인스턴스

unregisterProvider

public static void unregisterProvider(String  providerID)
                               throws SyncFactoryException 

현재 등록되어 있는 지정의 동기 프로바이더를 팩토리 SPI 레지스터로부터 삭제합니다.

파라미터:

providerID - 동기 프로바이더의 일의의 ID

예외:

SyncFactoryException - 미등록의 SyncProvider 구현의 등록을 해제하는 처리가 시행되었을 경우

getInstance

public static SyncProvider  getInstance(String  providerID)
                                throws SyncFactoryException 

providerID로 식별되는 SyncProvider인스턴스를 리턴합니다.

파라미터:

providerID - 일의의 프로바이더 식별자

반환값:

SyncProvider 구현

예외:

SyncFactoryException - SyncProvider가 발견되지 않는 경우, 또는 이 프로바이더의 호출시에 어떠한 에러가 발생했을 경우

getRegisteredProviders

public static Enumeration <SyncProvider > getRegisteredProviders()
                                                        throws SyncFactoryException 

현재 등록되어 있는 동기 프로바이더를 열거합니다. RowSet구현은 열거된 프로바이더의 어느쪽이든을 SyncProvider오 브제크트로서 사용할 수 있습니다.

최소한, JDBC 드라이버를 사용해 RowSet 컨텐츠 데이터를 포함할 수 있도록 하는 참조 동기 프로바이더를 사용할 수 있습니다.

반환값:

열거. 이 팩토리에 등록되어 있는 사용 가능한 동기 프로바이더의 열거

예외:

SyncFactoryException

setLogger

public static void setLogger(Logger  logger)

SyncFactory이 제공하는 SyncProvider구현에 의해 사용되는 로그오 브제크트를 설정합니다. 모든 SyncProvider구현은 이 객체에 이벤트를 기록할 수 있습니다. 어플리 케이 숀은, getLogger메서드를 사용해 이 객체의 핸들을 취득할 수 있습니다.

파라미터:

logger - Logger 객체 인스턴스

setLogger

public static void setLogger(Logger  logger,
                             Level  level)

SyncFactorySPI가 제공하는 SyncProvider구현에 의해 사용되고 로그 객체를 설정합니다. 모든 SyncProvider구현은 이 객체에 이벤트를 기록할 수 있습니다. 어플리케이션은, getLogger메서드를 사용해 이 객체의 핸들을 취득할 수 있습니다.

파라미터:

logger - Logger 객체 인스턴스

level - 필요한 로그의 단계를 나타내는 Level 객체 인스턴스

getLogger

public static Logger  getLogger()
                        throws SyncFactoryException 

어플리케이션이 SyncProvider 구현에 의해 표시된 동기 이벤트를 취득하기 위해서 필요한 로그 객체를 리턴합니다.

예외:

SyncFactoryException - 로그 객체가 설정되어 있지 않은 경우

setJNDIContext

public static void setJNDIContext(Context  ctx)
                           throws SyncFactoryException 

JNDI 이름 공간으로부터 SyncProvider 구현을 얻는 초기 JNDI 컨텍스트를 설정합니다.

파라미터:

ctx - 유효한 JNDI 컨텍스트

예외:

SyncFactoryException - 지정된 JNDI 컨텍스트이 null인 경우