org.ametys.core.authentication

Class CredentialProviderFactory

java.lang.Object

org.ametys.runtime.plugin.component.AbstractLogEnabled

org.ametys.core.authentication.CredentialProviderFactory

All Implemented Interfaces:

LogEnabled, ExtensionPoint<CredentialProviderModel>, Disposable, Initializable, Component, Contextualizable, Serviceable, ThreadSafe

public class CredentialProviderFactory
extends AbstractLogEnabled
implements ExtensionPoint<CredentialProviderModel>, Initializable, ThreadSafe, Component, Serviceable, Contextualizable, Disposable

This extension point handles a list of CredentialProvider handled by the plugins.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	CredentialProviderFactory.CredentialProviderModelParameterParser Class for parsing parameters of a CredentialProviderModel

Field Summary

Fields

Modifier and Type	Field and Description
private Context	_context
private Map<String,CredentialProviderModel>	_cpModels
private ServiceManager	_smanager
static String	ROLE The avalon role

Constructor Summary

Constructors

Constructor and Description
CredentialProviderFactory()

Method Summary

Modifier and Type	Method and Description
protected void	addCredentialProviderModel(String pluginName, Configuration configuration) Add a credential provider model
void	addExtension(String id, String pluginName, String featureName, Configuration configuration) Add an extension to this point.
protected void	configureParamChecker(ParameterCheckerParser parser, Configuration configuration, String pluginName, Map<String,ParameterCheckerDescriptor> parameterCheckers) Configure a parameter checker of a user directory
protected void	configureParameters(CredentialProviderFactory.CredentialProviderModelParameterParser paramParser, Configuration configuration, String pluginName, Map<String,Parameter<ParameterHelper.ParameterType>> parameters) Configure a parameter to access the credential provider
void	contextualize(Context context)
CredentialProvider	createCredentialProvider(String id, String modelId, Map<String,Object> paramsValues, String label) Creates a instance of CredentialProvider
void	dispose()
CredentialProviderModel	getExtension(String id) Returns the named extension
Set<String>	getExtensionsIds() Returns a Set containing the ids of all known extensions
boolean	hasExtension(String id) Returns true if the named extension exists
void	initialize()
void	initializeExtensions() Finalize the initialization of the extensions. This method is called after all addExtension() calls. This is the last step before the actual startup of the application.
void	service(ServiceManager smanager)

Methods inherited from class org.ametys.runtime.plugin.component.AbstractLogEnabled

getLogger, setLogger

Methods inherited from class java.lang.Object

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

Field Detail

ROLE

public static final String ROLE

The avalon role

_cpModels

private Map<String,CredentialProviderModel> _cpModels

_smanager

private ServiceManager _smanager

_context

private Context _context

Constructor Detail

CredentialProviderFactory

public CredentialProviderFactory()

Method Detail

initialize

public void initialize()
                throws Exception

Specified by:

initialize in interface Initializable

Throws:

Exception

dispose

public void dispose()

Specified by:

dispose in interface Disposable

service

public void service(ServiceManager smanager)
             throws ServiceException

Specified by:

service in interface Serviceable

Throws:

ServiceException

contextualize

public void contextualize(Context context)
                   throws ContextException

Specified by:

contextualize in interface Contextualizable

Throws:

ContextException

createCredentialProvider

public CredentialProvider createCredentialProvider(String id,
                                                   String modelId,
                                                   Map<String,Object> paramsValues,
                                                   String label)

Creates a instance of CredentialProvider

Parameters:

id - The unique id of this credential provider instance

modelId - The id of the credential provider model

paramsValues - the parameters's values

label - The optional label

Returns:

a credential provider

addExtension

public void addExtension(String id,
                         String pluginName,
                         String featureName,
                         Configuration configuration)
                  throws ConfigurationException

Description copied from interface: ExtensionPoint

Add an extension to this point. Each implementation knows the meaning of the given configuration.

Specified by:

addExtension in interface ExtensionPoint<CredentialProviderModel>

Parameters:

id - the unique identifier of the extension.

pluginName - Unique identifier for the plugin hosting the extension

featureName - Unique feature identifier (unique for a given pluginName)

configuration - the information about the extension to be added

Throws:

ConfigurationException - when a configuration problem occurs

addCredentialProviderModel

protected void addCredentialProviderModel(String pluginName,
                                          Configuration configuration)
                                   throws ConfigurationException

Add a credential provider model

Parameters:

pluginName - The plugin name

configuration - The configuration

Throws:

ConfigurationException - when a configuration problem occurs

configureParameters

protected void configureParameters(CredentialProviderFactory.CredentialProviderModelParameterParser paramParser,
                                   Configuration configuration,
                                   String pluginName,
                                   Map<String,Parameter<ParameterHelper.ParameterType>> parameters)
                            throws ConfigurationException

Configure a parameter to access the credential provider

Parameters:

paramParser - the parameter parser.

configuration - The parameter configuration.

pluginName - The plugin name

parameters - The model's parameters

Throws:

ConfigurationException - if configuration is incomplete or invalid.

configureParamChecker

protected void configureParamChecker(ParameterCheckerParser parser,
                                     Configuration configuration,
                                     String pluginName,
                                     Map<String,ParameterCheckerDescriptor> parameterCheckers)
                              throws ConfigurationException

Configure a parameter checker of a user directory

Parameters:

parser - the parameter checker parser.

configuration - The parameter checker configuration.

pluginName - The plugin name

parameterCheckers - The model's parameter checkers

Throws:

ConfigurationException - if configuration is incomplete or invalid.

initializeExtensions

public void initializeExtensions()
                          throws Exception

Description copied from interface: ExtensionPoint

Finalize the initialization of the extensions.
This method is called after all addExtension() calls.
This is the last step before the actual startup of the application.

Specified by:

initializeExtensions in interface ExtensionPoint<CredentialProviderModel>

Throws:

Exception - if something wrong occurs

hasExtension

public boolean hasExtension(String id)

Description copied from interface: ExtensionPoint

Returns true if the named extension exists

Specified by:

hasExtension in interface ExtensionPoint<CredentialProviderModel>

Parameters:

id - the unique id of the extension

Returns:

true if the named extension exists

getExtension

public CredentialProviderModel getExtension(String id)

Description copied from interface: ExtensionPoint

Returns the named extension

Specified by:

getExtension in interface ExtensionPoint<CredentialProviderModel>

Parameters:

id - the unique id of the extension

Returns:

the named extension

getExtensionsIds

public Set<String> getExtensionsIds()

Description copied from interface: ExtensionPoint

Returns a Set containing the ids of all known extensions

Specified by:

getExtensionsIds in interface ExtensionPoint<CredentialProviderModel>

Returns:

a Set containing the ids of all known extensions