Package jakarta.security.jacc

Class PolicyFactory

java.lang.Object
jakarta.security.jacc.PolicyFactory
public abstract class PolicyFactory extends Object
Abstract factory and finder class for obtaining the instance of the class that implements the PolicyFactory of a provider. The factory will be used to instantiate Policy objects.
Author:
Arjan Tijms
See Also:

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final String
    FACTORY_NAME
     

  • Constructor Summary

    Constructors
    Constructor
    Description
    PolicyFactory()
    Default constructor for if no wrapping is needed
    PolicyFactory(PolicyFactory wrapped)
    If this factory has been decorated, the implementation doing the decorating should push the implementation being wrapped to this constructor.

  • Method Summary

    Modifier and Type
    Method
    Description
    Policy
    getPolicy()
    This method is used to obtain an instance of the provider specific class that implements the Policy interface that corresponds to policy context within the provider.
    abstract Policy
    getPolicy(String contextId)
    This method is used to obtain an instance of the provider specific class that implements the Policy interface that corresponds to policy context within the provider.
    static PolicyFactory
    getPolicyFactory()
    Get the system-wide PolicyFactory implementation.
    PolicyFactory
    getWrapped()
    If this factory has been decorated, the implementation doing the decorating may override this method to provide access to the implementation being wrapped.
    void
    setPolicy(Policy policy)
    Set the context Policy implementation.
    abstract void
    setPolicy(String contextId, Policy policy)
    Set the context Policy implementation.
    static void
    setPolicyFactory(PolicyFactory policyFactory)
    Set the system-wide PolicyFactory implementation.

    Methods inherited from class java.lang.Object

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

  • Field Details

  • Constructor Details

    • PolicyFactory

      public PolicyFactory()
      Default constructor for if no wrapping is needed

    • PolicyFactory

      public PolicyFactory(PolicyFactory wrapped)
      If this factory has been decorated, the implementation doing the decorating should push the implementation being wrapped to this constructor. The getWrapped() will then return the implementation being wrapped.
      Parameters:
      wrapped - The implementation being wrapped.

  • Method Details

    • getPolicyFactory

      public static PolicyFactory getPolicyFactory()
      Get the system-wide PolicyFactory implementation.

      The name of the factory implementation class is obtained from the value of the system property, 

      
     jakarta.security.jacc.PolicyFactory.provider
      This value can also be retrieved from the field PolicyFactory.FACTORY_NAME.
      Returns:
      the system-wide singleton instance of the provider specific PolicyFactory implementation class.
      Throws:
      SecurityException - If an exception was thrown during the class loading, or construction of the default PolicyFactory implementation class; in which case the SecurityException will contain the root Exception as its cause.

    • setPolicyFactory

      public static void setPolicyFactory(PolicyFactory policyFactory)
      Set the system-wide PolicyFactory implementation.

      If an implementation was set previously, it will be replaced.

      Parameters:
      policyFactory - The PolicyFactory instance, which may be null.

    • getWrapped

      public PolicyFactory getWrapped()
      If this factory has been decorated, the implementation doing the decorating may override this method to provide access to the implementation being wrapped.

    • getPolicy

      public Policy getPolicy()
      This method is used to obtain an instance of the provider specific class that implements the Policy interface that corresponds to policy context within the provider. The policy context is identified by the value of the policy context identifier associated with the thread on which the accessor is called.

      For a given determined value of the policy context identifier, this method must always return the same instance of Policy and there must be at most one actual instance of a Policy with a given policy context identifier (during a process context).

      This method should be logically identical to calling getPolicy(String) with as input the value returned from PolicyContext.getContextID().

      Returns:
      an Object that implements the Policy interface corresponding to the identified policy context, or a null if such an Object is not present.

    • setPolicy

      public void setPolicy(Policy policy)
      Set the context Policy implementation.

      If an implementation was set previously, it will be replaced.

      This method should be logically identical to calling setPolicy(String, Policy) with as input for the first parameter the value returned from PolicyContext.getContextID().

      Parameters:
      policy - The policy instance, which may be null.

    • getPolicy

      public abstract Policy getPolicy(String contextId)
      This method is used to obtain an instance of the provider specific class that implements the Policy interface that corresponds to policy context within the provider. The policy context is identified by the value of the policy context identifier associated with the thread on which the accessor is called.

      For a given determined value of the policy context identifier, this method must always return the same instance of Policy and there must be at most one actual instance of a Policy with a given policy context identifier (during a process context).

      Parameters:
      contextId - A String identifying the policy context whose Policy interface is to be returned. The value passed to this parameter can be null, which corresponds to the system-wide default Policy instance.
      Returns:
      an Object that implements the Policy interface corresponding to the identified policy context, or a null if such an Object is not present.

    • setPolicy

      public abstract void setPolicy(String contextId, Policy policy)
      Set the context Policy implementation.

      If an implementation was set previously, it will be replaced.

      Parameters:
      contextId - A String identifying the policy context whose Policy interface is to be returned. The value passed to this parameter can be null, which corresponds to the system-wide default Policy instance.
      policy - The policy instance, which may be null.