In diesem Abschnitt wird beschrieben, wie der REST-Datenservice von WebSphere eXtreme Scale in einem Webserver installiert wird.
Der REST-Datenservice von WebSphere eXtreme Scale ist eine Java-Webanwendung, die in jedem Anwendungsserver implementiert werden kann, der die Java-Servlet-Spezifikation Version 2.3 und eine Java Runtime Environment der Version Version 5 oder höher unterstützt.
Der REST-Datenservice von WebSphere eXtreme Scale enthält eine einzige Datei wxsrestservice.war. Die Datei wxsrestservice.war enthält ein einziges Servlet, das als Gateway zwischen Ihren WCF-Data-Services-Clientanwendungen oder einem anderen HTTP-REST-Client und einem Datengrid agiert.
Der REST-Datenservice enthält ein Beispiel, das Ihnen ermöglicht, schnell ein Datengrid zu erstellen und mit diesem über einen eXtreme-Scale-Client oder den REST-Datenservice zu interagieren. Weitere Einzelheiten zur Verwendung des Beispiels finden Sie unter REST-Datenservices konfigurieren.
Die Datei wxsrestservice.ear enthält die Datei wxsrestservice.war, und beide sind eng mit der Laufzeitumgebung von WebSphere WebSphere eXtreme Scale gekoppelt. Wenn ein Upgrade von WebSphere eXtreme Scale auf eine neue Version vorgenommen oder ein Fixpack angewendet wird, muss die Datei wxsrestservice.war bzw. wxsrestservice.ear manuell auf die in diesem Verzeichnis installierte Version aktualisiert werden.
Das Verzeichnis gettingstarted enthält ein einfaches Beispiel, das veranschaulicht, wie der REST-Datenservice von WebSphere eXtreme Scale mit einem Datengrid verwendet wird.
Der REST-Datenservice ist als eigenständiges WAR-Modul entworfen. Zum Konfigurieren des REST-Datenservice müssen Sie die Konfiguration des REST-Datenservice und die optionalen Konfigurationsdateien von WebSphere eXtreme Scale in eine JAR-Datei oder in ein Verzeichnis packen. Dieses Anwendungspaket wird anschließend von der Laufzeitumgebung des Webcontainerservers referenziert. Die folgende Abbildung zeigt die vom REST-Datenservice von eXtreme Scale verwendeten Dateien.
Die Konfigurations-JAR-Datei bzw. das Konfigurationsverzeichnis des REST-Service muss die folgenden Dateien enthalten:
wxsRestService.properties: Die Datei wxsRestService.properties enthält die Konfigurationsoptionen für den REST-Datenservice. Dazu gehören die Katalogserviceendpunkte, die Namen der bereitzustellenden ObjectGrids, Traceoptionen usw. Weitere Informationen finden Sie unter Eigenschaftendatei des REST-Datenservice.
Im Folgenden sehen Sie ein Beispiel mit der erforderlichen Mindestkonfigurationsdatei, in dem die Entitäten in der XML auf den Servern definiert sind:
restserviceconfig.jar:
wxsRestService.properties
catalogServiceEndPoints=localhost:2809
objectGridNames=NorthwindGrid
Beispiel mit einer einzigen Entität, XML-Dateien für Überschreiben und Entitätsklassen:
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"/>