java.lang.Object
javax.security.jacc.PolicyConfigurationFactory
- public abstract class PolicyConfigurationFactory
- extends java.lang.Object
Abstract factory and finder class for obtaining the instance of the class
that implements the PolicyConfigurationFactory of a provider. The factory
will be used to instantiate PolicyConfiguration objects that will be used
by the deployment tools of the container to create and manage policy
contexts within the Policy Provider.
Implementation classes must have a public no argument constructor that may
be used to create an operational instance of the factory implementation class.
- Version:
- $Rev: 46019 $ $Date: 2004-09-14 02:56:06 -0700 (Tue, 14 Sep 2004) $
|
Method Summary |
abstract PolicyConfiguration |
getPolicyConfiguration(java.lang.String contextID,
boolean remove)
This method is used to obtain an instance of the provider specific class
that implements the PolicyConfiguration interface that corresponds to
the identified policy context within the provider. |
static PolicyConfigurationFactory |
getPolicyConfigurationFactory()
This static method uses a system property to find and instantiate (via a
public constructor) a provider specific factory implementation class. |
abstract boolean |
inService(java.lang.String contextID)
This method determines if the identified policy context exists with
state "inService" in the Policy provider associated with the factory. |
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
FACTORY_NAME
private static final java.lang.String FACTORY_NAME
- See Also:
- Constant Field Values
policyConfigurationFactory
private static PolicyConfigurationFactory policyConfigurationFactory
PolicyConfigurationFactory
public PolicyConfigurationFactory()
getPolicyConfigurationFactory
public static PolicyConfigurationFactory getPolicyConfigurationFactory()
throws java.lang.ClassNotFoundException,
PolicyContextException
- This static method uses a system property to find and instantiate (via a
public constructor) a provider specific factory implementation class.
The name of the provider specific factory implementation class is
obtained from the value of the system property,
javax.security.jacc.PolicyConfigurationFactory.provider.
getPolicyConfiguration
public abstract PolicyConfiguration getPolicyConfiguration(java.lang.String contextID,
boolean remove)
throws PolicyContextException
- This method is used to obtain an instance of the provider specific class
that implements the PolicyConfiguration interface that corresponds to
the identified policy context within the provider. The methods of the
PolicyConfiguration interface are used to define the policy statements
of the identified policy context.
If at the time of the call, the identified policy context does not exist
in the provider, then the policy context will be created in the provider
and the Object that implements the context's PolicyConfiguration
Interface will be returned. If the state of the identified context is
"deleted" or "inService" it will be transitioned to the "open" state as
a result of the call. The states in the lifecycle of a policy context
are defined by the PolicyConfiguration interface.
For a given value of policy context identifier, this method must always
return the same instance of PolicyConfiguration and there must be at
most one actual instance of a PolicyConfiguration with a given policy
context identifier (during a process context).
To preserve the invariant that there be at most one PolicyConfiguration
object for a given policy context, it may be necessary for this method
to be thread safe.
inService
public abstract boolean inService(java.lang.String contextID)
throws PolicyContextException
- This method determines if the identified policy context exists with
state "inService" in the Policy provider associated with the factory.
JAVADOC | 
SOURCE | 
DOWNLOAD | NESTED | FIELD | CONSTR | METHOD