- 
 public interface ConnectionBuilderA builder created from aDataSourceobject, used to establish a connection to the database that thedata sourceobject represents. The connection properties that were specified for thedata sourceare used as the default values by theConnectionBuilder.The following example illustrates the use of ConnectionBuilderto create aConnection: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") .setShardingKey(shardingKey) .setSuperShardingKey(superShardingKey) .build();- Since:
- 9
 
- 
- 
Method SummaryAll Methods Instance Methods Abstract Methods Modifier and Type Method Description Connectionbuild()Returns an instance of the object defined by this builder.ConnectionBuilderpassword(String password)Specifies the password to be used when creating a connectionConnectionBuildershardingKey(ShardingKey shardingKey)Specifies ashardingKeyto be used when creating a connectionConnectionBuildersuperShardingKey(ShardingKey superShardingKey)Specifies asuperShardingKeyto be used when creating a connectionConnectionBuilderuser(String username)Specifies the username to be used when creating a connection
 
- 
- 
- 
Method Detail- 
userConnectionBuilder user(String username) Specifies the username to be used when creating a connection- Parameters:
- username- the database user on whose behalf the connection is being made
- Returns:
- the same ConnectionBuilderinstance
 
 - 
passwordConnectionBuilder password(String password) Specifies the password to be used when creating a connection- Parameters:
- password- the password to use for this connection. May be- null
- Returns:
- the same ConnectionBuilderinstance
 
 - 
shardingKeyConnectionBuilder shardingKey(ShardingKey shardingKey) Specifies ashardingKeyto be used when creating a connection- Parameters:
- shardingKey- the ShardingKey. May be- null
- Returns:
- the same ConnectionBuilderinstance
- See Also:
- ShardingKey,- ShardingKeyBuilder
 
 - 
superShardingKeyConnectionBuilder superShardingKey(ShardingKey superShardingKey) Specifies asuperShardingKeyto be used when creating a connection- Parameters:
- superShardingKey- the SuperShardingKey. May be- null
- Returns:
- the same ConnectionBuilderinstance
- See Also:
- ShardingKey,- ShardingKeyBuilder
 
 - 
buildConnection build() throws SQLException Returns an instance of the object defined by this builder.- Returns:
- The built object
- Throws:
- SQLException- If an error occurs building the object
 
 
- 
 
-