このトピックでは、WebSphere® eXtreme Scale REST データ・サービスを Web サーバーにインストールする方法について説明します。
WebSphere eXtreme Scale REST データ・サービスは、Java Web アプリケーションであり、Java サーブレット仕様バージョン 2.3 および Java ランタイム環境バージョン 5 以上をサポートする任意のアプリケーション・サーバーにデプロイできます。
WebSphere eXtreme Scale REST データ・サービスには、単一 wxsrestservice.war ファイルが含まれます。wxsrestservice.war には、WCF Data Services クライアント・アプリケーションまたはその他の HTTP REST クライアントとデータ・グリッド間のゲートウェイとして機能する単一のサーブレットが含まれています。
REST データ・サービスには、迅速にデータ・グリッドを作成し、eXtreme Scale クライアントまたは REST データ・サービスを使用してそのグリッドと対話できるようにするサンプルが含まれています。サンプルの使用法の詳細については、REST データ・サービスの構成を参照してください。
wxsrestservice.ear ファイルには、wxsrestservice.war ファイルが含まれており、ともに WebSphere WebSphere eXtreme Scale ランタイムに密結合されています。WebSphere eXtreme Scale を新しいバージョンにアップグレードするかフィックスパックを適用した場合には、wxsrestservice.war ファイルまたは wxsrestservice.ear ファイルを、このディレクトリーにインストールされたバージョンに手動でアップグレードする必要があります。
gettingstarted ディレクトリーには、WebSphere eXtreme Scale REST データ・サービスをデータ・グリッドで使用する方法を説明する単純なサンプルが含まれます。
REST データ・サービスは、必要なものを完備した WAR モジュールとして設計されています。 REST データ・サービスを構成するには、まず、REST データ・サービス構成およびオプションの WebSphere eXtreme Scale 構成ファイルを JAR ファイルまたはディレクトリーにパッケージ化する必要があります。このアプリケーション・パッケージは、Web コンテナー・サービス・ランタイムによって参照されます。 次の図に、eXtreme Scale REST データ・サービスで使用されるファイルを示します。
REST サービス構成 JAR またはディレクトリーには、以下のファイルが含まれている必要があります。
wxsRestService.properties: wxsRestService.properties ファイルには、REST データ・サービスの構成オプションが含まれます。これには、カタログ・サービス・エンドポイント、公開する ObjectGrid 名、トレース・オプションなどがあります。 REST データ・サービスのプロパティー・ファイルを参照してください。
エンティティーがサーバー上で XML で定義された、最小要件の構成ファイルを使用した例:
restserviceconfig.jar:
wxsRestService.properties
catalogServiceEndPoints=localhost:2809
objectGridNames=NorthwindGrid
単一エンティティー、オーバーライド XML ファイル、およびエンティティー・クラスの例:
restserviceconfig.jar:
wxsRestService.properties
catalogServiceEndPoints=localhost:2809
objectGridNames=NorthwindGrid
com/acme/entities/Customer.class
META-INF/objectGridClient.xml
<objectGrid name="CustomerGrid" entityMetadataXMLFile="emd.xml"/>
META-INF/emd.xml
<entity class-name="com.acme.entities.Customer" name="Customer"/>