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:
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.