software.amazon.jdbc

Class PluginCallContext

java.lang.Object

software.amazon.jdbc.PluginCallContext

public class PluginCallContext
extends java.lang.Object

Per-JDBC-call context that flows through the plugin pipeline. Plugins can store and retrieve attributes, similar to servlet request attributes.

The context is scoped to the PluginServiceImpl instance, which has the same lifecycle as the wrapper connection. It is automatically cleared before each call begins. Upstream plugins (e.g., SQL parsing) can populate attributes that downstream plugins (e.g., encryption, caching) consume.

Access the context from any plugin via PluginService.getCallContext().

Constructor Summary

Constructors

Constructor and Description
PluginCallContext()

Method Summary

Modifier and Type	Method and Description
<T> T	getAttribute(java.lang.String key, java.lang.Class<T> type) Gets an attribute from the context.
boolean	hasAttribute(java.lang.String key) Checks if an attribute exists.
void	reset() Clears all attributes from the context.
void	setAttribute(java.lang.String key, java.lang.Object value) Sets an attribute in the context.

Methods inherited from class java.lang.Object

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

Constructor Detail

PluginCallContext

public PluginCallContext()

Method Detail

reset

public void reset()

Clears all attributes from the context.

setAttribute

public void setAttribute(java.lang.String key,
                         java.lang.Object value)

Sets an attribute in the context.

Parameters:

key - the attribute key

value - the attribute value

getAttribute

public <T> T getAttribute(java.lang.String key,
                          java.lang.Class<T> type)

Gets an attribute from the context.

Type Parameters:

T - the expected type

Parameters:

key - the attribute key

type - the expected type

Returns:

the attribute value, or null if not set

Throws:

java.lang.ClassCastException - if the value is not of the expected type

hasAttribute

public boolean hasAttribute(java.lang.String key)

Checks if an attribute exists.

Parameters:

key - the attribute key

Returns:

true if the attribute is set