Implementando o Serviço de Dados REST no WebSphere Application Server

Este tópico descreve como configurar o serviço de dados REST do WebSphere eXtreme Scale no WebSphere Application Server ou no WebSphere Application Server Network Deployment Versão 6.1.0.25 ou posterior. Estas instruções também se aplicam às implementações nas quais o WebSphere eXtreme Scale é integrado com a implementação do WebSphere Application Server.

Antes de Iniciar

Você deve ter um dos seguintes ambientes em seu sistema para configurar e implementar o serviço de dados REST para o WebSphere eXtreme Scale.

Procedimento

  1. Configure e inicie uma grade de dados.
    1. Para obter detalhes sobre como configurar uma grade de dados para usar com o serviço de dados REST, consulte Iniciando uma Grade de Dados para os Serviços de Dados REST no WebSphere Application Server.
    2. Verifique se um cliente pode se conectar com e acessar entidades na grade de dados. Para obter um exemplo, consulte Tutorial: Introdução ao WebSphere eXtreme Scale.
  2. Construa a JAR da configuração do serviço eXtreme Scale REST ou o diretório. Consulte as informações sobre como empacotar e implementar o serviço REST no Instalando o Serviço de Dados REST.
  3. Inclua o diretório ou JAR da configuração do serviço de dados REST no caminho de classe do servidor de aplicativos:
    1. Abra o console administrativo do WebSphere Application Server
    2. Navegue para Ambiente > Bibliotecas Compartilhadas
    3. Clique em Novo
    4. Inclua as seguintes entradas nos campos apropriados:
      • Nome: extremescale_rest _configuration
      • Caminho de classe: <diretório ou jar da configuração do serviço REST>
    5. Clique em OK
    6. Salve as mudanças na configuração principal
  4. Inclua o JAR de tempo de execução do cliente do WebSphere eXtreme Scale, wsogclient.jar, e o JAR ou o diretório de configuração do serviço de dados REST no caminho de classe do servidor de aplicativos: Essa etapa não será necessária se o WebSphere eXtreme Scale for integrado com o WebSphere Application Server.

    1. Abra o console administrativo do WebSphere Application Server.
    2. Navegue para Ambiente > BibliotecasCompartilhadas.
    3. Clique em Novo.
    4. Inclua as seguintes entradas nos campos:
      • Nome: extremescale_client_v71
      • Caminho da classe: wxs_home/lib/wsogclient.jar
      Lembre-se: Inclua cada caminho em uma linha separada.
    5. Clique em OK.
    6. Salve as alterações na configuração principal.
  5. Instale o arquivo EAR do serviço de dados REST, wxsrestservice.ear, no WebSphere Application Server usando o console administrativo:
    1. Abra o console administrativo do WebSphere Application Server.
    2. Clique em Aplicativos > Novo aplicativo.
    3. Navegue para o arquivo /lib/wxsrestservice.ear no sistema de arquivos, selecione-o e clique em Avançar.
      • Se estiver usando o WebSphere Application Server Versão 7.0, clique em Avançar.
      • Se estiver usando o WebSphere Application Server Versão 6.1, insira um valor de Raiz de Contexto com o nome: /wxsrestservice e continue na próxima etapa.
    4. Escolha uma opção de instalação detalhada e clique em Avançar.
    5. Na tela de avisos de segurança do aplicativo, clique em Continuar.
    6. Escolha as opções de instalação padrão e clique em Avançar.
    7. Escolha um servidor para o qual o aplicativo será mapeado e clique em Avançar.
    8. Na página de recarregamento de JSP, utilize os padrões e clique em Avançar.
    9. Na página de bibliotecas compartilhadas, mapeie o módulo wxsrestservice.war para as bibliotecas compartilhadas definidas:
      • extremescale_rest_configuration
      • extremescale_client_v71
      Dica: Esta biblioteca compartilhada será necessária apenas se o WebSphere eXtreme Scale não estiver integrado ao WebSphere Application Server.
    10. Na página de relacionamentos da biblioteca compartilhada do mapa, utilize os padrões e clique em Avançar.
    11. Na página hosts virtuais do mapa, clique nos padrões e em Avançar.
    12. Na página de raízes de contexto do mapa, configure a raiz de contexto como: wxsrestservice
    13. Na tela Resumo, clique em Concluir para concluir a instalação.
    14. Salve as alterações na configuração principal.
  6. Inicie o aplicativo de serviço de dados REST wxsrestservice:
    1. Acesse o aplicativo no console administrativo.
      • WebSphere Application Server Versão 7.0: No console administrativo, clique em Aplicativos > Tipos de Aplicativos > Aplicativos WebSphere.
      • WebSphere Application Server Versão 6.0: No console administrativo, clique em Aplicativos > Aplicativos Corporativos.
    2. Marque a caixa de seleção ao lado do aplicativo wxsrestservice e clique em Iniciar.
    3. Revise o arquivo SystemOut.log para o perfil do servidor de aplicativos. Quando o serviço de dados REST for iniciado com êxito, a seguinte mensagem será exibida no arquivo SystemOut.log para o perfil do servidor:

      CWOBJ4000I: O serviço de dados REST do WebSphere eXtreme Scale foi iniciado.

  7. Verifique se o serviço de dados do REST está funcionando: O número da porta pode ser localizado no arquivo SystemOut.log dentro do diretório de logs do perfil do servidor de aplicativos ao consultar a primeira porta exibida para o identificador de mensagem: SRVE0250I.. A porta padrão é 9080.

    Por exemplo:http://localhost:9080/wxsrestservice/restservice/NorthwindGrid/ Resultado: O documento de serviço AtomPub é exibido.

    Por exemplo: http://localhost:9080/wxsrestservice/restservice/NorthwindGrid/$metadata. O documento Entity Model Data Extensions (EDMX) é exibido.

  8. Para parar os processos da grade de dados, use CTRL+C na respectiva janela de comando.