Spring常用注解 Spring常用注解

Spring的一个核心功能是IOC，就是将Bean初始化加载到容器中，Bean是如何加载到容器的，可以使用Spring注解方式或者Spring XML配置方式。
Spring注解方式减少了配置文件内容，更加便于管理，并且使用注解大大提高了开发效率！
下面按照分类讲解Spring中常用的一些注解。
1.声明bean的注解（将普通类加入容器形成Bean）

@Component 组件，没有明确的角色
@Service 在业务逻辑层使用（业务逻辑层）
@Repository 在数据访问层使用（数据访问层）
@Controller 在展现层使用，控制器的声明（页面访问控制层）

这些都是注解在平时的开发过程中出镜率极高，@Component、@Repository、@Service、@Controller实质上属于同一类注解，用法相同，功能相同，区别在于标识组件的类型。@Component可以代替@Repository、@Service、@Controller，因为这三个注解是被@Component标注的。
如下@controller源码：

@Target({ElementType.TYPE}) @Retention(RetentionPolicy.RUNTIME) @Documented @Component public @interface Controller { String value() default ""; }

1、被注解的java类当做Bean实例，Bean实例的名称默认是Bean类的首字母小写，其他部分不变。@Service也可以自定义Bean名称，但是必须是唯一的！
2、尽量使用对应组件注解的类替换@Component注解，在spring未来的版本中，@Controller，@Service，@Repository会携带更多语义。并且便于开发和维护！
3、指定了某些类可作为Spring Bean类使用后，最好还需要让spring搜索指定路径，在Spring配置文件加入如下配置：

2.注入bean的注解（从容器中获取Bean即装配bean）开发中最常用到的用于装配的注解是：@Autowired和@Resource

@Autowired注解：
@Autowired源码：

@Target({ElementType.CONSTRUCTOR, ElementType.FIELD, ElementType.METHOD, ElementType.ANNOTATION_TYPE}) @Retention(RetentionPolicy.RUNTIME) @Documented public @interface Autowired { boolean required() default true; }

@Autowired注解可用于为类的属性、构造器、方法进行注值。默认情况下，其依赖的对象必须存在（bean可用），如果需要改变这种默认方式，可以设置其required属性为false。另外一个比较重要的点就是，@Autowired注解默认按照类型装配，如果容器中包含多个同一类型的Bean，那么启动容器时会报找不到指定类型bean的异常，解决办法是结合@Qualified注解进行限定，指定注入的bean名称，例如：

public class MovieRecommender {@Autowired private MovieCatalog movieCatalog; private CustomerPreferenceDao customerPreferenceDao; @Autowired public MovieRecommender(CustomerPreferenceDao customerPreferenceDao) { this.customerPreferenceDao = customerPreferenceDao; } }

@Controller public class HappyController { @Autowired //默认依赖的ClubDao 对象（Bean）必须存在 //@Autowired(required = false) 改变默认方式 @Qualifier("goodClubService") private ClubService clubService; // Control the people entering the Club // do something }

@Service(value="https://www.it610.com/article/goodClubService") //使用@Service注解不加value ,默认名称是clubService public class ClubServiceImpl implements ClubService { @Autowired private ClubDao clubDao; public void doHappy(){ //do some Happy } }

@Resource注解
@Resource源码：

@Target({TYPE, FIELD, METHOD}) @Retention(RUNTIME) public @interface Resource { String name() default ""; Class type() default java.lang.Object.class;

对于@Resource注解，它并不属于spring的注解，而是来自于JSR-250。其默认情况下按照bean的名称进行注入，当找不到匹配项时会按照类型装配。当按照名称进行装配时，可以指定其name属性，倘若没有指定，注解标注在哪个字段上，其默认名称就是那个字段的名称。当然，@Resource注解也支持按指定类型进行装配，给它的type属性赋特定类型的值即可（注意，当指定了name属性后，只能按照名称装配）

public class AnotationExp {@Resource(name = "HappyClient") private HappyClient happyClient; @Resource(type = HappyPlayAno .class) private HappyPlayAno happyPlayAno; }

总结

相同点：

@Resource的作用相当于@Autowired，均可标注在字段或属性的setter方法上。

不同点：

a：提供方 @Autowired是Spring的注解，@Resource是javax.annotation注解，而是来自于JSR-250，J2EE提供，需要JDK1.6及以上。

b ：注入方式 @Autowired只按照Type 注入；@Resource默认按Name自动注入，也提供按照Type 注入；

c：属性
@Autowired注解可用于为类的属性、构造器、方法进行注值。默认情况下，其依赖的对象必须存在（bean可用），如果需要改变这种默认方式，可以设置其required属性为false。
还有一个比较重要的点就是，@Autowired注解默认按照类型装配，如果容器中包含多个同一类型的Bean，那么启动容器时会报找不到指定类型bean的异常，解决办法是结合@Qualifier注解进行限定，指定注入的bean名称。
@Resource有两个中重要的属性：name和type。name属性指定byName，如果没有指定name属性，当注解标注在字段上，即默认取字段的名称作为bean名称寻找依赖对象，当注解标注在属性的setter方法上，即默认取属性名作为bean名称寻找依赖对象。
需要注意的是，@Resource如果没有指定name属性，并且按照默认的名称仍然找不到依赖对象时， @Resource注解会回退到按类型装配。但一旦指定了name属性，就只能按名称装配了。

d：@Resource注解的使用性更为灵活，可指定名称，也可以指定类型；@Autowired注解进行装配容易抛出异常，特别是装配的bean类型有多个的时候，而解决的办法是需要在增加@Qualifier进行限定。

3. Java配置类相关注解

@Configuration 声明当前类为配置类，其中内部组合了@Component注解，表明这个类是一个bean相当于xml形式的Spring配置（类上）
Spring的官方团队说@Component可以替代 @Configuration注解，事实上我们看源码也可以发现看到，如下

@Target({ElementType.TYPE}) @Retention(RetentionPolicy.RUNTIME) @Documented @Component//看这里！！！ public @interface Configuration { String value() default "";

@Bean 注解在方法上，声明当前方法的返回值为一个bean，替代xml中的方式（方法上）
@ComponentScan 用于对Component进行扫描，相当于xml中的context:component-scan/（类上）
@WishlyConfiguration 为@Configuration与@ComponentScan的组合注解，可以替代这两个注解

4.Spring @Configuration与@Component的区别代码如下：

@Configuration public static class Config {@Bean public SimpleBean simpleBean() { return new SimpleBean(); }@Bean public SimpleBeanConsumer simpleBeanConsumer() { return new SimpleBeanConsumer(simpleBean()); } }

@Component public static class Config {@Bean public SimpleBean simpleBean() { return new SimpleBean(); }@Bean public SimpleBeanConsumer simpleBeanConsumer() { return new SimpleBeanConsumer(simpleBean()); } }

第一段代码可以正常运行，并且可以预期地从SimpleBeanConsumer获得指向singleton的链接SimpleBean。但是不幸的是，它在签名环境中不起作用。
第二个配置是完全错误的，因为Spring会创建一个SimpleBean的单例bean，但是SimpleBeanConsumer将获得另一个SimpleBean实例（也就是相当于直接调用new SimpleBean() ，这个bean是不归Spring管理的），既new SimpleBean() 实例是Spring上下文控件之外的。
这种现象的原因可以解释如下：
如果使用@Configuration，则所有标记为的方法@Bean都将被包装到CGLIB包装器中，该包装器将像第一次调用此方法一样工作，然后将执行原始方法的主体，并将结果对象注册在spring上下文中。所有其他调用仅返回从上下文中检索到的bean。
在上面的第二个代码块中，new SimpleBeanConsumer(simpleBean())仅调用一个纯java方法。要更正第二个代码块，我们可以执行以下操作：

@Component public static class Config { @Autowired SimpleBean simpleBean; @Bean public SimpleBean simpleBean() { return new SimpleBean(); }@Bean public SimpleBeanConsumer simpleBeanConsumer() { return new SimpleBeanConsumer(simpleBean); } }

原因总结

使用@ configuration，所有标记为@ bean的方法将被包装成一个CGLIB包装器，它的工作方式就好像是这个方法的第一个调用，那么原始方法的主体将被执行，最终的对象将在spring上下文中注册。所有进一步的调用只返回从上下文检索的bean。

Spring注解——使用@ComponentScan自动扫描组件
5.切面（AOP）相关注解 Spring支持AspectJ的注解式切面编程。

@EnableAspectJAutoProxy 开启基于注解的aop模式
@Aspect 声明一个切面（类上）
@After 在方法执行之后执行（方法上）
@Before 在方法执行之前执行（方法上）
@Around 在方法执行之前与之后执行（方法上）
@PointCut 声明切点
@EnableAspectJAutoProxy在java配置类中使用该注解开启Spring对AspectJ代理的支持（类上）

6.@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中还有涉及
@Qualifier注解定义Bean名称（方法上，必须有@Bean）。
当你创建多个具有相同类型的 bean 时，并且想要用一个属性只为它们其中的一个进行装配，在这种情况下，你可以使用 @Qualifier 注释和 @Autowired 注释通过指定哪一个真正的 bean 将会被装配来消除混乱。
@PostConstruct 用来标记是在项目启动的时候执行这个方法。用来修饰一个非静态的void()方法
也就是spring容器启动时就执行，多用于一些全局配置、数据字典之类的加载。
被@PostConstruct修饰的方法会在服务器加载Servlet的时候运行，并且只会被服务器执行一次。PostConstruct在构造函数之后执行,init()方法之前执行。PreDestroy（）方法在destroy()方法执行执行之后执
@PreDestory 被@PreDestroy修饰的方法会在服务器卸载Servlet的时候运行，并且只会被服务器调用一次，类似于Servlet的destroy()方法。被@PreDestroy修饰的方法会在destroy()方法之后运行，在Servlet被彻底卸载之前

7.@Value注解 【Spring常用注解】@Value 为属性注入值（属性上）
示例：

注入普通字符: @Value("Michael Jackson") String name; 注入操作系统属性: @Value("#{systemProperties['os.name']}") String osName; 注入表达式结果: @Value("#{ T(java.lang.Math).random() * 100 }") String randomNumber; 注入其它bean属性: @Value("#{domeClass.name}") String name; 注入文件资源: @Value("classpath:com/hgs/hello/test.txt") String Resource file; 注入网站资源: @Value("http://www.cznovel.com") Resource url; 注入配置文件: @Value("${book.name}") String bookName; 注入配置使用方法： ① 编写配置文件（test.properties） book.name=《三体》 ② @PropertySource 加载配置文件(类上) @PropertySource("classpath:com/hgs/hello/test/test.propertie") ③ 还需配置一个PropertySourcesPlaceholderConfigurer的bean。