com.atlassian.activeobjects.internal

Class ConnectionUnwrapper

java.lang.Object

com.atlassian.activeobjects.internal.ConnectionUnwrapper

public final class ConnectionUnwrapper
extends Object

This utility class is responsible for unwrapping the connection proxies and wrappers to get to the DBMS specific connection underneath (e.g. PGConnection).

It might be used to access some methods exclusive for some DBMS connections.

Since:

3.0.3

Method Summary

Modifier and Type	Method and Description
static Optional<Connection>	tryUnwrapConnection(Connection origin) Try to extract the most nested connection from the possible wrapped passed connection origin.

Methods inherited from class java.lang.Object

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

Method Detail

tryUnwrapConnection

@Nonnull
public static Optional<Connection> tryUnwrapConnection(@Nonnull
                                                                Connection origin)

Try to extract the most nested connection from the possible wrapped passed connection origin. Since the task is impossible to solve in general case (it depends on implementation of Connection), this method provides only best effort guarantees and doesn't guarantee any particular result (there's no clear definition of success). Please check the return value and handle the errors gracefully.

Returns:

The most nested connection that we could get. Optional.empty() if we couldn't extract anything at all.