< Anterior | Próximo >

Lição 2.1: Instalar e Implementar o Serviço da Web

Nesse exercício, você instalará um arquivo do aplicativo corporativo de amostra (EAR) no WebSphere Application Server v6.1 e implementará o serviço da Web EmployeeDirectory. Seu aplicativo utilizará este serviço da Web para criar, ler, atualizar e excluir registros de funcionários.

Antes de iniciar, você deve concluir uma das seguintes opções para certificar-se de que o seu projeto MyDirectory esteja no ponto inicial adequado:
Seu projeto Java MyDirectory inclui um arquivo EmployeeDirectory.ear. Você utilizará o WebSphere Administrative Console para instalar o aplicativo corporativo EmployeeDirectory contido no arquivo EAR. Ao instalar o aplicativo, você também implementa o serviço da Web incluído no aplicativo. O aplicativo My Company Directory concluído utiliza esse serviço da Web implementado.

Para instalar o aplicativo EmployeeDirectory de amostra e implementar o serviço da Web no ambiente do WebSphere Application Server v6.1:

  1. Inicie uma instância do servidor de aplicativos no ambiente de trabalho. Há várias maneiras diferentes que possibilitam ativar o servidor, mas estas etapas descrevem como fazer isso do workbench:
    1. Abra a exibição Servidores. Para incluir a visualização Servidores na perspectiva Java, clique em Janela (Window) > Mostrar Visualização (Show view) > Outra e Selecionar Servidor (Other and select Server) > Servidores (Servers).
    2. A visualização Servidores lista os servidores instalados e configurados.
    3. Clique com o botão direito do mouse em seu servidor e selecione Iniciar (Start). Quando a visualização Servidores mostra o status do servidor como Iniciado (Started) ou o console afirma Servidor server1 aberto para e-business (Server server1 open for e-business), o servidor é iniciado com êxito. É possível agora executar o Administrative Console.
    Nota: Se não houver instância do servidor na exibição Servidores, crie um novo servidor:
    1. Clique com o botão direito na exibição Servidores e selecione Novo (New) > Servidor (Server).
    2. Utilize o assistente Novo Servidor para incluir o WebSphere Application Server v6.1.
  2. Execute o WebSphere Administrative Console. Novamente, há outras maneiras de executar o Administrative Console, mas essas instruções descrevem como fazer isso a partir do workbench:
    1. Na visualização Servidores, clique com o botão direito no servidor iniciado e selecione Executar o Console Administrativo (Run administrative console). O WebSphere Administrative Console é aberto em uma janela do navegador.
    2. Digite um ID do usuário e clique em Efetuar Login (Log in). A página Bem-vindo (Welcome) do Administrative Console é aberta. O ID do usuário digitado é utilizado apenas para monitorar as alterações específicas do usuário para os dados de configuração do servidor.
  3. Utilize o Administrative Console para instalar o aplicativo corporativo EmployeeDirectory.ear localizado no projeto MyDirectory. O Administrative Console utiliza uma abordagem do assistente para ajudá-lo a instalar aplicativos, em que você clica em Avançar (Next) para mover de página em página até que todas as opções sejam definidas. Para instalar o aplicativo corporativo de amostra que contém o serviço da Web para esse tutorial:
    1. À esquerda do Administrative Console, expanda a opção de menu Aplicativos (Applications) e clique em Instalar Novo Aplicativo (Install New Application).
    2. Selecione Sistema de Arquivos Local (Local file system) e no campo Especificar Caminho (Specify path), digite o caminho completo para o arquivo EmployeeDirectory.ear que está no projeto MyDirectory. Dica: Para obter o caminho completo, clique com o botão direito no arquivo EmployeeDirectory.ear no Explorador de Pacotes (Package Explorer) e selecione Propriedades (Properties). A página Propriedades (Properties) lista o local do arquivo, que você pode copiar e colar no campo Especificar Caminho (Specify path).
    3. Clique em Avançar (Next) até alcançar a página Selecionar as opções de instalação (Select installation options).
    4. Selecione Implementar Serviços da Web (Deploy Web services).
    5. Clique em Avançar (Next) até alcançar a página Resumo (Summary) e, em seguida, clique em Concluir (Finish).
    6. Clique no link Salvar na Configuração Master (Save to Master Configuration) ao ser solicitado a aplicar as alterações feitas na configuração local. Reveja as alterações e clique no botão Salvar (Save).
  4. Utilize o Administrative Console para iniciar o aplicativo EmployeeDirectory:
    1. Clique em Aplicativos (Applications) > Aplicativos Corporativos (Enterprise Applications). O aplicativo EmployeeDirectory está listado como um aplicativo instalado no servidor, mas seu status é Parado (Stopped).

      Aplicativos Corporativos no Console Administrativo

    2. Selecione a caixa de opções próxima a EmployeeDirectory e clique em Iniciar (Start). Uma mensagem indica que o aplicativo EmployeeDirectory foi iniciado com êxito e o ícone Status é alterado para a seta verde.

Agora, o aplicativo EmployeeDirectory está em execução no host local na porta 9080 e o serviço da Web pode ser acessado. Após concluir esse tutorial, é possível voltar ao Administrative Console, parar o aplicativo EmployeeDirectory e, em seguida, desinstalá-lo.

Se você abrir o arquivo EmployeeDirectory.wsdl localizado no projeto MyDirectory (deve ser aberto no WSDL Editor gráfico, por padrão), é possível examinar o serviço da Web implementado. Se o arquivo WSDL não for aberto no WSDL Editor, o recurso Web Service Developer pode não estar ligado no workbench. Você pode especificar os recursos de workbench em Preferências (Preferences) (Janela (Window) > Preferências (Preferences) > Workbench > Recursos (Capabilities)).

A imagem a seguir do editor WSDL mostra as operações disponíveis no serviço EmployeeDirectory:

Captura de Tela da Seção Tipos de Porta do Editor WSDL

É possível utilizar o editor WSDL para examinar cada operação e as mensagens de pedido e mensagens de retorno correspondentes. Isso pode ajudá-lo a compreender o serviço da Web e como é utilizado nos exercícios restantes.

< Anterior | Próximo >