一篇带你了解Java开发中常用的注解与作用

JAVA开发常用框架注解与作用

原创来源本人公众号：小简聊开发

Spring全家桶

声明Bean

• @Component组件，没有明确的角色。
• @Service在业务逻辑层使用->Service层。
• D@Repository在数据访问层使用->Dao层。
• @Controller在展现层使用，控制器的声明。

注入Bean

• @Autowired由Spring提供，根据类型进行自动装配，如果组合@Qualifier使用将按名称进行装配。
• @Inject由JSR-330提供使用时需要导入javax.inject.Inject实现注入同样是根据类型进行自动装配，如果需要按名称进行装配，则需要配合@Named。
• @Resource由JSR-250提供，使用需要导入javax.annotation，根据名称进行自动装配的，一般会指定一个name属性。

声明功能

• @Transactional声明事务
• @Cacheable声明缓存

配置相关

• @Configuration声明当前类为配置类。
• @Bean注解在方法上，声明当前方法的返回值为一个bean。
• @ComponentScan用于对Component进行扫描->自定义路径。
• @WishlyConfiguration为@Configuration与@ComponentScan的组合注解，可以替代这两个注解。

AOP相关

• @Aspect声明一个切面。
• @After在方法执行之后执行。
• @Before在方法执行之前执行。
• @Around在方法执行之前与之后都执行。
• @PointCut声明切点。

@Bean的属性支持

@Scope设置Spring新建Bean的模式，可选择包括如下：

• Singleton单例,一个Spring容器中只有一个bean实例，默认模式。
• Protetype每次调用新建一个bean。
• Request web项目中，给每个http request新建一个bean。
• Session web项目中，给每个http session新建一个bean。
• GlobalSession（给每一个global http session新建一个Bean实例。

Class生命周期相关

• @PostConstruct由JSR-250提供，在类的构造函数执行完之后执行，等价于xml配置文件中bean的initMethod。
• @PreDestory由JSR-250提供，在Bean销毁之前执行。

配置项注入

@Value为属性注入值，支持如下方式的注入：

• 普通字符@Value(“JanYork”)。
• 操作系统属性@Value("#{systemProperties[‘os.name’]}")。
• 表达式结果@Value("#{ T(java.lang.Math).random() * 100 }")。
• 其它bean属性@Value("#{domeClass.name}")。
• 文件资源@Value(“classpath:cn/janyork/demo.txt”)。
• 网站资源@Value(“https://ideaopen.cn”)。
• 配置文件属性@Value("${book.name}")。

注入配置文件@PropertySource(“classpath:cn/janyork/dev.propertie”)

也可以读取yml文件配置。

开发环境配置

• @Profile通过设定Environment的ActiveProfiles来设定当前context需要使用的配置环境。
• @Conditional根据代码中设置的条件装载不同的bean，包括一系列的注解。
  • @ConditionalOnBean存在bean。
  • @ConditionalOnMissingBean不存在bean。
  • @ConditionalOnClass存在某个类。
  • @ConditionalOnMissingClass不存在某个类。
  • @ConditionalOnProperty(prefix = “jan”, name = “york”, havingValue = “token”)当存在配置文件中以jan为前缀的属性，属性名称为york，然后它的值为token时才会实例化一个类。
  • @ConditionalOnProperty(prefix = “jan”, name = “york”, havingValue = “counter”, matchIfMissing = true)如果所有的都不满足的话就选择counter为默认实现。
  • @ConditionalOnJava如果是Java应用。
  • @ConditionalOnWebApplication如果是Web应用。

异步注解

@Async在实际执行的bean方法使用该注解来申明其是一个异步任务。

定时任务

@Scheduled来申明这是一个任务，包括cron、fixDelay、fixRate等类型。

开启某些功能

• @EnableAspectJAutoProxy开启对AspectJ自动代理的支持。
• @EnableAsync开启异步方法的支持。
• @EnableScheduling开启计划任务的支持。
• @EnableWebMvc开启Web MVC的配置支持。
• @EnableConfigurationProperties开启对@ConfigurationProperties注解配置Bean的支持。
• @EnableJpaRepositories开启对SpringData JPA Repository的支持。
• @EnableTransactionManagement开启注解式事务的支持。
• @EnableCaching开启注解式的缓存支持。

测试相关

• @RunWith Spring中通常用于对JUnit的支持。
• @ContextConfiguration用来加载配置ApplicationContext。
• @Test用于单元测试。

MVC相关

• @RequestMapping用于映射Web请求，包括访问路径和参数。
• ResponseBody支持将返回值放在response内，而不是一个页面。
• @PathVariable用于接收路径参数。
• @RestController该注解为一个组合注解，相当于@Controller和@ResponseBody的组合，注解在类上，意味着，该Controller的所有方法都默认加上了@ResponseBody。
• @ControllerAdvice通过该注解，我们可以将对于控制器的全局配置放置在同一个位置，注解了@Controller的类的方法可使用@ExceptionHandler、@InitBinder、@ModelAttribute注解到方法上，
  这对所有注解了@RequestMapping的控制器内的方法有效。
• @ExceptionHandler用于全局处理控制器里的异常。
• @InitBinder用来设置WebDataBinder，WebDataBinder用来自动绑定前台请求参数到Model中。
• @ModelAttribute本来的作用是绑定键值对到Model里，在@ControllerAdvice中是让全局的@RequestMapping都能获得在此处设置的键值对。

Boot相关

• @EnableAutoConfiguration自动载入应用程序所需的所有Bean。该注解组合了@Import注解，@Import注解导入了EnableAutoCofigurationImportSelector类，它使用SpringFactoriesLoader.loaderFactoryNames方法来扫描具有META-INF/spring.factories文件的jar包。而spring.factories里声明了有哪些自动配置
  ​+ @SpingBootApplication SpringBoot的核心注解，主要目的是开启自动配置。它也是一个组合注解，主要组合了@Configurer，@EnableAutoConfiguration（核心）和@ComponentScan。可以通过@SpringBootApplication(exclude={想要关闭的自动配置的类名.class})来关闭特定的自动配置。
• @ImportResource加载xml配置的。
• @AutoConfigureAfter在指定的自动配置类之后再配置。

MyBatis

SQL语句映射

@Insert实现新增功能。

@Select实现查询功能。

@SelectKey插入后，获取id的值。

@Insert实现插入功能。

@Update实现更新功能。

@Delete实现删除功能。

结果集映射

@Result、@Results、@ResultMap是结果集映射的三大注解。

@Results各个属性的含义：

id为当前结果集声明唯一标识，value值为结果集映射关系，@Result代表一个字段的映射关系，column指定数据库字段的名称，property指定实体类属性的名称，jdbcType数据库字段类型，@Result里的id值为true表明主键，默认false。

使用@ResultMap来引用映射结果集，其中value可省略。

关系映射

@one用于一对一关系映射。

@many用于一对多关系映射。

MyBatisPlus

请看官方文档。

Lombok

• @Getter、@Setter ->自动产生 getter/setter。
• @ToString->自动重写 toString() 方法，会印出所有变量。
• @EqualsAndHashCode->自动生成 equals(Object other) 和 hashcode() 方法，包括所有非静态变量和非 transient 的变量。

---

• @NoArgsConstructor、@AllArgsConstructor,、@RequiredArgsConstructor

这三个很像，都是在自动生成该类的构造器，差别只在生成的构造器的参数不一样而已。

• @NoArgsConstructor生成一个没有参数的构造器。
• @AllArgsConstructor生成一个包含所有参数的构造器。
• @RequiredArgsConstructor生成一个包含 “特定参数” 的构造器，特定参数指的是那些有加上 final 修饰词的变量们。

注意：

这里注意一个Java的小坑，当我们没有指定构造器时，Java编译器会帮我们自动生成一个没有任何参数的构造器给该类，但是如果我们自己写了构造器之后，Java就不会自动帮我们补上那个无参数的构造器了。

然而很多地方（像是 Spring Data JPA），会需要每个类都一定要有一个无参数的构造器，所以你在加上 @AllArgsConstructor 时，一定要补上 @NoArgsConstrcutor，不然会有各种坑等着你。

---

@Data：整合包，只要加了@Data这个注解，等于同时加了以下注解。

• @Getter/@Setter
• @ToString
• @EqualsAndHashCode
• @RequiredArgsConstructor

@Value：整合包，但是他会把所有的变量都设成final的，其他的就跟@Data一样，等于同时加了以下注解。

• @Getter (没有setter)
• @ToString
• @EqualsAndHashCode
• @RequiredArgsConstructor

@Builder：自动生成流式set值写法，从此之后再也不用写一堆 setter了。

注意，虽然只要加上 @Builder 注解，我们就能够用流式写法快速设定对象的值，但是 setter 还是必须要写不能省略的，因为 Spring 或是其他框架有很多地方都会用到对象的 getter/setter 对他们取值/赋值

所以通常是 @Data 和 @Builder 会一起用在同个类上，既方便我们流式写代码，也方便框架做事。

@Slf4j：自动生成该类的 log 静态常量，要打日志就可以直接打，不用再手动 new log 静态常量了。

除了 @Slf4j 之外，lombok 也提供其他日志框架的变种注解可以用，像是 @Log、@Log4j …等，他们都是帮我们创建一个静态常量 log，只是使用的库不一样而已。

@Log //对应的log语句如下
private static final java.util.logging.Logger log = java.util.logging.Logger.getLogger(LogExample.class.getName());

@Log4j //对应的log语句如下
private static final org.apache.log4j.Logger log = org.apache.log4j.Logger.getLogger(LogExample.class);

SpringBoot默认支持的就是slf4j + logback的日志框架，所以也不用再多做啥设定，直接就可以用在 SpringBoot project上，log 系列注解最常用的就是 @Slf4j。

Shiro

@RequiresAuthentication验证用户是否登录，等同于方法subject.isAuthenticated()结果为true时。

@RequiresUser验证用户是否被记忆，user有两种含义：

• 一种是成功登录的（subject.isAuthenticated()结果为true）。

• 另外一种是被记忆的（subject.isRemembered()结果为true）。

@RequiresGuest验证是否是一个guest的请求，与@RequiresUser完全相反。换言之，RequiresUser == !RequiresGuest。此时subject.getPrincipal()结果为null。

@RequiresRoles例如：

@RequiresRoles("JanYork");
void someMethod();

如果subject中有JanYork角色才可以访问方法someMethod。如果没有这个权限则会抛出异常AuthorizationException。

@RequiresPermissions例如：

@RequiresPermissions({
    
    "file:read","write:aFile.txt"})
void someMethod();

要求subject中必须同时含有file:read和write:aFile.txt的权限才能执行方法someMethod()。否则抛出异常AuthorizationException。

SpringSecurity

@Secured：

方法级别的权限认证，只有被该注解指定的角色才能访问该方法。

使用该注解需要开启注解功能，在配置类或者启动类上添加以下注解。

@EnableGlobalMethodSecurity(securedEnabled=true)

在controller方法上添加@Secured注解演示：

@GetMapping("user")
 //设置只有这两种角色才能访问这个方法
@Secured({
    
    "ROLE_admin","ROLE_admin_Pro"})
public String getUser() {
    
    
   return ".......";
}

此时如果不是这两个角色其中之一访问请求将被拒绝。

@PreAuthorize ：

进入方法前的权限验证，同时也支持表达式的访问控制

要想使用该注解需要在@EnableGlobalMethodSecurity注解上添加 prePostEnabled = true属性

在controller方法上添加@PreAuthorize注解演示：

@GetMapping("user")
@PreAuthorize("hasAuthority('admin')")
public String getUser() {
    
    
   return ".......";
}

此时如果不具备manager权限的访问将会被拒绝。

多个条件同时满足可以这样：

@PreAuthorize("hasAuthority('admin') and hasRole('admin_Pro')")

如果不能同时满足这两个条件，那么这个方法将不能访问。

@PostAuthorize：

同上面的注解一样，要开启此注解的功能需要在 @EnableGlobalMethodSecurity注解上添加 prePostEnabled = true属性。

@PostAuthorize注解的使用频率并不高，在方法执行之后再进行权限验证，适合验证带有返回值的权限。

@PostFilter：

在权限验证过后对数据进行过滤。

@PreFilter：

进入控制器之前对数据进行过滤。

Spring Cache

@EnableCaching开启Spring Cache框架支持。解析对应的注解，实现缓存读写访问。

@CacheConfig缓存配置，可以配置当前类型中所用缓存注解的通用信息。

示例：配置当类前所有缓存注解的缓存前缀。

@CacheConfig(cacheNames = "cache:prefix")

@Cacheable表示要对方法返回值进行缓存。

包含属性：

• cacheNames ： 缓存key前缀名字。
• key ：缓存key后缀。
• condition : SpringEL表达式，结果为true，缓存数据到redis。结果为false，不缓存数据到redis。
• unless：SpringEL表达式，结果为false，缓存数据到redis。结果为true，不缓存数据到redis。

@CacheEvict淘汰缓存注解。

包含属性：

• allEntries代表是否删除cacheNames对应的全部的缓存。默认false，可选true。
• 注解属性和Cacheable相似。

@CachePut更新缓存，如果key存在覆盖缓存数据。key不存在，新增数据到缓存。

注解属性：跟@Cacheable相似。

结束

全篇完，其他注解请自行了解。