一,Annotation简介

J2SE5.0提供了很多新的我,其中一个很重要的我就是对元数据的支持,在J2SE5.0中,这种元数据被称为注释,通过使用注释,程序开发人员可以在不改变原有逻辑的情况下,在源文件嵌入一些补充的信息.

Annotation可以用来修饰类,属性,方法,而且不影响程序运行,无论是否使用Annotation代码都可以正常进行.

java.lang.annotation.Annotation是Annotation的接口,只要是Annotation都必须实现此接口,此接口定义如下:

public interface Annotation{
public Class<? extends Annotation> annotationType();
public boolean equals(Object obj);
public int hashCode();
String toString();
}

二.系统内建的Annotation

以下讨论到的注解中有一些被称之为Meta注解,它们的目的注解其他注解,并且包含关于其它注解的信息。

  • @Retention:这个注解注在其他注解上,并用来说明如何存储已被标记的注解。这是一种元注解,用来标记注解并提供注解的信息。可能的值是:

    • SOURCE:表明这个注解会被编译器忽略,并只会保留在源代码中。
    • CLASS:表明这个注解会通过编译驻留在CLASS文件,但会被JVM在运行时忽略,正因为如此,其在运行时不可见。
    • RUNTIME:表示这个注解会被JVM获取,并在运行时通过反射获取。
  • @Target:这个注解用于限制某个元素可以被注解的类型。例如:

    • ANNOTATION_TYPE 表示该注解可以应用到其他注解上
    • CONSTRUCTOR 表示可以使用到构造器上
    • FIELD 表示可以使用到域或属性上
    • LOCAL_VARIABLE表示可以使用到局部变量上。
    • METHOD可以使用到方法级别的注解上。
    • PACKAGE可以使用到包声明上。
    • PARAMETER可以使用到方法的参数上
    • TYPE可以使用到一个类的任何元素上。
  • @Documented:被注解的元素将会作为Javadoc产生的文档中的内容。注解都默认不会成为成为文档中的内容。这个注解可以对其它注解使用。
  • @Inherited:在默认情况下,注解不会被子类继承。被此注解标记的注解会被所有子类继承。这个注解可以对类使用。

对于系统内建的3个Annotation这里就不多说了

序号 Annotation java中的声明
1 @override

主要是在方法覆写时使用,用于保证方法覆写的正确性

2 @Deprecated 主要功能是用来声明一个不建议使用的方法,如果在程序中使用了此方法,则在编译时将出现警告信息
3 @supperssWarning 主要功能是用来压制警告,例如,进行泛形操作时,如果在类声明时没有指明泛形,则肯定在编译时产生警告,那么此时就可以用这个注释来压制住这种警告.

三,自定义Annotation(本次学习的重点)

1. 定义简单的Annotation

格式如下:

public @interface Annotation AnnotationName{
数据类型 变量名称();
}

要定义Annotation必须使用@interface的方式进行定义,但是从格式中可以发现,在定义Annotation时也可以定义各种变量,但是变量定义 之后必须带上();

注意:使用@interface就相当于继承了Annotation的接口

例:

public @interface MyAnnotation{

}

其实这就是一个最简单的自定义的接口,其中没有定义任何变量.那么此时如何使用呢?要想使用此Annotation,需要定义其他的类,并使用@Annotationtv很简单

@MyAnnotation
public Class MyAnnotationTest{ }

2.向Annotation中设置内容

定义MyAnnotation可以接收一个变量

public @interface MyAnnotation{
public String value();//接收设置的内容
}

在以上的Annotation中定义了一个value以后在使用此Annotation时,可以将内容设置给value.

例:

@MyAnnotation("wangyang")
public class Demo{}

以上程序在使用Annotation时,向其中设置了一个内容,使用MyAnnotation中定义的value属性进行接收,在使用MyAnnotation时也可以直接指定接收的属性的名称

@MyAnnotation(value="wangyang")
public class Demo{}

以上形式一般只有向一个Annotation中指定多个属性时才会用到

3.在Annotation中设置多少属性

public @interface MyAnnotation{
public String key();
public String value();//接收设置的内容
}
@MyAnnotation(key="wang",value="wangyang")
public class Demo{}

但在现在定义的Annotation中,每次只能向Annotation中的属性传递一个内容,如果要为一个属性设置多个内容,则可以将一个属性定义成一个数组

public @interface MyAnnotation{
public String[] value();
}
@MyAnnotation(value={"wangyang01","wangyang02"})
public class Demo{}

4.在上面的操作中,所有内容都是需要用户在调用Annotation时手工设置的,当然,为了方便用户,有时也可以通过设置默认值的方式减少用户设置的内容

如果在一个定义好的Annotation中已经定义了若干个属性,但是在使用Annotation时并没指定其具体的内容,则在编译时就会出现错误

public @interface MyAnnotation{
public String key();
public String value();//接收设置的内容
}
@MyAnnotation(value="wangyang")
public class Demo{} @MyAnnotation(key="wang")
public class Demo{} @MyAnnotation
public class Demo{}

以上的用法都是错误的

如果我们这样做:

public @interface MyAnnotation{
public String key() default "wang";
public String value() default "wangyang";//接收设置的内容
}

这橛,以后在使用MyAnnotation时,如果没有设置内容,则会将默认值赋予属性,而如果已经明确地给出了内容,则是将给出的内容赋予属性

5.同样我们也可以使用枚举来限制设置的内容

在Annotation中也可以通过枚举来限制Annotation的取值范围

首先我们定义一个枚举:

public enum Color{
BLACK,RED,WHITE;
}

再定义MyAnnotation,此Annotation的取值必须是Color中的类型

public @interface MyAnnotation{
public Color color() default Color.RED; }

这样,以后再使用MyAnnotation时,所有的取值都必须从Color中取

@MyAnnotation(color=Color.RED)
public class Demo{}

四,定义一个完整的Annotation

@Documented
@Retention(value=RUNTIME)
@Ttarget(value=ANNOTATION_TYPE)
public @interface MyAnnotation{
public Color color() default Color.RED; }

注意:

  • @Retention:这个注解注在其他注解上,并用来说明如何存储已被标记的注解。这是一种元注解,用来标记注解并提供注解的信息。可能的值是:

    • SOURCE:表明这个注解会被编译器忽略,并只会保留在源代码中。
    • CLASS:表明这个注解会通过编译驻留在CLASS文件,但会被JVM在运行时忽略,正因为如此,其在运行时不可见。
    • RUNTIME:表示这个注解会被JVM获取,并在运行时通过反射获取。
  • @Target:这个注解用于限制某个元素可以被注解的类型。例如:

    • ANNOTATION_TYPE 表示该注解可以应用到其他注解上
    • CONSTRUCTOR 表示可以使用到构造器上
    • FIELD 表示可以使用到域或属性上
    • LOCAL_VARIABLE表示可以使用到局部变量上。
    • METHOD可以使用到方法级别的注解上。
    • PACKAGE可以使用到包声明上。
    • PARAMETER可以使用到方法的参数上
    • TYPE可以使用到一个类的任何元素上。
  • @Documented:被注解的元素将会作为Javadoc产生的文档中的内容。注解都默认不会成为成为文档中的内容。这个注解可以对其它注解使用。
  • @Inherited:在默认情况下,注解不会被子类继承。被此注解标记的注解会被所有子类继承。这个注解可以对类使用。

java_annotation_01的更多相关文章

随机推荐

  1. Lua开发环境配置

    Lua(英语发音:/ˈluːə/)程序设计语言是一个简洁.轻量.可扩展的脚本语言,是葡萄牙语中“Luna”(月亮)的意思. Lua is a powerful, fast, lightweight, ...

  2. underscore.js框架使用

    Underscore.js是一个很精干的库,压缩后只有4KB.它提供了几十种函数式编程的方法,弥补了标准库的不足,大大方便了JavaScript的编程.MVC框架Backbone.js就将这个库作为自 ...

  3. ZOJ-3597-Hit the Target!(线段树+扫描线)

    题解引自:http://www.cnblogs.com/wuyiqi/archive/2012/04/28/2474614.html 这题和着题解一块看,看了半天才看懂的....菜菜.... 题意:有 ...

  4. 图论(二分图最大权独立点集):COGS 2051. 王者之剑

    2051. 王者之剑 ★★★☆   输入文件:Excalibur.in   输出文件:Excalibur.out   简单对比 时间限制:1 s   内存限制:256 MB [题目描述] 这是在阿尔托 ...

  5. 【树状数组】CSU 1811 Tree Intersection (2016湖南省第十二届大学生计算机程序设计竞赛)

    题目链接: http://acm.csu.edu.cn/OnlineJudge/problem.php?id=1811 题目大意: 一棵树,N(2<=N<=105)个节点,每个节点有一种颜 ...

  6. 【模拟】Codeforces 711B Chris and Magic Square

    题目链接: http://codeforces.com/problemset/problem/711/B 题目大意: N*N的矩阵,有且只有一个0,求要把这个矩阵变成幻方要填什么正数.无解输出-1.幻 ...

  7. 使用ChineseLunisolarCalendar 对象由年份获得生肖名,Datetime.now.tostring获得星期几

    一:使用ChineseLunisolarCalendar 对象由年份获得生肖名,截图 二:代码 using System; using System.Collections.Generic; usin ...

  8. 从SG函数浅谈解决博弈问题的通法

    基于笔者之前对于几种二元零和博弈游戏的介绍,这里将其思想进行简单的提炼,并引出解决这类二元零和博弈游戏的强大工具——SG函数. 其实对于博弈游戏如Bash.Nim等基本类型,异或一些比较高级的棋类游戏 ...

  9. Postman newman

    安装 官方文档: Newman - Running collections in the command line Installing Newman on Windows 1. 安装NodeJs 下 ...

  10. Palindrome - POJ 3974 (最长回文子串,Manacher模板)

    题意:就是求一个串的最长回文子串....输出长度. 直接上代码吧,没什么好分析的了.   代码如下: ================================================= ...