NetBeansおよびGlassFishを使用した、簡単なJava Message Service（JMS）プロデューサの作成

概要

目的

このチュートリアルでは、GlassFish 3.1.2およびNetBeans 7を使用して、JMS APIを使用した簡単なメッセージ・プロデューサを作成する方法について説明します。

所要時間

約45分

はじめに

メッセージングは、ソフトウェア・コンポーネント間やアプリケーション間での通信手段です。メッセージングは分散アプリケーション間での疎結合通信を可能にします。メッセージ・クライアントは、メッセージの受信と配信に役立つメッセージング・エージェントに接続することで、メッセージングの送受信を行います。クライアント側では、メッセージを消費または生成するその他のクライアントについて把握する必要はありません。メッセージ・クライアントが知っている必要があるのは、送信メッセージの形式と宛先のみです。したがって、メッセージングは、アプリケーション側でリモート・アプリケーションのメソッドを把握する必要のあるその他の密結合テクノロジー（Remote Method Invocation（RMI）など）とは異なります。

Java Message Service APIは、エンタープライズ・メッセージング製品（メッセージ指向ミドルウェア（MOM）とも呼ばれる）を介して企業内アプリケーションを接続するという要望に応じるため、Sun Microsystemsなどの企業によって設計されました。 JMSはJavaアプリケーションからメッセージング・システムへのアクセス手段を提供します。 JMSは、一連のインタフェースに加えて、JMSクライアントがメッセージ実装機能にアクセスする方法を定義した関連セマンティックで構成されています。この点において、JMSはJDBCに非常によく似ています。

メッセージング・システムはPeer-to-Peer機能であるため、クライアントはどのクライアントに対してもメッセージを送受信することができます。一部のメッセージング・システムは多数の宛先にメッセージをブロードキャストできるため、クライアントが特定のチャネルまたはトピックをサブスクライブすることでブロードキャストされたメッセージを受信できます。 JMSはJMSプロバイダの実装に応じて、両方のモデルをサポートするように実装されています。次の図に、Java Message Service実装に関係するコンポーネントを示します。

JMS APIメッセージング・システムに関係するコンポーネント

JMSテクノロジー・プロバイダ（JMSプロバイダ）は、JMS APIの実装を提供するメッセージング・システムです。 JMSテクノロジーをサポートするアプリケーション・サーバーに対して、このアプリケーション・サーバーのJNDIテクノロジー名前空間に管理対象オブジェクト（コネクション･ファクトリ、キュー宛先、トピック宛先）を配置する必要があります。通常は、アプリケーション・サーバーで提供されている管理ツールを使用してこのタスクを実行しますが、このチュートリアルでは、NetBeansに組み込まれた機能を使用して管理対象オブジェクトの定義と作成を行います。

具体的に言うと、キュー宛先とコネクション・ファクトリをNetBeans内に定義します。アプリケーションをデプロイした後で、NetBeansの機能を使用し、指定したコネクション・ファクトリを使用するコードを生成して、コネクション・オブジェクトを生成します。生成されたコードはこのコネクション・オブジェクトを使用してセッション・オブジェクトを作成します。このセッション・オブジェクトを使用してMessageProducerオブジェクトが作成され、JSFページに入力された文字列がメッセージ・オブジェクトとしてキューに送信されます。

ソフトウェア要件

Windowsプラットフォームでこのチュートリアルを実行するには、次のソフトウェアが必要です。ソフトウェアは次に示す順序でインストールする必要があります。

こちらのリンクからJava JDK 7をダウンロードし、インストールします。
こちらのリンクからNetBeans IDE 7.1.2 Java EEバージョンをダウンロードし、インストールします。このソフトウェアには、GlassFish 3.1.2（Java EEダウンロード・バンドル）が含まれています。
インストール中に、GlassFishをインストールするためのチェック・ボックスを必ず選択してください。 JUnitのインストールは省略可能であり、このチュートリアルでは必要ありません。

前提条件

このチュートリアルを始める前に以下のことを確認してください。

ソフトウェア要件に記載されたソフトウェアをインストールしていること。
NetBeans IDEを起動していること。
このチュートリアルに必要なNetBeansプロジェクトが含まれているMDBExample.zipファイルをダウンロードし、解凍していること。
注： NetBeansプロジェクトを解凍するフォルダには、英数字以外の文字や空白を使用しないでください。

NetBeansのWebアプリケーション・プロジェクトの作成

NetBeansはさまざまなプロジェクト・オプションを提供しています。このチュートリアルではWebアプリケーション・プロジェクトを作成し、JSFフレームワークを使用します。

新しいWebアプリケーション・プロジェクトを作成します。

「**File**」→「**New**」→「**Project**」を選択します。

**New Project**ダイアログで、Categoriesから「**Java Web**」を選択し、Projectsから「**Web Application**」を選択します。「**Next**」をクリックします。

Project Nameに**JSFProducer**と入力します。
任意のプロジェクト・ロケーションを入力します。
「**Next**」をクリックします。

「**Enable Contexts and Dependency Injection**」を選択します。「**Next**」をクリックします。

Frameworksから「**JavaServer Faces**」を選択します。「**Finish**」をクリックします。

JMSプロデューサ用マネージドBeanの作成

このトピックでは、JSF Facelet用のマネージドBeanを作成します。

新しいJSFマネージドBeanの作成

作成したプロジェクトを開きます。「**Source**」パッケージを右クリックし、「**New**」→「**Other**」を選択します。

Categoriesから「**Java Server Faces**」を選択し、File Typesから「**JSF Managed Bean**」を選択します。「**Next**」をクリックします。

Class Nameに**MessageProducerBean** と入力します。
Packageに**obe**と入力します。
BeanのScopeとして「**request**」を選択します。
「**Finish**」をクリックします。

String型のメッセージ・フィールドを含むJSFマネージドBeanの実装

String型のメッセージ・フィールドをマネージドBeanに追加します。

private String message;

NetBeansのコード挿入機能を使用して、このフィールドのgetterとsetterを追加します。「**MessageProducerBean**」ファイルの最後の閉じかっこの真上をクリックし、**[Alt]**を押しながら**[Insert]**キーを押して、Generateリストから「**Getter and Setter**」を選択します。

「**message**」フィールドを選択します。「**Generate**」をクリックします。

getterとsetterの下に、戻り型がvoidの空の**send()**メソッドを追加します。
ファイルを保存します。

JSFページの実装

マネージドBeanのメッセージ・フィールドに書込みを実行するためのコンポーネントをJSFページに追加します。

Web Pagesフォルダを開き、**index.xhtml**ファイルを開きます。ページに次のマークアップを追加し、**Hello from Facelets**文字列を置き換えます。

JMS Message Producer
<h:form>
    <h:outputLabel value="Message: " for="message"/>
    <h:inputText id="message" value="#{messageProducerBean.message}"/>
    <h:commandButton value="Send Message" action="#{messageProducerBean.send}"/>
    <h:messages globalOnly="true"/>
</h:form>

JSFページのタイトルを**JMS Message Producer**に変更します。ファイルを保存します。

プロジェクトへのメッセージ・キューとコネクション・ファクトリの追加

JMSキューの管理オブジェクト・リソースの追加

プロジェクトを右クリックして、「**New**」→「**Other**」を選択します。
Categoriesから「**GlassFish**」を選択し、File Typesから「**JMS Resource**」を選択します。
「**Next**」をクリックします。

JNDI Name（**jms/myQueue**）とAdmin Object Resourceはデフォルトのままにします。「**Next**」をクリックします。

JMS Properties画面でValueフィールドに**myQueue**と入力し、**[Enter]**キーを押します。
「**Finish**」をクリックします。

JMSキューのコネクタ・リソースの追加

JNDI Nameに**jms/myQueueFactory**と入力します。
Connector Resourceとして「**javax.jms.QueueConnectionFactory**」を選択します。
「**Finish**」をクリックします。

GlassFishアプリケーション・サーバーの起動とアプリケーションのデプロイ

Servicesタブを開き（「**Windows**」→「**Services**」）、「**Servers**」を開きます。
「**GlassFish Server 3.1.2**」を**右クリック**し、「**Start**」を選択します。
注： GlassFishインスタンスの魚アイコンの横に緑色の三角マークが表示されている場合、サーバーは起動済みであり、Startコマンドはグレーアウトされます。

「**Projects**」タブを選択して開きます。
「**JSFProducer**」プロジェクトを**右クリック**して、「**Deploy**」を選択します。

「**Services**」タブを開きます。「**Applications**」フォルダを**右クリック**して「**Refresh**」を選択し、**JSFProducer**アプリケーションのデプロイを確認します。
「**Resources**」フォルダを開き、「**Connectors**」フォルダを開きます。
「**Admin Object Resources**」を**右クリック**し、「**Refresh**」を選択します。
「**Connector Resources**」フォルダと「**Connector Connection Pools**」フォルダに対して同じ処理を繰り返します。
GlassFishによって**JSFProducer**アプリケーションがデプロイされ、**jms/myQueue**管理オブジェクト・リソースと**jms/myQueueFactory**コネクタ・リソース・オブジェクトが作成されたことを確認します。

マネージドBean内のJMSコードの生成

**MessageProducerBean**クラスをエディタで開き、ファイルの最後（閉じかっこの直前）をクリックします。
**[Alt]**を押しながら**[Insert]**を押してNetBeansのコード生成機能を開き、「**Send JMS Message...**」を選択します。

デフォルトで、Server Destinationには管理リソース・オブジェクト（**jms/myQueue**）が選択され、Connection factoryには**jms/myQueueFactory**が入力されます。「OK」をクリックします。

ファイル上部までスクロールし、**Queue**インスタンスと**ConnectionFactory**インスタンスに対する適切なリソース宣言がNetBeansにより追加されていることを確認します。

sendメソッドの変更による生成コードの呼出し

次のコードを**send()**メソッドに追加します。

FacesContext facesContext = FacesContext.getCurrentInstance();
try {
     sendJMSMessageToMyQueue(message);
     FacesMessage facesMessage = new FacesMessage("Message sent: " + message);
     facesMessage.setSeverity(FacesMessage.SEVERITY_INFO);
     facesContext.addMessage(null, facesMessage);
} catch (JMSException jmse) {
     FacesMessage facesMessage = new FacesMessage("Message NOT sent: " + message);
     facesMessage.setSeverity(FacesMessage.SEVERITY_ERROR);
    facesContext.addMessage(null, facesMessage);
}

send()メソッドは、先ほどプロジェクトに追加したJMSキュー宛先に対して文字列messageの送信を試みます。
メッセージが正しく送信されると、現在のビュー・ページを表すFacesContextインスタンスにFacesMessageが追加されます。ページがレンダリングされると、FacesMessageがブラウザ・クライアントに表示されます。

不足しているインポートを修正し（**[Ctrl]**と**[Shift]**を押しながら**[I]**）、ファイルを保存します。

OutputウィンドウのGlassFish Server 3.1.2タブにアプリケーションが正しくデプロイされたことが示されますが、次の警告が表示されます。
注：角かっこ内のメッセージ内容は環境によって異なる場合があります。

これらの警告は、先ほど作成したキューとコネクション・ファクトリに対して、NetBeansが移植可能なJNDIルックアップ参照を作成しようとしたことに起因します。この例では、JMSリソースに対して移植可能でない**mappedName**ルックアップが使用されているため、この警告を無視して構いません。または、**glassfish-web.xml**ファイルから次に示す行を削除します。

これらの行を削除してからファイルを保存すると、GlassFishによって自動的に**JSFProducer**アプリケーションが再デプロイされ、警告は表示されません。

アプリケーションのテスト

ブラウザを開き、次のURLを入力します。

**http://localhost:8080/JSFProducer/**

何らかのテキストを入力し、「**Send Message**」ボタンをクリックします。
メッセージが正しく送信されることを確認します。次に例を示します。

メッセージ・キュー統計の参照

サーバー上のメッセージの中身を表示することはできませんが、宛先に送信された（まだ取得されていない）メッセージの数を確認することはできます。

コマンドラインの使用

コマンド・ウィンドウを開きます (（「**スタート**」→「**ファイル名を指定して実行**」→「**cmd**」）
次のコマンドを入力します。

**"C:\Program Files\glassfish-3.1.2\mq\bin\imqcmd" list dst**

Usernameとして**admin**を入力し、Passwordとして**admin**を入力します。

myQueueには1つのメッセージが入っています。

管理コンソールの使用

ブラウザに次のURLを入力し、**GlassFish Admin Console**を起動します。

http://localhost:4848/common/index.jsf

左側のパネルから「**server (Admin Server)**」を**クリック**します。

「**JMS Physical Destinations**」タブを選択します。

**Number of Messages**統計情報が表示されるまで、下方向にスクロールします。

キュー上のメッセージの読取り

このチュートリアルには、キュー上のメッセージを"表示"するための簡単なMessage-Driven Bean（MDB）プロジェクトが含まれています。キューからメッセージを取得して別のアプリケーション用に保存する方法を含む、より高度なMDBアプリケーションについては、別のOBEで学習します。

**MDBExample.zip**プロジェクトをディレクトリに解凍し、NetBeansでこのプロジェクトを開きます。

「**MDBExample**」プロジェクトを**右クリック**して「**Deploy**」を選択し、GlassFishにこのMDBをデプロイします。

Outputウィンドウの「**GlassFish Server 3.1.2**」タブ（システム・コンソール）をクリックすると、JSFウィンドウに入力したメッセージが確認できます。

まとめ

このチュートリアルでは、JMSプロデューサ・アプリケーションを作成しました。このアプリケーションはJSFページを使用して文字列メッセージとマネージドBeanを作成し、JMSメッセージ・キューに文字列を格納します。

参考資料

The Java EE 6 Tutorial: Java Message Service Concepts
Java Message Service Documentation
Developing Java EE 6 Applications for the Java EE 6 Platform
Java EEアプリケーションでのJava Message Serviceの使用について、詳しくはOracle Learning Libraryに含まれるその他のOBEを参照してください。

著者

カリキュラム開発責任者： Tom McGinn
共著者： Matt Heimer

このOracle by Exampleをナビゲートする際、次の機能を使用できます。

ヘッダー・ボタンの非表示：: ヘッダー内のボタンを非表示にするには、タイトルをクリックします。ボタンを再表示するには、もう一度タイトルをクリックします。
トピック一覧ボタン：: すべてのトピックの一覧です。いずれかのトピックをクリックすると、その項に移動します。
すべてのトピックを開く/閉じる：: すべての項に対する詳細を表示または非表示にします。デフォルトでは、すべてのトピックが閉じられています。
すべてのイメージを表示/非表示：: すべてのスクリーンショットを表示または非表示にします。デフォルトでは、すべてのイメージが表示されています。
印刷：: コンテンツを印刷します。現在表示または非表示にされているコンテンツが印刷されます。

このチュートリアルの特定の項に移動するには、一覧からトピックを選択してください。