PooledConnectionBuilder

PooledConnectionBuilder (연결 풀 빌더)

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

출처: Java API Reference

본문

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

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

ConnectionPoolDataSource ds = new MyConnectionPoolDataSource();
ShardingKey superShardingKey = ds.createShardingKeyBuilder()
    .subkey("EASTERN_REGION", JDBCType.VARCHAR)
    .build();
ShardingKey shardingKey = ds.createShardingKeyBuilder()
    .subkey("PITTSBURGH_BRANCH", JDBCType.VARCHAR)
    .build();
PooledConnection con = ds.createPooledConnectionBuilder()
    .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일 수 있습니다.

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

더 알아보기 (Learn more)

Java 공식 API