net.shibboleth.idp.profile.spring.factory

Class FlowDefinitionRegistryFactoryBean

java.lang.Object

org.springframework.beans.factory.config.AbstractFactoryBean<org.springframework.webflow.definition.registry.FlowDefinitionRegistry>

net.shibboleth.idp.profile.spring.factory.FlowDefinitionRegistryFactoryBean

All Implemented Interfaces:

org.springframework.beans.factory.Aware, org.springframework.beans.factory.BeanClassLoaderAware, org.springframework.beans.factory.BeanFactoryAware, org.springframework.beans.factory.DisposableBean, org.springframework.beans.factory.FactoryBean<org.springframework.webflow.definition.registry.FlowDefinitionRegistry>, org.springframework.beans.factory.InitializingBean

public class FlowDefinitionRegistryFactoryBean
extends org.springframework.beans.factory.config.AbstractFactoryBean<org.springframework.webflow.definition.registry.FlowDefinitionRegistry>

A bean factory for creating FlowDefinitionRegistry instances, based on the programmatic builder built into SWF.

Overrides the resource factory implementation, which they neglected to support, and that's where all the fancy derivation of flow IDs lives.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	FlowDefinitionRegistryFactoryBean.DefaultFlowRegistry Copied from SWF, a basic registry implementation.

Field Summary

Fields

Modifier and Type	Field and Description
private String	basePath Base path for registry.
private org.springframework.webflow.engine.builder.support.FlowBuilderServices	flowBuilderServices Required collaborator.
private Map<String,String>	flowLocationPatterns Pattern-based flow mappings from pattern to base location to apply.
private Map<String,String>	flowLocations Explicit flow mappings from flow ID to resource path.
private FlowDefinitionResourceFactory	flowResourceFactory Overriden resource factory, the whole reason for this class.
private org.slf4j.Logger	log Class logger.
private org.springframework.webflow.definition.registry.FlowDefinitionRegistry	parent Optional parent reference.

Fields inherited from class org.springframework.beans.factory.config.AbstractFactoryBean

logger

Constructor Summary

Constructors

Constructor and Description
FlowDefinitionRegistryFactoryBean() Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected org.springframework.webflow.definition.registry.FlowDefinitionRegistry	createInstance()
protected void	destroyInstance(org.springframework.webflow.definition.registry.FlowDefinitionRegistry instance)
Class<?>	getObjectType()
private void	registerFlow(org.springframework.webflow.config.FlowDefinitionResource resource, FlowDefinitionRegistryFactoryBean.DefaultFlowRegistry flowRegistry) Register a flow resource into the registry.
private void	registerFlowLocationPatterns(FlowDefinitionRegistryFactoryBean.DefaultFlowRegistry flowRegistry) Register flows derived from resource patterns.
private void	registerFlowLocations(FlowDefinitionRegistryFactoryBean.DefaultFlowRegistry flowRegistry) Register explicit flow mappings.
void	setBasePath(String path) Configure the base path where flow definitions are found.
void	setFlowBuilderServices(org.springframework.webflow.engine.builder.support.FlowBuilderServices builderServices) Set the FlowBuilderServices to use for defining custom services needed to build the flows registered in this registry.
void	setFlowLocationPatterns(Map<String,String> patternMap) Registers a set of flows resolved from a resource location pattern as the mapping key, with an optional value containing a portion to strip when computing the flow IDs, with the default base location applied if empty/null.
void	setFlowLocations(Map<String,String> locationMap) Set explicit flow ID to resource mappings.
void	setParent(org.springframework.webflow.definition.registry.FlowDefinitionRegistry parentRegistry) Set a parent registry.
private void	updateFlowAttributes(org.springframework.webflow.core.collection.LocalAttributeMap<Object> attributes) Update flow attributes with development bit.

Methods inherited from class org.springframework.beans.factory.config.AbstractFactoryBean

afterPropertiesSet, destroy, getBeanFactory, getBeanTypeConverter, getEarlySingletonInterfaces, getObject, isSingleton, setBeanClassLoader, setBeanFactory, setSingleton

Methods inherited from class java.lang.Object

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

Field Detail

log

@Nonnull
private final org.slf4j.Logger log

Class logger.

flowLocations

@Nonnull
@NonnullElements
private Map<String,String> flowLocations

Explicit flow mappings from flow ID to resource path.

flowLocationPatterns

@Nonnull
@NonnullElements
private Map<String,String> flowLocationPatterns

Pattern-based flow mappings from pattern to base location to apply.

flowBuilderServices

@Nullable
private org.springframework.webflow.engine.builder.support.FlowBuilderServices flowBuilderServices

Required collaborator.

basePath

@Nullable
private String basePath

Base path for registry.

parent

@Nullable
private org.springframework.webflow.definition.registry.FlowDefinitionRegistry parent

Optional parent reference.

flowResourceFactory

@Nullable
private FlowDefinitionResourceFactory flowResourceFactory

Overriden resource factory, the whole reason for this class.

Constructor Detail

FlowDefinitionRegistryFactoryBean

public FlowDefinitionRegistryFactoryBean()

Constructor.

Method Detail

getObjectType

public Class<?> getObjectType()

Specified by:

getObjectType in interface org.springframework.beans.factory.FactoryBean<org.springframework.webflow.definition.registry.FlowDefinitionRegistry>

Specified by:

getObjectType in class org.springframework.beans.factory.config.AbstractFactoryBean<org.springframework.webflow.definition.registry.FlowDefinitionRegistry>

setBasePath

public void setBasePath(@Nullable
               String path)

Configure the base path where flow definitions are found.

Parameters:

path - the base path to use

setFlowLocations

public void setFlowLocations(@Nonnull@NonnullElements
                    Map<String,String> locationMap)

Set explicit flow ID to resource mappings.

Parameters:

locationMap - mappings from flow ID to resource

setFlowLocationPatterns

public void setFlowLocationPatterns(@Nonnull
                           Map<String,String> patternMap)

Registers a set of flows resolved from a resource location pattern as the mapping key, with an optional value containing a portion to strip when computing the flow IDs, with the default base location applied if empty/null.

Parameters:

patternMap - the mappings to use

setFlowBuilderServices

public void setFlowBuilderServices(@Nonnull
                          org.springframework.webflow.engine.builder.support.FlowBuilderServices builderServices)

Set the FlowBuilderServices to use for defining custom services needed to build the flows registered in this registry.

Parameters:

builderServices - the FlowBuilderServices instance

setParent

public void setParent(@Nullable
             org.springframework.webflow.definition.registry.FlowDefinitionRegistry parentRegistry)

Set a parent registry.

Parameters:

parentRegistry - the parent registry

createInstance

protected org.springframework.webflow.definition.registry.FlowDefinitionRegistry createInstance()
                                                                                         throws Exception

Specified by:

createInstance in class org.springframework.beans.factory.config.AbstractFactoryBean<org.springframework.webflow.definition.registry.FlowDefinitionRegistry>

Throws:

Exception

destroyInstance

protected void destroyInstance(org.springframework.webflow.definition.registry.FlowDefinitionRegistry instance)
                        throws Exception

Overrides:

destroyInstance in class org.springframework.beans.factory.config.AbstractFactoryBean<org.springframework.webflow.definition.registry.FlowDefinitionRegistry>

Throws:

Exception

registerFlowLocations

private void registerFlowLocations(@Nonnull
                         FlowDefinitionRegistryFactoryBean.DefaultFlowRegistry flowRegistry)

Register explicit flow mappings.

Parameters:

flowRegistry - the flow registry

registerFlowLocationPatterns

private void registerFlowLocationPatterns(@Nonnull
                                FlowDefinitionRegistryFactoryBean.DefaultFlowRegistry flowRegistry)

Register flows derived from resource patterns.

Parameters:

flowRegistry - the flow registry

registerFlow

private void registerFlow(@Nonnull
                org.springframework.webflow.config.FlowDefinitionResource resource,
                @Nonnull
                FlowDefinitionRegistryFactoryBean.DefaultFlowRegistry flowRegistry)

Register a flow resource into the registry.

Parameters:

resource - the flow resource

flowRegistry - the registry

updateFlowAttributes

private void updateFlowAttributes(@Nonnull
                        org.springframework.webflow.core.collection.LocalAttributeMap<Object> attributes)

Update flow attributes with development bit.

Parameters:

attributes - attribute map to update