Utilizando um Cliente Java com Serviço de Dados REST

O aplicativo cliente Java usa a API EntityManager do eXtreme Scale para inserir dados na grade.

Sobre Esta Tarefa

As seções anteriores descreveram como criar uma grade de dados do eXtreme Scale e configurar e iniciar o serviço de dados REST do eXtreme Scale. O aplicativo cliente Java usa a API EntityManager do eXtreme Scale para inserir dados na grade. Ele não demonstra como utilizar interfaces REST. O objetivo desse cliente é demonstrar como a API EntityManager é usada para interagir com a grade de dados do eXtreme Scale e permitir a modificação de dados na grade. Para visualizar dados na grade usando o serviço de dados REST, use um navegador da Web ou use o aplicativo cliente Visual Studio 2008.

Procedimento

Para incluir rapidamente conteúdo na grade de dados do eXtreme Scale, execute o seguinte comando:

  1. Abra uma janela do terminal ou da linha de comandos e configure a variável de ambiente JAVA_HOME:
    • [Linux][Unix] export JAVA_HOME=java_home
    • [Windows] set JAVA_HOME=java_home
  2. cd restservice_home/gettingstarted
  3. Insira alguns dados na grade. Os dados que são inseridos serão recuperados depois com o uso de um navegador da Web e do serviço de dados REST.

    Se a grade dedados tiver sido iniciada sem a segurança do eXtreme Scale, use os comandos a seguir.

    • [Unix][Linux] ./runclient.sh load default
    • [Windows] runclient.bat load default

    Se a grade de dados tiver sido iniciada com a segurança do eXtreme Scale, use os comandos a seguir.

    • [Unix][Linux] ./runclient_secure.sh load default
    • [Windows] runclient_secure.bat load default
    Para um cliente Java, use a seguinte sintaxe de comando:
    • [Unix][Linux] runclient.sh comando
    • [Windows] runclient.bat comando
    Os comandos a seguir estão disponíveis:
    • load default

      Carrega um conjunto predefinido de entidades Customer, Category e Product na grade de dados e cria um conjunto aleatório de Orders para cada cliente.

    • load category categoryId categoryName firstProductId num_products

      Cria uma Category de produto e um número fixo de entidades Product na grade de dados. O parâmetro firstProductId identifica o número do ID do primeiro produto, e a cada produto subsequente é designado o próximo id até o número especificado de produtos ser criado.

    • load customer companyCode contactNamecompanyName numOrders firstOrderIdshipCity maxItems discountPct

      Carrega um novo Customer na grade de dados e cria um conjunto fixo de entidades Order para qualquer produto aleatório atualmente carregado na grade. O número de Orders é determinado pela configuração do parâmetro <numOrders>. Cada Order terá um número aleatório de entidades OrderDetail até <maxItems>

    • display customer companyCode

      Exibe uma entidade Customer e as entidades Order e OrderDetail associadas.

    • display category categoryId

      Exibe uma entidade Category do produto e as entidades Product associadas.

Resultados

Executando e Construindo a Grade de Dados de Amostra e o Cliente Java com Eclipse

A amostra de introdução do serviço de dados REST pode ser atualizada e aprimorada com uso do Eclipse. Para obter detalhes sobre como configurar seu ambiente Eclipse, consulte o documento de texto: restservice_home/gettingstarted/ECLIPSE_README.txt.

Depois que o projeto WXSRestGettingStarted for importado para o Eclipse e estiver sendo construído com êxito, a amostra automaticamente recompilará e os arquivos de script usados par iniciar o servidor e o cliente de contêiner automaticamente selecionarão os arquivos de classe e os arquivos XML. O serviço de dados REST detectará automaticamente quaisquer mudanças, já que o servidor da Web está configurado para ler os diretórios de compilação do Eclipse automaticamente.
Importante: Ao alterar arquivos de origem ou de configuração, o servidor de contêiner do eXtreme Scale e o aplicativo do serviço de dados REST devem ser reiniciados. O servidor de contêiner do eXtreme Scale deve ser iniciado antes do aplicativo da Web do serviço de dados REST.