逐渐的,在Spring的开发过程中,注解的使用越来越频繁,之前一直不喜欢注解,因为个人觉得可读性不好,但是正是这个原因使得自己不愿意花时间在这个上面花费时间研究,大势所趋,要学的是逃不掉的,于是就整理了一番,见到的都整理到这里,和其他文章一样,这篇文章不会一蹴而就,而是会逐渐更新,有新的就会更新到这里
一、注解总览
1.Spring注解
@Configuration
@Bean
@Scope
@Lazy
@Conditional
@ComponentScan
@Import
@Value
@PropertySource
@ConfigurationProperties
@AutoWired
@Profile
AOP相关
@Before
@After
@AfterReturning
@AfterThrowing
@Around
@Pointcut
@Aspect
@EnableAspectJAutoProxy
声明式事务
@Transactional
@EnableTransactionManagement
2.SpringMVC注解
常见注解
@Controller
@ResponseBody
@RestController
@ModelAttribute
@SessionAttributes
@requestParam
@RequestHeader
@CookieValue
@PathVariable
@Component
@Repository
SpringMVC的整合
其他的配置
3.原生JavaWeb注解
二、注解解释
1.Spring注解
@Configuration
被该注解标注的类对应于之前配置开发的applicationContext.xml
@Bean
被该注解标注的方法相当于之前在applicationContext.xml中的一个<bean ... />配置;
返回值类型就是<bean ... />中的class属性的值,方法名就是<bean ... />中的id属性的值;
参数中可以指定initMethod和destroyMethod方法
✔ 还有一种方式,就是我们的bean实现两个接口:InitializingBean和DisposableBean即可(记得给Bean添加@Component);
✔ @PostConstruct和@PreDestroy:这两个配置在Bean的初始化和销毁的方法上(记得给Bean添加@Component);
✔ 接口:BeanPostProcessor,初始化前后调用定义的两个方法(记得给Bean添加@Component);
对应的Bean方法也可以添加参数,但是这个参数必须能在Spring容器中唯一定位;
@Scope
作用在配置类的方法上,用来提到<bean ... />的scope属性;
@Lazy
作用在配置类的方法上,用来使得单例的对象也延迟加载;
@Conditional
有条件的把标注的方法返回的对象注入到Spring容器中;需要自定义一个实现了Spring的Condition接口的类,添加到注解的参数即可;
@ComponentScan
该注解主要标注在配置类上,相当于applicationContext.xml中的<context:conponent-scan ··· />;
@Import
原生类导入
✔ 直接把一些类放在@Import的参数中,就可以把这个类导入到Spring的容器中;
ImportSelector
✔ 用来给打@Import的类批量的,有选择的导入一些类到Spring的容器中;@Import参数是实现了ImportSelector接口的类,返回的是要注入的类的全类名字符串;
ImportBeanDefinitionRegistrar
✔ 手动注册类,@Import参数是实现了ImportBeanDefinitionRegistrar接口的类,没有返回值;
@Value
用来给Bean的字段赋值
✔ 参数为字面量
✔ 参数为SpEL,用来计算:#{}
✔ 参数为${},用来获取配置文件的值,配合@PropertySource使用;
@PropertySource
用来加载配置文件,标注在配置类上;
@ConfigurationProperties
用来把application.properties/yml配置文件中的属性注入到Bean中,所以一般添加在配置类的方法上,当然也可以添加在类上;
✔ 当这个注解 @ConfigurationProperties 放在类上的时候,那么这个类就是一个实体类,一般配合@Component 来使用,即把这个类实例化一份,并把配置文件中对应 prefix 转配到这个实体中,然后把这个实体放入Spring容器中;
✔ 如果注解 @ConfigurationProperties 放在方法上,即把配置文件的值装配到该方法的返回的 Bean 中,这种情况一般是是在配置类的情况下,一般配合方法的 @Bean 注解结合使用;当然了,在这种情况下,返回的 Bean 对应的类上就不需要 @Component 和 @ConfigurationProperties来修饰了,这里需要注意一下;
@ConfigurationProperties(prefix="<key-prefix-in-properties/yml>")
@AutoWired
自动把容器中的对象装载进打了该标签的变量;先按照类型找,在按照变量名称找,如果要指定要装配的组件,配合使用@Qualifier指定组件的id即可,也可以使用@Primary首选项来指定(配置在配置类的方法上);
可以添加参数required来表明当在容器中找不到这个对象时怎么处理;
这个功能还可以通过Java标准的注解:@Resource(默认按照字段名称装配的)和@Inject(需要导入jar,除了required外和AutoWired一样)来实现;
可以标注在字段上,字段的setter方法上,构造方法上;当标注在构造方法上,如果构造方法的参数在容器中有,那么就自动从容器中获取;
@Profile
老的项目中一般解决项目的多套配置一般都是使用Maven的Profile配置来解决,而Maven的Profile是基于配置文件的,在使用了全注解的情况下,Spring的Profile就登场了;
用法这里简单说一下,我把这里的Profile分为两种,一种就是不同的环境使用不同的Bean,如数据源的不同,另外一种就是使用不同参数配置,如端口;当然你也可以把前者使用后者实现:
1.对于使用不同的Bean,可以这样做:假如创建三种配置的数据源,当然这些数据源都在一个配置类中,每个@Bean配置一个数据源,在每个@Bean的方法上添加@Profile,参数就是这个Profile的名字,类似于Maven中Profile的dev/beta/online,注意的是,添加了@Profile之后,只有是 default的Bean才会被注入注册到容器中,而且加了环境标识的Bean只有这个环境被激活的时候才会被注册到容器中;问题是如何切换环境的激活状态:
运行参数:(通用的方式)
Java虚拟机参数:-Dspring.profiles.active=<active-profile-name>
Program arguments(java -jar运行的时候):--spring.profiles.active=<active-profile-name>
代码的方式实现,如下:
//1、获取applicationContext
AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext();
//2、设置激活的环境
ctx.getEnvironment().setActiveProfiles("development");
//3、注册配置类
ctx.register(<come-config-class>.class);
//4、刷新容器
ctx.refresh();
仔细想想,这个功能之前的一个注解@Conditional能不能实现呢?☺
2.对于不同的配置参数,可以创建不同的配置文件,如:application-<env-name>.properties/yml:
在配置文件中使用spring.profiles.active=<env-name>来指定当前使用的环境配置;
而且使用yml文件的话,还可以在一个配置文件中利用yml的文档块来配置多个环境,三个英文的-就把文档分为两个文档块,具体摆渡一下就知道了,如:
server:
port: 8081
spring:
profiles:
active: prod # 要使用的环境名称
---
server:
port: 8082
spring:
profiles: dev
---
server:
port: 8083
spring:
profiles: prod
AOP相关,参数就是AspectJ表达式,每个方法都可以添加一个参数:JoinPoint(必须作为第一个参数)来查看目标方法的信息,如方法名,参数等:
@Before
@After:正常异常完成后调用
@AfterReturning:目标方法正常返回,在这个方法上可以添加参数来接收目标方法的返回值,并且在这个注解的参数中使用returning指定这个参数的名称;
@AfterThrowing:异常繁盛就会调用这个方法,同样可以使用throwing来接收目标方法的异常对象信息;
@Around
@Pointcut:用来指定公共的切入点表达式,上面的注解的参数就像调用方法一样调用这个注解标注的方法,每个上面也可以有自己的切入点表达式;
@Aspect:表明标注的类是一个切面类,这个切面类里面的方法标注上面的注解;
@EnableAspectJAutoProxy:相当于在配置文件中的开启基于注解的配置文件<aop:aspectj-autoprocy />
声明式事务:
@Transactional:Service的实现方法上添加
@EnableTransactionManagement:相当于在配置文件中开启配置式的事务<tx:annotation-driven />;
向容器中注入一个DataSourceTransactionManager
2.SpringMVC注解,参考
常见注解
@Controller
@ResponseBody
@RestController
@ModelAttribute
@SessionAttributes
@requestParam
@RequestHeader
@CookieValue
@PathVariable
@Component
@Repository
SpringMVC的整合
编写一个继承于AbstractAnnotationConfigDispatcherServletInitializer的初始化器,重写三个方法:
✔ getRootConfigClasses:用于返回包含Spring的配置类的数组,形成Spring的一个父容器;
✔ getServletConfigClasses:用于返回包含SpringMVC配置类的数组,形成Spring的一个子容器;
✔ getServletMappings:用于返回包含Spring的拦截请求信息的数组,类似于web.xml中配置的url-pattern中的内容;
创建两个配置类:ApplicationContextConfig.java和SpringMVCConfig.java
✔ Spring配置类:添加注解@ComponentScan
@ComponentScan(value = "org.shreker.web", excludeFilters = {
@Filter(type = FilterType.ANNOTATION, classes={Controller.class})
})
✔ SpringMVC配置类:添加注解@ComponentScan,注意:在include的时候一定要禁用默认的过滤规则,否则无效
@ComponentScan(value = "org.shreker.web", includeFilters = {
@Filter(type = FilterType.ANNOTATION, classes = {Controller.class})
}, useDefaultFilters = false)
其他的配置,参考官网文档
✔ 在SpringMVC的配置类上添加注解:@EnableWebMvc,即开启SpringMVC的其他配置,类比于配置文件中的<mvc:annotation-driven />;
✔ 让SpringMVC的配置类继承WebMvcConfigurerAdapter(当然你也可以实现接口WebMvcConfigurer);在这些方法中,有各种配置的方法,根据需要实现即可,实现也特比诶简单,只需要研究传递进来的参数即可;
3.原生JavaWeb注解
@WebServlet
@WebFilter
@WebInitParam
@WebListener
@MultipartConfig
以上的注解都是servlet 3.0(不需要web.xml)模块的,其他的请移步到jcp网站了解(右上角搜索servlet 3.0,就会导航到标准的下载页面 下载查看即可)