SeamFramework.orgCommunity Documentation

第41章 GlassFish アプリケーションサーバー上の Seam

41.1. GlassFish 環境とデプロイメント情報
41.1.1. インストール
41.2. jee5/booking サンプル
41.2.1. Building the jee5/booking example
41.2.2. GlassFish へのアプリケーションのデプロイ
41.3. jpa booking サンプル
41.3.1. jpa サンプルのビルド
41.3.2. jpa サンプルのデプロイ
41.3.3. GlassFish v2 UR2 での変更点
41.4. seam-gen により生成されたアプリケーションの GlassFish v2 UR2 へのデプロイ
41.4.1. seam-gen セットアップの実行
41.4.2. GlassFish へのデプロイに必要な変更点

GlassFish は、Java EE 5 を完全に実装したオープンソースのアプリケーションサーバーです。最新の安定リリースは v2 UR2 です。

まず最初に GlassFish 環境について述べて、どのように jee5 サンプルをデプロイするのかを詳しく説明します。次に、jpa サンプルアプリケーションをデプロイします。最後に、seam-gen により生成されたアプリケーションをどのようにして GlassFish 上で動作させるのかを示します。

41.1. GlassFish 環境とデプロイメント情報

この章のサンプルと情報は、すべて執筆時の GlassFish の最新バージョンに基づいています。

GlassFish をダウンロードして、インストールしてください。 

$ java -Xmx256m -jar glassfish-installer-v2ur2-b04-linux.jar

インストールした後に、GlassFish をセットアップしてください。 

$ cd glassfish; ant -f setup.xml

作成されたドメインの名前はdomain1 です。

次に、組み込み JavaDB サーバを起動します。 

$ bin/asadmin start-database

注意

JavaDB は、HSQLDB が JBoss AS に含まれているのと同様に、GlassFish の組み込みデータベースです。

最後に、GlassFish サーバを起動してください。 

$ bin/asadmin start-domain domain1

The web administration console is available at http://localhost:4848/. You can access the web admin console with the default username (admin) and password (adminadmin). We will be using the the admin console to deploy our examples. You can also copy EAR/WAR files to the glassfish/domains/domain1/autodeploy directory to deploy them, although we are not going to cover that.

サーバとデータベースを停止するには、以下のようにしてください。 

$ bin/asadmin stop-domain domain1; bin/asadmin stop-database

41.2. jee5/booking サンプル

jee5/booking サンプルは、(JBoss AS 上で動作する) ホテル予約サンプルに基づいています。そのままで GlassFish 上で動作するように設計されています。このサンプルは $SEAM_DIST/examples/jee5/booking にあります。

To build the example, simply execute the default ant target: 

$ ant

in the examples/jee5/booking directory. This will create the dist and exploded-archives directories.

GlassFish 管理コンソールを利用して GlassFish にアプリケーションをデプロイします。

  1. http://localhost:4848 から管理コンソールにログインします。

  2. 左側のサイドメニュー Applications (アプリケーション) の下にあるメニューオプションで Enterprise Applications (エンタープライズアプリケーション) にアクセスしてください。

  3. Enterprise Application (エンタープライズアプリケーション) テーブルのトップで Deploy (配備) を選択してください。以下のヒントを使って、ウィザードを最後まで進めてください。

  4. http://localhost:8081/seam-jee5/ からアプリケーションにアクセスできます。

41.3. jpa booking サンプル

これは、Hibernate JPA と JPA トランザクションを利用して Seam POJO で実装されたホテル予約サンプルです。アプリケーションサーバで動作させるのに、EJB3 サポートを必要としません。

サンプルには、GlassFish も含めた多くのコンテナ用の構成とビルドスクリプトが既に用意されています。

サンプルをビルドするためには、glassfish ターゲットを使用します。 

$ ant glassfish

これによりコンテナに対応した dist-glassfish ディレクトリと exploded-archives-glassfish ディレクトリが作成されます。

This is very similar to the jee5 example at 項41.2.2. 「GlassFish へのアプリケーションのデプロイ」 except that this is a war and not an ear.

  • 管理コンソールへログインしてください。 

    http://localhost:4848

  • 左側のサイドメニュー Applications (アプリケーション) の下にあるメニューオプションで Web Applications (Web アプリケーション) にアクセスしてください。

    • アプリケーションのインストール準備

      • ブラウザで examples/jpa/dist-glassfish/jboss-seam-jpa.war を指定してください。

      • OK ボタンを選択してください。

    • http://localhost:8081/jboss-seam-jpa/ からアプリケーションにアクセスできます。

Hypersonic SQL DB の代わりに Derby を使用

In order for the app to work out of the box with GlassFish, we have used the Derby (aka JavaDB) database in GlassFish. However, we strongly recommend that you use another database (e.g. HSQL). examples/jpa/resources-glassfish/WEB-INF/classes/GlassfishDerbyDialect.class is a hack to get around a Derby bug in GlassFish server. You must use it as your Hibernate dialect if you use Derby with GlassFish.

41.4. seam-gen により生成されたアプリケーションの GlassFish v2 UR2 へのデプロイ

seam-gen is a very useful tool for developers to quickly get an application up and running, and provides a foundation to add your own functionality. Out of box seam-gen will produce applications configured to run on JBoss AS. These instructions will show the steps needed to get it to run on GlassFish.

第一ステップは、雛形となるプロジェクトを生成できるように seam-gen をセットアップすることです。以下に実行したように、設定すべき項目がいくつかあります。特に、データソースと Hibernate の設定値は、プロジェクトを生成する環境に合わせて設定します。 

$ ./seam setup
Buildfile: build.xml

init:

setup:
[echo] Welcome to seam-gen :-)
[input] Enter your Java project workspace (the directory that contains your
Seam projects) [C:/Projects] [C:/Projects]
/projects
[input] Enter your JBoss home directory [C:/Program Files/jboss-4.2.3.GA]
[C:/Program Files/jboss-4.2.3.GA]

[input] Enter the project name [myproject] [myproject]
seamgen_example
[echo] Accepted project name as: seamgen_example
[input] Do you want to use ICEfaces instead of RichFaces [n] (y, [n])

[input] skipping input as property icefaces.home.new has already
been set.
[input] Select a RichFaces skin [blueSky] ([blueSky], classic, ruby, wine,
deepMarine, emeraldTown, japanCherry, DEFAULT)

[input] Is this project deployed as an EAR (with EJB components) or a WAR
(with no EJB support) [ear] ([ear], war)

[input] Enter the Java package name for your session beans
[com.mydomain.seamgen_example] [com.mydomain.seamgen_example]
org.jboss.seam.tutorial.glassfish.action
[input] Enter the Java package name for your entity beans
[org.jboss.seam.tutorial.glassfish.action]
[org.jboss.seam.tutorial.glassfish.action]
org.jboss.seam.tutorial.glassfish.model
[input] Enter the Java package name for your test cases
[org.jboss.seam.tutorial.glassfish.action.test]
[org.jboss.seam.tutorial.glassfish.action.test]
org.jboss.seam.tutorial.glassfish.test
[input] What kind of database are you using? [hsql] ([hsql], mysql, oracle,
postgres, mssql, db2, sybase, enterprisedb, h2)

[input] Enter the Hibernate dialect for your database
[org.hibernate.dialect.HSQLDialect]
[org.hibernate.dialect.HSQLDialect]

[input] Enter the filesystem path to the JDBC driver jar
[/tmp/seam/lib/hsqldb.jar] [/tmp/seam/lib/hsqldb.jar]

[input] Enter JDBC driver class for your database [org.hsqldb.jdbcDriver]
[org.hsqldb.jdbcDriver]

[input] Enter the JDBC URL for your database [jdbc:hsqldb:.]
[jdbc:hsqldb:.]

[input] Enter database username [sa] [sa]

[input] Enter database password [] []

[input] Enter the database schema name (it is OK to leave this blank) [] []

[input] Enter the database catalog name (it is OK to leave this
blank) [] []

[input] Are you working with tables that already exist in the database? [n]
(y, [n])

[input] Do you want to drop and recreate the database tables and data in
import.sql each time you deploy? [n] (y, [n])

[propertyfile] Creating new property file:
/home/mnovotny/workspaces/jboss/jboss-seam/seam-gen/build.properties
[echo] Installing JDBC driver jar to JBoss server
[copy] Copying 1 file to
/home/mnovotny/workspaces/jboss/jboss-seam/seam-gen/C:/Program
Files/jboss-4.2.3.GA/server/default/lib
[echo] Type 'seam create-project' to create the new project

BUILD SUCCESSFUL
Total time: 4 minutes 5 seconds

プロジェクトを作成するためには、$ ./seam new-project と入力してください。そして cd /projects/seamgen_example と入力して新しく作成されたディレクトリへ移動してください。

生成されたプロジェクトに変更を行う必要があります。

resources/META-INF/persistence-dev.xml
resources/GlassfishDerbyDialect.class

他のサンプルと同様に、データベースサポートのためのこのクラスを含める必要があります。jpa サンプルから seamgen_example/resources ディレクトリへコピーしてください。 

$ cp \ 
$SEAM_DIST/examples/jpa/resources-glassfish/WEB-INF/classes/GlassfishDerbyDialect.class \ 
./resources
resources/META-INF/jboss-app.xml

JBoss AS にはデプロイしないのでこのファイルを削除できます (JBoss AS では jboss-app.xml を使用して、クラスローディングの分離を有効にします)

resources/*-ds.xml

JBoss AS にはデプロイしないのでこのファイルを削除できます (これらのファイルは、JBoss AS ではデータソースを定義していますが、GlassFish ではデフォルトのデータソースを使用しています)

resources/WEB-INF/components.xml

  • コンテナ管理トランザクション統合を有効にします - <transaction:ejb-transaction/> コンポーネントと、その名前空間宣言 xmlns:transaction="http://jboss.com/products/seam/transaction" を追記してください

  • Alter the jndi-pattern to java:comp/env/seamgen_example/#{ejbName}

resources/WEB-INF/web.xml

As with the jee5/booking example, we need to add EJB references to web.xml. Technically, the reference type is not required, but we add it here for good measure. Note that these references require the presence of an empty local-home element to retain compatibility with a JBoss AS 4.x deployment. 


<ejb-local-ref>              

    <ejb-ref-name>seamgen_example/AuthenticatorAction</ejb-ref-name>                

    <ejb-ref-type>Session</ejb-ref-type>     

    <local-home/>

    <local>org.jboss.seam.tutorial.glassfish.action.Authenticator</local>  

  </ejb-local-ref>

   

  <ejb-local-ref>

    <ejb-ref-name>seamgen_example/EjbSynchronizations</ejb-ref-name>  

    <ejb-ref-type>Session</ejb-ref-type>

    <local-home/>

    <local>org.jboss.seam.transaction.LocalEjbSynchronizations</local>

  </ejb-local-ref>

Keep in mind that if you are deploying to JBoss AS 4.x, and have defined the EJB references shown above in your web.xml, you will need to also define local JNDI names for each of them in jboss-web.xml, as shown below. This step is not required when deploying to GlassFish, but it's mentioned here in case you are also deploying the application to JBoss AS 4.x (not required for JBoss AS 5). 


<ejb-local-ref>              

    <ejb-ref-name>seamgen_example/AuthenticatorAction</ejb-ref-name>                

    <local-jndi-name>AuthenticatorAction</local-jndi-name>  

  </ejb-local-ref>

   

  <ejb-local-ref>

    <ejb-ref-name>seamgen_example/EjbSynchronizations</ejb-ref-name>  

    <local-jndi-name>EjbSynchronizations</local-jndi-name>

  </ejb-local-ref>

既存の Authenticator Seam POJO コンポーネントを利用して、EJB3 を作成します。 

  1. @Name("authenticator") 

    @Stateless

    public class AuthenticatorAction implements Authenticator {
    @Local

    public interface Authenticator { 


       public boolean authenticate(); 

    }

  2. すでに web.xml ファイルには EJB 参照を追加したので、次に進めます。

このアプリケーションは、jee5/booking サンプルと同様の変更が必要となります。