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

É possível configurar o serviço de dados REST do eXtreme Scale no WebSphere Application Server Community Edition Version 2.1.1.3 ou posterior.

Antes de Iniciar

Procedimento

  1. Configure e inicie uma grade de dados.
    1. Para obter detalhes sobre como configurar uma grade de dados do eXtreme Scale para usar com o serviço de dados REST, consulte o Iniciando uma Grade de Dados Independente para os Serviços de Dados REST.
    2. Verifique se um cliente do eXtreme Scale pode se conectar com, e acessar, as entidades na grade. 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 de empacotamento e implementação no tópico Instalando o Serviço de Dados REST para obter detalhes.
  3. Inicie o servidor WebSphere Application Server Community Edition:
    1. Para iniciar o servidor sem a segurança Java SE ativada, execute o seguinte comando:

      [Unix][Linux] wasce_root/bin/startup.sh

      [Windows] wasce_root/bin/startup.bat

    2. Para iniciar o servidor com a segurança Java SE ativada, siga estas etapas: [Unix][Linux]
      1. Abra uma janela de linha de comandos ou de terminal e execute o seguinte comando de cópia (ou copie o conteúdo do arquivo de política especificado na política existente): cp restservice_home/gettingstarted/wasce/geronimo.policy wasce_root/bin
      2. Edite o arquivo wasce_root/bin/setenv.sh
      3. Depois da linha que contém "WASCE_JAVA_HOME=", inclua o seguinte: export JAVA_OPTS="-Djava.security.manager -Djava.security.policy=geronimo.policy"

      [Windows]
      1. Abra uma janela de linha de comandos e execute o seguinte comando de cópia, ou copie o conteúdo do arquivo de políticas especificado na política existente:

        copy restservice_home\gettingstarted\wasce\geronimo.policy\bin

      2. Edite o arquivo wasce_root\bin\setenv.bat
      3. Após a linha contendo "set WASCE_JAVA_HOME=", inclua o seguinte:

        set JAVA_OPTS="-Djava.security.manager -Djava.security.policy=geronimo.policy"

  4. Inclua o JAR de tempo de execução do cliente ObjectGrid ao repositório WebSphere Application Server Community Edition:
    1. Abra o console administrativo WebSphere Application Server Community Edition e efetue login. A URL padrão é: http://localhost:8080/console, o ID do usuário padrão é system e a senha é manager.
    2. Clique no link Repositório no lado esquerdo da janela do console, na pasta Serviços.
    3. Na seção Incluir Archive no Repositório, preencha o seguinte nas caixas de texto de entrada:
      Tabela 1. Incluir Archive no Repositório
      Caixa de texto Valor
      File wxs_home/lib/ogclient.jar
      Grupo com.ibm.websphere.xs
      Artefato ogclient
      Versão 7.1
      Tipo JAR
    4. Clique no botão Instalar

    Consulte a seguinte nota técnica para obter detalhes sobre as diferentes maneiras pelas quais as dependências de classe e de biblioteca podem ser configuradas:Especificando dependências externas para aplicativos em execução no WebSphere Application Server Community Edition.

  5. Implemente e inicie o módulo do serviço de dados REST, o arquivo wxsrestservice.war, para o servidor WebSphere Application Server Community Edition.
    1. Copie e edite o arquivo XML do plano de implementação de amostra: restservice_home/gettingstarted/wasce/geronimo-web.xml para incluir dependências do caminho para o JAR ou o diretório de configuração do seu serviço de dados REST. Consulte a seção para obter um exemplo sobre como configurar o caminho de classe para incluir seu arquivo wxsRestService.properties e outros arquivos de configuração e classes de metadados.
    2. Abra o console administrativo WebSphere Application Server Community Edition e efetue login.
      Dica: A URL padrão é: http://localhost:8080/console. O ID de usuário padrão é system e a senha é manager.
    3. Clique no link Implementar Novo no lado esquerdo da janela do console.
    4. Na página Instalar Novos Aplicativos, insira os seguintes valores nas caixas de texto:
      Tabela 2. Instalar Novos Aplicativos
      Caixa de texto Valor
      Archive restservice_home/lib/wxsrestservice.war
      Plano restservice_home/gettingstarted/wasce/geronimo-web.xml
      Dica: Use o caminho para o arquivo geronimo-web.xml que você copiou e editou na etapa 3.
    5. Clique no botão Instalar. A página do console indica que o aplicativo foi instalado e iniciado com sucesso.
    6. Examine o log de saída do sistema ou o console do WebSphere Application Server Community Edition para verificar se o serviço de dados REST foi iniciado com êxito. A seguinte mensagem deve aparecer:

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

  6. Inicie o servidor WebSphere Application Server Community Edition executando o seguinte comando:
    • [Unix][Linux] wasce_root/bin/startup.sh
    • [Windows] wasce_root/bin/startup.bat
  7. Instale o serviço de dados REST do eXtreme Scale e a amostra fornecida no servidor WebSphere Application Server Community Edition:
    1. Inclua o JAR de tempo de execução do cliente ObjectGrid ao repositório WebSphere Application Server Community Edition:
      1. Abra o console administrativo WebSphere Application Server Community Edition e efetue login. A URL padrão é: http://localhost:8080/console. O ID de usuário padrão é system e a senha é manager.
      2. Clique no link Repositório no lado esquerdo da janela do console, na pasta Serviços.
      3. Na seção Incluir Archive no Repositório, preencha o seguinte nas caixas de texto de entrada:
        Tabela 3. Incluir Archive no Repositório
        Caixa de texto Valor
        File wxs_home/lib/ogclient.jar
        Grupo com.ibm.websphere.xs
        Artefato ogclient
        Versão 7.1
        Tipo JAR
      4. Clique no botão Instalar.
        Dica: Consulte a seguinte nota técnica para obter detalhes sobre as diferentes maneiras pelas quais as dependências de classe e de biblioteca podem ser configuradas: Especificando dependências externas para aplicativos em execução no WebSphere Application Server Community Edition
    2. Implemente o módulo de serviço de dados REST: wxsrestservice.war para o servidor WebSphere Application Server Community Edition.
      1. Edite o arquivo XML de implementação restservice_home/gettingstarted/wasce/geronimo-web.xml de amostra para incluir dependências do caminho nos diretórios do caminho de classe de amostra de introdução:
        • Altere "classesDirs" para os dois GBeans do cliente de introdução:
        O caminho "classesDirs" para o GBean GettingStarted_Client_SharedLib deve ser configurado para: restservice_home/gettingstarted/restclient/bin

        O caminho "classesDirs" para o GBean GettingStarted_Common_SharedLib deve ser configurado para: restservice_home/gettingstarted/common/bin

      2. Abra o console administrativo WebSphere Application Server Community Edition e efetue login.
      3. Clique no link Implementar Novo no lado esquerdo da janela do console.
      4. Na página Instalar Novos Aplicativos, insira os seguintes valores nas caixas de texto:
        Tabela 4. Instalar Novos Aplicativos
        Caixa de texto Valor
        Archive restservice_home/lib/wxsrestservice.war
        Plano restservice_home/gettingstarted/wasce/geronimo-web.xml
      5. Clique no botão Instalar.

        A página do console indica que o aplicativo foi instalado e iniciado com sucesso.

      6. Examine o log de saída do sistema WebSphere Application Server Community Edition para verificar se o serviço de dados REST foi iniciado com êxito verificando se a seguinte mensagem está presente:

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

  8. Verifique se o serviço de dados REST está funcionando:

    Abra um navegador da Web e navegue para a seguinte URL: http://<host>:<port>/<context root>/restservice/<Grid Name>

    A porta padrão para WebSphere Application Server Community Edition é 8080 e é definida usando a propriedade "HTTPPort" no arquivo /var/config/config-substitutions.properties.

    Por exemplo: http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/

Resultados

O documento de serviço AtomPub é exibido.