-
public interface RoundEnvironment
注释处理工具框架将为 provide an annotation processor with an object implementing this interface ,使得处理器可以查询关于一轮注释处理的信息。- 从以下版本开始:
- 1.6
-
-
方法摘要
所有方法 接口方法 抽象方法 Default Methods Modifier and Type 方法 描述 boolean
errorRaised()
如果在上一轮处理中出现错误,则返回true
; 否则返回false
。Set<? extends Element>
getElementsAnnotatedWith(Class<? extends Annotation> a)
返回使用给定注释类型注释的元素。Set<? extends Element>
getElementsAnnotatedWith(TypeElement a)
返回使用给定注释类型注释的元素。default Set<? extends Element>
getElementsAnnotatedWithAny(Set<Class<? extends Annotation>> annotations)
返回使用一个或多个给定注释类型注释的元素。default Set<? extends Element>
getElementsAnnotatedWithAny(TypeElement... annotations)
返回使用一个或多个给定注释类型注释的元素。Set<? extends Element>
getRootElements()
返回上一轮生成的注释处理的root elements 。boolean
processingOver()
返回true
如果由此轮生成的类型不会受到后续轮注的处理; 否则返回false
。
-
-
-
方法详细信息
-
processingOver
boolean processingOver()
返回true
如果由此轮生成的类型不会受到后续轮注的处理; 否则返回false
。- 结果
-
true
如果此轮生成的类型不会受到后续轮注的处理; 否则返回false
-
errorRaised
boolean errorRaised()
返回true
如果在上一轮处理中出现错误; 否则返回false
。- 结果
-
true
如果在前一轮处理中出现错误; 否则返回false
-
getRootElements
Set<? extends Element> getRootElements()
返回上一轮生成的注释处理的root elements 。- 结果
- 上一轮生成的注释处理的根元素,如果没有,则为空集
-
getElementsAnnotatedWith
Set<? extends Element> getElementsAnnotatedWith(TypeElement a)
返回使用给定注释类型注释的元素。 注释可以直接显示或继承。 仅返回本轮注释处理中包含的包元素,模块元素和类型元素,或者返回在其中声明的成员,构造函数,参数或类型参数的声明。 包含的类型元素为root types ,嵌套在其中的任何成员类型。 包的元素不包括在内,因为该包的package-info
文件已创建。 同样,模块的元素也不被认为是因为该模块的一个module-info
文件被创建- 参数
-
a
- 请求的注释类型 - 结果
- 用给定注释类型注释的元素,如果没有,则为空集
- 异常
-
IllegalArgumentException
- 如果参数不表示注释类型
-
getElementsAnnotatedWithAny
default Set<? extends Element> getElementsAnnotatedWithAny(TypeElement... annotations)
返回使用一个或多个给定注释类型注释的元素。- API Note:
- 当通过查找注释类型及其包含的注释类型同时处理重复注释时,此方法可能很有用。
- 实现要求:
-
此方法的默认实现将创建一个空结果集,迭代参数数组中的注释,每个注释上调用
getElementsAnnotatedWith(TypeElement)
,并将这些结果添加到结果集中。 最后,结果集的内容作为不可修改的集合返回。 - 参数
-
annotations
- 请求的注释类型 - 结果
- 用一个或多个给定注释类型注释的元素,如果没有,则为空集
- 异常
-
IllegalArgumentException
- 如果参数集的任何元素不表示注释类型 - 从以下版本开始:
- 9
- See The Java™ Language Specification:
- 9.6.3可重复注释类型
-
getElementsAnnotatedWith
Set<? extends Element> getElementsAnnotatedWith(Class<? extends Annotation> a)
返回使用给定注释类型注释的元素。 注释可以直接显示或继承。 仅返回本轮注释处理中包含的包元素,模块元素和类型元素,或者返回在其中声明的成员,构造函数,参数或类型参数的声明。 包含的类型元素为root types ,嵌套在其中的任何成员类型。 软件包中的元素不被认为包括在内,因为该软件包的package-info
文件已创建。 同样,模块的元素也不被认为是因为该模块的一个module-info
文件被创建- 参数
-
a
- 请求的注释类型 - 结果
- 用给定注释类型注释的元素,如果没有,则为空集
- 异常
-
IllegalArgumentException
- 如果参数不表示注释类型
-
getElementsAnnotatedWithAny
default Set<? extends Element> getElementsAnnotatedWithAny(Set<Class<? extends Annotation>> annotations)
返回使用一个或多个给定注释类型注释的元素。- API Note:
- 当通过查找注释类型及其包含的注释类型同时处理重复注释时,此方法可能很有用。
- 实现要求:
-
此方法的默认实现将创建一个空结果集,迭代在每个注释上调用
getElementsAnnotatedWith(Class)
的参数集中的注释,并将这些结果添加到结果集。 最后,结果集的内容作为不可修改的集合返回。 - 参数
-
annotations
- 请求的注释类型 - 结果
- 用一个或多个给定注释类型注释的元素,如果没有,则为空集
- 异常
-
IllegalArgumentException
- 如果参数集的任何元素不表示注释类型 - 从以下版本开始:
- 9
- See The Java™ Language Specification:
- 9.6.3可重复注释类型
-
-