com.singlestore.jdbc.client.impl

Class ConnectionHelper

java.lang.Object

com.singlestore.jdbc.client.impl.ConnectionHelper

public final class ConnectionHelper
extends Object

Connection creation helper class

Constructor Summary

Constructors

Constructor and Description
ConnectionHelper()

Method Summary

Modifier and Type	Method and Description
static void	authenticationHandler(Credential credential, Writer writer, Reader reader, com.singlestore.jdbc.client.Context context) Authentication swtich handler
static Socket	connectSocket(Configuration conf, HostAddress hostAddress) Connect socket
static Socket	createSocket(Configuration conf, HostAddress hostAddress) Create socket accordingly to options.
static long	initializeClientCapabilities(Configuration configuration, long serverCapabilities, HostAddress hostAddress) Initialize client capability according to configuration and server capabilities.
static Credential	loadCredential(CredentialPlugin credentialPlugin, Configuration configuration, HostAddress hostAddress) Load user/password plugin if configured to.
static SSLSocket	sslWrapper(HostAddress hostAddress, Socket socket, long clientCapabilities, byte exchangeCharset, com.singlestore.jdbc.client.Context context, Writer writer) Create SSL wrapper
static Socket	standardSocket(Configuration conf, HostAddress hostAddress) Use standard socket implementation.

Methods inherited from class java.lang.Object

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

Constructor Detail

ConnectionHelper

public ConnectionHelper()

Method Detail

createSocket

public static Socket createSocket(Configuration conf,
                                  HostAddress hostAddress)
                           throws IOException,
                                  SQLException

Create socket accordingly to options.

Parameters:

conf - Url options

hostAddress - host ( mandatory but for named pipe / unix socket)

Returns:

a nex socket

Throws:

IOException - if connection error occur

SQLException - in case of configuration error

standardSocket

public static Socket standardSocket(Configuration conf,
                                    HostAddress hostAddress)
                             throws IOException,
                                    SQLException

Use standard socket implementation.

Parameters:

conf - url options

hostAddress - host to connect

Returns:

socket

Throws:

IOException - in case of error establishing socket.

SQLException - in case host is null

connectSocket

public static Socket connectSocket(Configuration conf,
                                   HostAddress hostAddress)
                            throws SQLException

Connect socket

Parameters:

conf - configuration

hostAddress - host to connect

Returns:

socket

Throws:

SQLException - if hostname is required and not provided, or socket cannot be created

initializeClientCapabilities

public static long initializeClientCapabilities(Configuration configuration,
                                                long serverCapabilities,
                                                HostAddress hostAddress)

Initialize client capability according to configuration and server capabilities.

Parameters:

configuration - configuration

serverCapabilities - server capabilities

hostAddress - host address server

Returns:

client capabilities

authenticationHandler

public static void authenticationHandler(Credential credential,
                                         Writer writer,
                                         Reader reader,
                                         com.singlestore.jdbc.client.Context context)
                                  throws SQLException,
                                         IOException

Authentication swtich handler

Parameters:

credential - credential

writer - socket writer

reader - socket reader

context - connection context

Throws:

IOException - if any socket error occurs

SQLException - if any other kind of issue occurs

loadCredential

public static Credential loadCredential(CredentialPlugin credentialPlugin,
                                        Configuration configuration,
                                        HostAddress hostAddress)
                                 throws SQLException

Load user/password plugin if configured to.

Parameters:

credentialPlugin - configuration credential plugin

configuration - configuration

hostAddress - current connection host address

Returns:

credentials

Throws:

SQLException - if configured credential plugin fail

sslWrapper

public static SSLSocket sslWrapper(HostAddress hostAddress,
                                   Socket socket,
                                   long clientCapabilities,
                                   byte exchangeCharset,
                                   com.singlestore.jdbc.client.Context context,
                                   Writer writer)
                            throws SQLException,
                                   IOException

Create SSL wrapper

Parameters:

hostAddress - host

socket - socket

clientCapabilities - client capabilities

exchangeCharset - connection charset

context - connection context

writer - socket writer

Returns:

SSLsocket

Throws:

IOException - if any socket error occurs

SQLException - for any other kind of error