public interface XAConnectionBuilder
XADataSource
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 XAConnectionBuilder
. The following example illustrates the use of XAConnectionBuilder
to create a XAConnection
:
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")
.shardingKey(shardingKey)
.superShardingKey(superShardingKey)
.build();
Modifier and Type | Method | Description |
---|---|---|
XAConnection |
build() |
Returns an instance of the object defined by this builder. |
XAConnectionBuilder |
password |
Specifies the password to be used when creating a connection |
XAConnectionBuilder |
shardingKey |
Specifies a shardingKey to be used when creating a connection |
XAConnectionBuilder |
superShardingKey |
Specifies a superShardingKey to be used when creating a connection |
XAConnectionBuilder |
user |
Specifies the username to be used when creating a connection |
XAConnectionBuilder user(String username)
username
- the database user on whose behalf the connection is being madeXAConnectionBuilder
instanceXAConnectionBuilder password(String password)
password
- the password to use for this connection. May be null
XAConnectionBuilder
instanceXAConnectionBuilder shardingKey(ShardingKey shardingKey)
shardingKey
to be used when creating a connectionshardingKey
- the ShardingKey. May be null
XAConnectionBuilder
instanceXAConnectionBuilder superShardingKey(ShardingKey superShardingKey)
superShardingKey
to be used when creating a connectionsuperShardingKey
- the SuperShardingKey. May be null
XAConnectionBuilder
instanceXAConnection build() throws SQLException
SQLException
- If an error occurs building the object
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.sql/javax/sql/XAConnectionBuilder.html