Eclipseを起動します。

Eclipse Workspace Launcherが表示されます。 ワークスペースの場所を選択します （例：D:\oracle\tutorial。 以降、この場所を$WORKSPACEと 呼びます）。

「OK」をクリックします。

Eclipseワークスペースを開いた状態で、Welcome画面を終了します。

Eclipseのソフトウェア更新機能にアクセスします。 Helpメニューから「Software Updates」を選択します。

「Available Software」タブをクリックし、「Add Site」 をクリックします。

URLとしてhttp://download.oracle.com/otn_software/oepe/ganymedeを 入力します。 「OK」をクリックします。

注：Oracle Enterprise Pack for Eclipseについて詳しくは、こちらを参照してください。

新しく追加されたサイトを開き、「Oracle Enterprise Pack for Eclipse」 のチェック・ボックスを選択します。 すべてのサブコンポーネントが選択されていることを確認し、「Install」 をクリックします。

Install画面で「Next」をクリックします。

Review Licenses画面でライセンス条件を受け入れ、「Finish」 をクリックします。

インストールが終わると、プロセスを完了するためのダイアログ・ボックスが表示されます。 「Yes」 をクリックして、Eclipseを再起動します。 プロンプトが表示されたら、チュートリアル用のワークスペースをもう一度開きます。

プロジェクト名としてSimpleCacheAppと 入力したら、Target Runtimeの横にある「New」ボタンをクリックします。

タイプとして「Oracle」→「Oracle WebLogic Server 10gR3」を選択し、「Next」をクリックします。

WebLogic Server Home（$MIDDLEWARE_HOME\wlserver_10.3） を選択し、「Finish」をクリックします。

Dynamic Runtime Module versionが自動的に2.5に更新され、ConfigurationにはDefault Configuration for Oracle WebLogic Server 10gR3が設定されます。

この画面で構成を追加する必要はありません。 「Finish」をクリックします。

Project Explorerで「SimpleCacheApp」を右クリックし、「Properties」 を選択します。

「Java Build Path」カテゴリを選択し、「Libraries」 タブをクリックします。 「Add Library」をクリックします。

「User Library」を選択し、「Next」をクリッ クします。

「User Libraries」ボタンをクリックします。

User Librariesで「New」ボタンをクリックし ます。

ライブラリ名としてCoherenceと 入力したら、「OK」をクリックします。

「Add JARs」ボタンをクリックします。

$COHERENCE_HOME/libフォルダを参照します。 「coherence.jar」ファイルを選択し、「Open」 をクリックします。

「OK」→「Finish」の順にクリックし、もう一度「OK」 をクリックします。 Coherenceライブラリがプロジェクトに追加されました。

Coherenceライブラリを追加するには、次の方法があります。

• アプリケーション・サーバーのシステム・クラスパス・ライブラリとして追加する方法（このチュートリアルで詳しく説明されていま す）。 この方法では、ドメインのlibフォルダにcoherence.jarファイルを追加 します。 こうすることで、デプロイされたすべてのアプリケーションから、自動的にすべてのCoherenceクラスを使用できるようになります。
• アプリケーションにバンドルされたライブラリとして追加する方法。この方法では、プロジェクトのWEB-INF/libライブラ リにcoherence.jarファイルを追加します。この場合、Coherenceを使用す るアプリケーションごとに、それぞれ独自のcoherence.jarコピーを作成する必要があります。
• 共有ライブラリとして追加する方法。この方法では、WebLogic Serverの共有ライブラリとしてcoherence.jarファイルを配置し、各アプリケーションのweblogic-application.xmlまたはweblogic.xmlか らこのファイルを参照します。 この場合、Coherenceを使用するすべてのデプロイメントでこのライブラリを参照する必要があります。

$COHERENCE_HOME/libフォ ルダから$DOMAIN_HOME/WLS_A/libフォルダへ、coherence.jarファイルをコピーします。

注：ドメインのlibフォ ルダに追加されたJARファイルは、自動的にドメインのクラスパスに追加されるため、ドメイン内にデプロイされたすべてのアプリケーションからアクセスで きます。

Eclipseウィンドウの下部にある「Servers」ビューを選択します。 ビューの内側を右クリックし、「New」→「Server」の順に選択します。

サーバーのホスト名（localhost）、サーバー・タイプ（Oracle WebLogic Server 10gR3）、およびサーバーのランタイムについてデフォルトを受け入れます。 サー バー名をOracle WebLogic Server Aに変更します。 「Next」をクリックします。

再度、名前をOracle WebLogic Server Aに変更し、 先ほど作成したドメイン・ディレクトリ（$DOMAIN_HOME/WLS_A）を参照しま す。 「Finish」をクリックします。

$DOMAIN_HOME/WLS_AディレクトリにあるstartWebLogic.cmdスクリプトを使用して、ドメインを開始します。 サーバーが稼働中であることを確認します。 Eclipseウィンドウのサーバー・ステータスにはStartedが表示されます。

Oracle WebLogic ServerにプロジェクトをデプロイするためのEclipseの設定は完了しました。 後続の手順では、サーバー構成にプロジェクトを追加すると、Oracle Enterprise Pack for Eclipseによってデプロイが実行されます。

Project Explorerで、「SimpleCacheApp」を開きます。 「Java Resources」ノードを右クリックして、「New」→「Servlet」 の順に選択します。

パッケージにobe.coherenceを指定し、クラス名としてSimpleCacheTest1を入力します。 「Next」 をクリックします。

Initialization ParametersとURL Mappingsのデフォルト値を受け入れ、「Next」 をクリックします。

「doPost」の選択を解除したら、残りすべてのデフォルト値を受け入れて、 「Finish」 をクリックします。

以下を実行するdoGet()メソッドをコーディングします。

• Coherenceクラスタに接続します。
• 名前付きキャッシュ"mycache"にアクセスします。
• キー"greeting"を使用して、キャッシュから値を取得します。
• サーバー・コンソールとWebブラウザに値を出力します。

次のコードを使用して、Coherenceキャッシュに接続します。

CacheFactory.ensureCluster();

コードを追加すると、はじめはCacheFactoryに赤い下線が表示さ れます。これは、CacheFactoryクラスをインポートする必要があるためです。 クラスパスに含まれるCacheFactoryは1つだけであるため（coherence.jarから生成されたcom.tangosol.net.CacheFactory）、インポートは自動的に実行されます。

また、CacheFactory宣言の後に"."と入力すると、Eclipseのコード補完ボックスが開き、このクラスで使用できるすべてのメソッド が表示されます。

CacheFactoryを使用して、mycacheという名前のキャッシュに接続します。

NamedCache cache = CacheFactory.getCache("mycache");

NamedCacheには複数の候補があるため、今回は自動的にインポートされません。 左の余白に表示された赤色の ×印をクリックし、「Import ‘NamedCache’ (com.tangosol.net)」 を選択します。 このインポート文が、ソース・コードの最上部に追加されます。

"greeting"というキーを使用してキャッシュから値を取得し、Stringとして保管します。

String cachedValue = (String) cache.get("greeting");

注：キャッシュ対象のオブジェクトはシリアライズ可能なオブジェクトでなければなりません。 Stringは、シリアライズ可能なオブジェクトとして自動的に実装されます。

次のコードを使用して、サーバー・コンソールとブラウザにこの値を出力します。

         // Output this value to the server console
         System.out.println("Value retrieved from cache: " + cachedValue);
   
         // Output this value to the browser that called this servlet.
         response.setContentType("text/html; charset=ISO-8859-1");
         PrintWriter out = response.getWriter();
         out.println("<html>");
         out.println("<head><title>SimpleCacheTest</title></head>");
         out.println("<body>");
         out.println("<p><br>The value from the Coherence Cache is : " + cachedValue + "</p>");
         out.println("</body></html>");
         out.close();

ステップ7以降の手順を繰り返し、必要なクラスをすべてインポートします。

コードを保存します。

コードにエラーが含まれていないことを確認します （ソース・ビューの余白に表示される赤い印を確認します）。

あらかじめ起動されている場合を除いて、Coherenceキャッシュ・サーバー・インスタンス、Coherenceシェル・クライア ント・インスタンス、WebLogic Serverドメインを起動します。 起動時にエラーが発生していないことを確認します。

Coherenceキャッシュ・サーバーを起動するには、$COHERENCE_HOME/bin/cache-server.cmdを 実行します。.

Coherenceシェル・クライアントを起動するには、$COHERENCE_HOME/bin/coherence.cmdを 実行します。.

WebLogic Serverドメインを起動するには、$DOMAIN_HOME/WLS_A/startWebLogic.cmdを 実行します。.

Coherenceシェル・クライアントから"mycache"キャッ シュに接続します。

Map (?): cache mycache

このキャッシュのXMLスキーマがクライアントに表示されます。 また、Coherence Shellウィンドウには、短時間に多数のアクティビティが表示されます。

キャッシュに値を入力します。 Coherenceシェル・クライアントを使用し、greeting というキーと helloという値を入力して値を作成します。

Map (mycache): put greeting hello

クライアントには、応答としてnullが返されます。

WebLogic Serverにプロジェクトをデプロイします。 EclipseのServersビュー で「Oracle WebLogic Server」エントリを右クリックし、「Add and Remove Projects」を選択します。

Configured projectsへSimpleCacheAppを 追加し、「Finish」をクリックします。

Eclipseによって、WebLogic Serverにアプリケーションがデプロイされます。 サーバー・エントリのステータスが"Synchronized"になっており、WebLogic Serverコンソール・ウィンドウにエラーが表示されていないことを確認します。

Project Explorerで「SimpleCacheTest1」（SimpleCacheApp\Java Resources\src\obe.coherenceの 下）を右クリックし、「Run As」→「Run on Server」の順に選 択します。

Run On Serverダイアログで「Finish」をクリックします。

サーブレットがロードされ、アクセス用のEclipseテスト・ブラウザが起動される間に、doGet()メ ソッドがコールされ、サーブレットがCoherenceキャッシュに接続します（Coherence関連情報がWebLogic Serverウィンドウに表示され、Coherenceキャッシュ・サーバー・ウィンドウにアクティビティが表示されます）。 WebLogic ServerウィンドウとEclipseテスト・ブラウザの両方に、Coherenceシェル・クライアントから入力した値が表示されることを確認しま す。

Coherenceクライアント・シェルを使用して値を変更します。

put greeting howdy

Eclipseテスト・ブラウザの「Refresh」アイコンをクリックしてサーブレットを再実行 します。 更新された値がすぐにテスト・ブラウザに表示されます。

オプション課題：もとの値を取得して表示した後で、greetingに対する値を変更するように サーブレットを更新します。

どのようにこれを実現すれば良いでしょうか（ヒント：Coherenceクライアントで使用するコ マンドは何でしょうか。 NamedCacheオブジェクトで使用できるメソッドに、これと似たものはないでしょうか）。

変更を行った後で、Eclipseのサーバー・エントリ・ステータスがRepublishに変わることに注意してください。 これは、コードとデプロイ済みアプリケーション間で同期が取れておらず、アプリケーションの最新バージョンがサーバー上で実行されていないことを意味しま す。

サーバー・エントリを右クリックし、再度「Publish」を選択します。

ステータスがSynchronizedに変わったら、Coherenceクライアントを使用してキャッシュに値が含まれることを確認し （greetingの値をhelloに戻します）、Eclipseテスト・ブラウザを使用して サーブレットの再テストを行います。

前回と同じように、クライアントで設定した値がブラウザとWebLogic Serverウィンドウに表示されます。 クライアントを使用して、キャッシュ内に現在含まれる値を確認します。

Map (mycache): list

先ほどサーブレット・コードに追加したcache.put()と同じ値が返 されることを確認します。

次に、Eclipseテスト・ブラウザをリフレッシュします。 どのような値が表示されていますか。

この課題の解答となるコードを参照するには、こちらを参照してください。

テキスト・エディタで$DOMAIN_HOME/WLS_A/bin/setDomainEnv.cmdを 開きます。

setDomainEnv.cmdファ イルの中で、次のような行を探します（258行目辺り）。

set JAVA_PROPERTIES=%JAVA_PROPERTIES% %WLP_JAVA_PROPERTIES%

この行の上に、次の行を追加します。

@REM  ADDING COHERENCE SETTINGS
set COHERENCE_PROPERTIES=-Dtangosol.coherence.distributed.localstorage=false

ステップ1で見つけたJAVA_PROPERTIESの行を変更して、上で 作成した新しい環境変数を追加します。

set JAVA_PROPERTIES=%COHERENCE_PROPERTIES% %JAVA_PROPERTIES% %WLP_JAVA_PROPERTIES%

WebLogic Serverドメインを起動（または再起動）し、Coherenceキャッ シュ・サーバーおよびCoherenceシェル・クライアントの実行中インスタンスがあれば、それらを停止します。

テスト・アプリケーションを再デプロイし、前項と同様にサーブレットのテストを行います。 今回は、どのような結果になりましたか。

Coherenceキャッシュ・サーバーが停止されている場合、"storage not configured"という例外が表示されてテストは失敗します。 これは、WebLogic Serverドメインをクライアント・ノードとしてのみ動作するよう設定したため、アプリケーションに対してキャッシュ・サービスを提供できないことに起 因したエラーです。

Coherenceキャッシュ・サーバーとCoherenceクライアント・シェルを再起動し、前項と同様にアプリケーションをテスト します （はじめにCoherenceシェル・クライアントを使用して値を追加することに注意してください）。 今回はうまくいきましたか。

コマンドライン引数を介して設定できるCoherence構成には、その他にもキャッシュ構成の上書きなどがあります。