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代码。在实现是,可以采用反射、代码生成技术等等,均不受限制。

 

内容摘要:

 

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

   @Named | Qualifier

告诉DI容器创建几个实例

@Singleton | 不写

@Scope(“Singleton”) | @Scope(“prototype”)

   @Singleton | 不写

标注constructor、field、method是可住入的

@Inject

@Autowired

   @Inject

告诉DI容器注入哪个依赖

@Named | Qualifier

@Qualifier

   @Named | @Service | @Contract

自定义如何获取对象

Provider

ObjectFactory

   Provider

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

 

 

 

posted @ 2017-04-02 19:15 FangJinuo 阅读(...) 评论(...) 编辑 收藏