Nous allons expliquer comment installer sur un serveur Web le service de données REST d'WebSphere eXtreme Scale.
Le service de données REST d'WebSphere eXtreme Scale est une application Web Java qui peut être déployée sur tout serveur d'applications prenant en charge la spécification de servlet Java version 2.3 et un environnement d'exécution Java version 5 ou plus récente.
Le service de données REST WebSphere eXtreme Scale inclut un seul fichier wxsrestservice.war. Le fichier wxsrestservice.war comporte un seul servlet qui fait office de passerelle entre vos applications client WCF Data Services ou tout autre client REST HTTP et une grille de données.
Le service de données REST contient un exemple qui permet de créer rapidement une grille de données et d'interagir avec elle en utilisant un client eXtreme Scale ou le service de données REST. Voir Configuration des services de données REST pour plus d'informations sur l'utilisation de l'exemple.
Le fichier wxsrestservice.ear inclut le fichier wxsrestservice.war et tous deux sont étroitement couplés à l'environnement d'exécution WebSphere eXtreme Scale. En cas de mise à niveau d'WebSphere eXtreme Scale vers une nouvelle version ou si un groupe de correctifs est appliqué, les fichiers wxsrestservice.war file ou wxsrestservice.ear devront être mis à niveau manuellement vers la version installée dans ce répertoire.
Le répertoire gettingstarted contient un exemple simple montrant comment utiliser le service de données REST WebSphere eXtreme Scale avec une grille de données.
Le service de données REST a été conçu en tant que module WAR autonome. Pour configurer le service de données REST, vous devez commencer par packager dans un fichier JAR ou dans un répertoire la configuration du service de données REST et les éventuels fichiers de configuration d'WebSphere eXtreme Scale. Ce package d'application est ensuite référencé par l'environnement d'exécution du serveur de conteneur Web. La figure suivante illustre les fichiers utilisés par le service de données REST d'eXtreme Scale.
Le fichier JAR de configuration du service REST ou le répertoire doit contenir le fichier suivant :
wxsRestService.properties : le fichier wxsRestService.properties comprend les options de configuration du service de données REST : points de contact du service de catalogue, noms d'ObjectGrid à exposer, options de suivi, etc. Voir Fichier de propriétés du service de données REST.
Voici un exemple avec le fichier de configuration minimum requise, où les entités sont définies dans XML sur les serveurs :
restserviceconfig.jar:
wxsRestService.properties
catalogServiceEndPoints=localhost:2809
objectGridNames=NorthwindGrid
Un exemple avec une entité, des fichiers XML de remplacement et des classes entité :
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"/>