JavaTM 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 的基本类型的包装器类型(ByteCharacterDoubleFloatIntegerLongShortBoolean)。
 String toString()
          返回此 annotation 的字符串表示形式。
 

方法详细信息

equals

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

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

hashCode

int hashCode()
返回此 annotation 的哈希码,具体说明如下:

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

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

覆盖:
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 的注释类型。


JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策