Constructor Detail

• EclipseAnnotationHandler

  public EclipseAnnotationHandler()

Method Detail

• handle

  public abstract void handle(AnnotationValues<T> annotation,
            org.eclipse.jdt.internal.compiler.ast.Annotation ast,
            EclipseNode annotationNode)

  Called when an annotation is found that is likely to match the annotation you're interested in. Be aware that you'll be called for ANY annotation node in the source that looks like a match. There is, for example, no guarantee that the annotation node belongs to a method, even if you set your TargetType in the annotation to methods only.

  Parameters:

  annotation - The actual annotation - use this object to retrieve the annotation parameters.

  ast - The Eclipse AST node representing the annotation.

  annotationNode - The Lombok AST wrapper around the 'ast' parameter. You can use this object to travel back up the chain (something javac AST can't do) to the parent of the annotation, as well as access useful methods such as generating warnings or errors focused on the annotation.

• preHandle

  public void preHandle(AnnotationValues<T> annotation,
               org.eclipse.jdt.internal.compiler.ast.Annotation ast,
               EclipseNode annotationNode)

  Called when you want to defer until post diet, and we're still in pre-diet. May be called not at all or multiple times, so make sure this method is idempotent if run more than once, and whatever you do here should also be done in the main 'handle' method. NB: This method exists because in certain cases, within eclipse, you have to create i.e. a field before referencing it in generated code. You still have to create the field, if its not already there, in 'handle', because for example preHandle would never even be called in ecj mode.

• getAnnotationHandledByThisHandler

  public Class<T> getAnnotationHandledByThisHandler()

  This handler is a handler for the given annotation; you don't normally need to override this class as the annotation type is extracted from your extends EclipseAnnotationHandler<AnnotationTypeHere> signature.