Java注解初探

2024-09-07 21:48
文章标签 java 注解 初探

本文主要是介绍Java注解初探,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

什么是注解

注解(Annotation)是从JDK5开始引入的一个概念,其实就是代码里的一种特殊标记。这些标记可以在编译,类加载,运行时被读取,并执行相应的处理。通过注解开发人员可以在不改变原有代码和逻辑的情况下在源代码中嵌入补充信息。有了注解,就可以减少配置文件,现在越来越多的框架已经大量使用注解,而减少了XML配置文件的使用,尤其是Spring,已经将注解玩到了极致。

注解与XML配置各有优缺点:注解提高了效率,但同时也增加了代码的耦合度。XML配置降低了耦合度,但是也降低了效率。

Java提供了5个基本的注解,但是咱们编程中常用的有三个,分别是:

  • @Override:这个咱们见到的最多,用来限定父类重写方法。当子类重写父类方法,或者实现接口时,子类方法或者实现类的方法可以加上这个注解,这样IDE就会检查这个方法是否和父类或者接口的方法签名一致,确保子类或者实现类确实重写了父类的方法或者实现了接口中的方法,避免出现低级错误。如果子类或者实现类的方法上加了这个注解,但是方法签名和父类或者接口中的不一致,IDE会报错。如果没加这个注解,即使签名不一致,IDE也不会报错。
  • @Deprecated:用于表示某个程序类,方法等已过时,当其他程序使用已过时的类,方法时编译器会给出警告,上边会出现删除线。

  • @SuppressWarnings:用于抑制编译器警告,被该注解修饰的元素以及该元素的所有子元素取消显示编译器警告。这个对于不想看到黄色叹号的有强迫症的人比较有用,比如声明一个List时要求使用泛型指明list元素的类型,而有时没法指定(比如调用别人写好的方法,而该方法的返回值是list,且没有指定元素类型),或者我们不想指定,但是又不想看到IDE的警告,就可以用这个。

其它的两个不常用,就不做介绍了。

元注解

元注解是用来修饰其它注解的一种特殊注解。

常用的元注解包括:

  1. @Retention:用来设置被修饰的注解可以保存多久,带一个参数,该参数有三个可选值:(1)、RetentionPolicy.SOURCE,表示该注解只保存在源代码中,编译器直接丢弃该注解;(2)、RetentionPolicy.CLASS,表示编译器把该注解记录在class文件中,当运行java程序时,JVM不可获取注解信息,这是默认值;(3)、RetentionPolicy.RUNTIME,表示编译器把该注解记录在class文件中,当运行java程序时,JVM可获取注解信息,程序可以通过反射获取该注解信息。

  2. @Target:指定被修饰的注解能用于修饰哪些程序元素,值为一个ElementType类型的数组。常用的值包括:(1)、ElementType.TYPE:表示该注解可标注在类、接口、注解类型、枚举类型上;(2)、ElementType.FIELD:表示该注解可标注在字段上,包括枚举常量;(3)、ElementType.METHOD:表示该注解可标注在方法上;(4)、ElementType.PARAMETER:表示该注解可标注在参数上;(5)、ElementType.CONSTRUCTOR:表示该注解可标注在构造方法上;(6)、ElementType.LOCAL_VARIABLE:表示该注解可标注在局部变量上;(7)、ElementType.ANNOTATION_TYPE:表示该注解可标注在其它注解上。

  3. @Documented:指定被修饰的注解类将被javadoc工具提取成文档,如果定义注解类时使用了这个注解修饰,则所有使用该注解修饰的程序API文档将会包含该注解说明。

  4. @Inherited:指定被修饰的注解将具有继承性。如果父类加了这个注解,子类将自动进程父类的所有注解。

声明自定义注解

实际上单独声明一个注解是没有任何作用,或者说没有意义的。注解往往是和反射配合使用才能发挥作用。关于反射,参考我的另外一篇博文:Java中反射的实现方式。

使用@interface来声明自定义注解:

package com.huixin.annotation;import static java.lang.annotation.ElementType.FIELD;
import static java.lang.annotation.ElementType.METHOD;
import static java.lang.annotation.ElementType.TYPE;import java.lang.annotation.Documented;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;/*** 会员注解*/
@Retention(RetentionPolicy.RUNTIME)
@Target({ TYPE, FIELD, METHOD })
//@Inherited
//@Documented
public @interface MemberAnnotation {// 会员卡号String idCardNo() default "";// 会员姓名String name() default "";// 是否老板boolean isBoss() default false;
}

如果注解中有属性,则使用带括号“()”的方式来声明属性(如上边代码的第22行),看起来有点像一个方法,但是没有大括号“{}”。如果该属性有默认值的话,后边用default关键字来指定默认值。

下边写一个测试类来使用注解:

package com.huixin.annotation;@MemberAnnotation(idCardNo="610112", name="andrewlau", isBoss=true)
public class AnnotationTest {public static void main(String[] args) {MemberAnnotation ca = AnnotationTest.class.getAnnotation(MemberAnnotation.class);String idcardno = ca.idCardNo();String name = ca.name();boolean isadmin = ca.isBoss();System.out.println(idcardno + ", " + name + ", " + isadmin);}}

上述代码的注解加在类上,注解的三个属性都赋了值。第7行代码获取该类上的MemberAnnotation注解信息,第8到第10行获取注解的属性值。获取到属性之后就可以根据实际的业务来进行判断处理了。这就是一个简单的自定义注解的使用方法。

这篇关于Java注解初探的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1146253

相关文章

Java中流式并行操作parallelStream的原理和使用方法

《Java中流式并行操作parallelStream的原理和使用方法》本文详细介绍了Java中的并行流(parallelStream)的原理、正确使用方法以及在实际业务中的应用案例,并指出在使用并行流... 目录Java中流式并行操作parallelStream0. 问题的产生1. 什么是parallelS

Java中Redisson 的原理深度解析

《Java中Redisson的原理深度解析》Redisson是一个高性能的Redis客户端,它通过将Redis数据结构映射为Java对象和分布式对象,实现了在Java应用中方便地使用Redis,本文... 目录前言一、核心设计理念二、核心架构与通信层1. 基于 Netty 的异步非阻塞通信2. 编解码器三、

SpringBoot基于注解实现数据库字段回填的完整方案

《SpringBoot基于注解实现数据库字段回填的完整方案》这篇文章主要为大家详细介绍了SpringBoot如何基于注解实现数据库字段回填的相关方法,文中的示例代码讲解详细,感兴趣的小伙伴可以了解... 目录数据库表pom.XMLRelationFieldRelationFieldMapping基础的一些代

一篇文章彻底搞懂macOS如何决定java环境

《一篇文章彻底搞懂macOS如何决定java环境》MacOS作为一个功能强大的操作系统,为开发者提供了丰富的开发工具和框架,下面:本文主要介绍macOS如何决定java环境的相关资料,文中通过代码... 目录方法一:使用 which命令方法二:使用 Java_home工具(Apple 官方推荐)那问题来了,

Java HashMap的底层实现原理深度解析

《JavaHashMap的底层实现原理深度解析》HashMap基于数组+链表+红黑树结构,通过哈希算法和扩容机制优化性能,负载因子与树化阈值平衡效率,是Java开发必备的高效数据结构,本文给大家介绍... 目录一、概述:HashMap的宏观结构二、核心数据结构解析1. 数组(桶数组)2. 链表节点(Node

Java AOP面向切面编程的概念和实现方式

《JavaAOP面向切面编程的概念和实现方式》AOP是面向切面编程,通过动态代理将横切关注点(如日志、事务)与核心业务逻辑分离,提升代码复用性和可维护性,本文给大家介绍JavaAOP面向切面编程的概... 目录一、AOP 是什么?二、AOP 的核心概念与实现方式核心概念实现方式三、Spring AOP 的关

详解SpringBoot+Ehcache使用示例

《详解SpringBoot+Ehcache使用示例》本文介绍了SpringBoot中配置Ehcache、自定义get/set方式,并实际使用缓存的过程,文中通过示例代码介绍的非常详细,对大家的学习或者... 目录摘要概念内存与磁盘持久化存储:配置灵活性:编码示例引入依赖:配置ehcache.XML文件:配置

Java 虚拟线程的创建与使用深度解析

《Java虚拟线程的创建与使用深度解析》虚拟线程是Java19中以预览特性形式引入,Java21起正式发布的轻量级线程,本文给大家介绍Java虚拟线程的创建与使用,感兴趣的朋友一起看看吧... 目录一、虚拟线程简介1.1 什么是虚拟线程?1.2 为什么需要虚拟线程?二、虚拟线程与平台线程对比代码对比示例:三

Java中的.close()举例详解

《Java中的.close()举例详解》.close()方法只适用于通过window.open()打开的弹出窗口,对于浏览器的主窗口,如果没有得到用户允许是不能关闭的,:本文主要介绍Java中的.... 目录当你遇到以下三种情况时,一定要记得使用 .close():用法作用举例如何判断代码中的 input

Spring Gateway动态路由实现方案

《SpringGateway动态路由实现方案》本文主要介绍了SpringGateway动态路由实现方案,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随... 目录前沿何为路由RouteDefinitionRouteLocator工作流程动态路由实现尾巴前沿S