Interface HttpSessionCollection.AttributeScopeController

All Known Implementing Classes:
AbstractHttpSessionCollection.ApplicationScopeController, AbstractHttpSessionCollection.GlobalScopeController
Enclosing interface:
HttpSessionCollection

public static interface HttpSessionCollection.AttributeScopeController
The AttributeScopeController is an optional interface that is used to selectively scope attributes in cases when a session may be shared across more than one application. This enables different applications to potentially use the same attribute names for application-scope state without accidentally reading, updating, or removing other applications' attributes. Furthermore, in addition to having application-scoped information in the session, it allows the session to contain global (unscoped) information that is readable, updatable, and removable by any of the applications that share the session.
Since:
Coherence 3.4.2
  • Method Summary

    Modifier and Type
    Method
    Description
    Given a potentially qualified attribute name, return the original (fully unqualified) attribute name.
    void
    init(String sApplication)
    Initialize the AttributeScopeController.
    Given an attribute name, return a potentially qualified name.
  • Method Details

    • init

      void init(String sApplication)
      Initialize the AttributeScopeController.
      Parameters:
      sApplication - an application name that may be used to qualify attribute names
    • qualifyAttributeName

      String qualifyAttributeName(String sAttribute)
      Given an attribute name, return a potentially qualified name.

      Attribute names may be qualified in order to avoid collisions when a session is shared across multiple applications. In other words, when sessions are shared across multiple applications, attributes which are not intended to be shared across multiple applications must be qualified so that other applications do not inadvertently overwrite, use, or remove these attributes.

      Parameters:
      sAttribute - the name that the application identifies the attribute by
      Returns:
      either the name as passed in, or a qualified name
    • extractAttributeName

      String extractAttributeName(String sAttribute)
      Given a potentially qualified attribute name, return the original (fully unqualified) attribute name. The unqualified attribute name is the name that the application identifies the attribute by. Attributes that are shared across applications remain unqualified, whereas attributes that are private to an application are qualified in order to scope them to that application.
      Parameters:
      sAttribute - an attribute name that may be qualified
      Returns:
      the unqualified attribute name