Language:
Format:

移行ガイド

JBoss Enterprise Application Platform 6

JBoss Enterprise Application Platform 6 向け

エディッション 2

Sande Gilda

Eamon Logue

Darrin Mison

David Ryan

Misty Stanley-Jones

Keerat Verma

Tom Wells

法律上の通知

概要

本書は、以前のバージョンの JBoss Enterprise Application Platform よりアプリケーションを移行するためのガイドになります。

前書き

1. 表記方法

本ガイドは特定の単語や語句を強調したり、記載内容の特定部分に注意を引かせる目的で次のような表記方法を使用しています。

PDF版および印刷版では、 Liberation Fonts セットから採用した書体を使用しています。ご使用のシステムに Liberation Fonts セットがインストールされている場合、 HTML 版でもこのセットが使用されます。インストールされていない場合は代替として同等の書体が表示されます。注記: Red Hat Enterprise Linux 5 およびそれ以降のバージョンにはデフォルトで Liberation Fonts セットが収納されます。

1.1. 印刷における表記方法

特定の単語や語句に注意を引く目的で 4 種類の表記方法を使用しています。その表記方法および適用される状況は以下の通りです。

等幅の太字

シェルコマンド、ファイル名、パスなどシステムへの入力を強調するために使用しています。またキー配列やキーの組み合わせを強調するのにも使用しています。例えば、

現在作業中のディレクトリ内のファイル my_next_bestselling_novel の内容を表示させるには、シェルプロンプトで cat my_next_bestselling_novel コマンドを入力してから Enter を押してそのコマンドを実行します。

上記にはファイル名、シェルコマンド、キーが含まれています。すべて等幅の太字で表されているため文中内で見分けやすくなっています。

キーが 1 つの場合と複数のキーの組み合わせになる場合を区別するため、その組み合わせを構成するキー同士をハイフンでつないでいます。例えば、

Enter を押してコマンドを実行します。
Press Ctrl+Alt+F2 to switch to a virtual terminal.

最初の段落では押すべき 1 つのキーを特定して強調しています。次の段落では同時に押すべき 3 つのキーの組み合わせが 2 種類ありそれぞれ強調されています。

ソースコードの説明では 1 段落内で提示されるクラス名、メソッド、関数、変数名、戻り値を上記のように 等幅の太字 で表示します。例えば、

ファイル関連のクラス群はファイルシステムに対しては filesystem、ファイルには file、ディレクトリには dir をそれぞれ含みます。各クラスは個別に関連する権限セットを持っています。

プロポーショナルの太字

アプリケーション名、ダイアログボックスのテキスト、ラベル付きボタン、チェックボックスとラジオボタンのラベル、メニュータイトルとサブメニュータイトルなどシステム上で見られる単語や語句を表します。例えば、

メインメニューバーから システム > 個人設定 > マウス の順で選択し マウスの個人設定 を起動します。 ボタン タブ内で 左ききのマウス チェックボックスをクリックしてから 閉じる をクリックしマウスの主要ボタンを左から右に切り替えます (マウスを左ききの人が使用するのに適した設定にする)。
To insert a special character into a gedit file, choose Applications → Accessories → Character Map from the main menu bar. Next, choose Search → Find… from the Character Map menu bar, type the name of the character in the Search field and click Next. The character you sought will be highlighted in the Character Table. Double-click this highlighted character to place it in the Text to copy field and then click the Copy button. Now switch back to your document and choose Edit → Paste from the gedit menu bar.

上記には、アプリケーション名、システム全体のメニュー名と項目、アプリケーション固有のメニュー名、 GUI インタフェースで見られるボタンやテキストがあります。すべてプロポーショナルの太字で表示されているため文中内で見分けやすくなっています。

等幅の太字で且つ斜体 または プロポーショナルの太字で且つ斜体

等幅の太字やプロポーショナルの太字はいずれであっても斜体の場合は置換可能なテキストか変化するテキストを示します。斜体は記載されている通りには入力しないテキスト、あるいは状況に応じて変化する出力テキストを表します。例えば、

ssh を使用してリモートマシンに接続するには、シェルプロンプトで ssh username@domain.name と入力します。リモートマシンが example.com であり、そのマシンで使用しているユーザー名が john なら ssh john@example.com と入力します。
mount -o remount file-system コマンドは指定したファイルシステムを再マウントします。例えば、 /home ファイルシステムを再マウントするコマンドは mount -o remount /home になります。
現在インストールされているパッケージのバージョンを表示するには、 rpm -q package コマンドを使用します。結果として次を返してきます、 package-version-release。

Note the words in bold italics above — username, domain.name, file-system, package, version and release. Each word is a placeholder, either for text you enter when issuing a command or for text displayed by the system.

タイトル表示のような標準的な使用の他、斜体は新しい重要な用語が初めて出現する場合にも使用されます。例えば、

Publican は DocBook の発行システムです。

1.2. 引用における表記方法

端末の出力とソースコード一覧は、視覚的に周囲の文から区別されています。

端末に送信される出力は mono-spaced roman (等幅の Roman) にセットされるので以下のように表示されます。

books        Desktop   documentation  drafts  mss    photos   stuff  svn
books_tests  Desktop1  downloads      images  notes  scripts  svgs

ソースコードの一覧も mono-spaced roman (等幅の Roman) でセットされますが、以下のように強調表示されます。

package org.jboss.book.jca.ex1;

import javax.naming.InitialContext;

public class ExClient
{
   public static void main(String args[]) 
       throws Exception
   {
      InitialContext iniCtx = new InitialContext();
      Object         ref    = iniCtx.lookup("EchoBean");
      EchoHome       home   = (EchoHome) ref;
      Echo           echo   = home.create();

      System.out.println("Created Echo");

      System.out.println("Echo.echo('Hello') = " + echo.echo("Hello"));
   }
}

1.3. 注記および警告

情報が見過ごされないよう 3 種類の視覚的なスタイルを使用して注意を引いています。

注記

注記は説明している部分に対するヒントや近道あるいは代替となる手段などになります。注記を無視しても悪影響はありませんが知っておくと便利なコツを見逃すことになるかもしれません。

重要

重要ボックスは見逃しやすい事項を詳細に説明しています。現在のセッションにのみ適用される設定上の変更点、更新を適用する前に再起動が必要なサービスなどがあります。重要ボックスを無視してもデータを喪失するような結果にはなりませんがイライラ感やフラストレーションが生じる可能性があります。

警告

警告は無視しないでください。警告を無視するとデータを喪失する可能性が非常に高くなります。

第1章はじめに

1.1. 移行ガイドについて

JBoss Enterprise Application Platform 6 は Java Enterprise Edition 6 仕様の軽量で高速な実装です。アーキテクチャーはモジュラーサービスコンテナ上に構築され、アプリケーションが必要な時にサービスをオンデマンドで有効にします。この新しいアーキテクチャーにより、JBoss Enterprise Application Platform 5 で実行されるアプリケーションを JBoss Enterprise Application Platform 6 で実行するには変更が必要になる場合があります。

本ガイドは、Enterprise Application Platform 5.1 のアプリケーションを Enterprise Application Platform 6 で正常に実行しデプロイするために必要な変更内容の文書化を目的としています。デプロイメントおよびランタイム時に発生する問題の解決方法や、アプリケーションの挙動が変更されないようにする方法が記載されています。これは新しいプラットフォームへ移行する最初の一歩となります。アプリケーションが正常にデプロイされ実行されたら、 JBoss Enterprise Application Platform 6 の新機能を使用するよう各コンポーネントのアップグレードを計画することができます。

JNDI 名前空間	詳細
java:global	この名前空間の名前はアプリケーションサーバーインスタンス内にデプロイされている全アプリケーションで共有されます。この名前空間の名前を使いリモートの EJB を検索します。以下は java:global 名前空間の例になります。 `java:global/jboss-seam-booking/jboss-seam-booking.jar/HotelBookingAction`
java:module	この名前空間の名前は、1 つの EJB モジュールにある全エンタープライズ Bean や Web モジュールにある全コンポーネントなど、モジュール内の全コンポーネントで共有されます。 java:module 名前空間の例は次の通りです。 `java:module/HotelBookingAction!org.jboss.seam.example.booking.HotelBooking`
java:app	この名前空間の名前は、１つのアプリケーション内にある全モジュールのコンポーネントすべてで共有されます。例えば、同じ EAR ファイルにある WAR や EJB jar ファイルは java:app namespace のリソースにアクセスできます。以下は java:app 名前空間の例になります。 `java:app/jboss-seam-booking.jar/HotelBookingAction`

JBoss Enterprise Application Platform 5.x の名前空間	JBoss Enterprise Application Platform 6 の名前空間	追加コメント
OrderManagerApp/ProductManagerBean/local	java:module/ProductManagerBean!services.ejb.ProductManager	EE6 標準のバインディング、同じモジュール内でのみアクセス可能
OrderManagerApp/ProductManagerBean/local	java:app/OrderManagerEJB/ProductManagerBean!services.ejb.ProductManager	EE6 標準のバインディング、同じアプリケーション内でのみアクセス可能
OrderManagerApp/ProductManagerBean/local	java:global/OrderManagerApp/OrderManagerEJB/ProductManagerBean!services.ejb.ProductManager	EE6 標準のバインディング、グローバルにアクセス可能
java:comp/UserTransaction	java:comp/UserTransaction	アプリケーションが直接作成するスレッドなど、EE 以外のスレッド対してアクセス可能
java:comp/UserTransaction	java:jboss/UserTransaction	グローバルにアクセス可能。java:comp/UserTransaction を利用できない場合に使用。
java:/TransactionManager	java:jboss/TransactionManager
java:/TransactionSynchronizationRegistry	java:jboss/TransactionSynchronizationRegistry

プロパティ名	デフォルト値	目的
`hibernate.id.new_generator_mappings`	true	`@GeneratedValue(AUTO)` を使用して新しいエンティティに対して一意のインデックスキーを生成する場合にこの設定は有効です。新規のアプリケーションのデフォルト値は`true` になるはずです。Hibernate 3.3.x を使用した既存のアプリケーションが継続してシーケンスオブジェクトやテーブルベースのジェネレーターを使用し、後方互換性を維持するにはデフォルト値 `false` に変更する必要がある場合があります。アプリケーションは `persistence.xml` ファイルにあるこの値を上書きすることが可能です。詳細は以下を参照してください。
`hibernate.transaction.jta.platform`	`hibernate.ejb.resource_scanner` `org.hibernate.service.jta.platform.spi.JtaPlatform` インターフェースのインスタンス	このクラスはトランザクションマネージャーやユーザーのトランザクション、トランザクション同期化レジストリを Hibernate に渡します。
`hibernate.ejb.resource_scanner`	`org.hibernate.ejb.packaging.Scanner` インターフェースのインスタンス	このクラスは JBoss Enterprise Application Platform のアノテーションインデクサーを使用してより高速なデプロイメントを提供する方法を認識しています。
`hibernate.transaction.manager_lookup_class`		このプロパティは `hibernate.transaction.jta.platform` と競合することがあるため、persistence.xml に存在する場合は削除されます。
`hibernate.session_factory_name`	QUALIFIED_PERSISTENCE_UNIT_NAME	アプリケーション名 + 永続ユニット名に設定されます。アプリケーションは異なる値を指定することができますが JBoss Enterprise Application Platform インスタンス上のすべてのアプリケーションデプロイメントで一意となる値でなければなりません。
`hibernate.session_factory_name_is_jndi`	false	アプリケーションが `hibernate.session_factory_name` の値を指定しなかった場合のみ設定されます。
`hibernate.ejb.entitymanager_factory_name`	QUALIFIED_PERSISTENCE_UNIT_NAME	アプリケーション名 + 永続ユニット名に設定されます。アプリケーションは異なる値を指定することができますが JBoss Enterprise Application Platform インスタンス上のすべてのアプリケーションデプロイメントで一意となる値でなければなりません。

以前の DTD 名前空間	新しい DTD 名前空間
http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd	http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd
http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd	http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd

Language and Page Formatting Options

移行ガイド

JBoss Enterprise Application Platform 6 向け

Sande Gilda

Eamon Logue

Darrin Mison

David Ryan

Misty Stanley-Jones

Keerat Verma

Tom Wells

前書き

1. 表記方法

1.1. 印刷における表記方法

1.2. 引用における表記方法

1.3. 注記および警告

第1章 はじめに

1.1. 移行ガイドについて

第2章 移行の準備

2.1. 移行の準備

2.2. JBoss Enterprise Application Platform 6 の新機能と変更内容

第3章 アプリケーションの移行

3.1. ほとんどのアプリケーションで必要な変更

3.1.1. ほとんどのアプリケーションで必要な変更の確認

3.1.2. クラスローディングの変更

3.1.2.1. クラスローディングの変更によるアプリケーションの更新

3.1.2.2. モジュールの依存関係を理解する

3.1.2.3. クラスローディングの変更によるアプリケーション依存関係の更新

3.1.3. 設定ファイルの変更

3.1.3.1. JBoss Enterprise Application Platform 6 のクラスローディングを制御するファイルの作成または変更

3.1.3.2. Jboss-deployment-structure.xml

3.1.3.3. 新しいモジュラークラスローディングシステムのパッケージリソース

3.1.3.4. ResourceBundle プロパティーの場所変更

3.1.3.5. カスタムモジュールの作成

3.1.4. ロギングの変更

3.1.4.1. ロギング依存関係の編集

3.1.4.2. サードパーティーロギングフレームワークのアプリケーションコードの更新

3.1.4.3. 新しい JBoss ロギングフレームワークを使用したコードの変更

3.1.5. アプリケーションパッケージの変更

3.1.5.1. EAR および WAR パッケージの編集

3.1.6. データソースおよびリソースアダプター設定の変更

3.1.6.1. 設定変更によるアプリケーションの更新

3.1.6.2. DataSource 設定の更新

3.1.6.3. JDBC ドライバーのインストールと設定

3.1.6.4. Hibernate または JPA に対するデータソースの設定

3.1.6.5. リソースアダプター設定の更新

3.1.7. セキュリティーの変更

3.1.7.1. アプリケーションセキュリティーの変更設定

3.1.8. JNDI の変更

3.1.8.1. アプリケーションの JNDI 名前空間名の更新

3.1.8.2. 移植可能な JNDI ネーミング構文

3.1.8.3. JNDI 名前空間のルールの確認

3.1.8.4. 新しい JNDI 名前空間ルールに準拠するようアプリケーションを変更する

3.1.8.5. 以前のリリースにおける JNDI 名前空間の例、また JBoss Enterprise Application Platform 6 での名前空間の指定方法

3.2. アプリケーションのアーキテクチャーやコンポーネントによって異なる変更

3.2.1. アプリケーションのアーキテクチャーやコンポーネントによって異なる変更の確認

3.2.2. Hibernate および JPA の変更

3.2.2.1. Hibernate や JPA を使用するアプリケーションの更新

3.2.2.2. Hibernate および JPA を使用するアプリケーションの変更設定

3.2.2.3. Hibernate JPA 永続ユニットプロパティ

3.2.2.4. Hibernate 4 を使用するよう Hibernate 3 のアプリケーションを更新する

3.2.2.5. Hibernate アイデンティティの自動生成値の既存動作を保持する

3.2.2.6. Hibernate 3.3.x アプリケーションの Hibernate 4.x への移行

3.2.2.7. Hibernate 3.5.x アプリケーションの Hibernate 4.x への移行

3.2.2.8. クラスター環境で稼働する、移行された Seam および Hibernate アプリケーションの永続プロパティーの変更

3.2.2.9. JPA 2.0 の仕様に準拠するようアプリケーションを更新する

3.2.2.10. Infinispan による JPA/Hibernate 2 次キャッシュの置き換え

3.2.2.11. Hibernate キャッシュプロパティー

3.2.2.12. Hibernate Validator 4 への移行

3.2.3. JAX-RS および RESTEasy の変更

3.2.3.1. JAX-RS および RESTEasy の変更の設定

3.2.4. LDAP セキュリティーレルムの変更

3.2.4.1. LDAP セキュリティーレルムの変更設定

3.2.5. HornetQ の変更

3.2.5.1. 既存の JMS メッセージを Enterprise Application Platform 6 へ移行するため JMS ブリッジを設定する

3.2.5.2. HornetQ を JMS プロバイダーとして使用するためにアプリケーションを移行

3.2.5.3. HornetQ でのメッセージングの設定

3.2.6. クラスタリングの変更

3.2.6.1. クラスタリングに対するアプリケーションの変更

3.2.6.2. HA シングルトンの実装

3.2.7. サービススタイルデプロイメントの変更

第1章はじめに

第2章移行の準備

第3章アプリケーションの移行