谈谈Java中自定义注解及使用场景

更新时间：2020年09月06日 16:04:23 作者：巅峰大词典

这篇文章主要介绍了谈谈Java中自定义注解及使用场景，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧

Java自定义注解一般使用场景为：自定义注解+拦截器或者AOP，使用自定义注解来自己设计框架，使得代码看起来非常优雅。本文将先从自定义注解的基础概念说起，然后开始实战，写小段代码实现自定义注解+拦截器，自定义注解+AOP。

一. 什么是注解(Annotation)

Java注解是什么，以下是引用自维基百科的内容

Java注解又称Java标注，是JDK5.0版本开始支持加入源代码的特殊语法元数据。

Java语言中的类、方法、变量、参数和包等都可以被标注。和Javadoc不同，Java标注可以通过反射获取标注内容。在编译器生成类文件时，标注可以被嵌入到字节码中。Java虚拟机可以保留标注内容，在运行时可以获取到标注内容。当然它也支持自定义Java标注。

二. 注解体系图

元注解：java.lang.annotation中提供了元注解，可以使用这些注解来定义自己的注解。主要使用的是Target和Retention注解

注解处理类：既然上面定义了注解，那得有办法拿到我们定义的注解啊。java.lang.reflect.AnnotationElement接口则提供了该功能。注解的处理是通过java反射来处理的。

如下，反射相关的类Class, Method, Field都实现了AnnotationElement接口。

因此，只要我们通过反射拿到Class, Method, Field类，就能够通过getAnnotation(Class<T>)拿到我们想要的注解并取值。

三. 常用元注解

Target：描述了注解修饰的对象范围，取值在java.lang.annotation.ElementType定义，常用的包括：

METHOD：用于描述方法
PACKAGE：用于描述包
PARAMETER：用于描述方法变量
TYPE：用于描述类、接口或enum类型

Retention: 表示注解保留时间长短。取值在java.lang.annotation.RetentionPolicy中，取值为：

SOURCE：在源文件中有效，编译过程中会被忽略
CLASS：随源文件一起编译在class文件中，运行时忽略
RUNTIME：在运行时有效

只有定义为RetentionPolicy.RUNTIME时，我们才能通过注解反射获取到注解。

所以，假设我们要自定义一个注解，它用在字段上，并且可以通过反射获取到，功能是用来描述字段的长度和作用。

@Target(ElementType.FIELD) // 注解用于字段上
@Retention(RetentionPolicy.RUNTIME) // 保留到运行时，可通过注解获取
public @interface MyField {
 String description();
 int length();
}

四. 示例-反射获取注解

先定义一个注解：

@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyField {
 String description();
 int length();
}

通过反射获取注解

public class MyFieldTest {
 //使用我们的自定义注解
 @MyField(description = "用户名", length = 12)
 private String username;

 @Test
 public void testMyField() {
  // 获取类模板
  Class c = MyFieldTest.class;
  // 获取所有字段
  for (Field f : c.getDeclaredFields()) {
   // 判断这个字段是否有MyField注解
   if (f.isAnnotationPresent(MyField.class)) {
    MyField annotation = f.getAnnotation(MyField.class);
    System.out.println("字段:[" + f.getName() + "], 描述:[" + annotation.description() + "], 长度:[" + annotation.length() + "]");
   }
  }
 }
}

运行结果

应用场景一：自定义注解+拦截器实现登录校验

接下来，我们使用springboot拦截器实现这样一个功能，如果方法上加了@LoginRequired，则提示用户该接口需要登录才能访问，否则不需要登录。

首先定义一个LoginRequired注解

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface LoginRequired {

}

然后写两个简单的接口，访问sourceA，sourceB资源

@RestController
public class IndexController {
 @GetMapping("/sourceA")
 public String sourceA() {
  return "你正在访问sourceA资源";
 }

 @GetMapping("/sourceB")
 public String sourceB() {
  return "你正在访问sourceB资源";
 }
}

没添加拦截器之前成功访问

实现spring的HandlerInterceptor 类先实现拦截器，但不拦截，只是简单打印日志，如下：

public class SourceAccessInterceptor implements HandlerInterceptor {
 @Override
 public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
  System.out.println("进入拦截器了");
  return true;
 }

 @Override
 public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
 }

 @Override
 public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
 }
}

实现spring类WebMvcConfigurer，创建配置类把拦截器添加到拦截器链中

@Configuration
public class InterceptorTrainConfigurer implements WebMvcConfigurer {
 @Override
 public void addInterceptors(InterceptorRegistry registry) {
  registry.addInterceptor(new SourceAccessInterceptor()).addPathPatterns("/**");
 }
}

拦截成功如下

在sourceB方法上添加我们的登录注解@LoginRequired

@RestController
public class IndexController {
 @GetMapping("/sourceA")
 public String sourceA() {
  return "你正在访问sourceA资源";
 }

 @LoginRequired
 @GetMapping("/sourceB")
 public String sourceB() {
  return "你正在访问sourceB资源";
 }
}

简单实现登录拦截逻辑

@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
 System.out.println("进入拦截器了");
 // 反射获取方法上的LoginRequred注解
 HandlerMethod handlerMethod = (HandlerMethod) handler;
 LoginRequired loginRequired = handlerMethod.getMethod().getAnnotation(LoginRequired.class);
 if (loginRequired == null) {
  return true;
 }
 // 有LoginRequired注解说明需要登录，提示用户登录
 response.setContentType("application/json; charset=utf-8");
 response.getWriter().print("你访问的资源需要登录");
 return false;
}

运行成功，访问sourceB时需要登录了，访问sourceA则不用登录

应用场景二：自定义注解+AOP 实现日志打印

先导入切面需要的依赖包

<dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-aop</artifactId>
</dependency>

定义一个注解@MyLog

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyLog {

}

定义一个切面类，见如下代码注释理解：

@Aspect // 1.表明这是一个切面类
@Component
public class MyLogAspect {
 // 2. PointCut表示这是一个切点，@annotation表示这个切点切到一个注解上，后面带该注解的全类名
 // 切面最主要的就是切点，所有的故事都围绕切点发生
 // logPointCut()代表切点名称
 @Pointcut("@annotation(me.zebin.demo.annotationdemo.aoplog.MyLog)")
 public void logPointCut() {};
 // 3. 环绕通知
 @Around("logPointCut()")
 public void logAround(ProceedingJoinPoint joinPoint) {
  // 获取方法名称
  String methodName = joinPoint.getSignature().getName();
  // 获取入参
  Object[] param = joinPoint.getArgs();

  StringBuilder sb = new StringBuilder();
  for (Object o : param) {
   sb.append(o + "; ");
  }
  System.out.println("进入[" + methodName + "]方法,参数为:" + sb.toString());
  // 继续执行方法
  try {
   joinPoint.proceed();
  } catch (Throwable throwable) {
   throwable.printStackTrace();
  }
  System.out.println(methodName + "方法执行结束");
 }
}

在步骤二中的IndexController写一个sourceC进行测试，加上我们的自定义注解：

@MyLog
@GetMapping("/sourceC/{source_name}")
public String sourceC(@PathVariable("source_name") String sourceName){
 return "你正在访问sourceC资源";
}

启动springboot web项目，输入访问地址

到此这篇关于谈谈Java中自定义注解及使用场景的文章就介绍到这了,更多相关Java 自定义注解内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Java 面试题和答案 -（上）
本文主要介绍Java 面试题和答案,这里整理了Java面试中出现的各种题型，和相应知识点，有需要的小伙伴可以好好参考下，帮助大家面试成功
2016-09-09
SpringBoot中的ImportSelector类动态加载bean详解
这篇文章主要介绍了SpringBoot中的ImportSelector类动态加载bean详解,ImportSelector接口是spring中导入外部配置的核心接口,根据给定的条件(通常是一个或多个注释属性)判定要导入那个配置类,在spring自动化配置和@EnableXXX中都有它的存在,需要的朋友可以参考下
2024-01-01
Java版学生管理系统
这篇文章主要为大家详细介绍了Java版学生管理系统，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-06-06
mybatis-plus开启sql打印的三种方式总结
这篇文章主要给大家介绍了mybatisplus开启sql打印的三种方式,文章通过代码示例介绍的非常详细,对大家的学习或工作有一定的参考价值,需要的朋友可以参考下
2023-11-11
SpringBoot读写xml上传到AWS存储服务S3的示例
这篇文章主要介绍了SpringBoot读写xml上传到S3的示例，帮助大家更好的理解和使用springboot框架，感兴趣的朋友可以了解下
2020-10-10
使用Spring的注解方式实现AOP实例
本篇文章主要介绍了使用Spring的注解方式实现AOP实例，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2017-06-06
使用SpringBoot打jar包并部署到Tomcat详细步骤
今天带大家来学习怎么使用SpringBoot打jar包并部署到Tomcat,文中有非常详细的步骤及代码示例,对正在学习java的小伙伴们很有帮助,需要的朋友可以参考下
2021-05-05
Spring Data JPA调用存储过程实例代码
本篇文章主要介绍了Spring Data JPA调用存储过程实例代码，具有一定的参考价值，感兴趣的小伙伴们可以参考一下。
2017-04-04
详解Java编写并运行spark应用程序的方法
这篇文章主要介绍了详解Java编写并运行spark应用程序的方法，内容详细，结合了作者实际工作中的问题进行具体分析，具有一定参考价值。
2017-09-09
Java数据结构之LinkedList从链表到实现
LinkedList是Java中常用的数据结构之一，实现了链表的特性，支持快速添加、删除元素，可以用于实现队列、栈、双向队列等数据结构。LinkedList的内部实现采用了双向链表，其中每个节点都包含前驱节点和后继节点的引用，可以直接访问链表的头尾元素
2023-04-04

谈谈Java中自定义注解及使用场景

相关文章

最新评论

大家感兴趣的内容

最近更新的内容

常用在线小工具