beginning java ee 6 勉強会(5) #bje_study

Beginning JavaEE6 勉強会 (5)- メッセージ通信 -

Jun. 13, 2012

2

目次

04/13/2023 Beginning JavaEE6 勉強会 (5)

13. メッセージ通信

メッセージング

JMS

MDB

@ 見たな

ggrks

3

メッセージング


4

メッセージ指向ミドルウェア

• メッセージング処理– 異種システム間対応可能– 非同期通信

• メッセージ指向ミドルウェア (MOM)– 上記処理を可能にするソフトウェア– 通信内容（メッセージ）の生成・消費ペースを

調整するバッファとして機能する– メッセージの形式と「宛先」について合意する

だけで疎結合なシステム連携が実現できる• RPC (Remote Procedure Call) の場合、

メソッドシグネチャまで合意しなければならない


5

メッセージの流れ

13.1 メッセージとは

• MOM の用語


宛先

メッセージプロバイダ

（別名：ブローカ）

コンシューマプロデューサ

メッセージ

受信送信

6



• MOM の用語


宛先

メッセージプロバイダ

（別名：ブローカ）

コンシューマプロデューサ

メッセージ

受信送信メッセージの格納場所メッセージプロバイダ内に複数作れる

メッセージを溜め、振り分けるソフトウェア

メッセージを受けて処理するコンポーネント

メッセージを他のコンポーネントに送信するコンポーネント

連携データ

7


• JMS (Java Message Service)– メッセージの処理を Java アプリケーションから行

うための API– JDBC が複数データベース製品に対応するように、

JMS も製品を抽象化し複数製品に対応できる

• メッセージ・ドリブン Bean(MDB)– メッセージを受けて起動したい処理があるとき、

EJB コンテナにメッセージの定期的な監視と受信を任せることができる仕組み

– ステートレス . メッセージ間で独立して起動– 実際の処理はステートレス Bean に移譲してもよい


8

13.2 メッセージングの仕様の概要

• 簡単な歴史– 1980 後半システム間連携の方法なし

　　　　　各社低レベルプロトコルで作りこみ　　　　　そこで MOM が登場

– 1998 JMS 1.0 仕様公開– 2001 EJB 2.0 に MDB が採用– 2002 JMS 1.1 仕様公開– 2006 EJB 3.0 で MDB にアノテーションが採用– 2006 OpenMQ が参照実装としてオープンソース化

– 2012 JMS 2.0 仕様公開予定（ JSR 343 ）


9

13.2 メッセージングの仕様の概要• 簡単な歴史

– 1950 コンピュータ誕生– 1980s メインフレームの時代– 1990s オープンシステムが台頭

　　　システム間連携を個別に作りこむ必要性が発生– 1993 IBM MQSeries V1 発表

　　　 MOM 乱立– 1998 JMS 1.0 仕様公開– 2001 EJB 2.0 に MDB が採用– 2002 IBM WebSphere MQ V5.3 ( 改名した )– 2002 JMS 1.1 仕様公開– 2006 EJB 3.0 で MDB にアノテーションが採用– 2006 Sun の OpenMQ が参照実装としてオープンソース化

– 2012 JMS 2.0 仕様公開予定（ JSR 343 ）04/13/2023 Beginning JavaEE6 勉強会 (5)

書籍外

ポイント10 年間仕様変更

なし

10

JMS プロバイダの実装• Wikipedia によると以下の通り

– Apache ActiveMQ– Apache Qpid, using AMQP– EMS from TIBCO– OpenJMS, from The OpenJMS Group– JBoss Messaging and HornetQ from JBoss– JORAM, from the OW2 Consortium– Open Message Queue, from Sun Microsystems– BEA Weblogic (part of the Fusion Middleware suite) and Oracle AQ from Oracle– RabbitMQ, using AMQP– Solace JMS from Solace Systems– SonicMQ from Progress Software– StormMQ, using AMQP– SwiftMQ– Tervela– webMethods from Software AG– WebSphere Application Server from IBM, which provides an inbuilt default

messaging provider known as the Service Integration Bus (SIBus), or which can connect to WebSphere MQ as a JMS provider [5]

– WebSphere MQ (formerly MQSeries) from IBM– Ultra Messaging from 29 West (acquired by Informatica)

• TheServerSide.comに比較表もある– http://www.theserverside.com/matrix04/13/2023 Beginning JavaEE6 勉強会 (5)

書籍外

http://en.wikipedia.org/wiki/Java_Message_Service

http://en.wikipedia.org/wiki/ActiveMQ

http://en.wikipedia.org/wiki/ActiveMQ

http://en.wikipedia.org/wiki/Apache_Qpid

http://en.wikipedia.org/wiki/Apache_Qpid

http://en.wikipedia.org/wiki/AMQP

http://en.wikipedia.org/wiki/TIBCO

http://en.wikipedia.org/wiki/OpenJMS

http://en.wikipedia.org/wiki/JBoss_Messaging

http://en.wikipedia.org/wiki/JBoss_Messaging

http://en.wikipedia.org/wiki/HornetQ

http://en.wikipedia.org/wiki/JBoss_(company)

http://en.wikipedia.org/wiki/JORAM

http://en.wikipedia.org/wiki/OW2_Consortium

http://en.wikipedia.org/wiki/Open_Message_Queue

http://en.wikipedia.org/wiki/Sun_Microsystems

http://en.wikipedia.org/wiki/BEA_Weblogic

http://en.wikipedia.org/wiki/BEA_Weblogic

http://en.wikipedia.org/wiki/Oracle_Fusion_Middleware

http://en.wikipedia.org/wiki/Oracle_AQ

http://en.wikipedia.org/wiki/Oracle_Corporation

http://en.wikipedia.org/wiki/RabbitMQ


http://en.wikipedia.org/wiki/Solace_systems

http://en.wikipedia.org/wiki/SonicMQ

http://en.wikipedia.org/wiki/Progress_Software

http://en.wikipedia.org/wiki/StormMQ


http://en.wikipedia.org/wiki/Tervela

http://en.wikipedia.org/wiki/WebMethods

http://en.wikipedia.org/wiki/Software_AG

http://en.wikipedia.org/wiki/WebSphere_Application_Server

http://en.wikipedia.org/wiki/WebSphere_Application_Server

http://en.wikipedia.org/wiki/IBM

http://en.wikipedia.org/wiki/WebSphere_MQ




http://en.wikipedia.org/wiki/IBM

http://en.wikipedia.org/wiki/29_West

http://en.wikipedia.org/wiki/Informatica

11

13.3 メッセージを送受信する方法

• 以下の簡単なモデルで JMS だけを試す– 作成するのは Sender と Receiver クラスだけ– 他は設定と API を呼ぶのみ



OpenMQNetBeans 同梱の

Glassfish サーバに同梱されている

ReceiverSender

メッセージ

受信送信Queuemain() main()

12

Work#1 メッセージを送信する

作業手順1. MOM を起動する2. MOM に「管理対象オブジェクト」を作る

1. 宛先を作る2. コネクションファクトリを作る

3. Java でプロデューサ (Sender.java) を作る4. Java でコンシューマ (Receiver.java) を作る5. ビルド6. 動かす


13

Work#1-1 MOM を起動する

• Glassfish に付属している OpenMQ を使うので、単に Glassfish を起動する


14

Work#1-2 管理対象オブジェクトを作る

• ブラウザで OpenMQ の管理コンソールを開く– http://localhost:4848/


15

Work#1-2-1 コネクションファクトリを作る

• コネクションファクトリを作る– 下記 3 つだけ埋めてあとはデフォルトでよし


jms/javaee6/ConnectionFactoryjavax.jms.ConnectionFactoryjms/javaee6/ConnectionFactory

16

Work#1-2-2 宛先を作る

• 宛先を作る。（ Work#1 では” Queue” を作る）– 下記 4 つだけ埋めてあとはデフォルトでよし


jms/javaee6/Queuejms_javaee6_Queuejavax.jms.Queuejms/javaee6/Queue

17

Work#1-3 プロデューサを作る

• メッセージプロデューサ（生成側）– https://svn.kenai.com/svn/beginningee6~src/book/trunk/ を checkout– “Chapter 13 - JMS (JMS)” プロジェクト– “org.beginningee6.book.chapter13.jms.ex01” パッケージ


public class Sender { public static void main(String[] args) { try { Context jndiContext = new InitialContext(); ConnectionFactory connectionFactory = (ConnectionFactory) jndiContext.lookup("jms/javaee6/ConnectionFactory"); Queue queue = (Queue) jndiContext.lookup("jms/javaee6/Queue"); Connection connection = connectionFactory.createConnection(); Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE); MessageProducer producer = session.createProducer(queue); TextMessage message = session.createTextMessage();

message.setText("This is a text message sent at " + new Date()); producer.send(message); System.out.println("\nMessage sent !"); connection.close(); } catch (Exception e) { e.printStackTrace(); } System.exit(0); }}

※ package 文、 import 文、コメント等は紙面の都合で削除

org.beginningee6.book.chapter13.jms.ex01.Sender を参照

https://svn.kenai.com/svn/beginningee6~src/book/trunk/


18

Work#1-4 コンシューマを作る

• メッセージコンシューマ（消費側）– プロデューサと同様


public class Receiver {

public static void main(String[] args) { try { Context jndiContext = new InitialContext(); ConnectionFactory connectionFactory = (ConnectionFactory) jndiContext.lookup("jms/javaee6/ConnectionFactory"); Queue queue = (Queue) jndiContext.lookup("jms/javaee6/Queue"); Connection connection = connectionFactory.createConnection(); Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE); MessageConsumer consumer = session.createConsumer(queue); connection.start(); System.out.println("\nInfinite loop. Waiting for a message..."); while (true) { TextMessage message = (TextMessage) consumer.receive();

System.out.println("Message received: " + message.getText()); } } catch (Exception e) { e.printStackTrace(); } }

}


org.beginningee6.book.chapter13.jms.ex01.Receiver を参照

19

Work#1-5-1 ビルド -mainClass 指定

• pom.xml を編集し、動かしたいクラスを<mainClass> に指定


20

Work#1-5-2 ビルド - 実行

• 「依存関係で構築」または「生成物を削除して構築」


21

Work#1-5 動かす（コマンドライン）

• プロバイダを起動する（数回）– テキストメッセージが宛先に 1 つ送られる

• コンシューマを起動する（ mainClass 変えて生成する）– 送ったメッセージがすべて表示される


> appclient -client chapter13-JMS-2.0.jar

※1 C:\Program Files\glassfish-3.1.2\glassfish\bin\appclient※2 C:\Users\ （ユーザ名） \Documents\NetBeansProjects\book\　　　 chapter13\jms\target \chapter13-JMS-2.0.jar

> appclient -client chapter13-JMS-2.0.jar※ デフォルトでは生成物名が同じなので注意

22

補足 1 ： JMS リソースをコマンドラインから操作• JMS リソースはコマンドラインから操作可能– 実は設定項目がわかっていればそちらの方が簡単– コマンドは Glassfish に添付されている

• C:\Program Files\glassfish-3.1.2\glassfish\bin\asadmin


asadmin create-jms-resource --restype javax.jms.ConnectionFactory jms/javaee6/ConnectionFactoryasadmin create-jms-resource --restype javax.jms.QueueConnectionFactory jms/javaee6/QConnectionFactoryasadmin create-jms-resource --restype javax.jms.TopicConnectionFactory jms/javaee6/TConnectionFactoryasadmin create-jms-resource --restype javax.jms.Queue jms/javaee6/Queueasadmin create-jms-resource --restype javax.jms.Topic jms/javaee6/Topic

asadmin list-jms-resources

23

補足 2 ：スタンドアロン JMS クライアント• Work#1 はコンテナ外からでも動かせる– この場合ライブラリを読み込む必要があるので注意

• 金魚本では ACC 上で動かすようになっている– スタンドアロンの Glassfish インストールフォルダ

に同梱されているライブラリを使う。

– 必要なファイルは以下の通りインストールフォルダは人によって異なる• C:\Program Files\glassfish-3.1.2\mq\lib\jms.jar• C:\Program Files\glassfish-3.1.2\mq\lib\jms.jar• C:\Program Files\glassfish-3.1.2\glassfish\lib\gf-client.jar


今回は面倒なので省略

24

次の章に移る前に checkout [1/2]

• 金魚本公式からサンプルコードを checkout– https://svn.kenai.com/svn/beginningee6~src/book/trunk/

• “Chapter 13 - JMS (JMS)” プロジェクト– “org.beginningee6.book.chapter13.jms.ex01” パッケージ→Work#1 で終了

– “org.beginningee6.book.chapter13.jms.ex04” パッケージ→ Java EE コンテナ上で動作する例

– “org.beginningee6.book.chapter13.jms.ex05” パッケージ→ Java EE コンテナ上で動作する例。リスナを利用する

– “org.beginningee6.book.chapter13.jms.ex07” パッケージ→ Java EE コンテナ上で動作する例。セレクタを利用する

– “org.beginningee6.book.chapter13.jms.ex14” パッケージ→オブジェクトを送信する例。 MDB 動作確認時の送信側スタブとして使う




25

次の章に移る前に checkout [2/2]（つづき）

• “Chapter 13 - JMS (MDB)” プロジェクト– “org.beginningee6.book.chapter13.jms.ex08” パッケージ→MDB の例。

– “org.beginningee6.book.chapter13.jms.ex11” パッケージ→@MessageDriven アノテーションの属性指定の例。

– “org.beginningee6.book.chapter13.jms.ex12” パッケージ→MDB のライフサイクル確認用の例。　 @PostConstruct と @PreDestroy の動作確認。今回は利用しない。

– “org.beginningee6.book.chapter13.jms.ex15” パッケージ→オブジェクトを処理する MDB の例。今回は利用しない。（時間がない）


26

Java Message Service


27

13.4 Java Message Service

• 構成


JMS プロバイダ

JNDI ディレクトリ

プロデューサコンシューマ

メッセージの生成メッセージの使用

管理対象オブジェクトのルックアップ


28


• 構成


JMS プロバイダ

JNDI ディレクトリ

プロデューサコンシューマ

メッセージの生成メッセージの使用



クライアント

メッセージを送受信するアプリ。「クライアント」と総称する。・送信側は、プロデューサ、センダ、

　パブリッシャと呼ぶ。・受信側は、コンシューマ、　レシーバ、サブスクライバと呼ぶ。

MOM のこと。別名：ブローカメッセージのバッファや配信を制御

29


• 用語– JMS の世界では 2 つのモデルがあり、 API が違う

– 宛先（ Destination ）＝｛ Queue, Topic｝– P2P モデル → Queue– pub-sub モデル → Topic


一般名ポイント・ツー・ポイントパブリッシュ・サブスクライブ

Destination Queue TopicConnectionFactory QueueConnectionFactory TopicConnectionFactoryConnection QueueConnection TopicConnectionSession QueueSession TopicSessionMessageConsumer QueueReciever TopicRecieverMessageProducer QueueSender TopicSender

30

1.3.4.1 P2P モデル

• ポイント・ツー・ポイント・モデル– メッセージに対してレシーバが 1 つの場合使う

• レシーバが受信するとメッセージは消える• レシーバが複数ある場合、どれか 1 つにしか届かない

• イメージ


宛先レシーバ

センダ

メッセージ#1

受信送信

メッセージ#1メッセージ

#1


#1メッセージ#1

31

1.3.4.1 P2P モデル

• ポイント・ツー・ポイント・モデル– メッセージに対してレシーバが 1 つの場合使う

• レシーバが受信するとメッセージは消える• レシーバが複数ある場合、どれか 1 つにしか届かない

• イメージ


宛先レシーバ

センダ受信送信

レシーバ 2受信

レシーバ 3

受信


#1メッセージ#1

メッセージ#3 メッセージ

#2

メッセージ#1

※ 3 つメッセージを送信しても、　それぞれ先に取得したレシーバにしか　届かない

32

1.3.4.2 pub-sub モデル

• パブリッシュ・サブスクライブ・モデル– メッセージに対してレシーバが複数の場合使う

• すべてのサブスクライバが受信するとメッセージは消える

• P2P モデルと違い、受信側は宛先に対して最初に「購読（サブスクライブ）」作業をする必要がある（ただし明示的にメソッドコールする必要はない）

• サブスクライバが「非アクティブ状態」だと無視される

• イメージ


宛先サブスクライバ

パブリッシャ

メッセージ#1

サブスクライブ

パブリッシュ


#1


#1メッセージ#1

受信

33

1.3.4.2 pub-sub モデル

• パブリッシュ・サブスクライブ・モデル– メッセージに対してレシーバが複数の場合使う

• すべてのサブスクライバが受信するとメッセージは消える

• P2P モデルと違い、受信側は宛先に対して最初に「購読（サブスクライブ）」作業をする必要がある（ただし明示的にメソッドコールする必要はない）

• サブスクライバが「非アクティブ状態」だと無視される

• イメージ


宛先

サブスクライバ

パブリッシャ

メッセージ#1

サブスクライブ

パブリッシュ


#1


#1メッセージ#1

受信

サブスクライバ２サブスクライブメッセージ

#1メッセージ#1メッセージ

#1受信

※ すべて全サブスクライバに届く

34

1.3.4.3 JMS API

• JMS API は javax.jms パッケージにある– クラス名だけだと他と被るので注意


http://java.sun.com/developer/technicalArticles/Ecommerce/jms/

35

コネクション・ファクトリ

• プロバイダと接続するためのConnection オブジェクトを作成する役割

– JNDI ルックアップで取得する– QueueConnectionFactory 、 TopicConnectionF

acotry を使うとそれぞれ専用の機能が利用できるようになる

– 専用機能が不要の場合は ConnectionFactory でよい


Context jndiContext = new InitialContext();

ConnectionFactory connectionFactory = (ConnectionFactory) jndiContext.lookup("jms/javaee6/ConnectionFactory");


36

宛先 (Destination)

• プロバイダ情報を保持する。クライアントからプロバイダ情報を隠ぺいする役割– クラス名は、「 Queue 」または「 Topic 」– JNDI ルックアップで取得する


// Context jndiContext = new InitialContext(); // 前と同じ

Queue queue = (Queue) jndiContext.lookup("jms/javaee6/Queue");org.beginningee6.book.chapter13.jms.ex01.Sender を

参照

37

JNDI リソースをインジェクションで取得

• JNDI ルックアップで取得するものは、Java EE 6 のコンテナ上で実行されるならばリソースインジェクションで取得することも可

– いくつか要素があるが、 lookup を覚えておけばOK

– あとは API リファレンス参照04/13/2023 Beginning JavaEE6 勉強会 (5)

// プライベート変数@Resource(lookup = "jms/javaee6/ConnectionFactory")private static ConnectionFactory connectionFactory;

@Resource(lookup = "jms/javaee6/Queue")private static Queue queue;


38

コネクション

• JMS プロバイダとの接続を隠ぺいする役割– スレッドセーフに設計されているため、積極的に使いまわしすること

– 状態遷移図は右記の通り– stop メソッドは受信の際に一旦止めたい場合に利用する• connection をクローズして再生成するのはコストが高い


Connection connection = connectionFactory.createConnection();// いろいろconnection.start();// メッセージの受信などconnection.close();// エラー処理は省略

ConnectionFactory.createConnection()

Connection.close()

Connection.start()

Connection.stop()


39

セッション• メッセージ送信・受信時のグループ化の役割

– 1 メッセージしか送らなくても作る必要がある– トランザクション機能により、一連のメッセージを、

すべて送るかすべて送らないかのいずれかにできる（アトミック性）

– シングルスレッドで使うこと！（非スレッドセーフ）

• 第一引数：トランザクション管理をする→ true　　　　　しない→ false

• 第二引数：メッセージ受信時の確認応答の仕方（後述） .　　　　　とりあえず AUTO_ACKNOWLEDGE でよい


// Connection connection = connectionFactory.createConnection();Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);// いろいろ// connection.start(); org.beginningee6.book.chapter13.jms.ex01.Receiver を参照

40

メッセージ• 送受信したい情報を保持する役割

– ヘッダー、プロパティ、本文（ Body ）から構成される• ヘッダー：メッセージ識別、ルーティングに利用する情報• プロパティ：アプリケーションから設定する付加情報• 本文（ Body ）：テキスト、バイト、オブジェクトなど。

– メッセージオブジェクト（ Message ）は、メッセージ・コンシューマのメソッドを利用して生成する（後述）


ヘッダープロパティ本文

メッセージ

41

メッセージ：ヘッダー

• メッセージ識別、ルーティングに利用する情報– 各フィールドは、 JMS 仕様に規定されている


フィールド説明設定方法

JMSDestination 宛先 send または publish メソッド

JMSDeliveryMode 配信モード（損失防止の設定） send または publish メソッド

JMSExpiration 有効期限 send または publish メソッド

JMSPriority 優先度（ 0 最低～ 9 最高 ) send または publish メソッド

JMSMessageID 一意に識別するための ID send または publish メソッド

JMSTimestamp プロバイダに渡された時刻 send または publish メソッド

JMSCorrelationID 関連するメッセージのリンククライアントJMSReplyTo メッセージの応答の宛先クライアント

JMSType メッセージタイプ（後述）の識別子

クライアント

JMSRedelivered 再配信メッセージか否か JMS プロバイダ

42

メッセージ：プロパティ• アプリケーションから設定する付加情報、

ルーティングに利用する情報– ヘッダとの違いは JMS 仕様ではないこと

• ヘッダのフィールドは JMS 仕様で規定されている• 逆に、通信アプリ間では事前に合意しておく必要がある

– アプリ固有の識別情報を本文の外に埋め込める• 後述する「セレクタ」で利用する

– データ型はプリミティブ型＋ String型が利用できる• 型ごとにメソッドが用意されている• 変換可能な型は、読み取り可能（詳細は Javadoc 参照）


// メッセージ送信前に設定するmessage.setIntProperty("orderAmount", 1);// 受信時（※ セレクタを利用する場合は設定で自動振り分けされる）int amount = message.getIntProperty("orderAmount");


43

メッセージ：本文（ Body ）

• テキスト、バイト、オブジェクトなど– メッセージのタイプ（型）は 5 種類– それぞれのタイプに設定 /取得メソッドが

用意されている


インタフェース説明StreamMessage Java プリミティブ型の値のストリームを扱う

MapMessage 名前と値のペアの組を扱う名前は文字列、値は Java プリミティブ型

TextMessage 文字列を扱う

ObjectMessageシリアライズ可能なオブジェクト、あるいはシリアライズ可能なオブジェクトのコレクションを扱う

BytesMessage バイトストリームを扱う

44

メッセージ・プロデューサ

• メッセージ送信側のクライアント– Session から作成する– 別名：センダ（ P2P モデル）、

　　　パブリッシャ（ pub-sub モデル）

• クライアントインタフェース（クラス）には、モデルの違いはメソッド名が違うくらいで大差ない

• 違いは、 getQueue()/getTopic() メソッドをそれぞれ持つだけ


MessageProducer mp = session.createProducer(queue);mp.send(message);

// QueueSender.send(message) // P2P モデル用 I/F 覚えなくてよし// TopicPublisher.publish(message) // pub-sub モデル用 I/F 覚えなくてよし

45

メッセージの送信手順

• 送信側のソースが一通り読めるようになった


public class Sender { public static void main(String[] args) { try { Context jndiContext = new InitialContext(); ConnectionFactory connectionFactory = (ConnectionFactory) jndiContext.lookup("jms/javaee6/ConnectionFactory");

Queue queue = (Queue) jndiContext.lookup("jms/javaee6/Queue");

Connection connection = connectionFactory.createConnection();

Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);

MessageProducer producer = session.createProducer(queue);

TextMessage message = session.createTextMessage(); message.setText("This is a text message sent at " + new Date());

producer.send(message);

System.out.println("\nMessage sent !"); connection.close(); } catch (Exception e) { e.printStackTrace(); } System.exit(0); }}


コネクションファクトリをルックアップ

宛先をルックアップ

コネクションを作成

セッションを作成

クライアントを作成

メッセージを作成

メッセージを送信

コネクションをクローズ


46

メッセージ・コンシューマ• メッセージ受信側のクライアント

– Session から作成する– 別名：レシーバ（ P2P モデル）

　　　サブスクライバ（ pub-sub モデル）

• クライアントインタフェース（クラス）には、モデルの違いはほとんどない

• 違いは以下の通り。実用上、ほぼ使わないと思われる– getQueue()/getTopic() メソッドをそれぞれ持つこと– pub-sub モデルには、 NoLocal 属性※の getter があること


MessageConsumer mc = session.createConsumer(queue);Connection.start();TextMessage message = (TextMessage) mc.receive();

// QueueReceiver // P2P モデル用 I/F 覚えなくてよし// TopicSubscriber // pub-sub モデル用 I/F 覚えなくてよし

※ 自分で配信したメッセージについて、自分が受信しないようにする設定　　 http://otndnld.oracle.co.jp/document/products/wls/docs92/jms/implement.html#wp1168490

47

メッセージの受信方法（同期・非同期）

• 受信方法に、同期と非同期の方式を利用できる– 同期： receive メソッドを呼び出す。

　　　メッセージが到着するまでブロックする

– 非同期：リスナを利用する。　　　　イベントハンドラ（ onMessage ）を実装


宛先同期レシーバセンダ

取得recieve()

送信send()

宛先非同期レシーバセンダ登録

送信send()

通知

取得

48

同期配信

• receive() を利用してメッセージを受信する– 着信を待つため処理をブロックしてしまう– 着信を待たない recieveNoWait() もあるが、

ポーリングは自分で実装しなければならない


public static void main(String[] args) { try { Connection connection = connectionFactory.createConnection(); Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE); MessageConsumer consumer = session.createConsumer(topic); connection.start();

System.out.println("\nInfinite loop. Waiting for a message...");

while (true) {

TextMessage message = (TextMessage) consumer.receive(); System.out.println("Message received: " + message.getText()); }

} catch (Exception e) { e.printStackTrace(); } }


49

非同期配信

• リスナを使ったイベントモデルで実装できる


public class Listener implements MessageListener { // … public static void main(String[] args) {

System.out.println("\nStarting listener....");

try { Connection connection = connectionFactory.createConnection(); Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE); MessageConsumer consumer = session.createConsumer(topic);

consumer.setMessageListener(new Listener()); // “Listener” は自クラスのクラス名 connection.start();

} catch (Exception e) { e.printStackTrace(); } }

public void onMessage(Message message) { try { System.out.println("Message received: " + ((TextMessage) message).getText()); } catch (JMSException e) { e.printStackTrace(); } } }

org.beginningee6.book.chapter13.jms.ex05.Listener を参照

50

13.4.4 セレクタ

• 受信するメッセージをフィルタする場合に利用– 主に pub-sub モデルで利用する（と思われ）– ヘッダーとプロパティのどちらもフィルタに使える– 受信側作成時に設定するが送信側にも伝わっている

• フィルタされるものは送信されないので帯域幅も節約

– 複合条件も可能• 利用可能演算子

– NOT, AND, OR, =, >, >=, <, <=, <>, +, -, *, /, [NOT] BETWEEN, [NOT] IN, [NOT] LIKE,IS [NOT] NULL


String selector = "orderAmount < 5 or orderAmount > 7";// …MessageConsumer consumer = session.createConsumer(topic, selector);


51

13.4.5 信頼性確保のメカニズム [1/2]

• MOM にはメッセージを確実に送信するための信頼性確保の機能が用意されている

– つづく


メカニズム説明

メッセージ有効期限

古いメッセージの配信を制限する• producer.setTimeToLive(1000);• producer.send(msg, DeliveryMode.PERSISTENT, 2, 1000);

メッセージ永続性の指定

プロバイダのエラー時もメッセージが永続化されるようにする。「配信モード」で設定する。デフォルトは永続配信。• 1回配信する「永続配信」（ DeliverMode.PERSISTENT ）• 1回以上配信する「非永続配信」

（ DeliverMode.NON_PERSISTENT ）

確認応答の制御

メッセージ受信を確認応答する機能。トランザクション管理されている場合は自動。それ以外は確認応答モードを設定。• connection.createSession(false,

Session.AUTO_ACKNOWLEDGE);• 自動応答する場合： AUTO_ACKNOWLEDGE• 自動応答だが負荷を下げたい場合で、かつ重複受信してもよい場合：

DUPS_OK_ACKNOWLEDGE• 明示的にクライアントがメソッドを呼ぶ場合： CLIENT_ACKNOWLEDGE

（クライアント側で Message.acknowledge() を呼ぶ）

52

13.4.5 信頼性確保のメカニズム [2/2]（つづき）


メカニズム説明

恒久サブスクライバの作成

サブスクライバが一時的にオフラインになっていても、再接続した時にオフライン中のメッセージを受信できる機能。（ pub-sub モデルでは通常オフライン中にメッセージ配信しない） topicConn = connFactory.createTopicConnection(); topicConn.setClientID(“client1”); session.createDurableSubscriber(topic, “name”);• 受信側だけで関係する• createDurableSubscriber の第二引数は恒久サブスクライバの ID• 利用時はコネクションに毎回同じ Client ID を設定すること• 購読を停止する際は Session.unsubscribe() メソッドをコールする

優先度の設定

緊急メッセージを優先配信できる機能。0最低から 9最高まで指定可能。• producer.setPriority(2);• producer.send(msg, DeliveryMode.PERSISTENT, 2, 1000)

53

Message Driven Bean


54

13.5 メッセージ・ドリブン Bean

• EJB コンテナ上で実行されるアプリ向けの、非同期メッセージングモデルを提供する仕組み– ここでの非同期とは、先で説明した配信方法では

なく、メッセージングの特性のことを指している

• メッセージが着信するとコンテナから呼び出される非同期コンシューマ– ここでの非同期とは、配信方法がブロックしない、という

意味のほうを指している

• コンテナ上の機能を利用できるため、マルチスレッド化が容易– コンテナが MDB インスタンスをプールし、メッセージが着信するとインスタンスが割り当てられ、処理する

– ただしステートレスにしなければならない04/13/2023 Beginning JavaEE6 勉強会 (5)

55

13.5.1 MDB の作成方法

• 諸作業はコンテナが行うため、以下でよい

– @MessageDriven アノテーションと、javax.jms.MessageListener を実装するのが重要

– JMS の設定を変える場合は実は少し面倒（後述）04/13/2023 Beginning JavaEE6 勉強会 (5)

@MessageDriven(mappedName = "jms/javaee6/Topic")

public class BillingMDB08 implements MessageListener {

public void onMessage(Message message) { TextMessage msg = (TextMessage) message; try { System.out.println("Message received: " + msg.getText()); } catch (JMSException e) { e.printStackTrace(); } }}

org.beginningee6.book.chapter13.jms.ex08. BillingMDB08.java を参照

56

13.5.2 MDB モデル

• MDB は Web Profile に含まれないため、EAR ファイルにしてデプロイする必要がある

• MDB クラスの要件は以下の通り


# 要件

1 @javax.ejb.MessageDriven アノテーションを付与または XML デプロイメントディスクリプタ内に同様の内容を定義

2 MessageListener インタフェースを直接または間接的に実装

3 public 、非 final 、非 abstract クラスであること

4 引数なしパブリックコンストラクタがあること

5 finalize メソッドが実装されていないこと

57

Work#2 MDB を動かす

1. （管理対象オブジェクトを作る）←実施済み2. 受信側の用意

1. ビルドする（受信側）2. デプロイする

3. 送信側の用意1. ビルドする（送信側）

4. メッセージを送信し MDB を起動する


58

Work#2-2-1 ビルドする（受信側）

• “Chapter 13 JMS(MDB)” プロジェクトを「依存関係で構築」または「生成物を削除して構築」


JMS プロジェクトと違い、1回で全部ビルド＆ Jar 化される

59

Work#2-2-2 デプロイする（コマンドライン）• Jar ファイルをデプロイし、確認する


> asadmin deploy chapter13-MDB-2.0.jarchapter13-MDB-2.0 という名前のアプリケーションがデプロイされました。コマンド deploy は正常に実行されました。 > asadmin" list-componentschapter13-MDB-2.0 <ejb>

※1 C:\Program Files\glassfish-3.1.2\glassfish\bin\asadmin※2 C:\Users\ （ユーザ名） \Documents\NetBeansProjects\book\　　　 chapter13\mdb\target \chapter13-MDB-2.0.jar

60

Work#2-3 ビルドする（送信側）• “Chapter 13 JMS(JMS)” プロジェクトを開く• pom.xml を編集し、適切な mainClass を指定してビルドする


テキストメッセージ　 org.beginningee6.book.chapter13.jms.ex07. SenderDTO を利用したオブジェクトメッセージ　 org.beginningee6.book.chapter13.jms.ex14.OrderSender

61

Work#2-4 メッセージを送信し MDB を起動する• コマンドラインから送信側 jar ファイルを

ACC 上で起動する

– topic はシンプルメッセージを受け付けるtopic に送信した場合は 3 つの MDB が起動する

– queue は OrderDTO を受け付けるqueue に送信した場合は 1 つの MDB が起動する


> appclient -client chapter13-JMS-2.0.jar

※1 C:\Program Files\glassfish-3.1.2\glassfish\bin\appclient※2 C:\Users\ （ユーザ名） \Documents\NetBeansProjects\book\　　　 chapter13\jms\target \chapter13-JMS-2.0.jar

62

@MessageDriven と@ActivationConfigProperty• @MessageDriven アノテーションのフィールドと使い方


フィールド説明

name Bean の名前

description 説明テキスト（デプロイツールが利用）

mappedName 監視する宛先の JNDI 名

MessagelistenerInterface

インタフェースを複数実装した場合にMessageListenerInterface がどれか指定する

activationConfig 設定プロパティとその値のペアを @ActivationConfigProperty アノテーション配列で渡す。同アノテーションはpropertyName と propertyValue というフィールドを持つ

@MessageDriven(mappedName = "jms/javaee6/Topic", activationConfig = { @ActivationConfigProperty(propertyName = “acknowledgeMode”, propertyValue = "Auto-acknowledge"), @ActivationConfigProperty(propertyName = "messageSelector", propertyValue = "orderAmount < 3000")})public class BillingMDB11 implements MessageListener {// …

org.beginningee6.book.chapter13.jms.ex11. BillingMDB11.java を参照

63

省略したところ

• 依存性注入– MDB にも別オブジェクトを注入できる。当然なので省略

• MDB コンテキスト– トランザクションの状態や明示的ロールバック、

セキュリティの設定を知ることができる、があまり利用しないと思われるので省略

• ライフサイクルとコールバック・アノテーション– ステートレス・セッション Bean と同じなので省略


64

省略したところ２

• 13.5.2 コンシューマとしての MDB– 同期受信しないでください、リソース無駄です、

という内容• 13.5.3 プロデューサとしての MDB– MDB 内から別メッセージを送信することも可能、

という内容– 送信時は、コネクションファクトリを MDB に

@Resouce アノテーションで注入し、onMessage 内か委譲先で Session を作成しメッセージを送信する、という内容

– 送信時は @MessageDriven アノテーションは関係ないので混乱しないように注意


65

13.5.5 トランザクション

• MDB はトランザクションを使用できる（ BMT/CMT ）– すべてのメッセージが送信されるか、

すべて送信されないか、の一貫性を保証する• 他の EJB と違いイベントドリブンモデルのため、

呼び出し元が居ない– トランザクションコンテキストが渡されてこない– そのためトランザクション属性は以下に限られる

– これらの属性は @javax.ejb.TransactionAttributeアノテーションで付与できる


トランザクション属性説明

REQUIRED( デフォルト )

MDB から他の EJB を呼び出す場合に、コンテナがトランザクションコンテキストを渡す。 onMessage メソッド終了時に commit される。

NOT_SUPPORTED トランザクションコンテキストを渡さない。

66

13.5.5 例外処理

• JMS の例外は JMSException を継承している– 検査例外のためスローしてもロールバックしないの

で注意– ロールバックするには非検査例外をスローするか、

MessageDrivenContext.setRollBackOnly() をコールする• MessageDrivenContext は MDB に依存性注入すれば得られる


@Resource private MessageDrivenContext context;

67

まとめ


68

13.7 まとめ

• MOM を使うことで疎結合な非同期通信が可能• JMS API で利用できる– P2P モデルと pub-sub モデルを利用できる– コネクション・ファクトリ、宛先 (Queue と

Topic) 、コネクション、セッション、メッセージ等を利用

• EJB コンテナ上では、 MDB を利用できる– メッセージ処理するコードが簡単に書ける


beginning java ee 6 勉強会(5) #bje_study

Education