JBossで、、、

JBossでHelloEJB

作成 2003/5/5

ここでは、JBossでHelloWorldレベルのEJBを作成します。簡単、シンプルをポリシーとして、さくさくいきたいと思います。

パッケージングにはAntを使っています。 EJB自体についての説明は行っていません。 EJBとANTを少しは知ってる人が、ちょっとJBossを使ってみようというときに参考になる程度のメモです。

実験環境

WindowsXP SP1
JDK1.4.1_02
JBoss3.2.0
Ant1.5.3-1

JBossって？

JBossはオープンソースのEJBコンテナです。

たくさんダウンロードされてる人気者。賞も取った実力派。
EJBや他のサービスのデプロイと削除がすごい簡単
~~Tomcatなどと連携させれば、完全なアプリケーションサーバとして利用可　(ダウンロードしてすぐ使える、Tomcatセットもある)~~(現状デフォルトでセット)
商用利用は無料(LGPLライセンス)。~~J2EE認定を受けていないのがちょっと微妙。~~(受けました)

公式サイト
http://www.jboss.org/

日本語情報サイト(解説、ML、Wiki)
http://neverbird.sourceforge.jp/

JBossのインストール

JBossのダウンロード

上の公式サイトからJBossをダウンロードします。 Downloadsを選択し、最新版のJBossをダウンロードします。ここでは、JBoss3.2.0.zipをダウンロードしました。

JBossのインストール

ダウンロードしたアーカイブを解凍し、任意のディレクトリに配置します。ここでは、C:\app\jboss-3.2.0に配置しました (以降、インストールしたディレクトリを%JBOSS_HOME%と記述します)。

図、JBossのディレクトリ構造

binにバッチファイルがあれこれ。clientはクライアント用のjarとか。 serverはall、default、minimalの３種類があります。 serverの中のdeployがデプロイするディレクトリです。

サーバーの起動と停止

起動、停止用のバッチファイルが、%JBOSS_HOME%/binディレクトリにあります。

起動

run.bat

設定オプション-c=minimalなど指定すれば、サーバを変更できます。ここでは、何も指定せずdefaultを使います。

停止

shutdown.bat

-Sオプションで停止します。

HelloEJBの作成と実行

ここで、作成するアプリケーションは簡単なステートレスセッションビーン (と実行用のJavaアプリケーション)です。まず、全体の流れを説明し、その後、各手順について、説明してきます。

作成の流れ(Antで実行)

ここではAntタスクを利用して、以下の３手順で、作成、実行を行っています。

ejbjar EJBJARのコンパイルとパッケージング
deploy EJBJARのデプロイ
client クライアントから実行

簡単に動かしてみるには、以下のZIPファイルを解凍して使えます。
hello.zip

解凍したjboss01のbuild.xmlのjboss.homeのパスをインストールしたJBossのパスに書き換えます。

コマンドプロンプトで、
ant ejbjar
ant deploy
ant client
と実行すれば、なんとなく動きます。

画面、ejbjar、deploy、clientターゲットの実行

上記ZIPファイルは、Eclipse上で作成しているので、Eclipseの人は、インポートして、クラスパスを変更して使うと見易いでしょう。

各ターゲットで行っていることを簡単に説明していきます。

EJBの作成(ejbjar)

リソースの構成は以下のようになっています。

+- src/
|   +- java/
|   |   +- hello/
|   |   |   +- Client.java
|   |   |   +- Hello.java
|   |   |   +- HelloBean.java
|   |   |   +- HelloHome.java
|   |   +- jndi.properties
|   +- res/
|       +- ejb-jar.xml
|       +- jboss.xml
+- build.xml

build.xmlはAntのビルドファイルです。 Client.java、jndi.propertiesはクライアント用のリソースなので、 ejbjarには必要ありませんが、簡単のために一緒に作っています。

コンパイル、クライアントからの実行時に、%JBOSS_HOME%/client/jbossall-client.jarをクラスパスに通しています。

jboss.xmlはJBoss依存の設定ファイルです。EJB名とJNDI名をマッピングしています。

上記リソースをコンパイル、パッケージングして、以下の構成のhello.jarを作成しています。

+- hello/
|       +- Hello.class
|       +- HelloBean.class
|       +- HelloHome.class
+- META-INF
|       +- ejb-jar.xml
|       +- jboss.xml

Antからは以下のターゲットで実行できます。
ant ejbjar
jarはbuild/hello.jarに作成されます。

EJBのデプロイ(deploy)

JBossでのEJBのデプロイは%JBOSS_HOME%/server/default/deployに作成したejbjarをコピーするだけです。 JBossを起動したウィンドウでは、デプロイされたことが表示されます。

画面、デプロイ時のサーバ側(ここでエラーがあると例外が表示されます)

アンデプロイするのは、hello.jarファイルをdeployディレクトリから削除すればよいです。

デプロイの確認

jmx-consoleを使ってデプロイしたEJBのJNDIを確認できます。

以下のURLにアクセスします。
http://localhost:8080/jmx-console/

jbossのservice=JNDIViewを選択します。

ページ一番下のlist()メソッドの「invoke」ボタンをクリックします。

Ejb ModuleにHelloEJBが登録されていること
Global JNDI NamespaceにHelloEJBが登録されていること

がわかります。

クライアントの実行(client)

クライアントの実行クラスは Client.java です。

InitialContextの設定はクラスパス上のjndi.propertiesから読み込みます。また、lookupする名前はJ2EEコンテキストの中からのlookupではないので、 "java:comp/env/ejb/HelloEJB"でなく、単に"HelloEJB"でlookupしています。

JBossの起動しているウィンドウでもcall sayHelloが表示されていることがわかります。

画面、実行結果

なお、JBossではクライアント側にEJBのスタブは必要ありません (最近は他のEJBコンテナでもスタブいらないの多い？)。

感想

なるべくシンプルにしたかったんですが、ビルドファイルが必要なほどに複雑ですね。。。設定ファイルは書き間違いが多いので、検証ツールが必要だと思われます。ビルドファイル中のvalidateタスクでDTDレベルの検証は行えますが、 statefulとか間違っちゃうとなかなか見つからないし (deployer.batというのが、それっぽが、調査不足)。あと、ハローEntityBeanとXDocletの利用ぐらいは、そのうち試したいと思います。

TOP

ejbjar	EJBJARのコンパイルとパッケージング
deploy	EJBJARのデプロイ
client	クライアントから実行