Top Description Methods
javax.sql

public Interface PooledConnectionBuilder

Imports
java.sql.SQLException, .ShardingKey
A builder created from a ConnectionPoolDataSource object, used to establish a connection to the database that the data source object represents. The connection properties that were specified for the data source are used as the default values by the PooledConnectionBuilder.

The following example illustrates the use of PooledConnectionBuilder to create a XAConnection: 

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();
Since
9

Method Summary

Modifier and TypeMethod and Description
public PooledConnection

Returns:

The built object
build()

Returns an instance of the object defined by this builder.

public PooledConnectionBuilder

Returns:

the same PooledConnectionBuilder instance
password(String
the password to use for this connection. May be null
password)

Specifies the password to be used when creating a connection

public PooledConnectionBuilder

Returns:

the same PooledConnectionBuilder instance
shardingKey(ShardingKey
the ShardingKey. May be null
shardingKey)

Specifies a shardingKey to be used when creating a connection

public PooledConnectionBuilder

Returns:

the same PooledConnectionBuilder instance
superShardingKey(ShardingKey
the SuperShardingKey. May be null
superShardingKey)

Specifies a superShardingKey to be used when creating a connection

public PooledConnectionBuilder

Returns:

the same PooledConnectionBuilder instance
user(String
the database user on whose behalf the connection is being made
username)

Specifies the username to be used when creating a connection

Method Detail

buildback to summary
public PooledConnection build() throws SQLException

Returns an instance of the object defined by this builder.

Returns:PooledConnection

The built object

Exceptions
SQLException:
If an error occurs building the object
passwordback to summary
public PooledConnectionBuilder password(String password)

Specifies the password to be used when creating a connection

Parameters
password:String

the password to use for this connection. May be null

Returns:PooledConnectionBuilder

the same PooledConnectionBuilder instance

shardingKeyback to summary
public PooledConnectionBuilder shardingKey(ShardingKey shardingKey)

Specifies a shardingKey to be used when creating a connection

Parameters
shardingKey:ShardingKey

the ShardingKey. May be null

Returns:PooledConnectionBuilder

the same PooledConnectionBuilder instance

See Also
java.sql.ShardingKey, java.sql.ShardingKeyBuilder
superShardingKeyback to summary
public PooledConnectionBuilder superShardingKey(ShardingKey superShardingKey)

Specifies a superShardingKey to be used when creating a connection

Parameters
superShardingKey:ShardingKey

the SuperShardingKey. May be null

Returns:PooledConnectionBuilder

the same PooledConnectionBuilder instance

See Also
java.sql.ShardingKey, java.sql.ShardingKeyBuilder
userback to summary
public PooledConnectionBuilder user(String username)

Specifies the username to be used when creating a connection

Parameters
username:String

the database user on whose behalf the connection is being made

Returns:PooledConnectionBuilder

the same PooledConnectionBuilder instance