< Anterior | Próximo >

Lição 2: Configurar o Serviço

Agora, que você gravou o código para este serviço, é possível disponibilizá-lo para outros aplicativos como um serviço da Web. A disponibilização do serviço dessa forma envolve a criação de informações sobre ligação do serviço, que informa a outros aplicativos onde localizar o serviço e quais funções estão disponíveis no serviço. O serviço publica estas informações como um arquivo WSDL (Web Services Description Language).

Como uma alternativa para serviços da Web, os aplicativos clientes do EGL podem acessar aplicativos de serviço do EGL como serviços do EGL. Este método oferece melhor desempenho que serviços da Web, mas ele pode ser usado apenas entre dois aplicativos de EGL. Para a compatibilidade mais ampla, esse tutorial usa serviços da Web, que podem ser usados entre dois aplicativos de EGL, dois aplicativos não EGL ou um aplicativo de EGL e um aplicativo não EGL. Para obter mais informações, consulte a documentação do EGL clicando em Ajuda > Conteúdo da Ajuda.

As informações sobre ligação do serviço estão contidas em um descritor de implementação do EGL. Nestas etapas, você trabalha com o descritor de implementação do projeto e configura o descritor de construção do projeto para usar esse descritor de implementação.

Mostre-me

Verificar o Descritor de Implementação e o Descritor de Construção

Quando você criou o projeto do EGL, criou automaticamente um arquivo do descritor de implementação nomeado EGLService.egldd. Em seguida, quando você criou o serviço, selecionou a caixa de opção Criar como Serviço da Web, que incluiu automaticamente o serviço no descritor de implementação. Nesta seção, você verifica estas configurações.
  1. Na visualização Navegador de Projetos, expanda o projeto EGLService e a pasta EGLSource. Abra o arquivo do descritor de implementação do EGL dando um clique duplo no arquivo EGLService.egldd.
  2. No editor do descritor de implementação do EGL, clique na guia Implementação de Serviço da Web.
  3. Certifique-se de que seu serviço seja mostrado na lista de serviços a ser implementados como serviços da Web, como na figura a seguir:
    O arquivo descritor de implementação do EGL, que mostra as informações sobre ligação de serviço da Web
  4. Feche o arquivo do descritor de implementação.
  5. Dê um clique duplo no descritor de construção do projeto para abri-lo no editor de partes de construção. Este arquivo é nomeado EGLService.eglbld e está localizado na pasta EGLSource do projeto. O arquivo do descritor de construção contém opções do descritor de construção, que descrevem como o EGL gerará seu projeto na linguagem de saída.
  6. Na lista de opções do descritor de construção, localize a opção nomeada deploymentDescriptor. Observe que ela é configurada como o nome do descritor de implementação, que tem o mesmo nome do projeto, por padrão. O descritor de implementação deve ser referenciado dessa forma para ser usado. O editor de partes de construção é semelhante a este:
    O editor de partes de construção, mostrando a opção deploymentDescriptor configurada como o nome do descritor de implementação
  7. Feche o descritor de construção.
  8. Gere o projeto inteiro clicando com o botão direito do mouse no projeto na visualização Explorador de Projetos e depois clicando em Gerar.

Gerar o Arquivo WSDL

Os arquivos WSDL comunicam informações sobre serviços para clientes, descrevendo as funções fornecidas no serviço e especificando o local do serviço. Nesta seção, você gera um arquivo WSDL a partir do serviço. Posteriormente, seu aplicativo cliente importará esse arquivo WSDL e usará as informações contidas ali.

O EGL usa as informações do arquivo do descritor de implementação e a parte de serviço em si para gerar um arquivo WSDL, mas precisa de mais uma informação: em qual porta o servidor hospedará o serviço. Por padrão, a porta é 9080. Siga estas etapas para localizar o número da porta do seu servidor:

  1. Abra a exibição Servidores. Se não conseguir localizar a visualização Servidores, clique em Janela > Mostrar Visualização > Servidores.
  2. Clique com o botão direito do mouse no servidor nomeado WebSphere Application Server v6.1 e inicie-o clicando em Iniciar no menu pop-up. O servidor pode levar algum tempo para iniciar, dependendo do sistema.
  3. Aguarde até que o servidor mostre Iniciado no campo Status, como nesta imagem:
    A visualização Servidores com o servidor iniciado
  4. Quando o servidor for iniciado, clique com o botão direito do mouse sobre ele na visualização Servidores e, em seguida, clique em Executar Console Administrativo, não em Executar Script Administrativo. O console administrativo é aberto no editor.
  5. No lado esquerdo do console administrativo, expanda Servidores e clique em Servidores de Aplicativos. Seu servidor é mostrado como uma listagem em Servidores de Aplicativos, como nesta imagem:
    Lista de servidores no console administrativo
  6. Clique no nome do servidor na coluna Nome.
  7. Na página que descreve o servidor, clique na guia Configuração.
  8. Na guia Configuração, em Comunicações, clique no link Portas.
  9. Na lista de portas, clique na porta com o Nome da Porta rotulado WC_defaulthost.
  10. Na página que descreve esta porta, anote o número da porta no campo Porta. Nesta imagem, o número da porta é 9082.
    Console administrativo mostrando o número da porta
  11. Feche o console administrativo sem fazer alterações.
  12. No menu superior, clique em Janela > Preferências.... No painel esquerdo, expanda EGL e clique em Serviços.
  13. Se a entrada do campo Porta não corresponder ao número da porta do servidor no console administrativo, digite o número da porta do console aqui. A janela é semelhante a esta:
    A preferência de Serviço mostra o mesmo número de porta para geração do WSDL usado pelo servidor.
  14. Clique em Concluir.
  15. Na visualização Explorador de Projetos, clique com o botão direito do mouse no arquivo HelloService.egl, que está no pacote de serviços da pasta EGLSource e, em seguida, clique em Serviços do EGL > Gerar Arquivo WSDL.
  16. Na janela Criar Arquivo WSDL, clique em Concluir. O EGL cria um arquivo WSDL no pacote wsdl da pasta EGLSource e exibe-o graficamente no editor WSDL.
  17. Examine a representação gráfica do arquivo WSDL e feche-a quando concluir.
Agora você configurou o serviço a ser usado por outros aplicativos no tempo de execução. O arquivo WSDL descreve o serviço para que os clientes possam se conectar a ele no tempo de execução, e o arquivo do descritor de implementação permite que o EGL disponibilize o serviço no tempo de execução.

No mundo real, os serviços são executados independentemente dos clientes que os usam. Para simular essa situação, você pode criar uma nova instância do servidor de aplicativos e executar o serviço ali. Para este tutorial, não há vantagem em consumir esses recursos adicionais, portanto você executará o serviço em seu servidor de aplicativos existente no momento em que testar seu cliente.

< Anterior | Próximo >