You are viewing a plain text version of this content. The canonical link for it is here.
Posted to scm@geronimo.apache.org by bu...@apache.org on 2020/05/31 19:13:35 UTC
svn commit: r1061327 [3/8] - in /websites/production/geronimo/content:
GMOxDEV/ GMOxDOC10/ GMOxDOC11/ GMOxDOC12/ GMOxDOC20/ GMOxDOC20ja/
GMOxDOC21/ GMOxDOC22/ GMOxDOC30/ GMOxKB/ GMOxPMGT/ GMOxSBOX/ cache/ doc/
gshell/
Modified: websites/production/geronimo/content/GMOxDOC20ja/42-jboss-to-geronimo-ejb-bmp-.html
==============================================================================
--- websites/production/geronimo/content/GMOxDOC20ja/42-jboss-to-geronimo-ejb-bmp-.html [UTF-8] (original)
+++ websites/production/geronimo/content/GMOxDOC20ja/42-jboss-to-geronimo-ejb-bmp-.html [UTF-8] Sun May 31 19:13:32 2020
@@ -103,21 +103,21 @@
<div class="pagecontent">
<div class="wiki-content">
<div class="wiki-content maincontent">
-<p><span class="confluence-anchor-link" id="id-4.2.JBosstoGeronimo-EJB-BMP移行-top"></span><br clear="none">
+<p><span class="confluence-anchor-link" id="id-4.2.JBosstoGeronimoEJBBMP移行-top"></span><br clear="none">
エンティティー・ビーンは、データベースから読み込むことができ、複数のフィールドをデータで埋めているような、永続化された情報を表現するものとして定義されています。エンティティ・ビーンは、更新されたり、データベースへ書き戻されたりすることも可能です。エ}
31;ティティー・ビーンには2種類あります。BMP(Bean-Managed Persistence) と CMP(Container-Managed Persistence) です。この文書では、BMP サンプル・アプリケーションの移行について取り扱います。この種のエンティティー・ビーンでは、読込や保存、データの検索といった永続化操作を実行するために、実際にコードを書かなけ
2428;ばいけません。例えば、データベースに対して、select、insert、update、delete を実行する JDBC のような永続化 API を、開発者は使用する必要があります。</p>
<p>この文書は、次のセクションで構成されています:</p>
<ul><li><a shape="rect" href="42-jboss-to-geronimo-ejb-bmp-.html">BMP 実装の分析</a></li><li><a shape="rect" href="42-jboss-to-geronimo-ejb-bmp-.html">サンプル・アプリケーション</a></li><li><a shape="rect" href="42-jboss-to-geronimo-ejb-bmp-.html">JBoss 環境</a></li><li><a shape="rect" href="42-jboss-to-geronimo-ejb-bmp-.html">Geronimo 環境</a></li><li><a shape="rect" href="42-jboss-to-geronimo-ejb-bmp-.html">段階的な移行</a></li><li><a shape="rect" href="42-jboss-to-geronimo-ejb-bmp-.html">まとめ</a></li></ul>
-<h1 id="id-4.2.JBosstoGeronimo-EJB-BMP移行-BMP実装の分析analysis">BMP 実装の分析 <span class="confluence-anchor-link" id="id-4.2.JBosstoGeronimo-EJB-BMP移行-analysis"></span></h1>
+<h1 id="id-4.2.JBosstoGeronimoEJBBMP移行-BMP実装の分析analysis">BMP 実装の分析 <span class="confluence-anchor-link" id="id-4.2.JBosstoGeronimoEJBBMP移行-analysis"></span></h1>
<p>BMP 実装はベンダーにより様々でしょう。本セクションの目的は、JBoss v4.0.5 と Apache Geronimo との間の BMP 仕様の機能比較を提供し、移行前の相違点や明確にし、それに応じて計画を立てられるようにします。</p>
<div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p> 機能 </p></th><th colspan="1" rowspan="1" class="confluenceTh"><p> JBoss v4.2.1 </p></th><th colspan="1" rowspan="1" class="confluenceTh"><p> Apache Geronimo </p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> EJB コンテナー </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> JBoss は独自の実装を使用します </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Geronimo は OpenEJB を EJB コンテナーとして使用します </p></td></tr></tbody></table></div>
<p><a shape="rect" href="42-jboss-to-geronimo-ejb-bmp-.html">トップへ戻る</a></p>
-<h1 id="id-4.2.JBosstoGeronimo-EJB-BMP移行-サンプル・アプリケーションsample">サンプル・アプリケーション <span class="confluence-anchor-link" id="id-4.2.JBosstoGeronimo-EJB-BMP移行-sample"></span></h1>
+<h1 id="id-4.2.JBosstoGeronimoEJBBMP移行-サンプル・アプリケーションsample">サンプル・アプリケーション <span class="confluence-anchor-link" id="id-4.2.JBosstoGeronimoEJBBMP移行-sample"></span></h1>
<p>これは、ユーザーにローンを許可し、管理者がローンを承認/拒否する、シンプルなローン登録のアプリケーションです。顧客は、管理者がローンの承認/拒否するためにシンプルな Java アプリケーションを運用している間、Web サイト上でローンを利用可能です。BMP エンティティー・ビ&#
12540;ンは、データベースからローン関連で永続されているデータを管理するために使用されます。それに加え、ステートレス・セッション・ビーンは、ワークフロー関連の状態をハンドルするために使用されます。</p>
@@ -127,7 +127,7 @@
<br clear="none" class="atl-forced-newline">
ローン登録の初期画面は、Webアプリケーションがローンと最新ステータスの一覧を表示する通知ボードとして、振る舞います。顧客がローンを利用する際、登録フォームを利用可能です。ローンの登録後、保留中の間は保持されます。管理者権限を持つマネージャーはローンのス&#
12486;ータスを更新するために、小型のアプリケーションを使用します。当該アプリケーションによって、マネージャーは、ステータスを承認するか拒否するか変更することができます。
<br clear="none" class="atl-forced-newline"></p>
-<h2 id="id-4.2.JBosstoGeronimo-EJB-BMP移行-アプリケーションのクラスとJSPページ">アプリケーションのクラスと JSP ページ</h2>
+<h2 id="id-4.2.JBosstoGeronimoEJBBMP移行-アプリケーションのクラスとJSPページ">アプリケーションのクラスと JSP ページ</h2>
<ul><li>org.apache.geronimo.samples.loan.client
<ul><li>LoanStatusChanger - 貸付の承認手続をするスタンドアローン・アプリケーション。</li></ul>
@@ -146,23 +146,23 @@
<ul><li>error.jsp - 予期せぬ状況を受け取る共通のエラー画面。</li><li>index.jsp - アプリケーションのローン一覧へ転送します。</li><li>list_loans.jsp - ローン一覧とその情報を表示します。</li><li>register_loan.jsp - 顧客が入力するローンの登録フォーム。</li></ul>
-<h2 id="id-4.2.JBosstoGeronimo-EJB-BMP移行-使用したツール">使用したツール</h2>
+<h2 id="id-4.2.JBosstoGeronimoEJBBMP移行-使用したツール">使用したツール</h2>
<p>ローン管理アプリケーションの開発および構築に使用したツールは、以下の通りです:</p>
-<h3 id="id-4.2.JBosstoGeronimo-EJB-BMP移行-Eclipse">Eclipse</h3>
+<h3 id="id-4.2.JBosstoGeronimoEJBBMP移行-Eclipse">Eclipse</h3>
<p>Eclipse IDE を使用してサンプル・アプリケーションは開発されました。非常に強力でポピュラーなオープンソース開発ツールであり、JBoss と Geronimo の両方にとって有効な統合プラグインです。Eclipse は次の URL からダウンロード可能です:<br clear="none">
<a shape="rect" class="external-link" href="http://www.eclipse.org" rel="nofollow">http://www.eclipse.org</a></p>
-<h3 id="id-4.2.JBosstoGeronimo-EJB-BMP移行-ApacheAnt">Apache Ant</h3>
+<h3 id="id-4.2.JBosstoGeronimoEJBBMP移行-ApacheAnt">Apache Ant</h3>
<p>Ant は Pure Java のビルド・ツールです。war ファイルの構築やオンライン仲介業務アプリケーションのデータベースの操作に使用されます。Ant は次の URL からダウンロード可能です:<br clear="none">
<a shape="rect" class="external-link" href="http://ant.apache.org">http://ant.apache.org</a></p>
<p><a shape="rect" href="42-jboss-to-geronimo-ejb-bmp-.html">トップへ戻る</a></p>
-<h1 id="id-4.2.JBosstoGeronimo-EJB-BMP移行-JBoss環境jboss">JBoss 環境 <span class="confluence-anchor-link" id="id-4.2.JBosstoGeronimo-EJB-BMP移行-jboss"></span></h1>
+<h1 id="id-4.2.JBosstoGeronimoEJBBMP移行-JBoss環境jboss">JBoss 環境 <span class="confluence-anchor-link" id="id-4.2.JBosstoGeronimoEJBBMP移行-jboss"></span></h1>
<p>このセクションでは、何処にどのようにして、サンプル JBoss リファレンス環境がインストールされ、シナリオを実装に対応付けるかを示します。この移行例では JBoss v4.1.2 が使用されたことを補足しておきます。</p>
@@ -172,18 +172,18 @@
<ol><li>製品ガイドで説明されているように JBoss v4.2.1 をダウンロードしてインストールします。ここからインストール・ディレクトリーは <jboss_home> として参照されます。</li><li>初期状態の JBoss v4.2.1 アプリケーション・サーバーのコピーを作成します。<strong><jboss_home>\server\default</strong> から <strong><jboss_home>\server\<your_server_name></strong> へ再帰的にコ
500;ーが行われます。</li><li><strong><jboss_home>\bin</strong> ディレクトリーから <strong>run.sh -c <your_server_name></strong> コマンドを実行することによって、新規サーバーを始動します。</li><li>サーバーが始動したら、Webブラウザーを開き URL: <a shape="rect" class="external-link" href="http://localhost:8080" rel="nofollow">http://localhost:8080</a> を指定して、実行していることを確認することが可能です。JBoss コンソ
;ールへアクセス可能な JBoss ウエルカム画面が表示されます。</li><li>アプリケーション・サーバーが実行中であることを確認したら、次の段階は、サンプル・アプリケーションに必要なソフトウェアのインストールと設定です。この段階は次のセクションに記述されています。</li></ol>
-<h2 id="id-4.2.JBosstoGeronimo-EJB-BMP移行-必要なソフトウェアのインストールと設定">必要なソフトウェアのインストールと設定</h2>
+<h2 id="id-4.2.JBosstoGeronimoEJBBMP移行-必要なソフトウェアのインストールと設定">必要なソフトウェアのインストールと設定</h2>
<p>この文書に含まれる Loan BMP アプリケーションをビルドして実行させるために、ビルド・ツールおよびアプリケーションで使用されるデータベースのインストールと設定が必要です。</p>
-<h3 id="id-4.2.JBosstoGeronimo-EJB-BMP移行-データベース設定の変更">データベース設定の変更</h3>
+<h3 id="id-4.2.JBosstoGeronimoEJBBMP移行-データベース設定の変更">データベース設定の変更</h3>
<p>このアプリケーションは JBoss バンドルの一部である HSQL データベースを使用しています。データベースを作成するためのスクリプトを変更する必要があります。<strong><jboss_home>\server\<your_server_name>\data\hypersonic</strong> ディレクトリーにある *localDB.script*ファイルを編集してください:</p>
<p>サンプル HSQL データベースを作成するための次の例の内容を <strong>localDB.script</strong> ファイルの最初に追加してください。また、JBoss 固有データ配下にある <strong>config/db.sql</strong> に指定された同ファイルの終端にサンプルのデータを追加してください。</p>
<div class="confluence-information-macro confluence-information-macro-note"><span class="aui-icon aui-icon-small aui-iconfont-warning confluence-information-macro-icon"></span><div class="confluence-information-macro-body"><p><strong>このファイルを編集する際は JBoss が実行していないことを確認してください。</strong></p></div></div>
-<h3 id="id-4.2.JBosstoGeronimo-EJB-BMP移行-Antの構成">Ant の構成</h3>
+<h3 id="id-4.2.JBosstoGeronimoEJBBMP移行-Antの構成">Ant の構成</h3>
<p>すでに述べたとおり、Apache Ant は Online Brokerage アプリケーションのバイナリーをビルドするために使用されます。まだ Ant をインストールしていなかったら、そのためのよい機会です。さらに、<strong><ant_home>/bin</strong> ディレクトリーがシステムの path 変数に追加されていることも確認してください。</p>
@@ -191,7 +191,7 @@
<p><a shape="rect" class="external-link" href="http://ant.apache.org">http://ant.apache.org</a></p>
-<h3 id="id-4.2.JBosstoGeronimo-EJB-BMP移行-XDocletの構成">XDoclet の構成</h3>
+<h3 id="id-4.2.JBosstoGeronimoEJBBMP移行-XDocletの構成">XDoclet の構成</h3>
<p>XDoclet は、構成ファイル生成のビルド・ツールとして使用します。オープンソースのコード生成エンジンです。Java の 属性指向プログラミングを可能にします。要約すると、Java ソースに対するメタ・データ(属性)を追加することによって、コードに意味を持たせることが可能となること|
34;意味します。<br clear="none">
XDoclet が EJB を作成するツールとして由来したとしても、汎用的なコード生成エンジンへ進化しました。XDoclet は、コアかつ非常に多くのモジュールから構成されます。新種のコンポーネントが必要となる場合、新規モジュールを書くために、かなり一方的です。<br clear="none">
@@ -199,11 +199,11 @@ XDoclet が EJB を作
<p>XDoclet の最新バージョンを解凍し、<strong>build.properties</strong> ファイルに <strong>xdoclet.home</strong> パラメータに設定してください。</p>
-<h2 id="id-4.2.JBosstoGeronimo-EJB-BMP移行-サンプル・アプリケーションのビルド">サンプル・アプリケーションのビルド</h2>
+<h2 id="id-4.2.JBosstoGeronimoEJBBMP移行-サンプル・アプリケーションのビルド">サンプル・アプリケーションのビルド</h2>
<p>この解説に含まれているローン管理アプリケーションでは、当該アプリケーションをビルドするために使用する Ant スクリプトが提供されています。次のリンクからローン・アプリケーションをダウンロードしてください:</p>
-<p><a shape="rect" href="42-jboss-to-geronimo-ejb-bmp-.data/loan.zip?version=1&modificationDate=1209145790000&api=v2" data-linked-resource-id="59672094" data-linked-resource-version="1" data-linked-resource-type="attachment" data-linked-resource-default-alias="loan.zip" data-nice-type="Zip Archive" data-linked-resource-content-type="application/zip" data-linked-resource-container-id="83141" data-linked-resource-container-version="67">Loan</a></p>
+<p><a shape="rect" href="42-jboss-to-geronimo-ejb-bmp-.data/loan.zip?version=1&modificationDate=1209145790000&api=v2" data-linked-resource-id="59672094" data-linked-resource-version="1" data-linked-resource-type="attachment" data-linked-resource-default-alias="loan.zip" data-nice-type="Zip Archive" data-linked-resource-content-type="application/zip" data-linked-resource-container-id="83141" data-linked-resource-container-version="72">Loan</a></p>
<p>zipファイルの解凍後、<strong>loan</strong> ディレクトリーが作成されます。そのディレクトリー内にある build.properties ファイルを開き、次の例で示されているように、あなたの環境に適合するプロパティーを編集してください:</p>
<div class="code panel pdl" style="border-style: solid;border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;border-bottom-style: solid;"><b>build.properties</b></div><div class="codeContent panelContent pdl">
@@ -219,13 +219,13 @@ xdoclet.home=<xdoclet_home>
<p>コマンド・プロンプトまたはシェルから、<strong>loan</strong> ディレクトリーへ移動し、<strong>ant jboss</strong> を実行してください。こうすると、ear ファイルがビルドされ、<strong>releases/jboss</strong> ディレクトリーにそれを直接配置します。</p>
-<h2 id="id-4.2.JBosstoGeronimo-EJB-BMP移行-サンプル・アプリケーションのデプロイ">サンプル・アプリケーションのデプロイ</h2>
+<h2 id="id-4.2.JBosstoGeronimoEJBBMP移行-サンプル・アプリケーションのデプロイ">サンプル・アプリケーションのデプロイ</h2>
<p>サンプル・アプリケーションをデプロイするには、<strong>loan/releases/jboss</strong> フォルダーへ作成された <strong>Loan.ear</strong> を <strong><jboss_home>/server/<your_server_name>/deploy</strong> へコピーしてください。</p>
<p>JBoss がすでに始動していれば、アプリケーションを自動的にデプロイし、始動します。そうでなければ、次回の始動時に、当該アプリケーションはデプロイ、始動されます。</p>
-<h2 id="id-4.2.JBosstoGeronimo-EJB-BMP移行-サンプル・アプリケーションのテスト">サンプル・アプリケーションのテスト</h2>
+<h2 id="id-4.2.JBosstoGeronimoEJBBMP移行-サンプル・アプリケーションのテスト">サンプル・アプリケーションのテスト</h2>
<p>アプリケーションをテスト実行するには、Web ブラウザーを開いて、次の URL へアクセスしてください:</p>
@@ -242,7 +242,7 @@ xdoclet.home=<xdoclet_home>
<a shape="rect" href="42-jboss-to-geronimo-ejb-bmp-.html">トップへ戻る</a></li></ol>
-<h1 id="id-4.2.JBosstoGeronimo-EJB-BMP移行-Geronimo環境geronimo">Geronimo 環境 <span class="confluence-anchor-link" id="id-4.2.JBosstoGeronimo-EJB-BMP移行-geronimo"></span></h1>
+<h1 id="id-4.2.JBosstoGeronimoEJBBMP移行-Geronimo環境geronimo">Geronimo 環境 <span class="confluence-anchor-link" id="id-4.2.JBosstoGeronimoEJBBMP移行-geronimo"></span></h1>
<p>以下の URL より Geronimo をダウンロードし、インストールしてください。</p>
@@ -255,7 +255,7 @@ xdoclet.home=<xdoclet_home>
<br clear="none" class="atl-forced-newline">
<br clear="none" class="atl-forced-newline"></p>
-<h1 id="id-4.2.JBosstoGeronimo-EJB-BMP移行-段階的な移行migration">段階的な移行 <span class="confluence-anchor-link" id="id-4.2.JBosstoGeronimo-EJB-BMP移行-migration"></span></h1>
+<h1 id="id-4.2.JBosstoGeronimoEJBBMP移行-段階的な移行migration">段階的な移行 <span class="confluence-anchor-link" id="id-4.2.JBosstoGeronimoEJBBMP移行-migration"></span></h1>
<p>ローン管理サンプル・アプリケーションをビルドすると、Ant はサンプル・アプリケーションがすでに提供している JBoss の <strong>jboss.xml</strong> および Geronimo の <strong>openejb-jar.xml</strong> の両ディスクリプターをパッケージングします。これらのファイルは <strong>loan/config</strong> ディレクトリーに配置されています。</p>
@@ -370,7 +370,7 @@ xdoclet.home=<xdoclet_home>
</div></div>
<p><strong>jboss-web.xml</strong> は、上記で指定された JNDI 名を使用している EJB と対応付けられ、<strong>geronimo-web.xml</strong> は EJB 名を直接使用します。互いにマッピングされているリファレンス名は、サーブレットから EJB を参照するために使用されます。WAR ファイルにある <strong>web.xml</strong> ファイルには、各 EJB リファレンス名に関するよ&
#12426;詳細な情報を含んでいます。それは、このアプリケーションにおける Geronimo および JBoss の特徴に対する共通点です。</p>
-<h2 id="id-4.2.JBosstoGeronimo-EJB-BMP移行-サンプル・アプリケーションのビルド.1">サンプル・アプリケーションのビルド</h2>
+<h2 id="id-4.2.JBosstoGeronimoEJBBMP移行-サンプル・アプリケーションのビルド.1">サンプル・アプリケーションのビルド</h2>
<p><strong>loan</strong> ディレクトリーから以下のコマンドを実行し、移行されたサンプル・アプリケーションの Geronimo バージョンをビルドしてください。</p>
@@ -378,24 +378,24 @@ xdoclet.home=<xdoclet_home>
<p><strong>loan/releases/geronimo</strong> フォルダーに <strong>Loan.ear</strong> が作成されます。</p>
-<h2 id="id-4.2.JBosstoGeronimo-EJB-BMP移行-移行されたアプリケーションのデプロイ">移行されたアプリケーションのデプロイ</h2>
+<h2 id="id-4.2.JBosstoGeronimoEJBBMP移行-移行されたアプリケーションのデプロイ">移行されたアプリケーションのデプロイ</h2>
<p>移行されたローン管理サンプル・アプリケーションをデプロイするには、Geronimo サーバーが始動され実行中であること、さらに、ユーザーがデータベースを操作しなければならないことを確認してください。その後、サンプル・アプリケーションをデプロイしてください。</p>
-<h3 id="id-4.2.JBosstoGeronimo-EJB-BMP移行-データベースの操作">データベースの操作</h3>
+<h3 id="id-4.2.JBosstoGeronimoEJBBMP移行-データベースの操作">データベースの操作</h3>
<p>このサンプル・アプリケーションでは、アプリケーション専用データを保持するための Geronimo システム・データベースをデフォルトで使用します。<br clear="none">
Geronimo コンソールより、以下の手順にしたがってください。</p>
<ol><li>左側のコンソール・ナビゲーションから DB Manager リンクを選択します。</li><li><strong>Use DB</strong> 欄に対して <strong>SystemDatabase</strong> を選択します。</li><li>テキスト・エディターから <strong>loan/config</strong> ディレクトリーにある <strong>db.sql</strong> を開き、下側にある Geronimo Specific Database SQL 欄に当該ファイルの中身をコピーします。</li><li>指定された上記の SQL コマ&
#12531;ドの中身をテキストエリアに貼り付けし、Run SQL ボタンを押下します。</li></ol>
-<h3 id="id-4.2.JBosstoGeronimo-EJB-BMP移行-サンプル・アプリケーションのデプロイ.1">サンプル・アプリケーションのデプロイ</h3>
+<h3 id="id-4.2.JBosstoGeronimoEJBBMP移行-サンプル・アプリケーションのデプロイ.1">サンプル・アプリケーションのデプロイ</h3>
<p>ブラウザーより Geronimo コンソールを開き、以下の手順にしたがってください:</p>
<ol><li><strong>Console Navigation</strong> パネルから <strong>Deploy New</strong> まで下へスクロールさせます。</li><li><strong>loan/releases/geronimo</strong> フォルダーから <strong>loan.ear</strong> を <strong>Archive</strong> 入力欄に 指定します。</li><li><strong>Install</strong> ボタンを押下し、サーバーに対してアプリケーションをデプロイします。</li></ol>
-<h2 id="id-4.2.JBosstoGeronimo-EJB-BMP移行-サンプル・アプリケーションのテスト実行">サンプル・アプリケーションのテスト実行</h2>
+<h2 id="id-4.2.JBosstoGeronimoEJBBMP移行-サンプル・アプリケーションのテスト実行">サンプル・アプリケーションのテスト実行</h2>
<p>アプリケーションをテスト実行するには、Web ブラウザーを開いて、以下の URL へアクセスしてください。</p>
@@ -412,7 +412,7 @@ Geronimo コンソー
<br clear="none" class="atl-forced-newline">
<br clear="none" class="atl-forced-newline"></p>
-<h1 id="id-4.2.JBosstoGeronimo-EJB-BMP移行-まとめsummary">まとめ <span class="confluence-anchor-link" id="id-4.2.JBosstoGeronimo-EJB-BMP移行-summary"></span></h1>
+<h1 id="id-4.2.JBosstoGeronimoEJBBMP移行-まとめsummary">まとめ <span class="confluence-anchor-link" id="id-4.2.JBosstoGeronimoEJBBMP移行-summary"></span></h1>
<p>この文書は、BMP エンティティー・ビーンを使用しているサンプル・アプリケーションの JBoss v4.2.1 から Apache Geronimo への移行方法を記述しています。アプリケーションのビルド、配置、稼動の段階的な説明にしたがって Geronimo 環境へ移行してください。</p>