Java SE 6
Interfaces used to model elements of the Java programming language.
When used in the context of annotation processing, an accurate model of the element being represented must be returned. As this is a language model, the source code provides the fiducial (reference) representation of the construct in question rather than a representation in an executable output like a class file. Executable output may serve as the basis for creating a modeling element. However, the process of translating source code to executable output may not permit recovering some aspects of the source code representation. For example, annotations with source retention cannot be recovered from class files and class files might not be able to provide source position information. The modifiers on an element may differ in some cases including
During annotation processing, operating on incomplete or
erroneous programs is necessary; however, there are fewer
guarantees about the nature of the resulting model. If the source
code is not syntactically well-formed, a model may or may not be
provided as a quality of implementation issue. If a program is
syntactically valid but erroneous in some other fashion, the
returned model must have no less information than if all the method
bodies in the program were replaced by
Unless otherwise specified in a particular implementation, the collections returned by methods in this package should be expected to be unmodifiable by the caller and unsafe for concurrent access.
Unless otherwise specified, methods in this package will throw
|About DocWeb · Bundles · Export · Export All||Top 10 · Statistics · Login|
Java SE 6· Copyright © 1994-2013 Sun Microsystems, Inc.
All rights reserved. Use is subject to license terms