※この文章は講演をもとにしていますが、自分が理解できた内容をまとめているものです。文章中の誤り等はすべて自分に責任があります。

2015年4月8日に東京国際フォーラムで開催されたJava Day Tokyoに行ってきました。
その中のセッションのひとつである寺田佳央さんによる『Java EE 7 エッセンシャルレシピ』を聞いてきましたので、なんとか追い付けた部分をまとめます。

公開されたスライドとメモを見ながら、思い出して書いてます。

Managed Bean JSR-250

Managed Beanはリソースの参照、インスタンスの生成、インスタンスの破棄に使用する。JSR-250にはいろいろアノテーションがあるけれど@ManagedBeanアノテーションはほぼ使わない。

リソースの参照はアノテーションで

よろしくない書き方

ng.java

InitialContext id = new InitialContext();
ic.lookup("java:comp/DefaultManagedExecutorService");

JNDIでlookupするのは好ましくない。

いまどきの書き方

ok.java

@Resource(name="comp/DefaultManagedExecutorService")
ManagedExecutorService managedExecSvc;

@Resourceアノテーションを使う。

コンストラクタは使わない

コンストラクタ呼び出し時は、DI（依存性注入）が完了していないのでぬるぽになるかも。

いまどきの書き方

Foo.java

public class Foo() {

  @PostConstruct
  public void init() {
    // ...
  }
}

@PostConstructをつけたメソッドの中でクラスを初期化する。

Interceptor JSR-318

JavaでAOPするもの。EE5ではEJBのみで使えた。EE6では要XMLだった。EE7では@PriorityをつけるだけでOK。

Intercepterを使えば、ビジネスロジック以外の処理（ログ出力や実行時間計測など）をアノテーションに詰め込める。

例えばメソッドの実行時間計測

よろしくない書き方

ng.java

public void executeSomeMethod1() {
 long start = System.currenTimeMillis();

 // 難しいビジネスロジック

 long end = System.currentTimeMillis();
 long time = end - start;
 logger.log(Level.DEBUG, "実行時間:" + time);
}

メソッドの中にやりたいこと（ビジネスロジック）に直接関係ないコードが入り込んでいる。

いまどきの書き方

ok.java

@MySimpleProfilerInterceptor
public void executeSomeMethod1() {
  // 難しいビジネスロジック
}

メソッドにアノテーションを付けるだけ、アノテーションの処理を別途書く。

Bean Validation JSR-349

Beanにセットされる値を検証したいときは、ロジックで書かずアノテーションにする。

いまどきの書き方

Foo.java

public class Foo {

  @NotNull
  @Size(min = 1)
  private String name;

  @NotNull
  @Size(max = 8)
  @Pattern("^\\d{3}-\\d{4}$")
  private String zipCode;
}

DI JSR-330

EE環境では@Injectと@Qualifierアノテーションを使う。JSF関係のところで@Namedを使う。

インスタンス生成ではnewを使わない

newではクラスが密に結びつく。インスタンス生成はコンテナにまかせて@Injectで注入する。

よろしくない書き方

Foo.java

public class Foo {

  public void listBar() {
    BarDAO = barDAO = new BarDAOFromCSV();
    // ...
  }
}

BarDAOを他の実装に入れ替えたくてもできない。

いまどきの書き方

Foo.java

public class Foo {

  @Inject
  private BarDAO barDAO;

  public void listBar() {
    // ...
  }
}

あとからBarDAOを実装した何かに入れ替えられる。

実装が複数あるときの区別の仕方

例えばFooを実装するFooManとFooWomanがあったとする。

FooMan.java

public class FooMan implements Foo {
  // ...
}

FooWoman.java

public class FooWoman implements Foo {
  // ...
}

エラーになる書き方

Fooを実装する2つのクラスがあると、下記の書き方では依存性を解決できないのでエラーになる。

Baz.java

public class Baz {

  @Inject
  private Foo foo;
}

解決策：Qualifierを作成して使う

クラスを識別するQualifierを作成して、クラスと注入ポイントにアノテーションを付ける。

注入するクラスにQualifierを付けて、、、

FooMan.java

@ManQualifier
public class FooMan implements Foo {
  // ...
}

FooWoman.java

@WomanQualifier
public class FooWoman implements Foo {
  // ...
}

注入ポイントにもQualifierを付ける。

Baz.java

public class Baz {

  @ManQualifier
  @Inject
  private Foo fooMan;

  @WomanQualifier
  @Inject
  private Foo fooWoman;
}

こうするとエラーにならず、期待したクラスが注入される。¹

独自Qualifierを作るときの注意

命名規約を作るか、それ用のパッケージに入れるようにしないと、混乱するかも。

不変(Immutable)なインスタンスが欲しいとき

エラーになる書き方

注入ポイントはfinalにできないのでエラーになる。

FooService.java

public class FooService {

  @Inject
  private final Foo foo;
}

解決策：コンストラクタインジェクションを使う

プロパティインジェクションはやめて、コンストラクタインジェクションにするとfinalが使える。

FooService.java

public class FooService {

  private final Foo foo;

  @Inject
  public FooService(Foo foo) {
    this.foo = foo;
  }
}

実装がたくさんありすぎてQualifierでは面倒なとき

@Namedアノテーションを使って区別するようにできるけど、ダメよ。ダメダメ。

@NamedはJSFやらのEL式に渡したいときに使う。

CDI JSR-346

CDIはデフォルト有効

Java EE 7からデフォルトで有効になっている。

Java EE 6はbeans.xmlというファイルを使っていた。Java EE 7では、アノテーションが付いているクラスがコンテナに載るようになる。

コンテナに載せたいときは、下記のアノテーションを付ける。

@NormalScopedを継承したもの
@Dependent

beans.xmlで全クラスをコンテナに載せるようにもできるけれど、起動が遅くなるからダメよ。

CDI Managed Beanとは

CDIコンテナによってProxyを自動生成されたbean。

CDIはbeanのProxyクラスを自動生成する。注入ポイントに実際に注入されるのはProxyクラスのインスタンスとなる。

シングルトンしたいとき

よろしくない書き方

javax.inject.Singletonは@NormalScoped継承ではないのでCDI Managed Beanにならない。

Ng.java

@javax.inject.Singleton
public class Ng {
  // ...
}

解決策：ApplicationScopedを使う

Ok.java

@javax.enterprise.context.ApplicationScoped
public class Ok {
  // ...
}

複数ある実装バージョンを配備時に切り替える

クラスに@Alternativeアノテーションを付けて、beans.xmlファイルで切り替える。

Foo1.java

@Alternative
@Dependent
public class Foo1 implements Foo {
  // ...
}

Foo2.java

@Alternative
@Dependent
public class Foo2 implements Foo {
  // ...
}

beans.xmlをクラスと同一アーカイブに入れる。

beans.xml

<beans xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/beans_1_0.xsd">
    <alternatives>
        <class>Foo2</class>
    </alternatives>
</beans>

Foo2が使われる。²

beans.xmlよりQualifierが優先

クラスにQualifierを付けると、@Alternativeが有効にならずbeans.xmlの設定が無視される。

クラスに@Specializedを付けるとよい。³

`@Produces`でCDI Managed Bean以外も注入する

やり方：

Qualiferを作る
インスタンスを提供するクラスを作る
インスタンスを提供するメソッドに作成したQualiferと@Producesアノテーションを付ける

アノテーションたくさんつけるの面倒

それStereotypeで解決するよ。

面倒な書き方

アノテーションがいっぱいあって忘れそう。

Stress.java

@RequestScoped
@Foo
@Bar
@Baz
@Qux
public class Stress {
  // ...
}

解決策：いつも使うアノテーションはStereotypeにまとめる

Stereotypeを作成する。

MyStereotype.java

@Stereotype
@RequestScoped
@Foo
@Bar
@Baz
@Qux
@Target(TYPE)
@Retention(RUNTIME)
public @interface MyStereotype {}

作成したStereotypeを使う。スッキリ。

Relax.java

@MyStereotype
public class Relax {

  // ...
}

組み込みのStereotypeがある

@Modelは、@Namedと@RequestScopedと一緒。⁴

独自Stereotypeを作るときの注意

命名規約を作るか、それ用のパッケージに入れるようにしないと、混乱するかも。

CDIでObserverパターン

CDIならObserverパターンも簡単に実装できる。

イベント発行側

Event<?>を注入し、fireメソッドを呼ぶ。

FireStartar.java

@Dependent
public class FireStartar {

  @Inject
  Event<Foo> fooEvent; // 引数にしたいクラスを指定する

  public void executeSomething() {
    // イベント発火
    fooEvent.fire(new Foo());
  }
}

イベントを受信側

@Observesを使う。

FireWorks.java

@Dependent
public class FireWorks {

  public void startFire(@Observes Foo foo) {
    // ...
  }
}

CDIのイベントは同期処理

イベントが終わるまで返ってこないので、重たい処理には不向き。

代わりにEJBやJMSを使う。

最後に：なんでもかんでもコンテナに載せない

機能が必要なものだけ載せましょう。

クラスにQualifierを付けて識別したら後から実装を入れ替えたくても入れ替えられないし、疎結合にならないような……？？？ ↩
Qualifierよりこちらがよいような。 ↩
このあたり意味わかってないです。 ↩
きっとJSFのバッキングbean用かな。 ↩

Managed Bean JSR-250

リソースの参照はアノテーションで

よろしくない書き方

いまどきの書き方

コンストラクタは使わない

いまどきの書き方

Interceptor JSR-318

例えばメソッドの実行時間計測

よろしくない書き方

いまどきの書き方

Bean Validation JSR-349

いまどきの書き方

DI JSR-330

インスタンス生成ではnewを使わない

よろしくない書き方

いまどきの書き方

実装が複数あるときの区別の仕方

エラーになる書き方

解決策：Qualifierを作成して使う

独自Qualifierを作るときの注意

不変(Immutable)なインスタンスが欲しいとき

エラーになる書き方

解決策：コンストラクタインジェクションを使う

実装がたくさんありすぎてQualifierでは面倒なとき

CDI JSR-346

CDIはデフォルト有効

CDI Managed Beanとは

シングルトンしたいとき

よろしくない書き方

解決策：ApplicationScopedを使う

複数ある実装バージョンを配備時に切り替える

beans.xmlよりQualifierが優先

@ProducesでCDI Managed Bean以外も注入する

アノテーションたくさんつけるの面倒

面倒な書き方

解決策：いつも使うアノテーションはStereotypeにまとめる

組み込みのStereotypeがある

独自Stereotypeを作るときの注意

CDIでObserverパターン

イベント発行側

イベントを受信側

CDIのイベントは同期処理

最後に：なんでもかんでもコンテナに載せない

`@Produces`でCDI Managed Bean以外も注入する