spoon.processing

Class AbstractAnnotationProcessor<A extends java.lang.annotation.Annotation,E extends CtElement>

java.lang.Object

spoon.processing.AbstractProcessor<E>

spoon.processing.AbstractAnnotationProcessor<A,E>

All Implemented Interfaces:

AnnotationProcessor<A,E>, FactoryAccessor, Processor<E>

public abstract class AbstractAnnotationProcessor<A extends java.lang.annotation.Annotation,E extends CtElement>
extends AbstractProcessor<E>
implements AnnotationProcessor<A,E>

This class defines an abstract annotation processor to be subclassed by the user for defining new annotation processors including Java 8 annotations.

Constructor Summary

Constructors

Constructor and Description
AbstractAnnotationProcessor() Empty constructor only for all processors (invoked by Spoon).

Method Summary

Modifier and Type	Method and Description
protected void	addConsumedAnnotationType(java.lang.Class<? extends A> annotationType) Adds a consumed annotation type (to be used in subclasses constructors).
protected void	addProcessedAnnotationType(java.lang.Class<? extends A> annotationType) Adds a processed annotation type (to be used in subclasses constructors).
protected void	clearConsumedAnnotationTypes() Clears the consumed annotation types.
protected void	clearProcessedAnnotationTypes() Clears the processed annotation types.
java.util.Set<java.lang.Class<? extends A>>	getConsumedAnnotationTypes() Gets the annotations types consumed by this processor.
java.util.Set<java.lang.Class<? extends A>>	getProcessedAnnotationTypes() Gets the annotations processed by this annotation processor, that is to say the annotation types that trigger the AnnotationProcessor.process(Annotation, CtElement) method when visiting a program element.
boolean	inferConsumedAnnotationType() Returns true (default) if the processor automatically infers the consumed annotation type to the A actual type.
boolean	isToBeProcessed(E element) Returns true if the element is annotated with an annotation whose type is processed.
void	process(E element) A callback method upcalled by the meta-model scanner to perform a dedicated job on the currently scanned element.
protected void	removeConsumedAnnotationType(java.lang.Class<? extends A> annotationType) Removes a processed annotation type.
protected void	removeProcessedAnnotationType(java.lang.Class<? extends A> annotationType) Removes a processed annotation type.
boolean	shoudBeConsumed(CtAnnotation<? extends java.lang.annotation.Annotation> annotation) Returns true if this annotation should be removed from the processed code.

Methods inherited from class spoon.processing.AbstractProcessor

addProcessedElementType, clearProcessedElementType, getEnvironment, getFactory, getProcessedElementTypes, getTraversalStrategy, init, initProperties, interrupt, loadProperties, process, processingDone, removeProcessedElementType, setFactory

Methods inherited from class java.lang.Object

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

Methods inherited from interface spoon.processing.AnnotationProcessor

process

Methods inherited from interface spoon.processing.Processor

getEnvironment, getProcessedElementTypes, getTraversalStrategy, init, initProperties, interrupt, process, processingDone

Methods inherited from interface spoon.processing.FactoryAccessor

getFactory, setFactory

Constructor Detail

AbstractAnnotationProcessor

public AbstractAnnotationProcessor()

Empty constructor only for all processors (invoked by Spoon).

Method Detail

addConsumedAnnotationType

protected final void addConsumedAnnotationType(java.lang.Class<? extends A> annotationType)

Adds a consumed annotation type (to be used in subclasses constructors). A consumed annotation type is also part of the processed annotation types.

addProcessedAnnotationType

protected final void addProcessedAnnotationType(java.lang.Class<? extends A> annotationType)

Adds a processed annotation type (to be used in subclasses constructors).

removeProcessedAnnotationType

protected final void removeProcessedAnnotationType(java.lang.Class<? extends A> annotationType)

Removes a processed annotation type.

clearProcessedAnnotationTypes

protected final void clearProcessedAnnotationTypes()

Clears the processed annotation types.

clearConsumedAnnotationTypes

protected final void clearConsumedAnnotationTypes()

Clears the consumed annotation types.

removeConsumedAnnotationType

protected final void removeConsumedAnnotationType(java.lang.Class<? extends A> annotationType)

Removes a processed annotation type.

getConsumedAnnotationTypes

public final java.util.Set<java.lang.Class<? extends A>> getConsumedAnnotationTypes()

Description copied from interface: AnnotationProcessor

Gets the annotations types consumed by this processor. A consumed annotation is a special kind of processed annotation (see AnnotationProcessor.getProcessedAnnotationTypes() that is automatically removed from the program once the associated processor has finished its job.

Specified by:

getConsumedAnnotationTypes in interface AnnotationProcessor<A extends java.lang.annotation.Annotation,E extends CtElement>

Returns:

the annotation classes

getProcessedAnnotationTypes

public final java.util.Set<java.lang.Class<? extends A>> getProcessedAnnotationTypes()

Description copied from interface: AnnotationProcessor

Gets the annotations processed by this annotation processor, that is to say the annotation types that trigger the AnnotationProcessor.process(Annotation, CtElement) method when visiting a program element. The processed annotation types includes all the consumed annotation types.

Specified by:

getProcessedAnnotationTypes in interface AnnotationProcessor<A extends java.lang.annotation.Annotation,E extends CtElement>

Returns:

the annotation classes

inferConsumedAnnotationType

public boolean inferConsumedAnnotationType()

Description copied from interface: AnnotationProcessor

Returns true (default) if the processor automatically infers the consumed annotation type to the A actual type.

Specified by:

inferConsumedAnnotationType in interface AnnotationProcessor<A extends java.lang.annotation.Annotation,E extends CtElement>

isToBeProcessed

public final boolean isToBeProcessed(E element)

Returns true if the element is annotated with an annotation whose type is processed.

Specified by:

isToBeProcessed in interface Processor<E extends CtElement>

Overrides:

isToBeProcessed in class AbstractProcessor<E extends CtElement>

Parameters:

element - the candidate

Returns:

true if the candidate is to be processed by the Processor.process(CtElement)

process

public final void process(E element)

Description copied from interface: Processor

A callback method upcalled by the meta-model scanner to perform a dedicated job on the currently scanned element. The way Spoon upcalls this method depends on the processed element types ( Processor.getProcessedElementTypes()), the traversal strategy ( Processor.getTraversalStrategy()), and the used processing manager ( Environment.getManager(). Also, this method is upcalled only if the method Processor.isToBeProcessed(CtElement) returns true for a given scanned element. In order to manually scan the meta-model, one can define the Processor.process() method instead.

Specified by:

process in interface Processor<E extends CtElement>

Parameters:

element - the element that is currently being scanned

shoudBeConsumed

public boolean shoudBeConsumed(CtAnnotation<? extends java.lang.annotation.Annotation> annotation)

Returns true if this annotation should be removed from the processed code. Removes all annotations A on elements E.

Specified by:

shoudBeConsumed in interface AnnotationProcessor<A extends java.lang.annotation.Annotation,E extends CtElement>