software.amazon.jdbc.plugin.efm.base

Interface ConnectionContextService

All Known Implementing Classes:

PoolConnectionContextServiceImpl, SimpleConnectionContextServiceImpl

public interface ConnectionContextService

Service for managing connection contexts used during host monitoring.

Implementing classes may choose to use pooling to reduce memory allocation overhead, or may create new context instances on each acquire call (non-pooled). The choice of implementation affects memory usage and allocation patterns:

• Pooled implementations reuse context objects to minimize garbage collection pressure and allocation overhead. Released contexts are returned to the pool for subsequent reuse.
• Non-pooled implementations create a new context instance on each acquire call. The release operation may simply mark the context as inactive without retaining it.

The Host Monitoring Plugins use a pooled connection context service by default.

See Also:

PoolConnectionContextServiceImpl

Method Summary

Modifier and Type	Method and Description
<T extends ConnectionContext> T	acquire(@NonNull java.lang.Class<T> contextClass) Acquire a connection context.
<T extends ConnectionContext> T	acquire(@NonNull java.lang.Class<T> contextClass, @Nullable java.util.function.Consumer<T> initializer) Acquire a connection context with optional initialization.
boolean	release(ConnectionContext context) Release a connection context.

Method Detail

acquire

<T extends ConnectionContext> T acquire(@NonNull java.lang.Class<T> contextClass)

Acquire a connection context. Depending on the implementation, this may return a context from a pool or create a new instance.

Type Parameters:

T - the type of connection context

Parameters:

contextClass - the class type of the connection context to acquire

Returns:

a connection context ready for use

acquire

<T extends ConnectionContext> T acquire(@NonNull java.lang.Class<T> contextClass,
                                        @Nullable java.util.function.Consumer<T> initializer)

Acquire a connection context with optional initialization. Depending on the implementation, this may return a context from a pool or create a new instance. The initializer is invoked on the context before returning it.

Type Parameters:

T - the type of connection context

Parameters:

contextClass - the class type of the connection context to acquire

initializer - optional consumer to initialize the context before use; may be null

Returns:

a connection context ready for use

release

boolean release(ConnectionContext context)

Release a connection context. For pooled implementations, the context is reset and made available for subsequent acquire operations. For non-pooled implementations, the context may simply be marked as inactive.

Parameters:

context - the context to release

Returns:

true if the context was successfully released, false otherwise