Implementando Serviços da Web Através do Ambiente de Trabalho

É possível utilizar o ambiente de trabalho para implementar serviços da Web em servidores da Web listados na visualização Servidores.
Pré-requisito

Configure o servidor da Web para executar os serviços da Web e incluir o servidor na visualização Servidores.

Sobre esta tarefa

Durante a implementação, o ambiente de trabalho gera um arquivo WAR (Web archive) que contém o serviço da Web e transfere esse arquivo para o servidor da Web.

Não é necessário iniciar o servidor da Web. O ambiente de trabalho iniciará o servidor automaticamente quando você implementar um serviço da Web nele.

Se você precisar modificar um serviço da Web depois de implementá-lo em um servidor da Web, edite o serviço no projeto de desenvolvimento de dados e, em seguida, implemente-o novamente no servidor.

Procedimento

Para implementar um serviço da Web em um servidor da Web listado na visualização Servidores:

  1. Clique com o botão direito do mouse no serviço da Web e selecione Implementar. Se você já configurou as opções de implementação para o serviço da Web, as etapas de 2 a 6 são opcionais.
  2. Opcional: Selecione um ou ambos os protocolos de mensagens para as mensagens que o serviço da Web receberá.
    Acesso à Web (REST)
    Selecione se uma ou mais operações no serviço da Web serão acessadas pelas mensagens de um dos seguintes tipos:
    • HTTP POST (text/xml)
    • HTTP GET/POST (url-encoded)
    Serviço da Web (SOAP/HTTP)
    Selecione se uma ou mais operações no serviço da Web serão acessadas pelas mensagens que são agrupadas em envelopes SOAP.
  3. Opcional: Especifique o servidor da Web que você deseja implementar em serviços da Web.
    Tipo
    Selecione um dos tipos suportados de servidor da Web.
    Servidor
    Selecione o servidor. Se o servidor da Web no qual você deseja implementar o serviço da Web ainda não estiver listado na visualização Servidores, clique em Novo.
  4. Opcional: Especifique valores para os parâmetros que são específicos do servidor da Web selecionado.
    Parâmetros para Apache Tomcat, Versão 5.5
    artifact.dataSourceGlobalName
    Especifica o nome do recurso definido globalmente para origens de dados do servidor da Web.
    Esta opção só aparece se a caixa de opções Registrar Conexão com o Banco de Dados com Servidor da Web não estiver selecionada.
    artifact.soapEngine
    Especifica o mecanismo SOAP a ser utilizado se você selecionou Serviço da Web (SOAP) em Protocolos de Mensagem.
    artifact.soapEngineDirectory
    Parâmetro opcional que especifica o diretório no sistema de arquivo local com os arquivos JAR para o mecanismo SOAP. Se você especificar esse diretório, o ambiente de trabalho empacota os arquivos JAR no arquivo WAR (Web archive) que você gera ao implementar o serviço da Web.
    Essa opção aparecerá apenas se você especificar para utilizar o protocolo de mensagens SOAP/HTTP.
    Parâmetros para WebSphere Application Server Community Edition, Versão 1.1 (WASCE)
    artifact.contextRoot
    Especifica a raiz de contexto para o serviço da Web.
    artifact.dataSourceGroupId
    Especifica o diretório ou a árvore de diretórios no repositório do WebSphere Application Server Community Edition, no qual o depósito de artefatos exclusivo está localizado. Para conjuntos de conexão com o banco de dados, o valor deveria ser console.dbpool.
    Esta opção só aparece se a caixa de opções Registrar Conexão com o Banco de Dados com Servidor da Web não estiver selecionada.
    artifact.dataSourceArtifactId
    Especifica o nome do conjunto de conexão com o banco de dados. Esse parâmetro faz distinção entre maiúsculas e minúsculas. No WebSphere Application Server Community Edition, esse valor é utilizado como o prefixo do nome de arquivo da biblioteca.
    Esta opção só aparece se a caixa de opções Registrar Conexão com o Banco de Dados com Servidor da Web não estiver selecionada.
    artifact.dataSourceVersion
    Especifica o número da versão a ser anexado ao nome do arquivo juntamente com uma extensão .jar, para criar o nome do arquivo da biblioteca.
    Esta opção só aparece se a caixa de opções Registrar Conexão com o Banco de Dados com Servidor da Web não estiver selecionada.
    artifact.soapEngine
    Especifica o mecanismo SOAP a ser utilizado se você selecionou Serviço da Web (SOAP) em Protocolos de Mensagem.
    artifact.soapEngineDirectory
    Parâmetro opcional que especifica o diretório no sistema de arquivo local com os arquivos JAR para o mecanismo SOAP. Se você especificar esse diretório, o ambiente de trabalho empacota os arquivos JAR no arquivo WAR (Web archive) que você gera ao implementar o serviço da Web.
    Esta opção estará disponível apenas se você estiver utilizando os mecanismos SOAP do Apache Axis 1.4 ou Apache Axis 2.
  5. Opcional: Inclua ou remova parâmetros customizados. Você pode incluir parâmetros que configuram as propriedades em um banco de dados DB2 ou configuram as propriedades de conexões do banco de dados. Consulte Incluindo Parâmetros em Serviços da Web.
  6. Opcional: Especifique se você deseja que o ambiente de trabalho crie o conjunto de bancos de dados no servidor da Web automaticamente. O ambiente de trabalho faz isso transmitindo as informações de conexão para o banco de dados no servidor da Web. É possível selecionar essa opção se, no campo Tipo, você selecionou o WebSphere Application Server Community Edition, Versão 1.1 ou em Apache Tomcat, Versão 5.5.

    Se você selecionar esta opção, o serviço da Web será o único aplicativo que pode utilizar o conjunto de banco de dados.

    Se você não selecionar essa opção, será necessário criar o conjunto de banco de dados global, o qual pode ser compartilhado por mais de um aplicativo da Web em um servidor da Web.

  7. Especifique se ativar o Explorador de Serviços da Web após o ambiente de trabalho implementar o serviço da Web. No Explorador de Serviços da Web, você pode utilizar o Explorador WSDL para testar o documento WSDL para o serviço da Web.
  8. Se você quiser desfazer suas alterações, selecione uma dessas duas opções.
    Restaurar Padrões do Projeto
    Restaura os valores padrão de nível do projeto para serviços da Web. Se você sobrescreveu esses valores padrão na visualização Propriedades do serviço da Web, esse botão restaurará os valores a partir dessa visualização.
    Reconfigurar
    Retorna as configurações no assistente Implementar Serviço da Web para os valores que foram selecionados quando o assistente foi aberto.
  9. Clique em Concluir.
Após implementar um serviço da Web, você pode acessá-lo utilizando as seguintes URLs:
  • Para acesso por pedidos SOAP/HTTP: http://server:port/context_root/services/service_name
  • Para acesso por pedidos POST (text/xml) ou POST (url-encoded) tipo REST: http://server:port/context_root/rest/service_name/operation_name
  • Para acesso por pedidos GET (url-encoded) tipo REST: http://server:port/context_root/rest/service_name/operation_name?parm1=val1&parm2;=val2&...
Para consultar o conteúdo do arquivo WSDL, utilize a URL http://server:port/context_root/wsdl.

Exemplo de Utilização do Explorador de Serviços da Web

Câmera Demonstração

Transcrição:

Esse viewlet demonstra recursos do Explorador WSDL, o qual você pode utilizar para testar um serviço da Web implementado através do ambiente de trabalho. O Explorador WSDL faz parte do Explorador de Serviços da Web.

A demonstração será iniciada através da implementação de um serviço da Web.

Selecione o servidor da Web.

Para essa demonstração, serão aceitos todos os valores padrão, exceto para essa opção. O Explorador de Serviços da Web será ativado, dessa forma, essa caixa de opções será selecionada.

O Explorador de Serviços da Web aparece com o Explorador WSDL aberto.

A área de janela Navegador exibe a URL para o documento WSDL no servidor da Web. Essa URL mostra que o servidor da Web está instalado localmente no ambiente de trabalho.

Aqui encontra-se o nome do documento WSDL, o qual é idêntico ao nome do serviço da Web. Você pode consultar as ligações no documento, expandindo-a.

Também é possível consultar uma lista das ligações nos Detalhes de Serviços WSDL.

As ligações serão expandidas a área de janela Navegador.

Em cada ligação aparece as operações no serviço da Web.

A operação EMPLOYEES_PER_PRODUCT será testada com a ligação GET. É possível imitar um pedido para a operação e, em seguida, ver a mensagem de resposta.

A mensagem de resposta aparece na área Status.

Agora, será testada a mesma operação, mas utilizando a ligação SOAP.

O conjunto de resultados aparece na área Status.

Você pode visualizar a origem para o pedido e a resposta.

Quando finalizar o Explorador de Serviços da Web, é possível retornar para o ambiente de trabalho.

Conceitos relacionados
Implementação Automática de Serviços da Web
Tarefas relacionadas
Removendo Implementação de Serviços da Web do Ambiente de Trabalho
Gerando Arquivos WAR (Web Archive) para Transferir Manualmente Servidores da Web
Incluindo Parâmetros em Serviços da Web
Selecionando as Opções de Implementação Padrão para Todos os Serviços da Web em um Projeto
Informações relacionadas
Testando Documentos WSDL e Serviços da Web Utilizando o WSDL Explorer

Feedback