スッキリ！SpringでJSR-330を使うための最小サンプル

SpringはJSR-330 (DI)を実装している。 JSR-330の実装でスタンドアローンで使うならGuiceだよねーという声が聞こえたので、Springでも結構さくっと使えるよっていうサンプル。 XMLはいまや不要ですよ。

全部でこれだけ

pom.xml

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>minimam-spring-jsr330</groupId>
    <artifactId>minimam-spring-jsr330</artifactId>
    <version>1.0.0-SNAPSHOT</version>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>1.7</source>
                    <target>1.7</target>
                </configuration>
            </plugin>
        </plugins>
    </build>

    <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>3.2.4.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>javax.inject</groupId>
            <artifactId>javax.inject</artifactId>
            <version>1</version>
        </dependency>
    </dependencies>
</project>

DIを使うだけならspring-contextだけで十分(AOPもついてきますが)

コンポーネント作成

package sample;

import javax.inject.Named;

@Named
public class GreetingService {
    public String hello(String message) {
        return "Hello " + message + "!";
    }
}

@Namedをつけておけば後で設定するコンポーネントスキャンにより、DIコンテナに管理されます。 JSR-330準拠だとデフォルトscopeがprototype(毎回生成)になります。

JSRにこだわらなければ@Serviceとか@Componentとか責務のわかるアノテーション付ける方が好き。

Injectionする

コンポーネントを使う側

package sample;

import javax.inject.Inject;

public class MyApp {
    @Inject
    protected GreetingService greetingService;

    public void run(String message) {
        System.out.println(greetingService.hello(message));
    }
}

@Injectでインジェクションします。

JavaConfig

SpringおなじみのBean定義XMLファイルの代わりにJavaでBean定義できます。

package sample;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Jsr330ScopeMetadataResolver;

@Configuration
@ComponentScan(basePackages = "sample", scopeResolver = Jsr330ScopeMetadataResolver.class)
public class AppConfig {
    @Bean
    public MyApp myApp() {
        return new MyApp();
    }
}

@ConfigurationつけるとBean定義ファイル相当になります。@Beanをつけたメソッドが返すオブジェクトがDIコンテナに管理されます。<bean class="sample.MyApp" />と同義。

また@ComponentScanで指定したパッケージ以下のクラスで@Namedがついているものは自動でDIコンテナに登録されます。<contect:component-scan base-packages="sample">相当。 Jsr330ScopeMetadataResolverを指定するとJSR-330準拠になり、デフォルトscopeがprototypeになります。指定しなければSpringの慣習に合わせてデフォルトscopeがsingletonになります。

エントリポイント

package sample;

import org.springframework.context.annotation.AnnotationConfigApplicationContext;
import org.springframework.context.support.GenericApplicationContext;

public class Main {

    public static void main(String[] args) {
        try (GenericApplicationContext applicationContext = 
                new AnnotationConfigApplicationContext(AppConfig.class)) {
            MyApp app = applicationContext.getBean(MyApp.class);
            app.run("World");
        }
    }

}

AnnotationConfigApplicationContextにJavaConfigファイルを渡してDIコンテナ作成。 getBeanでDIコンテナに管理されたBeanを取得できます。タイプセーフです。

簡単だったでしょ？Springはいまはかなりシンプルに使えます。

Todo

GuiceのサンプルとWeldのサンプルも作ろう

IK.AM