IT学习站-137zw.com

more +资源更新Forums

more +随机图赏Gallery

Spring Boot编程思想(核心篇) PDF 电子书 百度云 网盘下载Spring Boot编程思想(核心篇) PDF 电子书 百度云 网盘下载
10节课让你成为滚床单高手  强烈推荐 屌丝的福音10节课让你成为滚床单高手 强烈推荐 屌丝的福音
最新流出的传智博学谷黑马python5.0课程最新流出的传智博学谷黑马python5.0课程
MySQL视频教程价值288元MySQL面试指南视频教程 百度云 百度...MySQL视频教程价值288元MySQL面试指南视频教程 百度云 百度...
python基础教程编程数据分析excel源代码pandas视频教学数据处理python基础教程编程数据分析excel源代码pandas视频教学数据处理
价值388元 Spark Streaming实时流处理项目实战视频教程 百度云盘价值388元 Spark Streaming实时流处理项目实战视频教程 百度云盘

java注解使用总结

java注解使用总结

[复制链接]
六翼天使494 | 显示全部楼层 发表于: 2019-11-14 10:25:04
六翼天使494 发表于: 2019-11-14 10:25:04 | 显示全部楼层 |阅读模式
查看: 124|回复: 0

你还没有注册,无法下载本站所有资源,请立即注册!

您需要 登录 才可以下载或查看,没有帐号?立即注册

x
2005年,sun公司推出了jdk1.5,同时推出的注解功能吸引了很多人的目光,使用注解编写代码,能够减轻java程序员繁琐配置的痛苦。
使用注解可以编写出更加易于维护,bug更少的代码。
注解是什么呢?按照官方的说法,注解就是元标签,可以添加到你的代码,并应用于包声明、类型声明、构造函数、方法、字段、参数和变量。
注解提供了一种非常有用的方法来显示你编写的方法是否依赖于其他方法,它们是否完整,编写出的类是否引用了其他类,等等。
按照Oracle官方的说法,基于注解编写出的java代码会根据源代码中的注解生成模板代码,从而避免我们在大多数情况下编写模板代码。这导致了一种声明式编程风格,在这种风格中,程序员说要做什么功能,工具就写出相应的代码来实现它。
简而言之,注解是一种机制,用于将元标签与程序元素相关联,并允许编译器或虚拟机从这些注解元素中提取程序行为,并在必要时生成相互依赖的代码。
现在开始我们的java注解学习之旅。
内置注解
java会内置一些已经实现好的注解,可以直接使用,内置的注解主要用于给java编译器提供指令。
java内置的注解有五个:

  • @Deprecated
  • @Override
  • @SuppressWarnings
  • @SafeVarargs
  • @FunctionalInterface
@Deprecated注解主要用于给类、方法、变量打上不建议使用的标签,如果你的代码使用了不建议使用的类、方法、变量,编译器就会给你一个警告。
下面是使用@Deprecated的示例:定义了一个MyAnnotation,在类名,变量名和方法名上都使用的@Deprecated注解。
使用了@Deprecated标识的类、方法或变量时,
@Deprecated还有另外一个用处,就是在javadoc文档中写明类、方法或变量为什么不建议使用,并且给出替代方法:@Override注解在方法上使用,标识这个方法重写父类的方法。如果这个方法和父类方法不一致,编译器就会显示错误。
强烈建议在重写父类的方法上使用@Override注解,不用也不会有什么影响,但是如果不使用@Override注解,当有人修改父类的方法时,你就无法识别出子类的方法是否重写了父类的方法。而使用了@Override注解,只要父类没有这个方法,编译器就会提示父类没有对应方法的错误。
下面是使用@Override注解的示例:Cat类的run()方法使用了@Override注解,如果将Cat类中的方法改为run1(),编译器就会显示The method run1() of type Cat must override or implement a supertype的错误。
如果不使用@Override注解,将Cat类中的方法改为run1(),系统则不会报错。
@SuppressWarnings注解也是在方法上使用,用于抑制警告,在调用deprecated的方法或者进行不安全的类型转化时,编译器会发出一些警告,使用@SuppressWarnings就可以忽略那些警告。
使用示例:@SafeVarargs注解主要用于抑制参数类型安全检查警告,这个是jdk1.7新增的功能。
使用示例:如果不使用@SafeVarargs注解,编译器会给出警告信息:Type safety: Potential heap pollution via varargs parameter stringLists。
使用@SafeVarargs有个前提,你必须保证某个使用了可变长度参数的方法,在与泛型类一起使用时不会出现类型安全问题。否则在运行行时会抛出 ClassCastException异常。
@SafeVarargs注解只能在满足如下条件的方法上使用:

  • 参数长度可变的方法或构造方法。
  • 方法必须声明为static或final。
@FunctionalInterface注解主要用于编译级错误检查,加上该注解,当你写的接口不符合函数式接口定义的时候,编译器会报错。
使用示例:创建注解
注解的创建和接口有点类似,都是使用interface关检字,区别是创建注解时,需要在interface前面加上一个@字符。
下面是创建一个注解的例子:上面创建注解没有任何成员变量。
创建带成员变量的注解:TestAnnotation注解有两个成员变量,age和name。
注解的成员变量以无参数无方法体的方法形式声明。
使用default关键字指定注解成员变量的默认值:使用自定义注解时,如果该注解的变量有默认值,可以不为成员变量指定值,直接使用默认值。
使用示例:如果注解的变量没有默认值,在使用时必须为每个变量都指定值,代码如下:元注解
什么是元注解呢?元注解就是注解的注解,也就是用于定义注解的注解,可以理解为注解的基础数据类型。这玩意真的很拗口,还是看代码比较舒服。@Target就是元注解,用于定义Test_Target注解。
java提供五种元注解,分别是:

  • @Retention 指定注解的生命周期,即存活时间。
  • @Documented javadoc命令生成的文档中体现注解的内容
  • @Target 指定注解可用于哪些元素,例如类、方法、变量等
  • @Inherited 注解的继承性,
  • @Repeatable 可重复使用的注解
@Retention用于指定注解的生命周期,即存活时间。@Retention提供了如下的三个值,在使用@Retention时,必须使用其中的一个值。

  • RetentionPolicy.SOURCE 注解只在源码阶段保留,在编译器进行编译生成class文件时丢弃,无法通过反射获取注解信息。
  • RetentionPolicy.CLASS 注解只被保留到编译进行的时候,它并不会被加载到JVM中,无法通过反射获取注解信息,这是默认值。
  • RetentionPolicy.RUNTIME 注解可以保留到程序运行的时候,它会被加载进入到 JVM 中,程序运行时可以通过反射获取到它们。
下面是使用@Retention定义一个自定义注解的示例:上面的代码创建了一个Test_Retention的注解,并且使用@Retention指定Test_Retention注解可以保留到程序运行的时候(RetentionPolicy.RUNTIME),MyAnnotation使用@Test_Retention修饰,因此在运行时可以通过反射获取到MyAnnotation的注解信息。
@Documented如果类A使用了@Documented元注解注解的注解,那么在使用javadoc生成的类A的文档会包含有相应的注解信息。
使用示例:@Target指定了注解所修饰对象的范围,可用于变量、参数、方法、包信息等。
@Target元注解提供如下的八个值:

  • ElementType.ANNOTATION_TYPE 用于描述注解类型
  • ElementType.CONSTRUCTOR 用于注解构造方法
  • ElementType.FIELD 用于变量注解
  • ElementType.LOCAL_VARIABLE 用于局部变量注解
  • ElementType.METHOD 用于方法注解
  • ElementType.PACKAGE 用于包注解
  • ElementType.PARAMETER 用于方法内的参数注解
  • ElementType.TYPE 用于类、接口、枚举注解
代码示例:TestMethodTarget注解只能用于注解类的方法,TestFieldTarget只能用于注解类的成员变量,TestTypeTarget可用于注解类、接口(包括注解类型) 或enum声明
@Inherited指定了注解可被继承。某个类使用了被@Inherited修饰的注解,那么那个注解也会用到该类的子类。
代码示例:@Repeatable同一个注解可多次使用。例如一个人有多种爱好,跑步、画画、看电影等。
示例代码:上面的代码,@Repeatable 注解了 Person。而 @Repeatable后面括号中的类相当于一个容器注解。
什么是容器注解呢?就是用来存放其它注解的地方。它本身也是一个注解。
上面详细介绍了注解的知识以及自定义注解的语法。现在我们来看下如何使用注解进行单元测试。
使用注解这要到反射的知识,关于反射的知识请看我的另外一篇文章“Java反射使用总结”。在得到反射对象后,要调用isAnnotationPresent方法这个对象是否包含指定类型的注解。 Annotation
示例代码:运行结果:上面的代码,我们定义了一个RuningTest注解,里面没有任何变量。这个注解使用@Retention和@Target元注解修饰,其中@Target元注解的值规定了这个RuningTest注解只能在方法上使用,而@Retention元注解值指定了在运行时可以获取到注解的信息。
定义了一个Marathonrunner马拉松远动员类,里面有4个方法。
定义了一个专门用于测试Marathonrunner运动员方法的类。如果我们想测试某个类,只需在那个类上添加@RuningTest注解,不加@RuningTest注解的方法不会进行测试。test5km()和test21km()方法都加了@RuningTest注解,所以被测试到。
注解在spring,mybatis注解中广发应用。下次专门写篇文章讲下spring中注解的应用。
总结:
本文主要讲解了注解的概念,元注解的概念,如何自定义注解,以及如何使用自己定义注解进行单元测试。

来源:http://www.137zw.com
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!
137zw.com IT学习站致力于免费提供精品的java技术教程和python技术教程,CCNA书籍/资料/CCNP书籍/资料教程/CCIE书籍/资料/H3C学习/认证/一级建造师考试/微软学习/认证/包括基础教程和高级实战教程,同时也提供分享网站源码下载和互联网相关一系列的技术教程,我们想做的就是让知识分享更有价值!(IT学习站官方唯一域名地址:www.137zw.com 请谨防假冒网站!)本站所有资源全部收集于互联网或网友自行分享,分享目的仅供大家学习与参考,如无意中侵犯您的合法权益,请联系本站管理员进行删除处理!
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

关闭

站长推荐上一条 /1 下一条

浙ICP备19022368号-1|Archiver|手机版|IT学习站-137zw.com

GMT+8, 2020-7-10 22:53 , Processed in 0.192196 second(s), 33 queries .

快速回复 返回顶部 返回列表