All Known Subinterfaces:
public interface AnnotationProcessorFactory
A factory for creating annotation processors.
Each factory is responsible for creating processors for one or more
The factory is said to support these types.
Each implementation of an AnnotationProcessorFactory
must provide a public no-argument constructor to be used by tools to
instantiate the factory.
- Returns the options recognized by this factory or by any of the
processors it may create.
processor-specific options are included, each of which begins
with "-A". For example, if this factory recognizes
options such as -Adebug -Aloglevel=3, it will
return the strings "-Adebug" and "-Aloglevel".
A tool might use this information to determine if any
options provided by a user are unrecognized by any processor,
in which case it may wish to report an error.
- the options recognized by this factory or by any of the
processors it may create, or an empty collection if none
- Returns the names of the annotation types supported by this factory.
An element of the result may be the canonical (fully qualified) name
of a supported annotation type. Alternately it may be of the form
representing the set of all annotation types
with canonical names beginning with "name."
Finally, "*" by itself represents the set of all
- the names of the annotation types supported by this factory
- Returns an annotation processor for a set of annotation
types. The set will be empty if the factory supports
"*" and the specified type declarations have
no annotations. Note that the set of annotation types may be
empty for other reasons, such as giving the factory an
opportunity to register a listener. An
AnnotationProcessorFactory must gracefully handle an
empty set of annotations; an appropriate response to an empty
set will often be returning
atds - type declarations of the annotation types to be processed
env - environment to use during processing
- an annotation processor for the given annotation types,
or null if the types are not supported or the
processor cannot be created
Copyright (c) IBM Corp. and others 2000, 2008. All Rights Reserved.