Package org.apache.commons.digester.annotations

Class FromAnnotationsRuleSet

java.lang.Object

org.apache.commons.digester.annotations.FromAnnotationsRuleSet

All Implemented Interfaces:

RuleSet

public final class FromAnnotationsRuleSet
extends Object
implements RuleSet

A RuleSet implementation that's able to inject Rules created with the annotations analysis.

Since:

2.1

Field Summary

Fields

Modifier and Type	Field	Description
private final DigesterLoader	digesterLoader
private final Set<Class<?>>	mappedClasses	Maintains all the classes that this RuleSet produces mapping for.
private String	namespaceURI	The namespace URI.
private final Map<String,List<AnnotationRuleProvider<Annotation,AnnotatedElement,Rule>>>	rules	The data structure that stores the patterns/AnnotationRuleProvider pairs.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	FromAnnotationsRuleSet(DigesterLoader digesterLoader)	Created a new FromAnnotationsRuleSet instance.

Method Summary

Modifier and Type	Method	Description
protected void	addMappedClass(Class<?> clazz)	Remember that this RuleSet is able to build Digester mapping rules for the input type.
void	addRuleInstances(Digester digester)	Add the set of Rule instances defined in this RuleSet to the specified Digester instance, associating them with our namespace URI (if any).
<A extends Annotation, E extends AnnotatedElement, R extends Rule, T extends AnnotationRuleProvider<A, E, R>> void	addRuleProvider(String pattern, Class<T> klass, A annotation, E element)	Builds and register an AnnotationRuleProvider for a specific pattern.
void	addRuleProvider(String pattern, AnnotationRuleProvider<? extends Annotation,? extends AnnotatedElement,? extends Rule> ruleProvider)	Register an AnnotationRuleProvider for a specific pattern.
void	addRules(Class<?> target)	Analyzes the target class and adds the AnnotationRuleProviders to this FromAnnotationsRuleSet.
void	addRulesProviderFrom(FromAnnotationsRuleSet ruleSet)	Add created AnnotationRuleProviders created in another analysis session.
String	getNamespaceURI()	Return the namespace URI that will be applied to all Rule instances created from this RuleSet.
<T extends AnnotationRuleProvider<? extends Annotation, ? extends AnnotatedElement, ? extends Rule>> T	getProvider(String pattern, Class<T> providerClass)	Retrieves a specific instance of the AnnotationRuleProvider for the input pattern.
private Map<String,List<AnnotationRuleProvider<Annotation,AnnotatedElement,Rule>>>	getRules()	Returns the data structure the patterns/AnnotationRuleProvider pairs.
protected boolean	mapsClass(Class<?> clazz)	Checks if this RuleSet builds Digester mapping rules for the input type.
void	setNamespaceURI(String namespaceURI)	Sets the namespace URI that will be applied to all Rule instances created from this RuleSet.
String	toString()

Methods inherited from class java.lang.Object

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

Field Details

rules

private final Map<String,List<AnnotationRuleProvider<Annotation,AnnotatedElement,Rule>>> rules

The data structure that stores the patterns/AnnotationRuleProvider pairs.

mappedClasses

private final Set<Class<?>> mappedClasses

Maintains all the classes that this RuleSet produces mapping for.

digesterLoader

private final DigesterLoader digesterLoader

namespaceURI

private volatile String namespaceURI

The namespace URI.

Constructor Details

FromAnnotationsRuleSet

protected FromAnnotationsRuleSet(DigesterLoader digesterLoader)

Created a new FromAnnotationsRuleSet instance.

Parameters:

digesterLoader - the parent DigesterLoader.

Method Details

addRuleInstances

public void addRuleInstances(Digester digester)

Add the set of Rule instances defined in this RuleSet to the specified Digester instance, associating them with our namespace URI (if any). This method should only be called by a Digester instance.

Specified by:

addRuleInstances in interface RuleSet

Parameters:

digester - Digester instance to which the new Rule instances should be added.

addRules

public void addRules(Class<?> target)

Analyzes the target class and adds the AnnotationRuleProviders to this FromAnnotationsRuleSet.

Parameters:

target - the class has to be analyzed.

addRuleProvider

public <A extends Annotation,
E extends AnnotatedElement,
R extends Rule,
T extends AnnotationRuleProvider<A,
E,
R>>
void addRuleProvider(String pattern,
 Class<T> klass,
 A annotation,
 E element)

Builds and register an AnnotationRuleProvider for a specific pattern.

Type Parameters:

T - the AnnotationRuleProvider type.

Parameters:

pattern - the pattern has to be associated to the rule provider.

klass - the AnnotationRuleProvider type has to be instantiated.

annotation - the current visited annotation.

element - the current visited element.

addRuleProvider

public void addRuleProvider(String pattern,
 AnnotationRuleProvider<? extends Annotation,? extends AnnotatedElement,? extends Rule> ruleProvider)

Register an AnnotationRuleProvider for a specific pattern.

Parameters:

pattern - the pattern has to be associated to the rule provider.

ruleProvider - the provider that builds the digester rule.

getProvider

public <T extends AnnotationRuleProvider<? extends Annotation,
? extends AnnotatedElement,
? extends Rule>>
T getProvider(String pattern,
 Class<T> providerClass)

Retrieves a specific instance of the AnnotationRuleProvider for the input pattern.

Type Parameters:

T - the AnnotationRuleProvider type

Parameters:

pattern - the input pattern

providerClass - the AnnotationRuleProvider class

Returns:

an AnnotationRuleProvider for the input pattern if found, null otherwise.

addRulesProviderFrom

public void addRulesProviderFrom(FromAnnotationsRuleSet ruleSet)

Add created AnnotationRuleProviders created in another analysis session.

Parameters:

ruleSet - the RuleSet created in another analysis session.

mapsClass

protected boolean mapsClass(Class<?> clazz)

Checks if this RuleSet builds Digester mapping rules for the input type.

Parameters:

clazz - the input type.

Returns:

true, if this RuleSet builds Digester mapping rules for the input type, false otherwise.

addMappedClass

protected void addMappedClass(Class<?> clazz)

Remember that this RuleSet is able to build Digester mapping rules for the input type.

Parameters:

clazz - the input type.

getRules

private Map<String,List<AnnotationRuleProvider<Annotation,AnnotatedElement,Rule>>> getRules()

Returns the data structure the patterns/AnnotationRuleProvider pairs.

Returns:

the data structure the patterns/AnnotationRuleProvider pairs.

getNamespaceURI

public String getNamespaceURI()

Return the namespace URI that will be applied to all Rule instances created from this RuleSet.

Specified by:

getNamespaceURI in interface RuleSet

setNamespaceURI

public void setNamespaceURI(String namespaceURI)

Sets the namespace URI that will be applied to all Rule instances created from this RuleSet.

Parameters:

namespaceURI - the namespace URI that will be applied to all Rule instances created from this RuleSet.

toString

public String toString()

Overrides:

toString in class Object