Este tópico descreve como instalar o serviço de dados REST do WebSphere eXtreme Scale em um servidor da Web.
O serviço de dados REST do WebSphere eXtreme Scale é um aplicativo da Web Java que pode ser implementado para qualquer servidor de aplicativos que suporte a especificação de servlet Java, Versão 2.3 e um ambiente de tempo de execução Java, Versão 5 ou posterior.
O serviço de dados REST do WebSphere eXtreme Scale inclui um único arquivo wxsrestservice.war. O arquivo wxsrestservice.war inclui um único servlet que age como um gateway entre os aplicativos clientes do WCF Data Services ou qualquer outro cliente HTTP REST e uma grade de dados.
O serviço de dados REST inclui uma amostra que o permite criar rapidamente uma grade de dados e interagir com ela usando o cliente do eXtreme Scale ou o serviço de dados REST. Consulte o Configurando Serviços de Dados REST para obter detalhes sobre como usar a amostra.
O arquivo wxsrestservice.ear inclui o arquivo wxsrestservice.war e os dois são estreitamente acoplados ao tempo de execução do WebSphere WebSphere eXtreme Scale. Se for feito o upgrade do WebSphere eXtreme Scale para uma nova versão um se um fix pack for aplicado, o arquivo wxsrestservice.war ou o arquivo wxsrestservice.ear precisarão ter seu upgrade feito manualmente para a versão instalada neste diretório.
O diretório gettingstarted contém uma amostra simples que demonstra como usar o serviço de dados REST do WebSphere eXtreme Scale com uma grade de dados.
O serviço de dados REST é projetado como um módulo WAR autocontido. Para configurar o serviço de dados REST, você deve primeiro empacotar a configuração do serviço de dados REST e os arquivos de configuração opcionais do WebSphere eXtreme Scale em um arquivo ou diretório JAR. Essa compactação de aplicativo é referida pelo tempo de execução do servidor de contêiner de Web. O diagrama a seguir ilustra os arquivos usados pelo serviço de dados REST do eXtreme Scale.
O diretório ou JAR de configuração do serviço REST deve conter o seguinte arquivo:
wxsRestService.properties: O arquivo wxsRestService.properties inclui as opções de configuração para o serviço de dados REST. Isso inclui terminais de serviço de catálogo, nomes de ObjectGrid para expor, opções de rastreio e mais. Consulte Arquivo de Propriedades do Serviço de Dados REST.
Um exemplo com o arquivo de configuração requerido mínimo, no qual as entidades são definidas em XML nos servidores:
restserviceconfig.jar:
wxsRestService.properties
catalogServiceEndPoints=localhost:2809
objectGridNames=NorthwindGrid
Um exemplo com uma entidade, arquivos XML de substituição e classes de entidade:
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"/>