Package oracle.jdbc

Interface OracleConnectionBuilder

All Superinterfaces:

ConnectionBuilder

All Known Implementing Classes:

OracleConnectionBuilderImpl

public interface OracleConnectionBuilder
extends ConnectionBuilder

A builder created from a OracleDataSource object, used to establish a connection to the database that the OracleDataSource object represents. The connection properties that were specified for the OracleDataSource are used as the default values by the OracleConnectionBuilder.

To use the builder, the corresponding builder method needs to be called for each parameter that needs to be part of the connection request followed by a build() method. The order in which the builder methods are called is not important. However if the same builder attribute is applied more than once, only the most recent value will be considered while building the connection. The builder object can be reused to build more than one connection and the builder attributes will be retained across multiple invocations of the build() method.

The following example illustrates the use of OracleConnectionBuilder to create a OracleConnection:

  
    OracleDataSource ods = new oracle.jdbc.pool.OracleDataSource();
    OracleShardingKey superShardingKey =
        ods.createShardingKeyBuilder()
           .subkey("EASTERN_REGION", JDBCType.VARCHAR)
           .build();
    OracleShardingKey shardingKey =
        ods.createShardingKeyBuilder()
           .subkey("PITTSBURGH_BRANCH", JDBCType.VARCHAR)
           .build();
    OracleConnection connection = ods.createConnectionBuilder()
                                     .user("rafa")
                                     .password("tennis")
                                     .shardingKey(shardingKey)
                                     .superShardingKey(superShardingKey)
                                     .build();
  
  

Since:

12.2

Method Summary

Modifier and Type	Method	Description
OracleConnection	build()	Builds the connection object.
OracleConnectionBuilder	gssCredential(GSSCredential credential)	Provide the GSSCredential used to authenticate the connection.
OracleConnectionBuilder	password(String password)
OracleConnectionBuilder	shardingKey(ShardingKey shardingKey)
OracleConnectionBuilder	shardingKey(OracleShardingKey shardingKey)
OracleConnectionBuilder	superShardingKey(ShardingKey superShardingKey)
OracleConnectionBuilder	superShardingKey(OracleShardingKey superShardingKey)
OracleConnectionBuilder	user(String user)

Method Detail

user

OracleConnectionBuilder user(String user)

Specified by:

user in interface ConnectionBuilder

Parameters:

user -

Returns:

This OracleConnectionBuilder object

password

OracleConnectionBuilder password(String password)

Specified by:

password in interface ConnectionBuilder

Parameters:

password -

Returns:

This OracleConnectionBuilder object

shardingKey

OracleConnectionBuilder shardingKey(OracleShardingKey shardingKey)

Parameters:

shardingKey - Sharding Key object that needs to be part of connection request

Returns:

This OracleConnectionBuilder object

superShardingKey

OracleConnectionBuilder superShardingKey(OracleShardingKey superShardingKey)

Parameters:

superShardingKey - Super sharding key object that needs to be part of connection request

Returns:

This OracleConnectionBuilder object

shardingKey

OracleConnectionBuilder shardingKey(ShardingKey shardingKey)

Specified by:

shardingKey in interface ConnectionBuilder

Parameters:

shardingKey - Sharding Key object that needs to be part of connection request

Returns:

This OracleConnectionBuilder object

superShardingKey

OracleConnectionBuilder superShardingKey(ShardingKey superShardingKey)

Specified by:

superShardingKey in interface ConnectionBuilder

Parameters:

superShardingKey - Super sharding key object that needs to be part of connection request

Returns:

This OracleConnectionBuilder object

gssCredential

OracleConnectionBuilder gssCredential(GSSCredential credential)

Provide the GSSCredential used to authenticate the connection.

Parameters:

credential - used to authenticate the connection. Not null.

build

OracleConnection build()
                throws SQLException

Builds the connection object.

Specified by:

build in interface ConnectionBuilder

Returns:

New OracleConnection that is created.

Throws:

SQLException