转载

Java中的注解-自定义注解

Hello,大家好,好久没有更了,看到上篇博文里有人说到让我快点更Spring系列博客,这样就可以不用买书了。这里我觉得有责任和大家说一下, 千万不要有只看博客不看书的习惯 ,很多人觉得博客来得快,学的快,紧抓重点。我承认,看博客是快速入门的一种方式,当然你的选好博客, 老实说,作者自愧不如,真心只是懂点皮毛,很多东西都是拾人牙慧。很多东西也处于学习阶段。而且作者有很多知识也不见得全是对的,仅供大家参考。 其实真正想把一系列只是学透彻,作者还是 强烈推荐看书 的,看一些淘宝,京东的架构写的书,虽然来的慢,但是很全面,很系统。 如果把博客看做是吃饭时的菜的话,那么看书无疑就是我们的主食大米了 ,有点养生常识的都知道,吃主食大米或者面食才是最补身体的。好了,扯了这么多,这一篇准备把Java中的自定义注解分享一下子,因为我身边好多小伙伴,貌似很多都不知道注解这个东西到底是什么,只知道怎么用,确不知道注解的底层原理。这一篇就和大家分享一下,文章结构:

  1. Java中的注解概述
  2. 四种元注解
  3. 自定义注解

1. Java中的注解概述

首先要说明一个东西,注解这个东西绝对不是Spring为我们提供的,而是JDK带的,JDK自己也是有很多内置注解的,比如@override. 注解的功能其实就是 为一些加了注解的类,方法等赋予特殊的含义 ,具体如何产生自定义的含义,其实就是 注解处理器 了,这是下一篇和大家讲的.

2. 四种元注解

元注解,说白了,就是JDK自带的注解,这些注解是干嘛的呢?其实就是在我们自定义注解时,注解到我们自定义的注解上的,举个例子:

@Target(ElementType.TYPE)
public @interface Table {
    public String tableName() default "className";
}

大家先不要管语法,Table其实就是我自定义的一个注解,可以@Table这样使用了,那么这个@Target其实就是元注解了。JDK自带的元注解如下:

  1. @Target
  2. @Retention
  3. @Documented
  4. @Inherited

@Target

用于描述注解的使用范围,有一个枚举 ElementType 来指定,具体如下:

  1. CONSTRUCTOR:用于描述构造器
  2. FIELD:用于描述域
  3. LOCAL_VARIABLE:用于描述局部变量
  4. METHOD:用于描述方法
  5. PACKAGE:用于描述包
  6. PARAMETER:用于描述参数
  7. TYPE:用于描述类、接口(包括注解类型) 或enum声明

eg:

@Target(ElementType.METHOD)
public @interface Dog {
    
}

大家可以看到,我这个Dog注解,只能用到方法上面 。

2. @Retention

表示需要在什么级别保存该注释信息,用于描述注解的生命周期,也是一个枚举 RetentionPoicy 来决定的,这个枚举我不列出来了,包括这个注解的具体怎么决定注解的生命周期我也不多讲,因为根据小弟这么多年使用的经验,都是填的 RetentionPoicy.RUNTIME ,填这个值注解处理器才能通过反色拿到注解信息,实现自己的语义,所以大家都填RetentionPoicy.RUNTIME就可以了,想扩展了解的自行google..

3. @Documented

如果用javadoc生成文档时,想把注解也生成文档,就带这个。(话说老铁们都是怎么写文档的,小弟表示从不写文档... ^_^)

4. @Inherited

@Inherited 元注解是一个标记注解,@Inherited阐述了某个被标注的类型是被继承的。如果一个使用了@Inherited修饰的annotation类型被用于一个class,则这个annotation将被用于该class的子类。注意,@Inherited annotation类型是被标注过的class的子类所继承。类并不从它所实现的接口继承annotation,方法并不从它所重载的方法继承annotation。

其实这几个注解只有一个有点用,就是@Target,大家稍微注意下就行了。 注解不是你想加哪就加哪的

3. 自定义注解

上面把元注解说了,来讲下如何自定义注解,顺带提一下,自定义的注解又叫组合注解.然后说下自定义注解格式:

Java中的注解-自定义注解
  1. 固定格式,不要搞事.
  2. 只能用public或默认(default)这两个访问权修饰.例如,String value();这里把方法设为defaul默认类型;
  3. 定义注解参数的类型,只能为:
  • 所有基本数据类型(int,float,boolean,byte,double,char,long,short)
  • String类型
  • Class类型
  • enum类型
  • Annotation类型
  • 以上所有类型的数组
  1. 方法名,就是这个 注解的支持的属性名 ,像常见的value.
  2. 表示该属性名在不指定时的默认值,可以不要。

好了,我举个例子:

@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Dog {
    public String dog() default "";
}

我定义了一个Dog注解,它有一个属性为dog,是String类型的,默认值为"".我在使用的时候可以这样使用,@Dog(dog="小黄"),还可以直接这样使用@Dog,不指定dog属性,默认就是"" .

好了,大家可以看到,这样就定义了一个注解了,大家可能好奇,这样有个毛用,我就是加到了具体的类上,也没什么鸟用啊。我这里和大家分享下自己的一点经验,自定义注解有两种用法:

  1. 自定义注解处理器专门为你自定义的注解实现语义(比如加了@Dog注解的方法,在调用的时候,全部都打印出调用信息到日志系统) ,后一篇博客讲自定义注解处理器。
  2. 配合Spring使用.

在讲如何配合Spring使用前,先说一个知识点,大家可能会忽略掉,那就是 注解是可以组合的 ,如上图,在自定义注解时,不仅可以加元注解,还可以加其他自定义注解 。这就好玩了,我举个例子:

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Component
public @interface Dog {
    public String dog() default "";
}

我为刚刚的@Dog注解加了@Component,那么这个注解就会有@Component的功能了(被Spring当做bean加入到Spring容器里).现在在顺带说下 属性修饰符public和默认的区别

  • public修饰的属性能被覆盖,默认的则不能. 举个例子:
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Component
@Dog
public @interface StupidDog {
    public String dog() default "我是一条StupidDog";
}

我现在又定义了一个StupidDog注解,这个注解覆盖掉了@Dog的dog属性,把默认值从""改成了"我是一条StupidDog"..

好了,回到话题上,知道了组合注解可以拥有被注解的注解的功能,还拿刚才那个加了@Component注解的@Dog注解来说,当某个类被加了这个注解,比如:

@Dog
public class TestService {
    ...
}

我们知道这个TestService在Spring的环境下会被加到Spring容器里成为Bean,可是这有什么鸟用了?这个作用可大了!这可以把Spring容器里的bean区分开来,比如如下代码片段:

// ctx 为Spring的ApplicationContext
// // 获取所有带有 Dog 注解的 Spring Bean
Map<String, Object> serviceBeanMap = ctx.getBeansWithAnnotation(Dog.class);

大家可以看到, 可以通过ApplicationContext取到一些带有特殊标记(自定义注解)的Spring bean! 大家不要小看了这一功能, 如果你想在Spring容器初始化完毕后,对某一类Spring Bean做一些特殊操作。自定义注解可以帮你区分开来。

结语

好了,自定义注解的一些知识就和大家分享完了,其实比较简单,语法也很清晰,然后又提了下运用组合注解的知识来结合Spring的@Componenet使用,截止到目前为止,大家会发现自己定义的注解,除了能和Spring结合用一下子,并没什么鸟用,上面也提到了,目前为止是的,下一篇给大家分享下 自定义注解处理 ,这个东西可以让我们自定义的注解实现自己特有的功能。今天周五,大家周末愉快,多出去打个野。少加班,保重龙体,干it的,别和需求过不去,能推就推。 Over,Have a good day .

原文  https://juejin.im/post/5a619f886fb9a01c9f5b7e4f
正文到此结束
Loading...