@Resource详解-代码示例

此注解来源于JSR规范（Java Specification Requests）,其作用是找到依赖的组件注入到应用来，它利用了JNDI（Java Naming and Directory Interface Java命名目录接口 J2EE规范之一）技术查找所需的资源。

网上查了些资料看的有点晕晕, 这里用例子来说明 @Resource的用法 , 以及需要注意的问题

属性介绍

name：
	资源的JNDI名称。在spring的注入时，指定bean的唯一标识。
type：
	指定bean的类型。
lookup:
	引用指向的资源的名称。它可以使用全局JNDI名称链接到任何兼容的资源。
authenticationType:
	指定资源的身份验证类型。它只能为任何受支持类型的连接工厂的资源指定此选项，而不能为其他类型的资源指定此选项。
shareable：
	指定此资源是否可以在此组件和其他组件之间共享。
mappedName：
	指定资源的映射名称。
description：
	指定资源的描述。

@Resource 的装配规则

默认情况下，即所有属性都不指定，它默认按照byType的方式装配bean对象。
如果指定了name，没有指定type，则采用byName。
如果没有指定name，而是指定了type，则按照byType装配bean对象。
当byName和byType都指定了，两个都会校验，如果找不到,或者找到多个(比如byName的方式找到了BeanA, ByType的方式找到了BeanB ) 这种情况也是不会成功的.

上述略显官方的味道的解释,相信不少人也是晕晕的 , 也对这个"默认值" 情况解释的不到位 , 下面来个灵魂总结.

灵魂总结

注意: !!! type和name的根本逻辑就是 type是划定一个范围 , 然后name 在其中选择一个
举个栗子:

• 如果 type 只匹配了 一个 ( 1 ) , 那么成功装备结果 必然是 1 , 如果name只有找到了1 , 或者没有找到的情况下才会配置成功( 没有显示指定name值, 默认为变量名) , name如果在容器中找到了非1 的bean ,则会报类型错误.
• 如果type 匹配了 ( 1 , 2 , 3 ) 多个实例 , 那么name只有匹配到 其中一个,才会装配成功, 如果一个也匹配不到 , 则会报错 ,因为spring不知道到底要装配哪个实例.
• 如果type一个都没有匹配到,那就直接凉凉了 ,报错:No qualifying bean of type xxx 的错误, 即使name指定的值在容器中找到了符合条件的bean实例, 也会报 类型不符合的错误.

先来看下@Resource的应用场景

@Resource的应用场景一般都是在装配的时候出现了多个符合条件的bean , 这时候用@Autowired注解自动装配就会出现了问题 . 此时就可以用@Resource注解类解决问题 . (@Qualifier + @Autowired 也可以实现, 这里主要说下@Resource注解) , 通常就是解决多态的问题.

代码演示

这里示例将@Resource 放在了类的属性上

首先有个HelloService接口:

package com.resource.service;
public interface HelloService {
    void sayHello();
}

两个实现类 , HelloServiceImpl1 和 HelloServiceImpl2 , 实现的sayHello()方法,分别在控制台打印出 hello one! , hello two! 如下:

package com.resource.service.impl;
@Component
public class HelloServiceImpl1 implements HelloService {
    public void sayHello() {
        System.out.println("hello one!");
    }
}

package com.resource.service.impl;
@Component
public class HelloServiceImpl2 implements HelloService {
    public void sayHello() {
        System.out.println("hello two!");
    }
}

业务类UseService 实现属性装配

package com.resource;
@Component
public class UseService {
    //@Qualifier("helloServiceImpl1")
    //@Autowired
    //private HelloService helloService;
    
    @Resource
    private HelloService helloServiceImpl;
    public void say(){
        helloServiceImpl.sayHello();
    }
}

测试类

    public static void main(String[] args) {
        //1.创建容器
        AnnotationConfigApplicationContext ac = new AnnotationConfigApplicationContext("com");
        //2.获取对象
        UseService useService = ac.getBean("useService", UseService.class);
        useService.say();
    }

默认情况

装配代码

其它代码不变

    @Resource
    private HelloService helloServiceImpl;
    public void say(){
        helloServiceImpl.sayHello();
    }

运行测试

这时候如果什么都不指定, 运行则会报错如下:

Caused by: org.springframework.beans.factory.NoUniqueBeanDefinitionException
: No qualifying bean of type 'com.resource.service.HelloService' available
: expected single matching bean but found 2: helloServiceImpl1,helloServiceImpl2

分析

@Resource是用 ByType和ByName 来装配的, 如果没有显示的通过type属性和name属性指定 , “就会找其默认值”
在这个示例中type就是HelloService.class , 又因为其是接口, spring在容器中找到了其两个已经注入容器的实现类分别为 helloServiceImpl1 , helloServiceImpl2 这两个实例. (范围)
而name 也没有通过属性执行 , name默认值就是变量的名称 helloServiceImpl , 显然spring容器中是没有的. (后续会通过测试验证)
通过默认指定值得ByType和ByName 其结果就是得到了两个符合要求的实例 , 而name也没有完成在type后有多个实例的情况下 “选一个” . 所有会有上述的把报错信息.

byName (name默认属性名)

装配代码

其它代码不变

    @Resource
    private HelloService helloServiceImpl1;
    public void say(){
        helloServiceImpl1.sayHello();
    }

这个变化就是上个示例中将属性名从helloServiceImpl 改成了 helloServiceImpl1 .

运行测试

hello one!
Process finished with exit code 0

分析

这里同样byType后 有两个实例 helloServiceImpl1 , helloServiceImpl2 , 而name没有显示指定, 默认为变量名 helloServiceImpl1 , 也完成了选一个的任务, 进而装配成功!

byName (name显示指定)

装配代码

其它代码不变

    @Resource(name="helloServiceImpl2")
    private HelloService helloServiceImpl1;
    public void say(){
        helloServiceImpl1.sayHello();
    }

这个变化就是上个示例中 指定了name属性的值

运行测试

hello two!
Process finished with exit code 0

分析

可以看到属性名为helloServiceImpl1 , 显示指定的是helloServiceImpl2 , 即如果显示指定name的值得话就取该值, 相当于是对默认的变量名覆盖了(可以这样理解). 就是有显示指定就用显示指定的, 没有就用变量名. 结果输出hello two! 就是对的了.

byType 显示指定

装配代码

其它代码不变 , 装配改为显示指定type值,如下

    @Resource(type = HelloServiceImpl1.class )
    private HelloService helloServiceImpl1;
    public void say(){
        helloServiceImpl1.sayHello();
    }

这个变化就是上个示例中 指定了name属性的值

运行测试

hello one!
Process finished with exit code 0

分析

显示指定了type = HelloServiceImpl1.class , 也就范围就是 helloServiceImpl1 , 根据开头的灵魂总结 , type已经确定了一个 , 那么 name (默认变量名 或者显示指定 ) 的值 就必须是helloServiceImpl1 或者是一个在spring容器中找不到的名称.
注意: 这是个坑, 如果你指定的变量名刚好是spring容器中的某个bean的id , 那么这里就会报
Bean named ‘xxxx’ is expected to be of type ‘com.resource.service.impl.HelloServiceImpl1’ 的异常!!!
这里用代码演示下:
新建了个HiService类

package com.resource.service.impl;
@Component
public class HiService {
   public void sayHello() {
       System.out.println("Hi Hi!");
   }
}

装配类 (主要改了变量名为hiservice ,HiService 的bean id)

    @Resource(type = HelloServiceImpl1.class )
    private HelloService hiService;
    public void say(){
        hiService.sayHello();
    }

运行报类型的错误如下:

org.springframework.beans.factory.BeanNotOfRequiredTypeException:
 Bean named 'hiService' is expected to be of type 'com.resource.service.impl.HelloServiceImpl1' 
 but was actually of type 'com.resource.service.impl.HiService'

finally

以上仅为个人见解 , 能看到这里希望能让您有所收获.
抛砖引玉 , 如有不到之处, 敬请指正.