Package 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, TracingContext, 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 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 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
    Description
    default <T extends Context>
    Optional<T>
    as(Class<T> clazz)
    Returns an @{link Optional} which contains the first context in the chain whose type is a sub-type of the provided Context class if one exists, or an empty optional if none is present.
    <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.
    default Optional<Context>
    get(String contextName)
    Returns an Optional containing the first context in the chain whose context name matches the provided name, or an empty Optional if none is present.
    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 Details

    • 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.

    • as

      default <T extends Context> Optional<T> as(Class<T> clazz)
      Returns an @{link Optional} which contains the first context in the chain whose type is a sub-type of the provided Context class if one exists, or an empty optional if none is present. 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:
      An Optional containing the first context in the chain whose type is a sub-type of the provided Context class, or an empty optional if no such Context exists in the 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.

    • get

      default Optional<Context> get(String contextName)
      Returns an Optional containing the first context in the chain whose context name matches the provided name, or an empty Optional if none is present.
      Parameters:
      contextName - The name of the context to be returned.
      Returns:
      An Optional containing the first context in the chain whose name matches the provided context name, an empty optional if none is present.

    • 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.