Annotation (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.lang.annotation
接口 Annotation

所有已知实现类：: BindingType, ConstructorProperties, Deprecated, DescriptorKey, Documented, Generated, HandlerChain, Inherited, InitParam, MXBean, Oneway, Override, PostConstruct, PreDestroy, RequestWrapper, Resource, Resources, ResponseWrapper, Retention, ServiceMode, SOAPBinding, SOAPMessageHandler, SOAPMessageHandlers, SupportedAnnotationTypes, SupportedOptions, SupportedSourceVersion, SuppressWarnings, Target, WebEndpoint, WebFault, WebMethod, WebParam, WebResult, WebService, WebServiceClient, WebServiceProvider, WebServiceRef, WebServiceRefs, XmlAccessorOrder, XmlAccessorType, XmlAnyAttribute, XmlAnyElement, XmlAttachmentRef, XmlAttribute, XmlElement, XmlElementDecl, XmlElementRef, XmlElementRefs, XmlElements, XmlElementWrapper, XmlEnum, XmlEnumValue, XmlID, XmlIDREF, XmlInlineBinaryData, XmlJavaTypeAdapter, XmlJavaTypeAdapters, XmlList, XmlMimeType, XmlMixed, XmlNs, XmlRegistry, XmlRootElement, XmlSchema, XmlSchemaType, XmlSchemaTypes, XmlTransient, XmlType, XmlValue

public interface Annotation

所有 annotation 类型都要扩展的公共接口。注意，手动扩展该公共接口的接口不定义 annotation 类型。还要注意此接口本身不定义 annotation 类型。

从以下版本开始：: 1.5

方法摘要

Class<? extends Annotation> annotationType()
          返回此 annotation 的注释类型。

boolean equals(Object obj)
          如果指定的对象表示在逻辑上等效于此接口的注释，则返回 true。

int hashCode()
          返回此 annotation 的哈希码，具体说明如下：一个 annotation 的哈希码是其成员（包括那些带有默认值的成员）的哈希码的和，具体说明如下： annotation 成员的哈希码是成员值哈希码的 XOR（它是 String.hashCode() 计算得到的成员名哈希码的 127 倍），具体说明如下：成员值的哈希码取决于其类型：基值 v 的哈希码等于 WrapperType.valueOf(v).hashCode()，其中 WrapperType 是对应 v 的基本类型的包装器类型（Byte、Character、Double、Float、Integer、Long、Short 或 Boolean）。

String toString()
          返回此 annotation 的字符串表示形式。

方法摘要
`Class<? extends Annotation>`	`annotationType()` 返回此 annotation 的注释类型。
`boolean`	`equals(Object obj)` 如果指定的对象表示在逻辑上等效于此接口的注释，则返回 true。
`int`	`hashCode()` 返回此 annotation 的哈希码，具体说明如下：一个 annotation 的哈希码是其成员（包括那些带有默认值的成员）的哈希码的和，具体说明如下： annotation 成员的哈希码是成员值哈希码的 XOR（它是 `String.hashCode()` 计算得到的成员名哈希码的 127 倍），具体说明如下：成员值的哈希码取决于其类型：基值 `v` 的哈希码等于 `WrapperType.valueOf(v).hashCode()`，其中 `WrapperType` 是对应 `v` 的基本类型的包装器类型（`Byte`、`Character`、`Double`、`Float`、`Integer`、`Long`、`Short` 或 `Boolean`）。
`String`	`toString()` 返回此 annotation 的字符串表示形式。

方法详细信息

equals

boolean equals(Object obj)

如果指定的对象表示在逻辑上等效于此接口的注释，则返回 true。换句话说，如果指定对象是一个与此实例相同的 annotation 类型的实例，即其所有成员都与此实例中所对应的成员相等，则返回 true，具体说明如下：

如果 x == y，则认为值分别为 x 和 y 的两个对应的基本类型成员相等，除非它们的类型是 float 或 double。
如果 Float.valueOf(x).equals(Float.valueOf(y)) 为真，则认为值分别为 x 和 y 的两个对应的 float 成员相等。（与 == 运算符不同，NaN 被认为等于其自身，并且 0.0f 不等于 -0.0f。）
如果 Double.valueOf(x).equals(Double.valueOf(y)) 为真，则认为值分别为 x 和 y 的两个对应的 double 成员相等。（与 == 运算符不同，NaN 被认为等于其自身，并且 0.0 不等于 -0.0。）
如果 x.equals(y) 为真，则认为值分别为 x 和 y 的两个对应的 String、Class、enum 或 annotation 类型的成员相等。（注意，此定义对于 annotation 类型的成员是递归的。）
对于适当重载的 Arrays.equals(long[], long[])，如果 Arrays.equals(x, y) 为真, 则认为两个对应的数组类型的成员 x 和 y 相等。

覆盖：: 类 Object 中的 equals

参数：: obj - 要与之比较的引用对象。
返回：: 如果指定的对象表示在逻辑上等效于该接口的 annotation，则返回 true，否则返回 false
另请参见：: Object.hashCode(), Hashtable

hashCode

int hashCode()

返回此 annotation 的哈希码，具体说明如下：

一个 annotation 的哈希码是其成员（包括那些带有默认值的成员）的哈希码的和，具体说明如下： annotation 成员的哈希码是成员值哈希码的 XOR（它是 String.hashCode() 计算得到的成员名哈希码的 127 倍），具体说明如下：

成员值的哈希码取决于其类型：

基值 v 的哈希码等于 WrapperType.valueOf(v).hashCode()，其中 WrapperType 是对应 v 的基本类型的包装器类型（Byte、Character、Double、Float、Integer、Long、Short 或 Boolean）。
string、enum、class 或 annotation 的成员值 I 的哈希码 v 是通过调用 v.hashCode() 来计算的。（对于 annotation 成员值，这是一种递归定义。）
数组成员值的哈希码是通过基于该值调用 Arrays.hashCode 的适当重载来计算的。（各种基本类型和对象引用类型分别对应一个重载。）

覆盖：: 类 Object 中的 hashCode

返回：: 此 annotation 的哈希码。
另请参见：: Object.equals(java.lang.Object), Hashtable

toString

String toString()

返回此 annotation 的字符串表示形式。表示形式的细节取决于实现，但下面的情况是最常见的：

   @com.acme.util.Name(first=Alfred, middle=E., last=Neuman)

覆盖：: 类 Object 中的 toString

返回：: 此 annotation 的字符串表示形式

annotationType

Class<? extends Annotation> annotationType()

返回此 annotation 的注释类型。

概述