public interface ConnectionBuilder
DataSource
オブジェクトから作成されたビルダーで、data source
オブジェクトが表すデータベースへの接続を確立するために使用されます。 data source
に指定された接続プロパティは、ConnectionBuilder
によってデフォルト値として使用されます。
次の例は、ConnectionBuilder
を使用してConnection
を作成する方法を示しています:
DataSource ds = new MyDataSource();
ShardingKey superShardingKey = ds.createShardingKeyBuilder()
.subkey("EASTERN_REGION", JDBCType.VARCHAR)
.build();
ShardingKey shardingKey = ds.createShardingKeyBuilder()
.subkey("PITTSBURGH_BRANCH", JDBCType.VARCHAR)
.build();
Connection con = ds.createConnectionBuilder()
.user("rafa")
.password("tennis")
.shardingKey(shardingKey)
.superShardingKey(superShardingKey)
.build();
- 導入されたバージョン:
- 9
-
メソッドのサマリー
修飾子と型メソッド説明build()
このビルダーによって定義されたオブジェクトのインスタンスを返します。接続を作成するときに使用するパスワードを指定shardingKey
(ShardingKey shardingKey) 接続を作成するときに使用するshardingKey
を指定superShardingKey
(ShardingKey superShardingKey) 接続を作成するときに使用するsuperShardingKey
を指定接続を作成するときに使用するユーザー名を指定
-
メソッドの詳細
-
user
ConnectionBuilder user(String username) 接続を作成するときに使用するユーザー名を指定- パラメータ:
username
- その代理として接続が行われるデータベース・ユーザー- 戻り値:
- 同じ
ConnectionBuilder
インスタンス
-
password
ConnectionBuilder password(String password) 接続を作成するときに使用するパスワードを指定- パラメータ:
password
- この接続に使用するパスワード。null
も可- 戻り値:
- 同じ
ConnectionBuilder
インスタンス
-
shardingKey
ConnectionBuilder shardingKey(ShardingKey shardingKey) 接続を作成するときに使用するshardingKey
を指定- パラメータ:
shardingKey
- ShardingKey。null
も可- 戻り値:
- 同じ
ConnectionBuilder
インスタンス - 関連項目:
-
superShardingKey
ConnectionBuilder superShardingKey(ShardingKey superShardingKey) 接続を作成するときに使用するsuperShardingKey
を指定- パラメータ:
superShardingKey
- SuperShardingKey。null
も可- 戻り値:
- 同じ
ConnectionBuilder
インスタンス - 関連項目:
-
build
Connection build() throws SQLExceptionこのビルダーによって定義されたオブジェクトのインスタンスを返します。- 戻り値:
- 構築されたオブジェクト
- 例外:
SQLException
- オブジェクトの構築中にエラーが発生した場合
-