com.mysql.cj.jdbc.ha.util

Class ConnectionUtils

java.lang.Object

com.mysql.cj.jdbc.ha.util.ConnectionUtils

public class ConnectionUtils
extends java.lang.Object

Utility class for copying HostInfo objects.

Constructor Summary

Constructors

Constructor and Description
ConnectionUtils()

Method Summary

Modifier and Type	Method and Description
static HostInfo	copyWithAdditionalProps(HostInfo baseHostInfo, ConnectionUrl connectionUrl) Create a copy of HostInfo object where host and port are the same while all others are from ConnectionUrl object.
static HostInfo	copyWithAdditionalProps(HostInfo baseHostInfo, HostInfo newHostInfo)
static HostInfo	copyWithAdditionalProps(HostInfo baseHostInfo, java.util.Map<java.lang.String,java.lang.String> additionalProps) Create a copy of the given HostInfo object where all details are the same except for the host properties, which will contain both the original properties and the properties passed into the function.
static HostInfo	createHostWithProperties(HostInfo baseHost, java.util.Map<java.lang.String,java.lang.String> properties)
static HostInfo	createInstanceHostWithProperties(java.lang.String instance, HostInfo previousHostInfo) Create a copy of HostInfo object where all properties are the same but the hostInfo points to the provided instance.
static java.lang.String	getUrlFromEndpoint(java.lang.String endpoint, int port, java.util.Properties props)
static boolean	isNetworkException(java.sql.SQLException exception) Check whether the given exception is caused by network errors.
static boolean	isNetworkException(java.lang.String sqlState) Check whether the given SQLState is caused by network errors.

Methods inherited from class java.lang.Object

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

Constructor Detail

ConnectionUtils

public ConnectionUtils()

Method Detail

copyWithAdditionalProps

public static HostInfo copyWithAdditionalProps(HostInfo baseHostInfo,
                                               java.util.Map<java.lang.String,java.lang.String> additionalProps)

Create a copy of the given HostInfo object where all details are the same except for the host properties, which will contain both the original properties and the properties passed into the function.

Parameters:

baseHostInfo - The HostInfo object to copy

additionalProps - The map of properties to add to the new HostInfo copy

Returns:

A copy of the given HostInfo object where all details are the same except for the host properties, will contain both the original properties and the properties passed into the function. Returns null if baseHostInfo is null

copyWithAdditionalProps

public static HostInfo copyWithAdditionalProps(HostInfo baseHostInfo,
                                               ConnectionUrl connectionUrl)

Create a copy of HostInfo object where host and port are the same while all others are from ConnectionUrl object.

Parameters:

baseHostInfo - The HostInfo object to copy host and port from

connectionUrl - All other properties to add to the new HostInfo

Returns:

A copy of HostInfo object where host and port are the same while all others are from ConnectionUrl object Returns baseHostInfo if connectionUrl is null Returns connectionUrl's HostInfo if baseHostInfo is null

copyWithAdditionalProps

public static HostInfo copyWithAdditionalProps(HostInfo baseHostInfo,
                                               HostInfo newHostInfo)

createHostWithProperties

public static HostInfo createHostWithProperties(HostInfo baseHost,
                                                java.util.Map<java.lang.String,java.lang.String> properties)
                                         throws java.sql.SQLException

Throws:

java.sql.SQLException

createInstanceHostWithProperties

public static HostInfo createInstanceHostWithProperties(java.lang.String instance,
                                                        HostInfo previousHostInfo)
                                                 throws java.sql.SQLException

Create a copy of HostInfo object where all properties are the same but the hostInfo points to the provided instance.

Parameters:

instance - The instance name to replace the previous host.

previousHostInfo - The HostInfo object that all other information to add to the new HostInfo.

Returns:

A copy of HostInfo object where only the host has been changed.

Throws:

java.sql.SQLException

getUrlFromEndpoint

public static java.lang.String getUrlFromEndpoint(java.lang.String endpoint,
                                                  int port,
                                                  java.util.Properties props)
                                           throws java.sql.SQLException

Throws:

java.sql.SQLException

isNetworkException

public static boolean isNetworkException(java.sql.SQLException exception)

Check whether the given exception is caused by network errors.

Parameters:

exception - The SQLException raised by the driver.

Returns:

true if the exception is caused by network errors; false otherwise.

isNetworkException

public static boolean isNetworkException(java.lang.String sqlState)

Check whether the given SQLState is caused by network errors.

Parameters:

sqlState - The SQLState of an exception raised by the driver.

Returns:

true if the exception is caused by network errors; false otherwise.