javax.validation.metadata

Interface BeanDescriptor

All Superinterfaces:

ElementDescriptor

public interface BeanDescriptor
extends ElementDescriptor

Describes a constrained Java Bean and the constraints associated to it. All objects returned by the methods of this descriptor (and associated objects including ConstraintDescriptors) are immutable.

Author:

Emmanuel Bernard, Gunnar Morling

Nested Class Summary

Nested classes/interfaces inherited from interface javax.validation.metadata.ElementDescriptor

ElementDescriptor.ConstraintFinder, ElementDescriptor.Kind

Method Summary

Methods

Modifier and Type	Method and Description
Set<ConstructorDescriptor>	getConstrainedConstructors() Returns a set with descriptors for the constrained constructors of the type represented by this descriptor.
Set<MethodDescriptor>	getConstrainedMethods() Returns a set with descriptors for the constrained methods of the type represented by this descriptor.
Set<PropertyDescriptor>	getConstrainedProperties() Returns a set of property descriptors having at least one constraint defined or marked as cascaded (@Valid).
ConstructorDescriptor	getConstraintsForConstructor(Class<?>... parameterTypes) Returns a constructor descriptor for the given constructor.
MethodDescriptor	getConstraintsForMethod(String methodName, Class<?>... parameterTypes) Returns a method descriptor for the given method.
PropertyDescriptor	getConstraintsForProperty(String propertyName) Return the property descriptor for a given property.
boolean	isBeanConstrained() Returns true if the bean involves validation: a constraint is hosted on the bean itself a constraint is hosted on one of the bean properties a bean property is marked for cascaded validation (@Valid) a constraint is hosted on the return value or a method parameter of one of the bean's methods or the return value or a method parameter of one of the bean's methods is marked for cascaded validation (@Valid)

Methods inherited from interface javax.validation.metadata.ElementDescriptor

as, findConstraints, getConstraintDescriptors, getElementClass, getKind, hasConstraints

Method Detail

isBeanConstrained

boolean isBeanConstrained()

Returns true if the bean involves validation:

• a constraint is hosted on the bean itself
• a constraint is hosted on one of the bean properties
• a bean property is marked for cascaded validation (@Valid)
• a constraint is hosted on the return value or a method parameter of one of the bean's methods
• or the return value or a method parameter of one of the bean's methods is marked for cascaded validation (@Valid)

Returns:

true if the bean involves validation, false otherwise.

getConstraintsForProperty

PropertyDescriptor getConstraintsForProperty(String propertyName)

Return the property descriptor for a given property. Return null if the property does not exist or has no constraint nor is marked as cascaded (see getConstrainedProperties() ) Properties of super types are considered.

Parameters:

propertyName - property evaluated

Returns:

the property descriptor for a given property.

Throws:

IllegalArgumentException - if propertyName is null

getConstrainedProperties

Set<PropertyDescriptor> getConstrainedProperties()

Returns a set of property descriptors having at least one constraint defined or marked as cascaded (@Valid). If not property matches, an empty set is returned. Properties of super types are considered.

Returns:

Returns the set of PropertyDescriptors for the constraint properties. If there are no constraint properties the empty set is returned

getConstraintsForMethod

MethodDescriptor getConstraintsForMethod(String methodName,
                                       Class<?>... parameterTypes)

Returns a method descriptor for the given method. Returns null if no method with the given name and parameter types exists or the specified method neither has parameter or return value constraints nor a parameter or return value marked for cascaded validation. Methods of super types are considered.

Parameters:

methodName - The name of the method.

parameterTypes - The parameter types of the method.

Returns:

A method descriptor for the given method.

Throws:

IllegalArgumentException - if methodName is null

Since:

1.1

getConstrainedMethods

Set<MethodDescriptor> getConstrainedMethods()

Returns a set with descriptors for the constrained methods of the type represented by this descriptor. Constrained are all those methods which have at least one parameter or return value constraint or at least one parameter or return value marked for cascaded validation. Methods of super types are considered.

Returns:

A set with descriptors for the constrained methods of this type. Will be empty if this type has no constrained methods but never null.

Since:

1.1

getConstraintsForConstructor

ConstructorDescriptor getConstraintsForConstructor(Class<?>... parameterTypes)

Returns a constructor descriptor for the given constructor. Returns null if no constructor with the given parameter types exists or the specified constructor neither has parameter or return value constraints nor a parameter or return value marked for cascaded validation. Constructor of super types are considered.

Parameters:

parameterTypes - The parameter types of the constructor.

Returns:

A constructor descriptor for the given constructor.

Since:

1.1

getConstrainedConstructors

Set<ConstructorDescriptor> getConstrainedConstructors()

Returns a set with descriptors for the constrained constructors of the type represented by this descriptor. Constrained are all those constructors which have at least one parameter or return value constraint or at least one parameter or return value marked for cascaded validation.

Returns:

A set with descriptors for the constrained constructor of this type. Will be empty if this type has no constrained constructor but never null.

Since:

1.1