Concurrency Utilities for Java EEをつかってみる

これは[Java EE Advent Calendar 2014](http://qiita.com/advent-calendar/2014/javaee)の11日目の記事です。昨日は@tkxlabさんの[JavaEEをはじめよう！](http://qiita.com/tkxlab/items/3c0d4073defacb1215f5)でした。明日は@tatsu983さんです。

先日の[JJUG CCC 2014 Fall](http://www.java-users.jp/?page_id=1290 "Timetable / JJUG CCC 2014 Fall")では，[JSR 356 Java API for WebSocket 1.0について](http://www.slideshare.net/takakiyo/jjug-ccc-201411 "いよいよ始められる Java EEでのWebSocket")お話させていただきましたが，今回はJSR 236 Concurrency Utilities for Java EEについてです。

# Concurrency Utilities for Java EEについて

## Javaの並行処理の歴史

Javaにおける並行処理，つまりマルチスレッドによる同時実行の歴史については，[9月のJJUGのナイトセミナー](http://jjug.doorkeeper.jp/events/14961 "JJUG ナイト・セミナー「Javaパラレル処理の最前線」9/17（水）")でさくらばさんが話された[Legend of Java Concurrency/Parallelism](http://www.slideshare.net/skrb/legend-of-java-concurrencyparallelizm)がとてもいいまとめになっていますので，ぜひごらんください。

Java SEの世界では比較的自由なスレッド生成・並行処理ですが，Java EEの世界では長らくタブーとされていました。EJB仕様ではユーザーコードによるスレッドの生成が明示的に禁止されていましたし，Servletからのスレッド生成にもいろいろな制限がありました。ほとんどのアプリケーションサーバーでは，Servletの実行スレッドからHttpSessionやHttpServletRequestなどを他のスレッドに渡しても，それらの機能が正常に呼び出せません。またDataSourceから取得したConnectionを複数スレッドで使い回したりすると，トランザクションが正常に管理されなくなるなどの問題が起こります。JNDIで利用されるjava:comp/envなどの名前空間も，独自に作成したスレッドからは参照ができません。

これは，Java EEの世界で利用される様々な情報を管理している「コンテキスト」の多くが，スレッドに紐付けられて管理されているためです。Java EEの機能の多くはこのコンテキストに依存しているため，別のスレッドに処理が移ると正常に稼働しなくなるのです。

## Java EEでの非同期処理の歴史

アプリケーションサーバー上でリクエスト処理とは異なるスレッドで非同期処理をおこなう方法は，過去にいくつも登場しています。J2EE 1.3では，Message-oriented Middlewareからとどいたメッセージをトリガーに処理をおこなうMDB（Message Driven Bean）がEJBに追加されました。Java EE 6では，Servletから非同期処理をおこなうAsyncContext機能がServlet 3.0仕様に，EJBで非同期処理をおこなうAsynchronous機能がEBJ 3.1仕様に追加されました。

汎用的な非同期処理をJava EE環境で使用するための仕様としては，2003年からJSR 236で[Timer for Application Server](http://news.mynavi.jp/column/jsr/022/ "Java EE環境でタスクのスケジューリングを可能にするJSR 236")という名前で検討が始まりました。当初はJava EE 5に組み込まれる予定だったのですが，別のJSRと統合されるなど紆余曲折があり，最終的にConcurrency Utilities for Java EEと名前を変えてJava EE 7に組み込まれました。

## Concurrency Utilities for Java EE

Concurrency Utilities for Java EEは，その名前が示すとおり[Java2 SE 5で追加されたConcurrency Utilities](http://www.javainthebox.net/laboratory/J2SE1.5/MiscAPI/ConcurrencyUtils/ConcurrencyUtils1.html "虎の穴 J2SE 5.0 入門 Concurrency Utilities No.1")を拡張する形で策定されました。SE環境で利用できるExecutorServiceやScheduledExecutorServiceを拡張したスレッド管理機能が提供され，ライフサイクル管理やモニタリング機能が提供されます。また，Java EEのコンテキストを伝達するContextServiceが提供されます。

ちなみにEnterprise JavaBean→EJBのような公的な略称がつくられなかったため，毎回「Concurrency Utilities for Java EE」と書かなければいけない，ちょっと面倒な仕様名です。前半の「Concurrency Utilities」だけだと，SE環境で提供されているjava.util.concurrentの機能のことになってしまいますし…。

Concurrency Utilities for Java EEについての詳細なガイドは，2015年1月に[developerWorksのサイト上](https://community.ibm.com/community/user/wasdevops/blogs/takakiyo-tanaka1/2021/05/14/developerworks)で「[Java EE 7 アプリケーション設計ガイド - Concurrency Utilities編](https://community.ibm.com/HigherLogic/System/DownloadDocumentFile.ashx?DocumentFileKey=c5984911-99c8-86ee-be17-9ea3cb9ea969)」が公開されていますので，そちらの方もご覧下さい。

# Concurrency Utilities for Java EEをつかってみる

別スレッドによる非同期処理に用途は数多くありますが，代表的なのは「時間のかかる処理，たとえば負荷の高いデータベース処理を別スレッドで非同期に実行」というものでしょう。データベースのConnectionを取得するDataSourceをJNDIでリソース参照経由でlookupしたり，トランザクション管理のためのUserTransactionを取得するにはJava EEのコンテキストが必要です。これらをConcurrency Utilities for Java EEで実装してみます。

## サーバー環境を用意する

さて，この記事では[WebSphere Libertyプロファイル](https://www.ibm.com/support/pages/websphere-liberty-developers)をつかってConcurrency Utilities for Java EEをためしてみます。Libertyプロファイルを使ったことがない，というかたは[Codezineの記事](http://codezine.jp/article/detail/7697 "軽量・高速・安価で、安定性と信頼性も兼ね備えたWebSphere Application Serverの「Liberty Core」を使ってみた ")とか[developerWorksの記事](http://www.ibm.com/developerworks/jp/websphere/library/was/liberty_intro/1.html "新卒関西人のWebSphere挑戦記")とか[こちらの記事](http://qiita.com/TTakakiyo/items/05dfdb020249699d9849 "最速，3分でできるWebSphereの導入と実行")とかを参考に導入してみて下さい。

Libertyプロファイルでは，おととい12月9日に[Concurrency Utilities for Java EEをはじめとしたJava EE 7の一部の機能が正式版として公開](https://developer.ibm.com/wasdev/blog/2014/12/09/announcing-new-liberty-features-tools/ "Announcing: New Liberty features and tools")されました。本番環境で商用サポート付きでご利用いただくことができます。

現在公開されている最新版のVersion 8.5.5.4であれば最初からのConcurrency Utilities for Java EEのFeatureが入っています。8.5.5.2〜8.5.5.3であれば導入ディレクトリのbinにあるfeatureManagerコマンドを使用して簡単にFeatureを追加することができます。

```
$ ./featureManager install concurrent-1.0 --when-file-exists=ignore
```

## サーバーを構成する

Libertyプロファイルの構成ファイルのserver.xmlにconcurrent-1.0のFeatureを追加すると，Concurrency Utilities for Java EEの機能が有効になります。

```xml:server.xml
<featureManager>
  <feature>concurrent-1.0</feature>
</featureManager>
```

サーバーで提供されるExecutorServiceを構成します。今回はJava EEメタデータを管理するコンテキストを伝搬させたいのでjeeMetadataContextを構成します。このほかにもclassloaderContextやsecurityContextなどが構成できます。

```xml:server.xml
<managedExecutorService jndiName="concurrent/myExecutor">
  <contextService>
    <jeeMetadataContext />
  </contextService>
</managedExecutorService>
```

## Javaコードから利用する

構成したExecutorServiceをサーブレットから利用するには，java.util.concurrent.ExecutorServiceやjavax.enterprise.concurrent.ManagedExecutorServiceのインスタンス変数を用意して，`@Resource`をつかってインジェクションすることができます。

```java
@Resource(lookup="concurrent/myExecutor")
private ExecutorService myExecutor;
```

ローカル変数として利用する場合は，JNDIをつかってlookupすることもできます。

```java
ExecutorService myExecutor;
try {
    myExecutor = (ExecutorService)new InitialContext().lookup("concurrent/myExecutor");
} catch (NamingException e) {
    e.printStackTrace();
}
```

ExecutorServiceで実行されるタスクを定義しておきます。この中では，JNDIからUserTransactionを取得してトランザクション処理をおこなってみます。通常のExecutorServiceで実行されたタスクであれば，java:comp/envの名前空間を利用することはできないのですが，Concurrency Utilities for Java EEのExecutorServiceで実行すると，ちゃんとコンテナが提供するUserTransactionが取得できます。アプリケーションに定義されたリソース参照などにもアクセスできます。

```java:LongTask.java
import javax.naming.Context;
import javax.naming.InitialContext;
import javax.transaction.SystemException;
import javax.transaction.UserTransaction;

public class LongTask implements Runnable {

	@Override
	public void run() {
		UserTransaction ut = null;
		try {
			Context con = new InitialContext();
			ut = (UserTransaction)con.lookup("java:comp/UserTransaction");
			ut.begin();
			// some transactional operations
			//
			ut.commit();
		} catch (Exception e) {
			if (ut != null) try {
				ut.rollback();
			} catch (SystemException se) {}
		}
	}
}
```

このタスクをServletの中から実行します。もちろん，Feature\<T>などを利用して結果を受け取ることもできます。

```java
myExecutor.submit(new LongTask());
```

# おわりに

Concurrency Utilities for Java EEは，JSF 2.2やCDI 1.1とならんで，Java EE 7の目玉機能のひとつです。簡潔で簡単に利用できる仕様でありながら，いままでできなかった多くの要件を実現することができます。

商用アプリケーションサーバーでのサポートもはじまりましたので，ぜひご利用を検討下さい。