org.opensaml.security.credential.criteria.impl

Class EvaluableCredentialCriteriaRegistry

java.lang.Object

org.opensaml.security.credential.criteria.impl.EvaluableCredentialCriteriaRegistry

public final class EvaluableCredentialCriteriaRegistry
extends Object

A registry which manages mappings from types of Criterion to the class type which can evaluate that criteria's data against a Credential target. That latter class will be a subtype of EvaluableCredentialCriterion. Each EvaluableCredentialCriterion implementation that is registered MUST implement a single-arg constructor which takes an instance of the Criterion to be evaluated. The evaluable instance is instantiated reflectively based on this requirement.

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_MAPPINGS_FILE Properties file storing default mappings from criteria to evaluable credential criteria.
private static boolean	initialized Flag to track whether registry is initialized.
private static Map<Class<? extends net.shibboleth.utilities.java.support.resolver.Criterion>,Class<? extends EvaluableCredentialCriterion>>	registry Storage for the registry mappings.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	EvaluableCredentialCriteriaRegistry() Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
static void	clearRegistry() Clear all mappings from the registry.
static void	deregister(Class<? extends net.shibboleth.utilities.java.support.resolver.Criterion> criteriaClass) Deregister a criteria-evaluator mapping.
static EvaluableCredentialCriterion	getEvaluator(net.shibboleth.utilities.java.support.resolver.Criterion criteria) Get an instance of EvaluableCredentialCriterion which can evaluate the supplied criteria's requirements against a Credential target.
private static Logger	getLogger() Get an SLF4J Logger.
static void	init() Initialize the registry.
static boolean	isInitialized() Check whether the registry has been initialized.
static void	loadDefaultMappings() Load the default set of criteria-evaluator mappings from the default mappings properties file.
static void	loadMappings(Properties mappings) Load a set of criteria-evaluator mappings from the supplied properties set.
static Class<? extends EvaluableCredentialCriterion>	lookup(Class<? extends net.shibboleth.utilities.java.support.resolver.Criterion> clazz) Lookup the class subtype of EvaluableCredentialCriterion which is registered for the specified Criterion class.
static void	register(Class<? extends net.shibboleth.utilities.java.support.resolver.Criterion> criteriaClass, Class<? extends EvaluableCredentialCriterion> evaluableClass) Register a credential evaluator class for a criteria class.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_MAPPINGS_FILE

public static final String DEFAULT_MAPPINGS_FILE

Properties file storing default mappings from criteria to evaluable credential criteria. Will be loaded as a resource stream relative to this class.

See Also:

Constant Field Values

registry

private static Map<Class<? extends net.shibboleth.utilities.java.support.resolver.Criterion>,Class<? extends EvaluableCredentialCriterion>> registry

Storage for the registry mappings.

initialized

private static boolean initialized

Flag to track whether registry is initialized.

Constructor Detail

EvaluableCredentialCriteriaRegistry

private EvaluableCredentialCriteriaRegistry()

Constructor.

Method Detail

getEvaluator

@Nullable
public static EvaluableCredentialCriterion getEvaluator(@Nonnull
                                                 net.shibboleth.utilities.java.support.resolver.Criterion criteria)
                                                 throws SecurityException

Get an instance of EvaluableCredentialCriterion which can evaluate the supplied criteria's requirements against a Credential target.

Parameters:

criteria - the criteria to be evaluated against a credential

Returns:

an instance of of EvaluableCredentialCriterion representing the specified criteria's requirements

Throws:

SecurityException - thrown if there is an error reflectively instantiating a new instance of EvaluableCredentialCriterion based on class information stored in the registry

lookup

@Nullable
public static Class<? extends EvaluableCredentialCriterion> lookup(@Nonnull
                                                            Class<? extends net.shibboleth.utilities.java.support.resolver.Criterion> clazz)

Lookup the class subtype of EvaluableCredentialCriterion which is registered for the specified Criterion class.

Parameters:

clazz - the Criterion class subtype to lookup

Returns:

the registered EvaluableCredentialCriterion class subtype

register

public static void register(@Nonnull
            Class<? extends net.shibboleth.utilities.java.support.resolver.Criterion> criteriaClass,
            @Nonnull
            Class<? extends EvaluableCredentialCriterion> evaluableClass)

Register a credential evaluator class for a criteria class.

Parameters:

criteriaClass - class subtype of Criterion

evaluableClass - class subtype of EvaluableCredentialCriterion

deregister

public static void deregister(@Nonnull
              Class<? extends net.shibboleth.utilities.java.support.resolver.Criterion> criteriaClass)

Deregister a criteria-evaluator mapping.

Parameters:

criteriaClass - class subtype of Criterion

clearRegistry

public static void clearRegistry()

Clear all mappings from the registry.

isInitialized

public static boolean isInitialized()

Check whether the registry has been initialized.

Returns:

true if registry is already initialized, false otherwise

init

public static void init()

Initialize the registry.

loadDefaultMappings

public static void loadDefaultMappings()

Load the default set of criteria-evaluator mappings from the default mappings properties file.

loadMappings

public static void loadMappings(@Nonnull
                Properties mappings)

Load a set of criteria-evaluator mappings from the supplied properties set.

Parameters:

mappings - properties set where the key is the criteria class name, the value is the evaluator class name

getLogger

@Nonnull
private static Logger getLogger()

Get an SLF4J Logger.

Returns:

a Logger instance