JSR330： DI

JSR330 DI

JSR 330 ，提供了一种可重用的、可维护、可测试的方式来获取Java对象。也称为Dependency Injection 。

DI应该都不陌生，因为它就是Spring core之一。在Spring盛行后，Google也提供了一种DI实现：Guice。因为这两个DI容器的盛行，JSR在2009年时诞生了。随后Spring、Guice也相继支持了该规范。

DI容器，也称为Injector。可以有多种实现方式，可以基于XML、注解、DSL（Domain-specific language），甚至是Java代码。在实现是，可以采用反射、代码生成技术等等，均不受限制。

内容摘要：

• JSR 330 (javax.inject)
  • @Inject
  • @Qualifer
  • @Named
  • @Scope, @Singleton
  • Provider
• JSR330 vs Spring vs guice vs HK2

javax.inject

下面就说说JSR 330 规范是如何定义的：

Interface Summary
Provider<T>	Provides instances of T.

Annotation Types Summary
Inject	Identifies injectable constructors, methods, and fields.
Named	String-based qualifier.
Qualifier	Identifies qualifier annotations.
Scope	Identifies scope annotations.
Singleton	Identifies a type that the injector only instantiates once.

@Inject

该注解可以在constructor、field、method上使用，也可以在static 的非 final 的field、method上使用。使用该注解标注的constructor、field、method访问修饰符不受限制，可以是private、package、protected、public中任意一种。Injector在进行注入时，要按照constructors、fiedls、methods的顺序进行。

对被标注的constructor的要求：

在满足上述说明的情况下，可以有其他的依赖作为方法的参数，别的要求倒没有什么。

对被标注的field的要求：

1）字段不能是final的。

对被标注的method的要求：

1）方法不能是abstract。

2）可以有其他的依赖作为方法的参数。

如果一个@Inject 的方法A.a，被子类B重写了方法a，但没有指定@Inject，那么就不会注入。

@Qualifier

它是一个元注解，用在标注一个注解的。被@Qualifier标注的注解，称为Qualifier。用于指定采用哪个实例。

譬如说，A类有两个子类A1,A2。B类依赖了A，那么DI容器在为B的实例注入A依赖时到底该注入哪个实例呢？

Class B{
    @Inject
    A a;
}

如果使用这个注解，就可以解决该问题了：

定义来个Qualifier注解：

@Qualifier
public @interface A_1 {
}

@Qualifier
public @interface A_2 {
}

然后对A1、A2两个类分别标注，加以区分：

@A_1
public class A1{
}

@A_2
public class A2{
}

如果你希望注入的是A1，那么Class B应该这样调整：

Class B{
    @Inject
    @A_1
     A a;
}

在JSR 330中，也默认设计了一个基于字符串命名的Qualifier，也就是@Named。

对上述案例，可以改造如下：

@Named(“A1”)
Public class A1{
}

@Named(“A2”)
Public class A2{
}

Class B{
    @Inject
    @Named(“A1”)
    A a;
}

也就是说，一个Qualifier可以把一个类定义成一个依赖类（类A1,A2中的使用方式），也可以用在注入时指定注入哪个依赖类的实例（Class B中的使用方式）。

@Named

它就是上面说的，默认的Qualifier。通过上面的例子，可以将其理解为Spring中的：

@Component：用于一个类上，告诉DI容器，这个类由DI容器来创建，并可以作为依赖类去注入到其他类中。

@Qualifier：用于指定使用哪个依赖类的实例。

上述代码在Spring中的写法是：

@Component(“A1”)
Class A1{
}

@Component(“A2”)
Class A2{
}

Class B{
    @Autowired
    @Qualifier(“A1”)
    A a;
}

@Scope、@Singleton

@Scope是Scope的元注解。用于声明Scope注解。譬如@Singleton。

Scope注解，用在类上，用于告诉Injector，为该类创建多少个对象。

也默认提供了一个Scope：@Singleton，它用于告诉容器，只为该类创建一个实例。所以当一类类被标注为@Singleton时，要注意线程安全性。

如果一个@Named或者其他自定义的Qualifier标准的类，没有被标注为@Singleton，那么就会创建多个实例。

单实例例子：

// Spring中的写法：
@Component(“cxxx”)
@Scope(“Singleton”)
public class C{
}

// 如果用JSR 330就可以写为：
@Named(“cxxx”)
@Scope(“prototype”)
public class C{
}

多实例例子：

// Spring中的写法：
@Component(“cxxx”)
public class C{
}

// 如果用JSR 330就可以写为：
@Named(“cxxx”)
public class C{
}

Provider

一个Provider用于提供某个类的实例。它就相当于Spring中的ObjectFactory。这是一个接口，不是一个注解，所以可以像其他的类一样使用它，它只有一个get方法。

class Car {
     @Inject Car(Provider<Seat> seatProvider) {
       Seat driver = seatProvider.get();
       Seat passenger = seatProvider.get();
       ...
     }
   }

我们也可以用它来解决类循环依赖的问题。

JSR330 vs Spring vs Guice vs HK2

功能说明	JSR330	Spring	Guice	HK2
告诉DI容器来管理一个类，并指定名称	@Named | Qualifier	@Component
告诉DI容器创建几个实例	@Singleton | 不写	@Scope(“Singleton”) | @Scope(“prototype”)
标注constructor、field、method是可住入的	@Inject	@Autowired
告诉DI容器注入哪个依赖	@Named | Qualifier	@Qualifier
自定义如何获取对象	Provider	ObjectFactory

此外，Spring、Guice、HK2 也已经支持JSR330了，所以你可以根据功能来选择使用JSR330的API。