8000字带你了解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淘汰缓存注解。

包含属性：