1 /* |
1 /* |
2 * Copyright (c) 2005, 2006, Oracle and/or its affiliates. All rights reserved. |
2 * Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved. |
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
4 * |
4 * |
5 * This code is free software; you can redistribute it and/or modify it |
5 * This code is free software; you can redistribute it and/or modify it |
6 * under the terms of the GNU General Public License version 2 only, as |
6 * under the terms of the GNU General Public License version 2 only, as |
7 * published by the Free Software Foundation. Oracle designates this |
7 * published by the Free Software Foundation. Oracle designates this |
64 * artifacts outside of this model. |
64 * artifacts outside of this model. |
65 * |
65 * |
66 * <p>During annotation processing, operating on incomplete or |
66 * <p>During annotation processing, operating on incomplete or |
67 * erroneous programs is necessary; however, there are fewer |
67 * erroneous programs is necessary; however, there are fewer |
68 * guarantees about the nature of the resulting model. If the source |
68 * guarantees about the nature of the resulting model. If the source |
69 * code is not syntactically well-formed, a model may or may not be |
69 * code is not syntactically well-formed or has some other |
70 * provided as a quality of implementation issue. If a program is |
70 * irrecoverable error that could not be removed by the generation of |
71 * syntactically valid but erroneous in some other fashion, the |
71 * new types, a model may or may not be provided as a quality of |
72 * returned model must have no less information than if all the method |
72 * implementation issue. |
73 * bodies in the program were replaced by {@code "throw new |
73 * If a program is syntactically valid but erroneous in some other |
74 * RuntimeException();"}. If a program refers to a missing type XYZ, |
74 * fashion, any returned model must have no less information than if |
|
75 * all the method bodies in the program were replaced by {@code "throw |
|
76 * new RuntimeException();"}. If a program refers to a missing type XYZ, |
75 * the returned model must contain no less information than if the |
77 * the returned model must contain no less information than if the |
76 * declaration of type XYZ were assumed to be {@code "class XYZ {}"}, |
78 * declaration of type XYZ were assumed to be {@code "class XYZ {}"}, |
77 * {@code "interface XYZ {}"}, {@code "enum XYZ {}"}, or {@code |
79 * {@code "interface XYZ {}"}, {@code "enum XYZ {}"}, or {@code |
78 * "@interface XYZ {}"}. If a program refers to a missing type {@code |
80 * "@interface XYZ {}"}. If a program refers to a missing type {@code |
79 * XYZ<K1, ... ,Kn>}, the returned model must contain no less |
81 * XYZ<K1, ... ,Kn>}, the returned model must contain no less |