com.mysql.cj.conf.url

Class LoadBalanceConnectionUrl

java.lang.Object

com.mysql.cj.conf.ConnectionUrl

com.mysql.cj.conf.url.LoadBalanceConnectionUrl

All Implemented Interfaces:

DatabaseUrlContainer

public class LoadBalanceConnectionUrl
extends ConnectionUrl

Nested Class Summary

Nested classes/interfaces inherited from class com.mysql.cj.conf.ConnectionUrl

ConnectionUrl.HostsCardinality, ConnectionUrl.Type

Field Summary

Fields inherited from class com.mysql.cj.conf.ConnectionUrl

DEFAULT_HOST, DEFAULT_PORT, hosts, originalConnStr, originalDatabase, properties, type

Constructor Summary

Constructors

Constructor and Description
LoadBalanceConnectionUrl(ConnectionUrlParser connStrParser, java.util.Properties info) Constructs an instance of LoadBalanceConnectionUrl, performing all the required initializations and validations.
LoadBalanceConnectionUrl(java.util.List<HostInfo> hosts, java.util.Map<java.lang.String,java.lang.String> properties) Constructs an instance of a LoadBalanceConnectionUrl based on a list of hosts and a global set of properties instead of connection string parsing.

Method Summary

Modifier and Type	Method and Description
java.util.List<java.lang.String>	getHostInfoListAsHostPortPairs() Returns a list of this connection URL hosts in the form of host:port pairs.
java.util.List<HostInfo>	getHostInfoListFromHostPortPairs(java.util.Collection<java.lang.String> hostPortPairs) Returns the list of HostInfo instances that matches the given collection of host:port pairs.
protected void	injectPerTypeProperties(java.util.Map<java.lang.String,java.lang.String> props) Injects additional properties into the connection arguments while it's being constructed.

Methods inherited from class com.mysql.cj.conf.ConnectionUrl

acceptsUrl, buildHostInfo, collectHostsInfo, collectProperties, expandPropertiesFromConfigFiles, fixHostInfo, fixProtocolDependencies, getConnectionArgumentsAsProperties, getConnectionUrlInstance, getDatabase, getDatabaseUrl, getDefaultHost, getDefaultPassword, getDefaultPort, getDefaultUser, getHostOrSpawnIsolated, getHostOrSpawnIsolated, getHostsList, getHostsList, getHostsListFromDnsSrv, getMainHost, getOriginalProperties, getPropertiesFromConfigFiles, getType, hostsCount, preprocessPerTypeHostProperties, replaceLegacyPropertyValues, setupPropertiesTransformer, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

LoadBalanceConnectionUrl

public LoadBalanceConnectionUrl(ConnectionUrlParser connStrParser,
                                java.util.Properties info)

Constructs an instance of LoadBalanceConnectionUrl, performing all the required initializations and validations. A load-balanced connection cannot deal with multiple hosts with same host:port.

Parameters:

connStrParser - a ConnectionUrlParser instance containing the parsed version of the original connection string

info - the connection arguments map

LoadBalanceConnectionUrl

public LoadBalanceConnectionUrl(java.util.List<HostInfo> hosts,
                                java.util.Map<java.lang.String,java.lang.String> properties)

Constructs an instance of a LoadBalanceConnectionUrl based on a list of hosts and a global set of properties instead of connection string parsing. ConnectionUrl instances created by this process are not cached.

Parameters:

hosts - the hosts list to use in this connection URL

properties - the properties common to all hosts

Method Detail

injectPerTypeProperties

protected void injectPerTypeProperties(java.util.Map<java.lang.String,java.lang.String> props)

Injects additional properties into the connection arguments while it's being constructed.

Overrides:

injectPerTypeProperties in class ConnectionUrl

Parameters:

props - the properties already containing all known connection arguments

getHostInfoListAsHostPortPairs

public java.util.List<java.lang.String> getHostInfoListAsHostPortPairs()

Returns a list of this connection URL hosts in the form of host:port pairs.

Returns:

a list of this connection URL hosts in the form of host:port pairs

getHostInfoListFromHostPortPairs

public java.util.List<HostInfo> getHostInfoListFromHostPortPairs(java.util.Collection<java.lang.String> hostPortPairs)

Returns the list of HostInfo instances that matches the given collection of host:port pairs. Isolated host info elements are spawned for the missing elements.

Parameters:

hostPortPairs - a list of host:port pairs

Returns:

a list of HostInfo instances corresponding to the given host:port pairs