XAConnectionBuilder

XAConnectionBuilder (XA 연결 빌더)

XADataSource 객체에서 생성되는 빌더로, 데이터 소스 객체가 나타내는 데이터베이스에 연결을 수립하는 데 사용됩니다.

출처: Java API Reference

본문

데이터 소스에 지정된 연결 속성은 XAConnectionBuilder의 기본값으로 사용됩니다. 즉, 빌더에서 별도로 값을 지정하지 않으면 데이터 소스에 설정된 속성이 그대로 적용됩니다.

다음 예시는 XAConnectionBuilder를 사용해 XAConnection을 만드는 방법을 보여줍니다.

XADataSource ds = new MyXADataSource();
ShardingKey superShardingKey = ds.createShardingKeyBuilder()
    .subkey("EASTERN_REGION", JDBCType.VARCHAR)
    .build();
ShardingKey shardingKey = ds.createShardingKeyBuilder()
    .subkey("PITTSBURGH_BRANCH", JDBCType.VARCHAR)
    .build();
XAConnection con = ds.createXAConnectionBuilder()
    .user("rafa")
    .password("tennis")
    .shardingKey(shardingKey)
    .superShardingKey(superShardingKey)
    .build();

빌더가 제공하는 주요 메서드는 다음과 같습니다.

• build() – 이 빌더가 정의한 객체의 인스턴스를 반환합니다.
• user(String username) – 연결을 만들 때 사용할 사용자 이름을 지정합니다.
• password(String password) – 연결을 만들 때 사용할 비밀번호를 지정합니다. null일 수 있습니다.
• shardingKey(ShardingKey shardingKey) – 연결에 사용할 샤딩 키를 지정합니다. null일 수 있습니다.
• superShardingKey(ShardingKey superShardingKey) – 연결에 사용할 슈퍼 샤딩 키를 지정합니다. null일 수 있습니다.

각 설정 메서드는 동일한 XAConnectionBuilder 인스턴스를 반환하므로 메서드 체이닝을 지원합니다.

더 알아보기 (Learn more)

Java 공식 API