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 的字元串表示形式。

方法詳細資訊

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 的註釋型別。