11、IOC 之使用 JSR 330 标准注释

11、IOC 之使用 JSR 330 标准注释

从Spring 3.0开始，Spring提供了对JSR-330标准注释(依赖注入)的支持。这些注释的扫描方式与Spring注释相同。要使用它们，需要在类路径中包含相关的jar文件。

如果使用 Maven，则项目在标准 Maven 存储库中可用。可以将以下依赖项添加到文件 pom.xml：

<dependency>
    <groupId>javax.inject</groupId>
    <artifactId>javax.inject</artifactId>
    <version>1</version>
</dependency>

11.1、依赖注入与 @Inject 和 @Named

可以使用 @javax.inject.Inject 而不是 @Autowired。注入如下:

import javax.inject.Inject;

public class SimpleMovieLister {

    private MovieFinder movieFinder;

    @Inject
    public void setMovieFinder(MovieFinder movieFinder) {
        this.movieFinder = movieFinder;
    }

    public void listMovies() {
        this.movieFinder.findMovies(...);
        // ...
    }
}

与 @Autowired 一样，可以在字段级别、方法级别和构造函数参数级别使用 @Inject。此外，可以将注入点声明为Provider，从而允许按需访问较短作用域的Bean，或通过 Provider.get() 调用延迟访问其他Bean。下面的例子提供了上一个例子的变体:

import javax.inject.Inject;
import javax.inject.Provider;

public class SimpleMovieLister {

    private Provider<MovieFinder> movieFinder;

    @Inject
    public void setMovieFinder(Provider<MovieFinder> movieFinder) {
        this.movieFinder = movieFinder;
    }

    public void listMovies() {
        this.movieFinder.get().findMovies(...);
        // ...
    }
}

如果要为应注入的依赖项使用限定名，则应使用@Named注释，如以下示例所示：

import javax.inject.Inject;
import javax.inject.Named;

public class SimpleMovieLister {

    private MovieFinder movieFinder;

    @Inject
    public void setMovieFinder(@Named("main") MovieFinder movieFinder) {
        this.movieFinder = movieFinder;
    }

    // ...
}

与 @Autowired 一样，@Inject 也可以与 java.util.Optional 或 @Nullable 一起使用。在这里更加适用，因为 @Inject 没有必需的属性。下面的两个例子展示了如何使用 @Inject 和 @Nullable:

public class SimpleMovieLister {
    @Inject
    public void setMovieFinder(Optional<MovieFinder> movieFinder) {
        // ...
    }
}

public class SimpleMovieLister {
    @Inject
    public void setMovieFinder(@Nullable MovieFinder movieFinder) {
        // ...
    }
}

11.2、@Named 和 @ManagedBean： @Component 注释的标准等价物

除了@Component，你可以使用 @javax.inject.Named 或 javax.annotation.ManagedBean。如下面的例子所示

import javax.inject.Inject;
import javax.inject.Named;

@Named("movieListener")  // @ManagedBean("movieListener") could be used as well
public class SimpleMovieLister {

    private MovieFinder movieFinder;

    @Inject
    public void setMovieFinder(MovieFinder movieFinder) {
        this.movieFinder = movieFinder;
    }

    // ...
}

在不指定组件名称的情况下使用 @Component 是很常见的。@Named 可以以类似的方式使用，如下面的例子所示:

import javax.inject.Inject;
import javax.inject.Named;

@Named
public class SimpleMovieLister {

    private MovieFinder movieFinder;

    @Inject
    public void setMovieFinder(MovieFinder movieFinder) {
        this.movieFinder = movieFinder;
    }

    // ...
}

当使用 @Named 或 @ManagedBean 时，可以使用与使用Spring注释完全相同的方式来使用组件扫描，如下示例所示:

@Configuration
@ComponentScan(basePackages = "org.example")
public class AppConfig  {
    // ...
}

与 @Component 相比，JSR-330 @Named 和 JSR-250 @ManagedBean 注解是不可组合的。应该使用 Spring的原型模型来构建定制组件注释。

11.3、JSR-330 标准注释的限制

使用标准批注时，应知道某些重要功能不可用，如下表所示：

Spring	javax.inject.*	javax.inject 限制/ 注解
@Autowired	@Inject	@Inject 没有 ‘required’ 属性. 可与 Java 8 的 Optional 一起使用
@Component	@Named / @ManagedBean	JSR-330不提供可组合的模型，只提供一种识别命名组件的方法
@Scope(“singleton”)	@Singleton	JSR-330 默认作用域类似于Spring的 prototype。但是，为了使它与Spring的一般默认值保持一致，在Spring容器中声明的JSR-330 Bean默认为 singleton。为了使用 singleton之外的作用域，应该使用Spring的@Scope注释。 javax.inject 还提供了一个@Scope注释。尽管如此，这个注释只用于创建你自己的注释
@Qualifier	@Qualifier / @Named	javax.inject.Qualifier 只是用于构建自定义限定符的元注释。具体的String 限定符（比如Spring的带值的 @Qualifier）可以通过 javax.inject.Named 关联起来
@Value	-	无等效项
@Required	-	无等效项
@Lazy	-	无等效项
ObjectFactory	Provider	javax.inject.Provider 是Spring的 ObjectFactory 的直接替代品，只是使用了更短的 get() 方法名。它还可以与Spring的 @Autowired 或者与非注释的构造函数和setter方法结合使用