26 Coherence RESTのデプロイ

この章では、Coherence RESTを埋込みHTTPサーバー、WebLogicサーバーおよびGlassFishサーバーにデプロイする方法について説明します。一般的なサーブレット・コンテナの使用方法についても説明します。Coherence RESTの保護の詳細は、『Oracle Coherenceの保護』を参照してください。

この章には次の項が含まれます:

• 埋込みHTTPサーバーによるデプロイ

• WebLogicサーバーへのデプロイ

• Java EEサーバー(一般)へのデプロイ

26.1 埋込みHTTPサーバーによるデプロイ

Coherenceでは、REST Webサービスをホストするために使用できる2つの埋込みHTTPサーバーを提供しています。com.tangosol.coherence.rest.server.DefaultHttpServer(Oracleの軽量HTTPサーバーでバッキング)とcom.tangosol.coherence.rest.server.GrizzlyHttpServer(Grizzlyでバッキング)です。デフォルトのHTTPサーバーの変更の詳細は、「埋込みHTTPサーバーの変更」を参照してください。

HTTPサーバーは、Coherenceプロキシ・サーバー上で有効である必要があります。HTTPサーバーを有効にするには、プロキシのキャッシュ構成ファイルを編集して、<http-acceptor>要素を<proxy-scheme>要素の中に追加し、HTTPサーバーのホストおよびポートを指定します。

次の例では、ローカルホスト127.0.0.1およびポート8080でリクエストを受け入れるようにHTTPサーバーを構成します。例では、HTTPサーバー・クラスおよびJerseyリソース構成クラスを明示的に定義し、Coherence RESTアプリケーションのコンテキスト・パスとして/を使用しています。ただし、デフォルト値があるので含める必要はありません。コンテキスト・パスは必要に応じて変更でき、別のコンテキス・パスとともに追加のCoherence RESTアプリケーションを定義できます。すべての<http-acceptorサブ要素の詳細なリファレンスは、『Oracle Coherenceでのアプリケーションの開発』を参照してください。

<proxy-scheme>
   <service-name>ExtendHttpProxyService</service-name>
   <acceptor-config>
      <http-acceptor>
         <class-name>
            com.tangosol.coherence.rest.server.DefaultHttpServer</class-name>
         <local-address>
            <address>127.0.0.1</address>
            <port>8080</port>
         </local-address>
         <resource-config>
            <context-path>/</context-path>
            <instance>
               <class-name>
                  com.tangosol.coherence.rest.server.DefaultResourceConfig
               </class-name>
            </instance>
         </resource-config>
      </http-acceptor>
   </acceptor-config>
   <autostart>true</autostart>
</proxy-scheme>

26.2 WebLogicサーバーへのデプロイ

WebLogic Serverには、WebLogicサーバー・ドメイン内にCoherenceアプリケーションをパッケージ化、デプロイおよび管理する方法を標準化するCoherence統合機能が含まれています。Coherence RESTは統合標準に準拠する必要があります。WebLogicサーバー・ドメインのクラスタの構成に関する詳細は、『Oracle WebLogic Serverクラスタの管理』を参照してください。さらに、Coherenceアプリケーションは、グリッド・アーカイブ(GAR)としてパッケージ化する必要があります。GARの作成に関する詳細は、『Oracle WebLogic ServerのためのOracle Coherenceアプリケーションの開発』を参照してください。

この項の内容は次のとおりです。

• タスク1: Coherence RESTのWebLogicサーバー・ドメインの構成

• タスク2: Coherence REST Webアプリケーションのパッケージ化

• タスク3: Coherenceアプリケーションのパッケージ化

• タスク4: エンタープライズ・アプリケーションのパッケージ化

• タスク5: エンタープライズ・アプリケーションのデプロイ

26.2.1 タスク1: Coherence RESTのWebLogicサーバー・ドメインの構成

Coherence RESTのドメインの構成:

1. Coherence RESTをホストするWebLogicサーバー・ドメインに、管理Coherenceサーバーを作成します。サーバーは、Coherenceクラスタのストレージが無効なメンバーとして構成する必要があります。Coherence RESTソリューションに複数の管理Coherenceサーバーが必要な場合、サーバーはWebLogicサーバー・クラスタの層として管理される必要があります。管理Coherenceサーバーに関する詳細は『Oracle WebLogic Serverクラスタの管理』を参照してください。

2. COHERENCE_HOME/lib/coherence-rest.jarを管理Coherenceサーバーを対象とする共有ライブラリとしてデプロイします。

   
   

   注意: coherence-rest.jarをシステムのクラスパスとして追加するか、GARファイルの/libディレクトリに含めることもできます。

   
   

3. Coherence RESTは、GlassFish参照実装からのJAXBプロバイダを要求します。WebLogicサーバーはデフォルトでEclipse MOXy JAXBプロバイダを使用します。GlassFish JAXBプロバイダを使用するようにWebLogicサーバーを構成するには、WebLogicサーバーの起動時に、次のシステム・プロパティを設定します。

   -Dcom.sun.xml.ws.spi.db.BindingContextFactory=com.sun.xml.ws.db.
   glassfish.JAXBRIContextFactory
   
   -Djavax.xml.bind.JAXBContext=com.sun.xml.bind.v2.ContextFactory
   

   WebLogic Server用のGlassFish JAXBプロバイダの構成の詳細は、『Oracle® Fusion Middleware Oracle WebLogic Server JAX-WS Webサービス・スタート・ガイド』を参照してください。

26.2.2 タスク2: Coherence REST Webアプリケーションのパッケージ化

Coherence REST Webアプリケーションをパッケージ化するには:

1. 次のようにWebアプリケーション・ディレクトリ構造を作成します。

   /
   /WEB-INF/
   /WEB-INF/classes/
   /WEB-INF/lib/
   

2. 次のJARファイルをORACLE_HOME/oracle_common/modules/ディレクトリから/WEB-INF/libディレクトリにコピーします。

   • jackson-core-asl-1.9.2.jar

   • jackson-jaxrs-1.9.2.jar

   • jackson-mapper-asl-1.9.2.jar

   • jackson-xc-1.9.2.jar

   • jersey-core-1.17.1.jar

   • jersey-json-1.17.1.jar

   • jersey-multipart-1.17.1.jar

   • jersey-server-1.17.1.jar

   • jersey-servlet-1.17.1.jar

3. Webアプリケーション・デプロイメント・ディスクリプタ(web.xml)を作成し、次のようにRESTアプリケーションのサーブレットの定義を含めます。

   
   

   注意: デフォルトのサーブレット・コンテキスト・リスナーは、RESTアプリケーションのシャットダウン中にクラスタ・メンバーをシャットダウンするcoherence-rest.jarに含まれています。このリスナーは次に示すように登録されています。クラスタ・メンバーがシャットダウンされない場合、シャットダウン後に様々な例外がスローされます。

   
   

   <web-app>
      ...
      <listener>
         <listener-class>
            com.tangosol.coherence.rest.servlet.DefaultServletContextListener
         </listener-class>
      </listener>
      <servlet>
         <servlet-name>Coherence REST</servlet-name>
         <servlet-class>com.sun.jersey.spi.container.servlet.ServletContainer
         </servlet-class>
         <init-param>
            <param-name>com.sun.jersey.config.property.resourceConfigClass
            </param-name>
            <param-value>
               com.tangosol.coherence.rest.server.ContainerResourceConfig
            </param-value>
         </init-param>
         <load-on-startup>1</load-on-startup>
      </servlet>
      <servlet-mapping>
         <servlet-name>Coherence REST</servlet-name>
         <url-pattern>/rest/*</url-pattern>
       </servlet-mapping>
         ...
   </web-app>
   

4. web.xmlファイルを/WEB-INF/ディレクトリに保存します。

5. jarユーティリティを使用して、WARファイルを作成します。たとえば、Webアプリケーション・ディレクトリのルートでコマンド・プロンプトから次のコマンドを発行します。

   jar -cvf coherence_rest.war *
   

26.2.3 タスク3: Coherenceアプリケーションのパッケージ化

Coherenceアプリケーションをパッケージ化するには:

1. coherence-rest-config.xmlファイルをCoherenceアプリケーションのルートにコピーします。構造は次のとおりにする必要があります。

   /
   /com/myco/MyClass.class
   /lib/
   /META-INF/
   /META-INF/coherence-application.xml
   /META-INF/coherence-cache-config.xml
   /META-INF/pof-config.xml
   coherence-rest-config.xml
   

2. pof-config.xmlファイルを編集し、Coherence RESTデフォルト・ユーザー・タイプを含むcoherence-rest-pof-config.xml POF構成ファイルをインクルードします。例:

   <pof-config>
      <user-type-list>
         <include>coherence-pof-config.xml</include>
         <include>coherence-rest-pof-config.xml</include>
         ...
      </user-type-list>
   </pof-config>
   

   coherence-rest-pof-config.xmlファイルがcoherence-rest.jarライブラリに配置され、実行時に自動的にロードされます。

3. jarユーティリティを使用して、GARファイルを作成します。たとえば、コマンド・プロンプトからGARディレクトリのルートで次のコマンドを発行します。

   jar -cvf MyCohApp.gar *
   

26.2.4 タスク4: エンタープライズ・アプリケーションのパッケージ化

エンタープライズ・アプリケーションをパッケージ化するには

1. エンタープライズ・アプリケーション・ディレクトリ構造を作成し、Coherence REST WARファイルおよびCoherenceアプリケーションGARファイルをEARのルートにコピーします。例:

   /
   /META-INF/
   /META-INF/application.xml
   /META-INF/weblogic-application.xml
   /coherence_rest.war
   /MyCohApp.gar
   

2. application.xmlファイルを編集し、Coherence REST Webアプリケーションのモジュール定義を追加します。例:

   <application>
      <module>
         <web>
            <web-uri>coherence_rest.war</web-uri>
            <context-root>/</context-root>
         </web>
      </module>
   </application>
   

3. weblogic-application.xmlファイルを編集し、coherence-rest.jar共有ライブラリのライブラリ参照およびCoherenceアプリケーションGARファイルのモジュール参照を追加します。例:

   <weblogic-application>
      <module>
         <name>person</name>
         <type>GAR</type>
         <path>MyCohApp.gar</path>
      </module>
      <library-ref>
         <library-name>coherence-rest</library-name>
      </library-ref>
   </weblogic-application>
   

4. jarユーティリティを使用して、EARファイルを作成します。たとえば、コマンド・プロンプトでEARディレクトリのルートから次のコマンドを発行します。

   jar -cvf MyCohRestApp.ear *
   

26.2.5 タスク5: エンタープライズ・アプリケーションのデプロイ

エンタープライズ・アプリケーションをデプロイするには

1. WebLogicサーバー・管理コンソールまたはWLSTツールを使用して、タスク1で作成した管理CoherenceサーバーにEARをデプロイします、

2. ブラウザから、管理Coherenceサーバーのリスニング・ポートに移動しURLの一部にキャッシュ名を含めることにより、デプロイメントを検証します。例: http://host:port/rest/{cacheName}

26.3 Java EEサーバー(一般)へのデプロイ

この項では、Coherence RestをJava EE環境にデプロイする方法について説明します。

この項には、次のトピックが含まれます:

• デプロイメント用のCoherence RESTのパッケージ化

• GlassFishへのデプロイ

• サーブレット・コンテナへのデプロイ

26.3.1 デプロイメント用のCoherence RESTのパッケージ化

Coherence RESTアプリケーションをパッケージ化するには:

1. 次のように基本のWebアプリケーション・ディレクトリ構造を作成します。

   /
   /WEB-INF
   /WEB-INF/classes
   /WEB-INF/lib
   

2. 次のJARファイルをCOHERENCE_HOME/libディレクトリおよびORACLE_HOME/oracle_common/modules/ディレクトリから/WEB-INF/libディレクトリへコピーします:

   • coherence.jar

   • coherence-rest.jar

   • jackson-core-asl-1.9.2.jar

   • jackson-jaxrs-1.9.2.jar

   • jackson-mapper-asl-1.9.2.jar

   • jackson-xc-1.9.2.jar

   • jersey-core-1.17.1.jar

   • jersey-json-1.17.1.jar

   • jersey-multipart-1.17.1.jar

   • jersey-server-1.17.1.jar

   • jersey-servlet-1.17.1.jar

3. Webアプリケーション・デプロイメント・ディスクリプタ(web.xml)を作成し、次のようにRESTアプリケーションのサーブレットの定義を含めます。

   
   

   注意: デフォルトのサーブレット・コンテキスト・リスナーは、RESTアプリケーションのシャットダウン中にクラスタ・メンバーをシャットダウンするcoherence-rest.jarに含まれています。このリスナーは次に示すように登録されています。クラスタ・メンバーがシャットダウンされない場合、シャットダウン後に様々な例外がスローされます。

   
   

   <web-app>
      ...
      <listener>
         <listener-class>
            com.tangosol.coherence.rest.servlet.DefaultServletContextListener
         </listener-class>
      </listener>
      <servlet>
         <servlet-name>Coherence REST</servlet-name>
         <servlet-class>com.sun.jersey.spi.container.servlet.ServletContainer
         </servlet-class>
         <init-param>
            <param-name>com.sun.jersey.config.property.resourceConfigClass
            </param-name>
            <param-value>
               com.tangosol.coherence.rest.server.ContainerResourceConfig
            </param-value>
         </init-param>
         <load-on-startup>1</load-on-startup>
      </servlet>
      <servlet-mapping>
         <servlet-name>Coherence REST</servlet-name>
         <url-pattern>/*</url-pattern>
       </servlet-mapping>
         ...
   </web-app>
   

4. web.xmlファイルを/WEB-INF/ディレクトリに保存します。

5. coherence-rest-config.xmlファイルを/WEB-INF/classesディレクトリにコピーします。

6. coherence-cache-config.xmlファイルおよびtangosol-coherence-override.xmlファイルをWEB-INF/classesディレクトリにコピーします。

7. jarユーティリティを使用して、Web ARchive (WAR)ファイルを作成します。たとえば、Webアプリケーション・ディレクトリのルートでコマンド・プロンプトから次のコマンドを発行します。

   jar -cvf coherence_rest.war *
   

   アーカイブには次のファイルが含まれます。

   /WEB-INF/web.xml
   /WEB-INF/classes/coherence-rest-config.xml
   /WEB-INF/classes/tangosol-coherence-override.xml
   /WEB-INF/classes/coherence-cache-config.xml
   /WEB-INF/lib/coherence.jar
   /WEB-INF/lib/coherence-rest.jar
   /WEB-INF/lib/jersey-server-1.17.1.jar
   /WEB-INF/lib/jersey-servlet-1.17.1.jar
   /WEB-INF/lib/jersey-core-1.17.1.jar
   /WEB-INF/lib/jersey-json-1.17.1.jar
   /WEB-INF/lib/jersey-multipart-1.17.1.jar
   /WEB-INF/lib/jersey-grizzly2-1.12.jar
   /WEB-INF/lib/jackson-core-asl-1.9.2.jar
   /WEB-INF/lib/jackson-jaxrs-1.9.2.jar
   /WEB-INF/lib/jackson-mapper-asl-1.9.2.jar
   /WEB-INF/lib/jackson-xc-1.9.2.jar
   

26.3.2 GlassFishへのデプロイ

Coherence RESTをGlassFishサーバーにデプロイするには:

1. GlassFish管理コンソール(http://localhost:4848/)から「構成」→JVM設定とクリックします。

2. 「JVMオプション」オプション・タブをクリックして、次のオプションを追加します。

   -Dcom.sun.enterprise.overrideablejavaxpackages=javax.ws.rs,javax.ws.rs.core,javax.ws.rs.ext

3. 「デプロイメント用のCoherence RESTのパッケージ化」で説明されているように、Coherence RESTをWARファイルとしてパッケージ化します。また、WEB-INF/sun-web.xmlまたはWEB-INF/glassfish-web.xmlでクラス・ローダー委任をfalseに設定することで、GlassFishで配信されるJerseyのバージョンをCoherence RESTで配信されるJerseyのバージョンにオーバーライドします。例:

   <sun-web-app error-url="">
      <class-loader delegate="false"/>
   </sun-web-app>
   

4. GlassFish管理コンソールを使用してWARをデプロイします。

5. ブラウザから、http://localhost:8080/coherence_rest/{cacheName}に移動して、デプロイメントを検証します。

26.3.3 サーブレット・コンテナへのデプロイ

Coherence RESTをWARファイルとしてパッケージ化することで、Coherence RESTを任意のサーブレット・コンテナにデプロイできます。詳細は、「デプロイ用のCoherence RESTのパッケージ化」を参照してください。WARファイルのデプロイの詳細は、ベンダーのドキュメントを参照してください。また、追加のサーブレット・コンテナ・デプロイメントのオプションについては、Jerseyユーザー・ガイドを参照してください。

http://jersey.java.net/nonav/documentation/latest/user-guide.html#d4e194