-
public interface XAConnectionBuilderA builder created from aXADataSourceobject, 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 theXAConnectionBuilder.The following example illustrates the use of
XAConnectionBuilderto create aXAConnection: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") .setShardingKey(shardingKey) .setSuperShardingKey(superShardingKey) .build();- Since:
- 9
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description XAConnectionbuild()Returns an instance of the object defined by this builder.XAConnectionBuilderpassword(String password)Specifies the password to be used when creating a connectionXAConnectionBuildershardingKey(ShardingKey shardingKey)Specifies ashardingKeyto be used when creating a connectionXAConnectionBuildersuperShardingKey(ShardingKey superShardingKey)Specifies asuperShardingKeyto be used when creating a connectionXAConnectionBuilderuser(String username)Specifies the username to be used when creating a connection
-
-
-
Method Detail
-
user
XAConnectionBuilder 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
XAConnectionBuilderinstance
-
password
XAConnectionBuilder password(String password)
Specifies the password to be used when creating a connection- Parameters:
password- the password to use for this connection. May benull- Returns:
- the same
XAConnectionBuilderinstance
-
shardingKey
XAConnectionBuilder shardingKey(ShardingKey shardingKey)
Specifies ashardingKeyto be used when creating a connection- Parameters:
shardingKey- the ShardingKey. May benull- Returns:
- the same
XAConnectionBuilderinstance - See Also:
ShardingKey,ShardingKeyBuilder
-
superShardingKey
XAConnectionBuilder superShardingKey(ShardingKey superShardingKey)
Specifies asuperShardingKeyto be used when creating a connection- Parameters:
superShardingKey- the SuperShardingKey. May benull- Returns:
- the same
XAConnectionBuilderinstance - See Also:
ShardingKey,ShardingKeyBuilder
-
build
XAConnection 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
-
-