org.apache.struts2.config

Class BeanSelectionProvider

java.lang.Object

org.apache.struts2.config.BeanSelectionProvider

All Implemented Interfaces:

ConfigurationProvider, ContainerProvider, PackageProvider

public class BeanSelectionProvider
extends Object
implements ConfigurationProvider

Selects the implementations of key framework extension points, using the loaded property constants. The implementations are selected from the container builder using the name defined in its associated property. The default implementation name will always be "struts".

The following is a list of the allowed extension points:

Type	Property	Scope	Description
com.opensymphony.xwork2.ObjectFactory	struts.objectFactory	singleton	Creates actions, results, and interceptors
com.opensymphony.xwork2.ActionProxyFactory	struts.actionProxyFactory	singleton	Creates the ActionProxy
com.opensymphony.xwork2.util.ObjectTypeDeterminer	struts.objectTypeDeterminer	singleton	Determines what the key and element class of a Map or Collection should be
org.apache.struts2.dispatcher.mapper.ActionMapper	struts.mapper.class	singleton	Determines the ActionMapping from a request and a URI from an ActionMapping
org.apache.struts2.dispatcher.multipart.MultiPartRequest	struts.multipart.parser	per request	Parses a multipart request (file upload)
org.apache.struts2.views.freemarker.FreemarkerManager	struts.freemarker.manager.classname	singleton	Loads and processes Freemarker templates
org.apache.struts2.views.velocity.VelocityManager	struts.velocity.manager.classname	singleton	Loads and processes Velocity templates
com.opensymphony.xwork2.validator.ActionValidatorManager	struts.actionValidatorManager	singleton	Main interface for validation managers (regular and annotation based). Handles both the loading of configuration and the actual validation (since 2.1)
com.opensymphony.xwork2.util.ValueStackFactory	struts.valueStackFactory	singleton	Creates value stacks (since 2.1)
com.opensymphony.xwork2.reflection.ReflectionProvider	struts.reflectionProvider	singleton	Provides reflection services, key place to plug in a custom expression language (since 2.1)
com.opensymphony.xwork2.reflection.ReflectionContextFactory	struts.reflectionContextFactory	singleton	Creates reflection context maps used for reflection and expression language operations (since 2.1)
com.opensymphony.xwork2.config.PackageProvider	N/A	singleton	All beans registered as PackageProvider implementations will be automatically included in configuration building (since 2.1)
com.opensymphony.xwork2.util.PatternMatcher	struts.patternMatcher	singleton	Matches patterns, such as action names, generally used in configuration (since 2.1)
org.apache.struts2.views.dispatcher.DefaultStaticContentLoader	struts.staticContentLoader	singleton	Loads static resources (since 2.1)
com.opensymphony.xwork2.conversion.impl.XWorkConverter	struts.xworkConverter	singleton	Handles conversion logic and allows to load custom converters per class or per action
com.opensymphony.xwork2.TextProvider	struts.xworkTextProvider	default	Allows provide custom TextProvider for whole application
com.opensymphony.xwork2.LocaleProvider	struts.localeProvider	singleton	Allows provide custom TextProvider for whole application
org.apache.struts2.components.UrlRenderer	struts.urlRenderer	singleton	Allows provide custom implementation of environment specific URL rendering/creating class
com.opensymphony.xwork2.UnknownHandlerManager	struts.unknownHandlerManager	singleton	Implementation of this interface allows handle logic of unknown Actions, Methods or Results
org.apache.struts2.views.util.UrlHelper	struts.view.urlHelper	singleton	Helper class used with URLRenderer to provide exact logic for building URLs
com.opensymphony.xwork2.FileManagerFactory	struts.fileManagerFactory	singleton	Used to create FileManager instance to access files on the File System as also to monitor if reload is needed, can be implemented / overwritten to meet specific an application server needs
com.opensymphony.xwork2.conversion.impl.CollectionConverter	struts.converter.collection	singleton	Converter used to convert any object to Collection and back
com.opensymphony.xwork2.conversion.impl.ArrayConverter	struts.converter.array	singleton	Converter used to convert any object to Array and back
com.opensymphony.xwork2.conversion.impl.DateConverter	struts.converter.date	singleton	Converter used to convert any object to Date and back
com.opensymphony.xwork2.conversion.impl.NumberConverter	struts.converter.number	singleton	Converter used to convert any object to Number and back
com.opensymphony.xwork2.conversion.impl.StringConverter	struts.converter.string	singleton	Converter used to convert any object to String and back
com.opensymphony.xwork2.conversion.ConversionPropertiesProcessor	struts.conversion.properties.processor	singleton	Process Properties to create converters
com.opensymphony.xwork2.conversion.ConversionPropertiesProcessor	struts.converter.file.processor	singleton	Process -conversion.properties file create converters
com.opensymphony.xwork2.conversion.ConversionAnnotationProcessor	struts.converter.annotation.processor	singleton	Process TypeConversion annotation to create converters
com.opensymphony.xwork2.conversion.TypeConverterCreator	struts.converter.creator	singleton	Creates user converters
com.opensymphony.xwork2.conversion.TypeConverterHolder	struts.converter.holder	singleton	Holds user converters' instances
com.opensymphony.xwork2.util.TextParser	struts.expression.parser	singleton	Used to parse expressions like ${foo.bar} or %{bar.foo} but it is up tp the TextParser's implementation what kind of opening char to use (#, $, %, etc)

Implementations are selected using the value of its associated property. That property is used to determine the implementation by:

1. Trying to find an existing bean by that name in the container
2. Trying to find a class by that name, then creating a new bean factory for it
3. Creating a new delegation bean factory that delegates to the configured ObjectFactory at runtime

Finally, this class overrides certain properties if dev mode is enabled:

• struts.i18n.reload = true
• struts.configuration.xml.reload = true

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_BEAN_NAME

Constructor Summary

Constructors

Constructor and Description
BeanSelectionProvider()

Method Summary

Methods

Modifier and Type	Method and Description
void	destroy()
void	init(Configuration configuration)
void	loadPackages()
boolean	needsReload()
void	register(ContainerBuilder builder, LocatableProperties props)

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_BEAN_NAME

public static final String DEFAULT_BEAN_NAME

See Also:

Constant Field Values

Constructor Detail

BeanSelectionProvider

public BeanSelectionProvider()

Method Detail

destroy

public void destroy()

Specified by:

destroy in interface ContainerProvider

loadPackages

public void loadPackages()
                  throws ConfigurationException

Specified by:

loadPackages in interface PackageProvider

Throws:

ConfigurationException

init

public void init(Configuration configuration)
          throws ConfigurationException

Specified by:

init in interface ContainerProvider

Specified by:

init in interface PackageProvider

Throws:

ConfigurationException

needsReload

public boolean needsReload()

Specified by:

needsReload in interface ContainerProvider

Specified by:

needsReload in interface PackageProvider

register

public void register(ContainerBuilder builder,
            LocatableProperties props)

Specified by:

register in interface ContainerProvider