< Anterior | Próximo >

Lição 3: Criar um Cliente de Serviço do EGL

A próxima etapa é criar um projeto de cliente para usar o serviço. Embora o cliente que você cria neste tutorial esteja no mesmo espaço de trabalho, você pode imaginar que ele esteja em um local completamente separado ou em uma plataforma diferente. Como os serviços e clientes não precisam ser gravados na mesma linguagem do código, você também pode imaginar que este aplicativo cliente é gravado em uma linguagem diferente ou é criado com um conjunto de ferramentas completamente diferente.

Mostre-me

  1. Clique em Arquivo > Novo > Projeto.
  2. Expanda EGL e clique em Projeto do EGL.
  3. Clique em Avançar.
  4. Nomeie o novo projeto do EGL como EGLClient.
  5. Clique em Projeto da Web.
  6. Clique em Avançar.
  7. Certifique-se de que Criar um Novo Descritor de Construção esteja selecionado. Não é necessário alterar as configurações avançadas, a menos que use o WAS e tenha alterado anteriormente as configurações para desativar a inclusão do projeto em um EAR.
  8. Você pode ver uma janela perguntando se deseja alternar para a perspectiva J2EE. Se visualizar essa janela, clique em Não.

Criar a Página da Web do Cliente

Para usar o serviço, você criará uma página da Web no cliente para recuperar a entrada, passar essa entrada para o serviço e exibir a saída do serviço. Você começará criando um Manipulador JSF, um tipo de parte lógica do EGL que controla uma página da Web e, em seguida, criará uma página da Web para estar de acordo com esse Manipulador JSF.
  1. Na visualização Explorador de Projetos, clique no projeto EGLClient para selecioná-lo.
  2. Clique em Arquivo > Novo > Outro.
  3. Expanda EGL e clique em Manipulador JSF.
  4. Clique em Avançar.
  5. Na janela Novo Manipulador JSF do EGL, certifique-se de que o campo Pasta de Origem esteja configurado como a pasta EGLSource do projeto:
    EGLClient\EGLSource
  6. No campo Pacote, digite este nome.
    jsfhandlers
  7. No campo Nome do Arquivo de Origem EGL, digite este nome:
    ClientPage
    A janela é semelhante a esta:
    A janela Novo Manipulador JSF do EGL
  8. Clique em Concluir. O novo Manipulador JSF é aberto no editor.

    Não salve o arquivo até que seja instruído a fazer isso. Quando você salva um Manipulador JSF, o EGL verifica se a página da Web mencionada na propriedade view existe ou não. Se não, o EGL cria o arquivo e inclui campos automaticamente com base nas variáveis do Manipulador JSF e nas propriedades DisplayUse dessas variáveis. Se você salvar o arquivo antes de ter incluído todas as variáveis, a nova página da Web não incluirá todas as variáveis. Se isso acontecer, será possível excluir o arquivo JSP (não o arquivo Manipulador JSF) e gerar o Manipulador JSF novamente para obter uma nova página da Web.

  9. Remova o código de amostra do novo Manipulador JSF para que o seguinte seja tudo o que resta:
    package jsfhandlers;
    
    handler ClientPage type JSFHandler
       {view = "jspLocation/jspName.jsp"}
       
    end
  10. Configure o valor da propriedade view como ClientPage.jsp, como neste exemplo:
    {view = "ClientPage.jsp"}
  11. No Manipulador JSF, crie as seguintes variáveis:
    name string {DisplayUse = input};
    city string {DisplayUse = input};
    output string {DisplayUse = output};
  12. Abaixo das variáveis, inclua esta função:
    function getHello()
    
    end
    Você incluirá código nesta função posteriormente. O Manipulador JSF é semelhante a este:
    O código no Manipulador JSF
  13. Salve o arquivo. Quando você salva o arquivo, o EGL cria uma página da Web a partir do arquivo automaticamente. Esse arquivo é nomeado com o valor da propriedade view, ClientPage.jsp, e o arquivo é colocado na pasta WebContent de seu projeto.
    Se você não recebeu um arquivo JSP, o EGL não está configurado para gerar partes do Manipulador JSF automaticamente. Gere o Manipulador JSF manualmente clicando com o botão direito do mouse na visualização Explorador de Projetos ou no editor EGL e, em seguida, clicando em Gerar. Então, siga estas etapas adicionais para configurar a geração automática de Manipuladores JSF:
    1. Clique em Janela > Preferências.
    2. Na janela Preferências, expanda EGL e clique em Geração.
    3. Na página Geração, selecione a caixa de opção Manipulador.
    4. Clique em OK.

    Agora, os Manipuladores JSF serão gerados automaticamente quando você os salvar.

  14. Abra o arquivo ClientPage.jsp no editor. Essa página possui campos com base nas variáveis criadas no Manipulador JSF. Esses campos estão pré-ligados às variáveis. Dessa forma, quando os valores desses campos forem alterados na página, as variáveis serão alteradas para corresponder. Da mesma forma, quando os valores das variáveis no Manipulador JSF forem alterados, os valores dos campos na página serão alterados para corresponder.

    Essa página também possui diversos campos de mensagem de erro. Isso não significa que sua página tenha erros; esses campos mostrarão erros na página, se houver algum, quando você executá-la.

  15. Localize a visualização Dados da Página. Se não conseguir localizar essa visualização, clique em Janela > Mostrar Visualização > Dados da Página. Essa visualização mostra os dados disponíveis para sua página, incluindo as variáveis criadas no Manipulador JSF. Também mostra funções no Manipulador JSF.
  16. Na visualização Dados da Página, expanda Manipulador JSF > Ações e localize a função getHello().
  17. Arraste a função getHello() da visualização Dados da Página diretamente para a parte inferior da página. Um botão ligado à função aparece na página. Quando o usuário pressionar o botão na página no tempo de execução, a função no Manipulador JSF será executada.
  18. Salve a página.
A página é semelhante a esta:
Aparência da página da Web do cliente

Você agora tem uma página da Web pronta para usar o serviço da Web. Na próxima lição, você configurará o projeto para agir como um cliente para o serviço por meio dessa página da Web.

< Anterior | Próximo >