software.amazon.jdbc

Class DataSourceConnectionProvider

java.lang.Object

software.amazon.jdbc.DataSourceConnectionProvider

All Implemented Interfaces:

ConnectionProvider

public class DataSourceConnectionProvider
extends java.lang.Object
implements ConnectionProvider

This class is a basic implementation of ConnectionProvider interface. It creates and returns an instance of PgConnection.

Constructor Summary

Constructors

Constructor and Description
DataSourceConnectionProvider(@NonNull javax.sql.DataSource dataSource)

Method Summary

Modifier and Type	Method and Description
boolean	acceptsStrategy(@NonNull HostRole role, @NonNull java.lang.String strategy) Indicates whether the selection strategy is supported by the connection provider.
boolean	acceptsUrl(@NonNull java.lang.String protocol, @NonNull HostSpec hostSpec, @NonNull java.util.Properties props) Indicates whether this ConnectionProvider can provide connections for the given host and properties.
java.sql.Connection	connect(@NonNull java.lang.String protocol, @NonNull Dialect dialect, @NonNull TargetDriverDialect targetDriverDialect, @NonNull HostSpec hostSpec, @NonNull java.util.Properties props) Called once per connection that needs to be created.
HostSpec	getHostSpecByStrategy(@NonNull java.util.List<HostSpec> hosts, @NonNull HostRole role, @NonNull java.lang.String strategy, @Nullable java.util.Properties props) Return a reader or a writer node using the specified strategy.
java.lang.String	getTargetName()
protected java.sql.Connection	openConnection(@NonNull javax.sql.DataSource ds, @NonNull java.lang.String protocol, @NonNull TargetDriverDialect targetDriverDialect, @NonNull HostSpec hostSpec, @NonNull java.util.Properties props)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DataSourceConnectionProvider

public DataSourceConnectionProvider(@NonNull javax.sql.DataSource dataSource)

Method Detail

acceptsUrl

public boolean acceptsUrl(@NonNull java.lang.String protocol,
                          @NonNull HostSpec hostSpec,
                          @NonNull java.util.Properties props)

Indicates whether this ConnectionProvider can provide connections for the given host and properties. Some ConnectionProvider implementations may not be able to handle certain URL types or properties.

Specified by:

acceptsUrl in interface ConnectionProvider

Parameters:

protocol - The connection protocol (example "jdbc:mysql://")

hostSpec - The HostSpec containing the host-port information for the host to connect to

props - The Properties to use for the connection

Returns:

true if this ConnectionProvider can provide connections for the given URL, otherwise return false

acceptsStrategy

public boolean acceptsStrategy(@NonNull HostRole role,
                               @NonNull java.lang.String strategy)

Description copied from interface: ConnectionProvider

Indicates whether the selection strategy is supported by the connection provider.

Specified by:

acceptsStrategy in interface ConnectionProvider

Parameters:

role - determines if the connection provider should return a reader host or a writer host

strategy - the selection strategy to use

Returns:

whether the strategy is supported

getHostSpecByStrategy

public HostSpec getHostSpecByStrategy(@NonNull java.util.List<HostSpec> hosts,
                                      @NonNull HostRole role,
                                      @NonNull java.lang.String strategy,
                                      @Nullable java.util.Properties props)
                               throws java.sql.SQLException

Description copied from interface: ConnectionProvider

Return a reader or a writer node using the specified strategy. This method should raise an UnsupportedOperationException if the specified strategy is unsupported.

Specified by:

getHostSpecByStrategy in interface ConnectionProvider

Parameters:

hosts - the list of HostSpec to select from

role - determines if the connection provider should return a writer or a reader

strategy - the strategy determining how the HostSpec should be selected, e.g., random or round-robin

props - any properties that are required by the provided strategy to select a host

Returns:

the HostSpec selected using the specified strategy

Throws:

java.sql.SQLException - if an error occurred while returning the hosts

connect

public java.sql.Connection connect(@NonNull java.lang.String protocol,
                                   @NonNull Dialect dialect,
                                   @NonNull TargetDriverDialect targetDriverDialect,
                                   @NonNull HostSpec hostSpec,
                                   @NonNull java.util.Properties props)
                            throws java.sql.SQLException

Called once per connection that needs to be created.

Specified by:

connect in interface ConnectionProvider

Parameters:

protocol - The connection protocol (example "jdbc:mysql://")

hostSpec - The HostSpec containing the host-port information for the host to connect to

props - The Properties to use for the connection

dialect - the database dialect

targetDriverDialect - the target driver dialect

Returns:

Connection resulting from the given connection information

Throws:

java.sql.SQLException - if an error occurs

openConnection

protected java.sql.Connection openConnection(@NonNull javax.sql.DataSource ds,
                                             @NonNull java.lang.String protocol,
                                             @NonNull TargetDriverDialect targetDriverDialect,
                                             @NonNull HostSpec hostSpec,
                                             @NonNull java.util.Properties props)
                                      throws java.sql.SQLException

Throws:

java.sql.SQLException

getTargetName

public java.lang.String getTargetName()

Specified by:

getTargetName in interface ConnectionProvider