Spring开发中常用的注解

一、SpringMVC中常用的注解

1、@Controller ：用于标记一个类，使用它标记的类就是一个SpringMVC Controller对象，即控制器类。Spring使用扫描机制，扫描程序中所有基于注解的控制器类，分发处理器会扫描了该注解类的方法，并检测该方法是否使用了@RequestMapping注解，而使用了@RequestMapping注解的方法才是真正处理请求的处理器。（开启扫描功能。）目前使用的@RestController则可以理解为这个控制器所有的方法都是Ajax请求,不是返回的某一个页面。

2、@RequestMapping：指示Spring用哪一个类或者方法来处理请求动作。可以用于类或者方法。

• value：用来映射一个请求或者方法
• method：标明处理哪些类型的Http请求。RequestMethod.GET
• consumes:指定处理请求的提交内容（content-type）
• produces：指定返回的类型。返回的类型必须是请求头中（Accept）包含的类型
• paams：表明请求中必须包含某些参数值时，才让该方法进行处理
• headers：指定Reques中必须包含了指定的header的值，才能让该方法进行处理
• PS：目前使用的GetMapping和PostMapping就是RequestMapping中指定HTTP请求类型的写法。通常如果使用的是@RestController则表明这个控制器返回的是Ajax的请求结果而不是对应的页面，如果没有使用@RestController注解，如果处理的是Ajax请求，则需要配套使用@ResponseBody注解。

3、PostMapping、GetMapping：略

4、@Service、类似的还包括@Component、@Repository，启动自动扫描后，将会自动注册到Spring容器中

5、@Resource、@AutoWired

• @Autowired和@Resource都可以用来装配bean，都可以写在字段上，或者方法上。
• @Autowired属于Spring的；@Resource为JSR-250标准的注释，属于J2EE的。
• @Autowired默认按类型装配，默认情况下必须要求依赖对象必须存在，如果要允许null值，可以设置它的required属性为false，例如：@Autowired(required=false) ，如果我们想使用名称装配可以结合@Qualifier注解进行使用
• @Resource，默认安装名称进行装配，名称可以通过name属性进行指定，如果没有指定name属性，当注解写在字段上时，默认取字段名进行安装名称查找，如果注解写在setter方法上默认取属性名进行装配。当找不到与名称匹配的bean时才按照类型进行装配。但是需要注意的是，如果name属性一旦指定，就只会按照名称进行装配。
• 推荐使用：@Resource注解在字段上，这样就不用写setter方法了，并且这个注解是属于J2EE的，减少了与spring的耦合。这样代码看起就比较优雅。

二、参数绑定注解

1、@RequestParam：用于将指定的请求参数赋值给方法中的形参

-name：指定请求头绑定的名称
-value：name的别名
-required：参数是否必须绑定
-defaultValue：默认值

2、@PathVariable：可以获取请求URL中的动态参数

• 只支持一个属性value，类型为String，表示绑定的名称。如果默认则表示绑定同名参数。

3、@RequestHeader：注解类型用于将请求的头信息区数据映射到功能处理的参数上

• name:指定请求头绑定的名称
• value：name属性的别名
• required：指定参数是否必须绑定
• defaultValue：未传参时的默认值

4、@CookieValue：用于将请求的Cookie参数数据映射到处理方法的参数上

• name:指定请求头绑定的名称
• value：name属性的别名
• required：指定参数是否必须绑定
• defaultValue：未传参时的默认值

5、@ModelAttribute：将请求对象绑定在Model对象上。注释方法将会在Controller的每一个方法执行前被执行。所以慎重使用。

三、Java元注解

1、@Inherited：允许子类继承父类的注解。

2、@Target：说明了Annotation所修饰的对象范围，明晰其修饰的目标，可被用于：

• packages
• types（类、接口、枚举、Annotation类型）
• 类型成员（方法、构造方法、成员变量、枚举值）
• 方法参数和本地变量（如循环变量、catch参数）

取值Element有：

• 1.CONSTRUCTOR:用于描述构造器
• 2.FIELD:用于描述域
• 3.LOCAL_VARIABLE:用于描述局部变量
• 4.METHOD:用于描述方法
• 5.PACKAGE:用于描述包
• 6.PARAMETER:用于描述参数
• 7.TYPE:用于描述类、接口(包括注解类型) 或enum声明

3、@Retention:定义了该Annotation被保留的时间长短。

• 1.SOURCE:在源文件中有效（即源文件保留）
• 2.CLASS:在class文件中有效（即class保留）
• 3.RUNTIME:在运行时有效（即运行时保留）

4、@Documented：用于描述其它类型的annotation应该被作为被标注的程序成员的公共API，因此可以被例如javadoc此类的工具文档化。Documented是一个标记注解，没有成员。

四：SpringBoot注解：

1、SpringBootApplication

2、@ComponentScan Spring的注解，自动扫描注有@Controller、@Service、@Repository，@Componet注解的类。

3、@EnableAsync 开启异步，使用@Async实现异步任务。

4、@SpringBootConfiguration 继承自 @Configuration 注解，所以两者功能也一致，可以将当前类内声明的一个或多个以 @Bean 注解标记的方法的实例纳入到 Srping 容器中，并且实例名就是方法名。

5、@EnableAutoConfiguration 开启SringBoot自动配置的功能

6、@Import 在应用中，有时没有把某个类注入到IOC容器中，但在运用的时候需要获取该类对应的bean，此时就需要用到@Import注解