IAnnotatedElement 接口
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示当前在此 VM 中运行的程序的带批注元素。
[Android.Runtime.Register("java/lang/reflect/AnnotatedElement", "", "Java.Lang.Reflect.IAnnotatedElementInvoker")]
public interface IAnnotatedElement : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable
[<Android.Runtime.Register("java/lang/reflect/AnnotatedElement", "", "Java.Lang.Reflect.IAnnotatedElementInvoker")>]
type IAnnotatedElement = interface
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- 派生
- 属性
- 实现
注解
表示当前在此 VM 中运行的程序的带批注元素。 此接口允许以反射性读取批注。 此接口中方法返回的所有批注都是不可变且可序列化的。 此接口的方法返回的数组可由调用方修改,而不会影响返回给其他调用方的数组。
Android 注意:返回不同类型的多个批注的方法,例如 #getAnnotations() ,并且 #getDeclaredAnnotations() 可能会受到 DEX 格式所指定的批注类型的显式字符代码排序的影响。 不保证在单个元素上返回不同类型的批注,其顺序在源中声明。
和#getAnnotationsByType(Class)#getDeclaredAnnotationsByType(Class)方法在元素上支持同一类型的多个批注。 如果任一方法的参数是可重复的批注类型(JLS 9.6),则该方法将“查看”容器批注(JLS 9.7),并返回容器内的任何批注。 容器批注可以在编译时生成,以包装参数类型的多个批注。
在整个接口中使用术语 <>em 直接呈现</>em<、>em<间接呈现>/em、<em>present</em 和 >em<associated>/em<> 来准确描述方法返回的批注:
<ul>
<如果>E 在原始源中由 < 注释,><>在元素 E 上直接存在/em。
<如果>E 由 < 的容器注释注释注释,则 a 注释 ><>在元素 E 上间接存在/em。
<li>An annotation A is present on an element E ifither:
<ul>
<li>A 直接存在于 E 上;或
<li>No annotation of A's type is directly present on E, and E is a class , and S's type is inheritable, and A is present on the superclass of E.
</ul>
<li>注释 A 与<>元素 < 关联的>/em(如果有):
<ul>
<li>A 直接或间接存在于 E 上;或
<li>没有 E 上直接或间接存在的 A 类型的注释,E 是类,A 的类型是可继承的,A 与 E 的超级类相关联。
</ul>
</ul>
下表总结了此接口中哪些批注存在不同方法。
<table class=“plain”>caption Overview of of presence of type of presence by different AnnotatedElement methods</caption><thead><tr>th colspan=2 scope=“col”<Method></th><colspan=4 scope=“col”>kind of Presence</th><tr>th scope=“col”<Return Type></th scope=“>col”Signature</><th><scope=“col”>Directly Present</th><scope=“col”><>Indirectly Present</><th scope=“col”>Present</><th th scope=“col”>Associated</th></thead><tbody><><td style=“text-align:right”>T</td><th scope=“row” style=“font-weight:normal; text-align:left”>#getAnnotation(Class) getAnnotation(Class<T>)<td></td><td><>< style=“text-align:center”>X</td><td/td><></tr><><td style=”text-align:right“>Annotation[]</td><th scope=”row“ style=”font-weight:normal; text-align:left“>#getAnnotations getAnnotations()<td></td><td td><td>< style=”text-align:center“>X</td><td/tr><><td><>< style=”text-align:right“>T[]</td><th scope=”row“ style=”font-weight:normal; text-align:left“>#getAnnotationsByType(Class) getAnnotationsByType(Class<T>)<td></td><td td></td><><>< style=”text-align:center“>X</td/tr><>td<>< style=”text-align:right“>T</td><th scope=”row“ style=”font-weight:normal; text-align:left“>#getDeclaredAnnotation(Class) getDeclaredAnnotation(Class<T>)<td style=”text-align:center“>X</><><><td td td/td td td/td><>< td><></tr><><td style=”text-align:right“>Annotation[]</td><th scope=”row“ style=”font-weight:normal;text-align:left“>#getDeclaredAnnotations getDeclaredAnnotations()<td style=”text-align:center“>X</td><td/td><>< td/td><td></td><></tr><><td style=”text-align:right“>T[]</td><th scope=”row“ style=”font-weight:normal; text-align:left“>#getDeclaredAnnotationsByType(Class) getDeclaredAnnotationsByType(Class<T>)<td style=”text-align:center“>X</td><td td style=”text-align:center“>X</td><td/td td><><></td></tr></tbody></table>
对于调用 get[Declared]AnnotationsByType( Class < T >),将计算在 E 上直接或间接存在的批注的顺序,就像 E 上的间接呈现批注直接存在于 E 上,以容器批注的值元素中出现的顺序。
如果批注类型 T 最初<不是></em> 可重复的,并且以后修改为可重复,则需记住几个兼容性问题。
T 的包含批注类型为 TC。
<ul>
<li>修改 T 可重复是源和二进制与 T 的现有用法兼容,与 现有 TC 的使用兼容。
也就是说,对于源兼容性,包含 T 类型或 TC 类型的注释的源代码仍将编译。 为了实现二进制兼容性,具有 T 类型或 TC 类型的注释的类文件(或者与类型 T 或类型 TC 的其他用途)的类文件将链接到修改后的 T 版本(如果它们与早期版本链接)。
(批注类型 TC 在修改为正式可 重复之前, 可以非正式地充当包含批注类型的操作。或者,当 T 进行可重复时, 可以将 TC 作为新类型引入。
<li>如果元素上存在批注类型 TC ,并且 T 修改为可重复使用 TC 作为其包含批注类型,则:
<ul>
<li>T 的更改 在行为上 get[Declared]Annotation(Class<T>) 与 T 或TC 的参数的行为兼容, get[Declared]Annotations() 因为由于 TC 成为 T 的包含批注类型,因此方法的结果不会更改。
<li>对 T 的 get[Declared]AnnotationsByType(Class<T>) 更改会更改使用 T 参数调用的方法的结果,因为这些方法现在会将 TC 类型的批注识别为 T 的容器批注,并会“查看”它以公开 T 类型的注释。
</ul>
<li>如果元素上存在 T 类型的批注,并且 T 是可重复的,并且将 更多的 T 类型的批注添加到元素中:
<ul>
<li>T 类型的批注的添加既是源兼容,又与二进制兼容。
<li>添加 T 类型的注释会更改方法和get[Declared]Annotation(Class<T>)方法的结果get[Declared]Annotations(),因为这些方法现在只会在元素上看到容器批注,并且看不到类型为 T 的注释。
<li>:添加 T 类型的批注会更改方法的结果,因为它们的结果 get[Declared]AnnotationsByType(Class<T>) 将公开 T 类型的附加批注,而以前它们只公开了 类型 T 的单个批注。
</ul>
</ul>
如果此接口中某个方法返回的批注包含(直接或间接) Class引用在此 VM 中无法访问的类的 -valued 成员,则尝试通过对返回的批注调用相关的类返回方法来读取该类将导致一个 TypeNotPresentException。
同样,尝试读取枚举值成员会导致 EnumConstantNotPresentException 在批注中的枚举常量不再存在于枚举类型中时。
如果使用值元素指示类型 TC 的批注类型 @Repeatable(meta-)进行批注,但 TC 未声明value()返回类型为 T[] 的方法,则会引发类型的java.lang.annotation.AnnotationFormatError异常。
最后,尝试读取其定义不相容的成员将导致或 java.lang.annotation.AnnotationTypeMismatchException 错误 java.lang.annotation.IncompleteAnnotationException。
在 1.5 中添加。
Java文档java.lang.reflect.AnnotatedElement。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
属性
| 名称 | 说明 |
|---|---|
| Handle |
获取基础 Android 对象的 JNI 值。 (继承自 IJavaObject) |
| JniIdentityHashCode |
返回包装实例的值 |
| JniManagedPeerState |
托管对等方的状态。 (继承自 IJavaPeerable) |
| JniObjectReferenceControlBlock |
表示当前在此 VM 中运行的程序的带批注元素。 (继承自 IJavaPeerable) |
| JniPeerMembers |
成员访问和调用支持。 (继承自 IJavaPeerable) |
| PeerReference |
返回JniObjectReference包装的Java对象实例。 (继承自 IJavaPeerable) |
方法
| 名称 | 说明 |
|---|---|
| Disposed() |
在释放实例时调用。 (继承自 IJavaPeerable) |
| DisposeUnlessReferenced() |
如果没有对此实例的未完成引用,则调用 |
| Finalized() |
在实例完成时调用。 (继承自 IJavaPeerable) |
| GetAnnotation(Class) |
如果此类批注为 <em>present</em>,则返回指定类型的此元素的批注,否则返回 null。 |
| GetAnnotations() |
返回此元素上 em 存在/em< 的批注>。<> |
| GetAnnotationsByType(Class) |
返回与此元素关联的/em< 的批注。><> |
| GetDeclaredAnnotation(Class) |
如果此类批注直接<>存在</em>,则返回指定类型的此元素的批注,否则返回 null。 |
| GetDeclaredAnnotations() |
返回此元素上直接存在的/em< 的批注。><> |
| GetDeclaredAnnotationsByType(Class) |
如果此类批注直接<存在/em> 或 <em>间接存在<>/em<,则返回指定类型的此元素的批注>(s)。 |
| IsAnnotationPresent(Class) |
如果指定类型的批注在此元素上为 <em>present</em> ,则返回 true,否则返回 false。 |
| SetJniIdentityHashCode(Int32) |
设置由 |
| SetJniManagedPeerState(JniManagedPeerStates) |
表示当前在此 VM 中运行的程序的带批注元素。 (继承自 IJavaPeerable) |
| SetPeerReference(JniObjectReference) |
设置由 |
| UnregisterFromRuntime() |
取消注册此实例,使运行时不会从将来 Java.Interop.JniRuntime+JniValueManager.PeekValue 的调用中返回它。 (继承自 IJavaPeerable) |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
表示当前在此 VM 中运行的程序的带批注元素。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |