DelegatingAuroraConnection (auroraArc 0.5 API)

java.lang.Object
- org.threadly.db.AbstractDelegatingConnection
- - org.threadly.db.aurora.DelegatingAuroraConnection

All Implemented Interfaces:

java.lang.AutoCloseable, java.sql.Connection, java.sql.Wrapper
```
public class DelegatingAuroraConnection
extends AbstractDelegatingConnection
implements java.sql.Connection
```
Implementation of Connection which under the hood delegates to one of several connections to an Aurora server. This uses the AuroraClusterMonitor to monitor the provided cluster, and intelligently choose which connection to delegate to.
From an external perspective this is just a single connection doing some magic to fairly distribute load if possible, and to handle fail over conditions with minimal impact.

Field Summary

Fields
Modifier and Type Field and Description

static java.lang.String URL_PREFIX
Prefix expected to the URL for connections handled by this class.
- Fields inherited from interface java.sql.Connection
  TRANSACTION_NONE, TRANSACTION_READ_COMMITTED, TRANSACTION_READ_UNCOMMITTED, TRANSACTION_REPEATABLE_READ, TRANSACTION_SERIALIZABLE

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`URL_PREFIX` Prefix expected to the URL for connections handled by this class.

Constructor Summary

Constructors
Constructor and Description
`DelegatingAuroraConnection(java.lang.String url, java.util.Properties info)` Construct a new connection with the provided url and info.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`abort(java.util.concurrent.Executor executor)`
`static boolean`	`acceptsURL(java.lang.String url)` Check if a given URL is accepted by this connection.
`void`	`clearWarnings()`
`void`	`close()`
`boolean`	`getAutoCommit()`
`int`	`getTransactionIsolation()`
`java.sql.SQLWarning`	`getWarnings()`
`boolean`	`isClosed()`
`boolean`	`isReadOnly()`
`boolean`	`isValid(int timeout)`
`void`	`setAutoCommit(boolean autoCommit)`
`void`	`setCatalog(java.lang.String catalog)`
`void`	`setClientInfo(java.util.Properties properties)`
`void`	`setClientInfo(java.lang.String name, java.lang.String value)`
`void`	`setHoldability(int holdability)`
`void`	`setNetworkTimeout(java.util.concurrent.Executor executor, int milliseconds)`
`void`	`setReadOnly(boolean readOnly)`
`void`	`setSchema(java.lang.String schema)`
`void`	`setTransactionIsolation(int level)`
`void`	`setTypeMap(java.util.Map<java.lang.String,java.lang.Class<?>> map)`
`java.lang.String`	`toString()`

Methods inherited from class org.threadly.db.AbstractDelegatingConnection
commit, createArrayOf, createBlob, createClob, createNClob, createSQLXML, createStatement, createStatement, createStatement, createStruct, getCatalog, getClientInfo, getClientInfo, getHoldability, getMetaData, getNetworkTimeout, getSchema, getTypeMap, isWrapperFor, nativeSQL, prepareCall, prepareCall, prepareCall, prepareStatement, prepareStatement, prepareStatement, prepareStatement, prepareStatement, prepareStatement, releaseSavepoint, rollback, rollback, setSavepoint, setSavepoint, unwrap

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.sql.Connection
commit, createArrayOf, createBlob, createClob, createNClob, createSQLXML, createStatement, createStatement, createStatement, createStruct, getCatalog, getClientInfo, getClientInfo, getHoldability, getMetaData, getNetworkTimeout, getSchema, getTypeMap, nativeSQL, prepareCall, prepareCall, prepareCall, prepareStatement, prepareStatement, prepareStatement, prepareStatement, prepareStatement, prepareStatement, releaseSavepoint, rollback, rollback, setSavepoint, setSavepoint

Methods inherited from interface java.sql.Wrapper
isWrapperFor, unwrap

- Field Detail
  - URL_PREFIX
```
public static final java.lang.String URL_PREFIX
```
    Prefix expected to the URL for connections handled by this class.
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - DelegatingAuroraConnection
```
public DelegatingAuroraConnection(java.lang.String url,
                                  java.util.Properties info)
                           throws java.sql.SQLException
```
    Construct a new connection with the provided url and info. The URL should be prefixed with URL_PREFIX. Aurora servers should be delineated by ','.
    
    Parameters:
    
    url - Servers and connect properties to connect to
    
    info - Info properties
    
    Throws:
    
    java.sql.SQLException - Thrown if issue in establishing delegate connections
- Method Detail
  - acceptsURL
```
public static boolean acceptsURL(java.lang.String url)
```
    Check if a given URL is accepted by this connection.
    
    Parameters:
    
    url - URL to test
    
    Returns:
    
    true if this connection is able to handled the provided url
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - close
```
public void close()
           throws java.sql.SQLException
```
    Specified by:
    
    close in interface java.lang.AutoCloseable
    
    Specified by:
    
    close in interface java.sql.Connection
    
    Throws:
    
    java.sql.SQLException
  - isClosed
```
public boolean isClosed()
                 throws java.sql.SQLException
```
    Specified by:
    
    isClosed in interface java.sql.Connection
    
    Throws:
    
    java.sql.SQLException
  - setReadOnly
```
public void setReadOnly(boolean readOnly)
                 throws java.sql.SQLException
```
    Specified by:
    
    setReadOnly in interface java.sql.Connection
    
    Throws:
    
    java.sql.SQLException
  - isReadOnly
```
public boolean isReadOnly()
```
    Specified by:
    
    isReadOnly in interface java.sql.Connection
  - setAutoCommit
```
public void setAutoCommit(boolean autoCommit)
                   throws java.sql.SQLException
```
    Specified by:
    
    setAutoCommit in interface java.sql.Connection
    
    Throws:
    
    java.sql.SQLException
  - getAutoCommit
```
public boolean getAutoCommit()
                      throws java.sql.SQLException
```
    Specified by:
    
    getAutoCommit in interface java.sql.Connection
    
    Throws:
    
    java.sql.SQLException
  - setCatalog
```
public void setCatalog(java.lang.String catalog)
                throws java.sql.SQLException
```
    Specified by:
    
    setCatalog in interface java.sql.Connection
    
    Throws:
    
    java.sql.SQLException
  - setTransactionIsolation
```
public void setTransactionIsolation(int level)
                             throws java.sql.SQLException
```
    Specified by:
    
    setTransactionIsolation in interface java.sql.Connection
    
    Throws:
    
    java.sql.SQLException
  - getTransactionIsolation
```
public int getTransactionIsolation()
                            throws java.sql.SQLException
```
    Specified by:
    
    getTransactionIsolation in interface java.sql.Connection
    
    Throws:
    
    java.sql.SQLException
  - getWarnings
```
public java.sql.SQLWarning getWarnings()
                                throws java.sql.SQLException
```
    Specified by:
    
    getWarnings in interface java.sql.Connection
    
    Throws:
    
    java.sql.SQLException
  - clearWarnings
```
public void clearWarnings()
                   throws java.sql.SQLException
```
    Specified by:
    
    clearWarnings in interface java.sql.Connection
    
    Throws:
    
    java.sql.SQLException
  - setTypeMap
```
public void setTypeMap(java.util.Map<java.lang.String,java.lang.Class<?>> map)
                throws java.sql.SQLException
```
    Specified by:
    
    setTypeMap in interface java.sql.Connection
    
    Throws:
    
    java.sql.SQLException
  - setHoldability
```
public void setHoldability(int holdability)
                    throws java.sql.SQLException
```
    Specified by:
    
    setHoldability in interface java.sql.Connection
    
    Throws:
    
    java.sql.SQLException
  - isValid
```
public boolean isValid(int timeout)
                throws java.sql.SQLException
```
    Specified by:
    
    isValid in interface java.sql.Connection
    
    Throws:
    
    java.sql.SQLException
  - setClientInfo
```
public void setClientInfo(java.lang.String name,
                          java.lang.String value)
                   throws java.sql.SQLClientInfoException
```
    Specified by:
    
    setClientInfo in interface java.sql.Connection
    
    Throws:
    
    java.sql.SQLClientInfoException
  - setClientInfo
```
public void setClientInfo(java.util.Properties properties)
                   throws java.sql.SQLClientInfoException
```
    Specified by:
    
    setClientInfo in interface java.sql.Connection
    
    Throws:
    
    java.sql.SQLClientInfoException
  - setSchema
```
public void setSchema(java.lang.String schema)
               throws java.sql.SQLException
```
    Specified by:
    
    setSchema in interface java.sql.Connection
    
    Throws:
    
    java.sql.SQLException
  - abort
```
public void abort(java.util.concurrent.Executor executor)
           throws java.sql.SQLException
```
    Specified by:
    
    abort in interface java.sql.Connection
    
    Throws:
    
    java.sql.SQLException
  - setNetworkTimeout
```
public void setNetworkTimeout(java.util.concurrent.Executor executor,
                              int milliseconds)
                       throws java.sql.SQLException
```
    Specified by:
    
    setNetworkTimeout in interface java.sql.Connection
    
    Throws:
    
    java.sql.SQLException

Class DelegatingAuroraConnection

Field Summary

Fields inherited from interface java.sql.Connection

Constructor Summary

Method Summary

Methods inherited from class org.threadly.db.AbstractDelegatingConnection

Methods inherited from class java.lang.Object

Methods inherited from interface java.sql.Connection

Methods inherited from interface java.sql.Wrapper

Field Detail

URL_PREFIX

Constructor Detail

DelegatingAuroraConnection

Method Detail

acceptsURL

toString

close

isClosed

setReadOnly

isReadOnly

setAutoCommit

getAutoCommit

setCatalog

setTransactionIsolation

getTransactionIsolation

getWarnings

clearWarnings

setTypeMap

setHoldability

isValid

setClientInfo

setClientInfo

setSchema

abort

setNetworkTimeout