net.sourceforge.stripes.controller

Class BindingPolicyManager

java.lang.Object

net.sourceforge.stripes.controller.BindingPolicyManager

@StrictBinding(defaultPolicy=ALLOW)
public class BindingPolicyManager
extends Object

Manages the policies observed by DefaultActionBeanPropertyBinder when binding properties to an ActionBean.

Author:

Ben Gunter

See Also:

StrictBinding

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	BindingPolicyManager(Class<?> beanClass) Create a new instance to handle binding security for the given type.

Method Summary

Methods

Modifier and Type	Method and Description
protected StrictBinding	getAnnotation(Class<?> beanType) Get the StrictBinding annotation for a class, checking all its superclasses if necessary.
Class<?>	getBeanClass() Get the bean class.
StrictBinding.Policy	getDefaultPolicy() Get the default policy.
static BindingPolicyManager	getInstance(Class<?> beanType) Get the policy manager for the given class.
protected String[]	getValidatedProperties(Class<?> beanClass) Get all the properties and nested properties of the given class for which there is a corresponding ValidationMetadata, as returned by ValidationMetadataProvider.getValidationMetadata(Class, ParameterName).
protected Pattern	globToPattern(String... globArray) Converts a glob to a regex Pattern.
boolean	isBindingAllowed(PropertyExpressionEvaluation eval) Indicates if binding is allowed for the given expression.
protected boolean	usesIllegalNodeValueType(PropertyExpressionEvaluation eval) Indicates if any node in the given PropertyExpressionEvaluation has a value type that is assignable from any of the classes listed in ILLEGAL_NODE_VALUE_TYPES.

Methods inherited from class java.lang.Object

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

Constructor Detail

BindingPolicyManager

protected BindingPolicyManager(Class<?> beanClass)

Create a new instance to handle binding security for the given type.

Parameters:

beanClass - the class to which the binding policy applies

Method Detail

getInstance

public static BindingPolicyManager getInstance(Class<?> beanType)

Get the policy manager for the given class. Instances are cached and returned on subsequent calls.

Parameters:

beanType - the class whose policy manager is to be retrieved

Returns:

a policy manager

isBindingAllowed

public boolean isBindingAllowed(PropertyExpressionEvaluation eval)

Indicates if binding is allowed for the given expression.

Parameters:

eval - a property expression that has been evaluated against an ActionBean

Returns:

true if binding is allowed; false if not

usesIllegalNodeValueType

protected boolean usesIllegalNodeValueType(PropertyExpressionEvaluation eval)

Indicates if any node in the given PropertyExpressionEvaluation has a value type that is assignable from any of the classes listed in ILLEGAL_NODE_VALUE_TYPES.

Parameters:

eval - a property expression that has been evaluated against an ActionBean

Returns:

true if the expression uses an illegal node value type; false otherwise

getAnnotation

protected StrictBinding getAnnotation(Class<?> beanType)

Get the StrictBinding annotation for a class, checking all its superclasses if necessary. If no annotation is found, then one will be returned whose default policy is to allow binding to all properties.

Parameters:

beanType - the class to get the StrictBinding annotation for

Returns:

An annotation. This method never returns null.

getValidatedProperties

protected String[] getValidatedProperties(Class<?> beanClass)

Get all the properties and nested properties of the given class for which there is a corresponding ValidationMetadata, as returned by ValidationMetadataProvider.getValidationMetadata(Class, ParameterName). The idea here is that if the bean property must be validated, then it is expected that the property may be bound to the bean.

Parameters:

beanClass - a class

Returns:

The validated properties. If no properties are annotated then null.

See Also:

ValidationMetadataProvider.getValidationMetadata(Class)

getBeanClass

public Class<?> getBeanClass()

Get the bean class.

Returns:

the bean class

getDefaultPolicy

public StrictBinding.Policy getDefaultPolicy()

Get the default policy.

Returns:

the policy

globToPattern

protected Pattern globToPattern(String... globArray)

Converts a glob to a regex Pattern.

Parameters:

globArray - an array of property name globs, each of which may be a comma separated list of globs

Returns:

the pattern