Spring注解

一、注解和注释两者区别

注解 ：参与代码编译，以@开头的。它是给应用程序看的，单独使用注解毫无意义，一定要跟工具一起使用,这个所谓的工具实际就是能读懂注解的应用程序
注释 ：对代码没有影响。对代码起到解释、说明的作用

二、Spring部分的注解

1.声明bean的注解

@Component 最普通的组件，可以被注入到spring容器进行管理没有明确的角色

@Service 在业务逻辑层使用（service层）

@Repository 在持久层（数据访问层）使用（dao层）

@Controller 在表现层使用，控制器的声明（spring-mvc的注解）

2.注入bean的注解

@Autowired：由Spring提供。自动装配，其作用是为了消除代码Java代码里面的getter/setter与bean属性中的property。
@Autowired默认先按byType进行匹配，如果发现找到多个bean，则又按照byName方式进行匹配，如果还有多个，则报出异常。
@Autowired有个属性为required，可以配置为false，如果配置为false之后，当没有找到相应bean的时候，系统不会抛错。

@Qualifier （指定注入Bean的名称）如果容器中有一个以上匹配的Bean，则可以通过@Qualifier注解限定Bean的名称
@Inject：由JSR-330提供。如下是@Inject的使用，不加@Named注解，需要配置与变量名一致即可。

@Inject
    @Named("mongo")
    private Mongo mongo;

@Resource：由JSR-250提供 。它在语义上被定义为通过其唯一的名称来标识特定的目标组件，其中声明的类型与匹配过程无关。

• @Resource一般会指定一个name属性，如下：

@Resource(name = "userMapper")
    private UserMapper userMapper;

• @Resource默认按byName自动注入。既不指定name属性，也不指定type属性，则自动按byName方式进行查找。如果没有找到符合的bean，则回退为一个原始类型进行进行查找，如果找到就注入。
• 只是指定了@Resource注解的name，则按name后的名字去bean元素里查找有与之相等的name属性的bean。
• 只指定@Resource注解的type属性，则从上下文中找到类型匹配的唯一bean进行装配，找不到或者找到多个，都会抛出异常。

3.java配置类相关注解

@Configuration 声明当前类为配置类，相当于xml形式的Spring配置（类上）

@Bean 注解在方法上，声明当前方法的返回值为一个bean，替代xml中的方式（方法上）

@Configuration 声明当前类为配置类，其中内部组合了@Component注解，表明这个类是一个bean（类上）

@ComponentScan 用于对Component进行扫描，相当于xml中的（类上）

@WishlyConfiguration 为@Configuration与@ComponentScan的组合注解，可以替代这两个注解

4.切面（AOP）相关注解

Spring支持AspectJ的注解式切面编程。

@Aspect 声明一个切面（类上）
使用@After、@Before、@Around定义建言（advice），可直接将拦截规则（切点）作为参数。

@After 在方法执行之后执行（方法上）
@Before 在方法执行之前执行（方法上）
@Around 在方法执行之前与之后执行（方法上）

@PointCut 声明切点
在java配置类中使用@EnableAspectJAutoProxy注解开启Spring对AspectJ代理的支持（类上）

5.@Bean的属性支持

@Scope 设置Spring容器如何新建Bean实例（方法上，得有@Bean）
其设置类型包括：

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

@StepScope 在Spring Batch中还有涉及

@PostConstruct 由JSR-250提供，在构造函数执行完之后执行，等价于xml配置文件中bean的initMethod

@PreDestory 由JSR-250提供，在Bean销毁之前执行，等价于xml配置文件中bean的destroyMethod

6.@Value注解

@Value 为属性注入值（属性上）
支持如下方式的注入：
》注入普通字符

@Value("Michael Jackson")
String name;

》注入操作系统属性

@Value("#{systemProperties['os.name']}")
String osName;

》注入表达式结果

@Value("#{ T(java.lang.Math).random() * 200 }")
String randomNumber;

》注入其它bean属性

@Value("#{domeClass.name}")
String name;

》注入文件资源

@Value("classpath:com/ght/user/test.txt")
String Resource file;

》注入网站资源

@Value("http://www.baidu.com")
Resource url;

》注入配置文件

@Value("${computer.name}")
String computerName;

注入配置使用方法：
① 编写配置文件（test.properties）

computer.name=《Dell》

② @PropertySource 加载配置文件(类上)

@PropertySource("classpath:com/ght/user/test.propertie")

③ 还需配置一个PropertySourcesPlaceholderConfigurer的bean。

7.环境切换

@Profile 通过设定Environment的ActiveProfiles来设定当前context需要使用的配置环境。（类或方法上）

@Conditional Spring4中可以使用此注解定义条件话的bean，通过实现Condition接口，并重写matches方法，从而决定该bean是否被实例化。（方法上）

8.异步相关

@EnableAsync 配置类中，通过此注解开启对异步任务的支持，叙事性AsyncConfigurer接口（类上）

@Async 在实际执行的bean方法使用该注解来申明其是一个异步任务（方法上或类上所有的方法都将异步，需要@EnableAsync开启异步任务）

9.定时任务相关

@EnableScheduling 在配置类上使用，开启计划任务的支持（类上）

@Scheduled 来申明这是一个任务，包括cron,fixDelay,fixRate等类型（方法上，需先开启计划任务的支持）

10.@Enable*注解说明

这些注解主要用来开启对xxx的支持。
@EnableAspectJAutoProxy 开启对AspectJ自动代理的支持

@EnableAsync 开启异步方法的支持

@EnableScheduling 开启计划任务的支持

@EnableWebMvc 开启Web MVC的配置支持

@EnableConfigurationProperties 开启对@ConfigurationProperties注解配置Bean的支持

@EnableJpaRepositories 开启对SpringData JPA Repository的支持

@EnableTransactionManagement 开启注解式事务的支持

@EnableTransactionManagement 开启注解式事务的支持

@EnableCaching 开启注解式的缓存支持

11.测试相关注解

@RunWith 运行器，Spring中通常用于对JUnit的支持

@RunWith(SpringJUnit4ClassRunner.class)

@ContextConfiguration 用来加载配置ApplicationContext，其中classes属性用来加载配置类

@ContextConfiguration(classes={TestConfig.class})

三、SpringMVC部分

@EnableWebMvc 在配置类中开启Web MVC的配置支持，如一些ViewResolver或者MessageConverter等，若无此句，重写WebMvcConfigurerAdapter方法（用于对SpringMVC的配置）。

@Controller 声明该类为SpringMVC中的Controller，负责注册一个bean 到spring 上下文中

@RequestMapping 用于映射Web请求，包括访问路径和参数（类或方法上），注解为控制器指定可以处理哪些 URL 请求

@RequestBody 该注解用于读取Request请求的body部分数据，使用系统默认配置的HttpMessageConverter进行解析，然后把相应的数据绑定到要返回的对象上 ,再把HttpMessageConverter返回的对象数据绑定到 controller中方法的参数上

@ResponseBody 该注解用于将Controller的方法返回的对象，通过适当的HttpMessageConverter转换为指定格式后，写入到Response对象的body数据区

@ModelAttribute 在方法定义上使用 @ModelAttribute 注解：Spring MVC 在调用目标处理方法前，会先逐个调用在方法级上标注了@ModelAttribute 的方法
在方法的入参前使用 @ModelAttribute 注解：可以从隐含对象中获取隐含的模型数据中获取对象，再将请求参数 –绑定到对象中，再传入入参将方法入参对象添加到模型中
@RequestParam　在处理方法入参处使用 @RequestParam 可以把请求参 数传递给请求方法
@PathVariable 用于接收路径参数，比如@RequestMapping(“/hello/{name}”)申明的路径，将注解放在参数中前，即可获取该值，通常作为Restful的接口实现方法。

@RestController 该注解为一个组合注解，相当于@Controller和@ResponseBody的组合，注解在类上，意味着，该Controller的所有方法都默认加上了@ResponseBody。
@ExceptionHandler 注解到方法上，出现异常时会执行该方法
@ControllerAdvice 通过该注解，我们可以将对于控制器的全局配置放置在同一个位置，注解了@Controller的类的方法可使用@ExceptionHandler、@InitBinder、
@ExceptionHandler 用于全局处理控制器里的异常
@InitBinder 用来设置WebDataBinder，WebDataBinder用来自动绑定前台请求参数到Model中。
@ModelAttribute 本来的作用是绑定键值对到Model里，在@ControllerAdvice中是让全局的@RequestMapping都能获得在此处设置的键值对。