74 Set<? extends Element> getRootElements(); |
74 Set<? extends Element> getRootElements(); |
75 |
75 |
76 /** |
76 /** |
77 * Returns the elements annotated with the given annotation type. |
77 * Returns the elements annotated with the given annotation type. |
78 * The annotation may appear directly or be inherited. Only |
78 * The annotation may appear directly or be inherited. Only |
79 * package elements and type elements <i>included</i> in this |
79 * package elements, module elements, and type elements <i>included</i> in this |
80 * round of annotation processing, or declarations of members, |
80 * round of annotation processing, or declarations of members, |
81 * constructors, parameters, or type parameters declared within |
81 * constructors, parameters, or type parameters declared within |
82 * those, are returned. Included type elements are {@linkplain |
82 * those, are returned. Included type elements are {@linkplain |
83 * #getRootElements root types} and any member types nested within |
83 * #getRootElements root types} and any member types nested within |
84 * them. Elements in a package are not considered included simply |
84 * them. Elements of a package are not considered included simply |
85 * because a {@code package-info} file for that package was |
85 * because a {@code package-info} file for that package was |
86 * created. |
86 * created. |
|
87 * Likewise, elements of a module are not considered included |
|
88 * simply because a {@code module-info} file for that module was |
|
89 * created |
87 * |
90 * |
88 * @param a annotation type being requested |
91 * @param a annotation type being requested |
89 * @return the elements annotated with the given annotation type, |
92 * @return the elements annotated with the given annotation type, |
90 * or an empty set if there are none |
93 * or an empty set if there are none |
91 * @throws IllegalArgumentException if the argument does not |
94 * @throws IllegalArgumentException if the argument does not |
126 } |
129 } |
127 |
130 |
128 /** |
131 /** |
129 * Returns the elements annotated with the given annotation type. |
132 * Returns the elements annotated with the given annotation type. |
130 * The annotation may appear directly or be inherited. Only |
133 * The annotation may appear directly or be inherited. Only |
131 * package elements and type elements <i>included</i> in this |
134 * package elements, module elements, and type elements <i>included</i> in this |
132 * round of annotation processing, or declarations of members, |
135 * round of annotation processing, or declarations of members, |
133 * constructors, parameters, or type parameters declared within |
136 * constructors, parameters, or type parameters declared within |
134 * those, are returned. Included type elements are {@linkplain |
137 * those, are returned. Included type elements are {@linkplain |
135 * #getRootElements root types} and any member types nested within |
138 * #getRootElements root types} and any member types nested within |
136 * them. Elements in a package are not considered included simply |
139 * them. Elements in a package are not considered included simply |
137 * because a {@code package-info} file for that package was |
140 * because a {@code package-info} file for that package was |
138 * created. |
141 * created. |
|
142 * Likewise, elements of a module are not considered included |
|
143 * simply because a {@code module-info} file for that module was |
|
144 * created |
139 * |
145 * |
140 * @param a annotation type being requested |
146 * @param a annotation type being requested |
141 * @return the elements annotated with the given annotation type, |
147 * @return the elements annotated with the given annotation type, |
142 * or an empty set if there are none |
148 * or an empty set if there are none |
143 * @throws IllegalArgumentException if the argument does not |
149 * @throws IllegalArgumentException if the argument does not |