org.forgerock.services.context

Interface Context

All Known Subinterfaces:

MessageContext, MessageInfoContext

All Known Implementing Classes:

AbstractContext, AdviceContext, ApiVersionRouterContext, AttributesContext, ClientContext, MessageContextImpl, OAuth2Context, RequestAuditContext, RootContext, SecurityContext, SelfServiceContext, SessionContext, TransactionIdContext, UriRouterContext

public interface Context

Type-safe contextual information associated with the processing of a request in an application. Contexts are linked together in a stack with a RootContext at the bottom of the stack. Each context maintains a reference to its parent context which can be accessed using the Context.getParent()} method. Context implementations may provide information about the client, the end-user, auditing information, routing decisions, etc. While contexts are arranged in a stack, application code will usually access contexts using the Context.asContext(Class) method:

     Context context = ...; // Opaque reference to the context stack

     String remoteHost = context.asContext(ClientContext.class).getRemoteHost();
     context.asContext(AttributesContext.class).getAttributes().put("key", "value");
 

Alternatively, scripted applications will usually access contexts by name:

     var remoteHost = context.client.remoteHost;
     context.attributes.key = "value";
 

Context implementations should inherit from AbstractContext and ensure that they can be serialized to and from JSON.

Method Summary

Modifier and Type	Method and Description
<T extends Context> T	asContext(Class<T> clazz) Returns the first context in the chain whose type is a sub-type of the provided Context class.
boolean	containsContext(Class<? extends Context> clazz) Returns true if there is a context in the chain whose type is a sub-type of the provided Context class.
boolean	containsContext(String contextName) Returns true if there is a context in the chain whose name matches the provided context name.
Context	getContext(String contextName) Returns the first context in the chain whose context name matches the provided name.
String	getContextName() Get this Context's name.
String	getId() Returns the unique ID identifying this context, usually a UUID.
Context	getParent() Returns the parent of this context.
String	getRootId() Returns the unique ID of the root context, usually a UUID.
boolean	isRootContext() Returns true if this context is a root context.
JsonValue	toJsonValue() Return this Context as a JsonValue (for persistence).

Method Detail

getContextName

String getContextName()

Get this Context's name.

Returns:

this object's name

asContext

<T extends Context> T asContext(Class<T> clazz)

Returns the first context in the chain whose type is a sub-type of the provided Context class. The method first checks this context to see if it has the required type, before proceeding to the parent context, and then continuing up the chain of parents until the root context is reached.

Type Parameters:

T - The context type.

Parameters:

clazz - The class of context to be returned.

Returns:

The first context in the chain whose type is a sub-type of the provided Context class.

Throws:

IllegalArgumentException - If no matching context was found in this context's parent chain.

getContext

Context getContext(String contextName)

Returns the first context in the chain whose context name matches the provided name.

Parameters:

contextName - The name of the context to be returned.

Returns:

The first context in the chain whose name matches the provided context name.

Throws:

IllegalArgumentException - If no matching context was found in this context's parent chain.

containsContext

boolean containsContext(Class<? extends Context> clazz)

Returns true if there is a context in the chain whose type is a sub-type of the provided Context class. The method first checks this context to see if it has the required type, before proceeding to the parent context, and then continuing up the chain of parents until the root context is reached.

Parameters:

clazz - The class of context to be checked.

Returns:

true if there is a context in the chain whose type is a sub-type of the provided Context class.

containsContext

boolean containsContext(String contextName)

Returns true if there is a context in the chain whose name matches the provided context name.

Parameters:

contextName - The name of the context to locate.

Returns:

true if there is a context in the chain whose context name matches contextName.

getId

String getId()

Returns the unique ID identifying this context, usually a UUID. If no ID has been defined then the ID of the parent context will be returned.

Returns:

The unique ID identifying this context. If no ID has been defined then the ID of the parent context will be returned.

getRootId

String getRootId()

Returns the unique ID of the root context, usually a UUID.

Returns:

The unique ID of the root context.

getParent

Context getParent()

Returns the parent of this context.

Returns:

The parent of this context, or null if this context is a root context.

isRootContext

boolean isRootContext()

Returns true if this context is a root context.

Returns:

true if this context is a root context.

toJsonValue

JsonValue toJsonValue()

Return this Context as a JsonValue (for persistence).

Returns:

the Context data as a JsonValue.