黑马程序员技术交流社区

标题: 自定义注解到底能起到什么作用? [打印本页]

作者: 欢欢    时间: 2014-3-27 20:43
标题: 自定义注解到底能起到什么作用?
使用注解@Override、@Deprecated、@SuppressWarning 和 元注解(注解的注解)@Target、@Retention 在代码中都会出现相应的效果,
但是看了源代码,又什么都没看到,不知道他们是怎么实现这些功能的 。。。
那么使用自定义注解能起到什么作用?自定义注解又能做什么呢?难道只是打个标签?本人愚钝、谁能帮我解释一下,最好举个例子,谢谢!

作者: ehuashao    时间: 2014-3-30 10:19
Java注解是附加在代码中的一些元信息,用于一些工具在编译、运行时进行解析和使用,起到说明、配置的功能。
注解不会也不能影响代码的实际逻辑,仅仅起到辅助性的作用。包含在 java.lang.annotation 包中。

1、元注解

元注解是指注解的注解。包括  @Retention @Target @Document @Inherited四种。


1.1、@Retention: 定义注解的保留策略

@Retention(RetentionPolicy.SOURCE)   //注解仅存在于源码中,在class字节码文件中不包含
@Retention(RetentionPolicy.CLASS)     // 默认的保留策略,注解会在class字节码文件中存在,但运行时无法获得,
@Retention(RetentionPolicy.RUNTIME)  // 注解会在class字节码文件中存在,在运行时可以通过反射获取到

1.2、@Target:定义注解的作用目标
其定义的源码为:
  1. @Documented
  2. 2 @Retention(RetentionPolicy.RUNTIME)
  3. 3 @Target(ElementType.ANNOTATION_TYPE)
  4. 4 public @interface Target {
  5. 5     ElementType[] value();
  6. 6 }
复制代码

@Target(ElementType.TYPE)   //接口、类、枚举、注解

@Target(ElementType.FIELD) //字段、枚举的常量
@Target(ElementType.METHOD) //方法
@Target(ElementType.PARAMETER) //方法参数
@Target(ElementType.CONSTRUCTOR)  //构造函数
@Target(ElementType.LOCAL_VARIABLE)//局部变量
@Target(ElementType.ANNOTATION_TYPE)//注解
@Target(ElementType.PACKAGE) ///包   
由以上的源码可以知道,他的elementType 可以有多个,一个注解可以为类的,方法的,字段的等等
1.3、@Document:说明该注解将被包含在javadoc中

1.4、@Inherited:说明子类可以继承父类中的该注解

2、java 注解的自定义
      下面是自定义注解的一个例子
  1. @Documented
  2. @Target({ElementType.TYPE,ElementType.METHOD})
  3. @Retention(RetentionPolicy.RUNTIME)
  4. public @interface Yts {
  5.     public enum YtsType{util,entity,service,model};
  6.    public YtsType classType() default YtsType.util;
  7. }
复制代码
  1. @Documented
  2. 2 @Retention(RetentionPolicy.RUNTIME)
  3. 3 @Target(ElementType.METHOD)
  4. 4 @Inherited
  5. 5 public @interface HelloWorld {
  6. 6    public String name()default "";
  7. 7 }
复制代码


@Retention(RetentionPolicy.RUNTIME)

定义的这个注解是注解会在class字节码文件中存在,在运行时可以通过反射获取到。

@Target({ElementType.TYPE,ElementType.METHOD})

因此这个注解可以是类注解,也可以是方法的注解

这样一个注解就自定义好了,当然注解里面的成员可以为基本的数据类型,也可以为数据,Object等等
作者: ╰つ    时间: 2014-3-30 10:34
比如说,有一个方法过时了,为了兼容以前的老版本,又不能把这个方法删除,所有要用到一个注解来标示已过时,来提示以后的开发人员尽量不要用这个已过时的方法,每个注解都有每个注解的用途,我就不在这举例了,再java高新技术里面讲的很详细,推荐你去看一下




欢迎光临 黑马程序员技术交流社区 (http://bbs.itheima.com/) 黑马程序员IT技术论坛 X3.2