java.lang.annotation

インタフェース Annotation

既知のすべての実装クラス:

Action, Addressing, BindingType, ConstructorProperties, Deprecated, DescriptorKey, Documented, FaultAction, Generated, HandlerChain, Inherited, InitParam, MTOM, MXBean, Oneway, Override, PostConstruct, PreDestroy, RequestWrapper, Resource, Resources, RespectBinding, ResponseWrapper, Retention, SafeVarargs, ServiceMode, SOAPBinding, SOAPMessageHandler, SOAPMessageHandlers, SupportedAnnotationTypes, SupportedOptions, SupportedSourceVersion, SuppressWarnings, Target, Transient, WebEndpoint, WebFault, WebMethod, WebParam, WebResult, WebService, WebServiceClient, WebServiceFeatureAnnotation, 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, XmlSeeAlso, XmlTransient, XmlType, XmlValue

public interface Annotation

すべての注釈型によって拡張される共通のインタフェースです。これを手動で拡張するインタフェースは注釈型を定義しないこと、また、このインタフェース自体は注釈型を定義しないことに留意してください。 注釈型の詳細については、『Java™ 言語仕様』のセクション 9.6 を参照してください。

導入されたバージョン:

1.5

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
Class<? extends Annotation>	annotationType() この注釈の注釈型を返します。
boolean	equals(Object obj) 指定されたオブジェクトがこれと論理的に等価な注釈を表す場合に、true を返します。
int	hashCode() この注釈のハッシュコードを返します。次に定義を示します。
String	toString() この注釈の文字列表現を返します。

メソッドの詳細

equals

boolean equals(Object obj)

指定されたオブジェクトがこれと論理的に等価な注釈を表す場合に、true を返します。つまり、指定されたオブジェクトがこのインスタンスと同じ注釈型のインスタンスであり、そのメンバーすべてがこの注釈の対応するメンバーと等しい場合に、true を返します。次に、定義を示します。

• x と y という値を持つ 2 つの対応するプリミティブ型メンバーは、x == y のときに等価とみなされる。ただし、型が float または double である場合は除く。
• x と y という値を持つ 2 つの対応する float メンバーは、Float.valueOf(x).equals(Float.valueOf(y)) の場合に等価とみなされる。(== 演算子とは違い、NaN はそれ自体と等価とみなされ、0.0f は -0.0f と等価ではないとみなされる)
• x と y という値を持つ 2 つの対応する double メンバーは、Double.valueOf(x).equals(Double.valueOf(y)) の場合に等価とみなされる。(== 演算子とは違い、NaN はそれ自体と等価とみなされ、0.0 は -0.0 と等価ではないとみなされる)
• x と y という値を持つ 2 つの対応する String、Class、列挙、または注釈型メンバーは、x.equals(y) のときに等価とみなされる。(この定義は注釈型のメンバーに対して再帰的である)
• x と y という値を持つ 2 つの対応する配列型メンバーは、Arrays.equals(long[], long[]) の適切なオーバーロードに対して Arrays.equals(x, y) のときに等価とみなされる。

オーバーライド:

equals、クラス: Object

パラメータ:

obj - 比較対象の参照オブジェクト。

戻り値:

指定されたオブジェクトが論理的にこれと等しい注釈を表す場合に true、そうでない場合は false

関連項目:

Object.hashCode(), HashMap

hashCode

int hashCode()

この注釈のハッシュコードを返します。次に定義を示します。

注釈のハッシュコードは、そのメンバー (デフォルト値を持つものを含む) のハッシュコードの合計です。次に定義を示します。 注釈メンバーのハッシュコードは、メンバー値のハッシュコードの XOR (String.hashCode() で計算されたメンバー名のハッシュコード x 127) です。次に定義を示します。

メンバー値のハッシュコードは、型によって異なります。

• v というプリミティブ値のハッシュコードは、WrapperType.valueOf(v).hashCode() と等価である。ここで、WrapperType は v (Byte、Character、Double、Float、Integer、Long、Short、または Boolean) というプリミティブ型に対応するラッパー型である。
• I v という文字列、列挙、クラス、または注釈メンバーの値のハッシュコードは、v.hashCode() を呼び出すことで計算される。注釈メンバー値の場合、これは再帰的な定義である
• 配列メンバー値のハッシュコードは、その値に対して Arrays.hashCode の適切なオーバーロードを呼び出すことで計算される。(プリミティブ型およびオブジェクト参照型についてそれぞれ 1 つのオーバーロードが行われる)

オーバーライド:

hashCode、クラス: Object

戻り値:

この注釈のハッシュコード

関連項目:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

String toString()

この注釈の文字列表現を返します。この表現の詳細は実装によって異なります。一般的な例を、次に示します。

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

オーバーライド:

toString、クラス: Object

戻り値:

この注釈の文字列表現

annotationType

Class<? extends Annotation> annotationType()

この注釈の注釈型を返します。