Este tema describe cómo instalar el servicio de datos REST de WebSphere eXtreme Scale en un servidor web.
El servicio de datos REST de WebSphere eXtreme Scale es una aplicación web Java que se puede desplegar en cualquier servidor de aplicaciones que soporte la especificación de servlet Java, Versión 2.3 y un entorno de tiempo de ejecución Java, Versión 5 o posterior.
El servicio de datos REST de WebSphere eXtreme Scale incluye un único archivo wxsrestservice.war. El archivo wxsrestservice.war incluye un único servlet que actúa como una pasarela entre las aplicaciones cliente de WCF Data Services o cualquier otro cliente HTTP REST y una cuadrícula de datos.
El servicio de datos REST incluye un ejemplo que le permite crear rápidamente una cuadrícula de datos e interactuar con ella utilizando un cliente eXtreme Scale o el servicio de datos REST. Consulte Configuración de servicios de datos REST para obtener detalles sobre la utilización del ejemplo.
El archivo wxsrestservice.ear incluye el archivo wxsrestservice.war y los dos están estrechamente vinculados con el tiempo de ejecución de WebSphere WebSphere eXtreme Scale. Si se actualiza WebSphere eXtreme Scale a una versión nueva o se aplica un fixpack, los archivos wxsrestservice.war o wxsrestservice.ear se deberán actualizar manualmente a la versión instalada en este directorio.
El directorio gettingstarted contiene un ejemplo simple que muestra cómo utilizar el servicio de datos REST de WebSphere eXtreme Scale con una cuadrícula de datos.
El servicio de datos REST está diseñado como un módulo WAR autocontenido. Para configurar el servicio de datos REST, en primer lugar debe empaquetar la configuración del servicio de datos REST y los archivos de configuración de WebSphere eXtreme Scale opcionales en un directorio o archivo JAR. El tiempo de ejecución del servidor de contenedores web hace referencia entonces a este empaquetado de aplicaciones. En el diagrama siguiente se ilustran los archivos utilizados por el servicio de datos REST de eXtreme Scale.
El JAR o el directorio de configuración del servicio REST deben contener el archivo siguiente:
wxsRestService.properties: El archivo wxsRestService.properties incluye las opciones de configuración del servicio de datos REST. Incluye los puntos finales de servicio de catálogo, nombres de ObjectGrid que se deben exponer, opciones de rastreo, etc. Consulte Archivo de propiedades del servicio de datos REST.
Un ejemplo con el archivo de configuración mínimo necesario, donde las entidades están definidas en XML en los servidores:
restserviceconfig.jar:
wxsRestService.properties
catalogServiceEndPoints=localhost:2809
objectGridNames=NorthwindGrid
Un ejemplo con una entidad, archivos XML de sustitución y clases de entidad:
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"/>