Gerando Arquivos WAR (Web Archive) para Transferir Manualmente Servidores da Web

Para implementar um serviço da Web em um servidor da Web que não está listado na visualização Servidores no espaço de trabalho, gere um arquivo WAR (Web Archive) e transfira esse arquivo no servidor da Web.

Sobre esta tarefa

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 gerar o arquivo WAR:

  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. 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 Construir o arquivo .war, mas não implementar o serviço da Web.
  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.
    Parâmetros para o WebSphere Application Server, Versão 6.x
    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.
  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. 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.
  7. Clique em Concluir para gerar o arquivo WAR. O arquivo é criado no seguinte diretório:
    • No Linux e UNIX: <workspace_directory>/<project_directory>/<DataServerWebServices/<name_of_Web_service>
    • No Windows: <workspace_directory>\<project_directory>\DataServerWebServices\<name_of_Web_service>
    Consulte a parte Mensagens da visualização Saída de Dados para obter o caminho exato.

    Utilize o método preferencial para transferir o arquivo para o servidor da Web. Consulte a documentação do servidor da Web para obter as etapas para implementação do serviço da Web.

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.
Tarefas relacionadas
Implementando Serviços da Web Através do Ambiente de Trabalho
Incluindo Parâmetros em Serviços da Web
Referências relacionadas
Servidores da Web, Mecanismos SOAP e Bancos de Dados Suportados

Feedback