この章の内容は次のとおりです。
Coherenceでは、ホストREST Webサービスに使用可能な、複数の埋込みHTTPサーバーが実装されます。
DefaultHttpServer
(Oracleの軽量HTTPサーバーでバッキング)
GrizzlyHttpServer
(Grizzly HTTPでバッキングされ、本番環境に推奨)
SimpleHttpServer
(Simple HTTPサーバーでバッキング)
JettyHttpServer
(Jetty HTTPサーバーでバッキング)
デフォルトの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>
POFを使用している場合は、pof-config.xml
ファイルにREST POFタイプの場所が含まれていることを確認します。詳細は、「POFが有効化されているサービスへのRESTサーバー・アクセスの構成」を参照してください。
WebLogic Serverには、WebLogicサーバー・ドメイン内にCoherenceアプリケーションをパッケージ化、デプロイおよび管理する方法を標準化するCoherence統合機能が含まれています。Coherence RESTは統合標準に準拠する必要があります。WebLogicサーバー・ドメインのクラスタの構成に関する詳細は、『Oracle WebLogic Serverクラスタの管理』を参照してください。さらに、Coherenceアプリケーションは、グリッド・アーカイブ(GAR)としてパッケージ化する必要があります。GARの作成に関する詳細は、『Oracle WebLogic ServerのためのOracle Coherenceアプリケーションの開発』を参照してください。
この項の内容は次のとおりです。
Coherence RESTをホストするWebLogicサーバー・ドメインに、管理Coherenceサーバーを作成します。サーバーは、Coherenceクラスタのストレージが無効なメンバーとして構成する必要があります。Coherence RESTソリューションに複数の管理Coherenceサーバーが必要な場合、サーバーはWebLogicサーバー・クラスタの層として管理される必要があります。管理Coherenceサーバーに関する詳細は『Oracle WebLogic Serverクラスタの管理』を参照してください。
この項では、Coherence RestをJava EE環境にデプロイする方法について説明します。
この項の内容は、次のとおりです。
Coherence RESTをWARファイルとしてパッケージ化することで、Coherence RESTを任意のサーブレット・コンテナにデプロイできます。詳細は、「デプロイメント用のCoherence RESTのパッケージ化」を参照してください。WARファイルのデプロイの詳細は、ベンダーのドキュメントを参照してください。また、追加のサーブレット・コンテナ・デプロイメントのオプションについては、Jerseyユーザー・ガイドを参照してください。
http://jersey.java.net/nonav/documentation/latest/user-guide.html#d4e194
POFが有効化されているサービスには、定義済のCoherence REST POFユーザー・タイプが含まれている必要があります。ユーザー・タイプは、coherence-rest.jar
ライブラリに配置されているcoherence-rest-pof-config.xml
ファイルに定義され、実行時に自動的にロードされます。
RESTのデフォルトのユーザー・タイプを構成するには、pof-config.xml
ファイルを編集して、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>