Boas Práticas de Migração de Serviços da Web
Use essas boas práticas de migração de serviços da Web quando migrar os aplicativos de serviços da Web.
Se você usou o suporte Apache SOAP para desenvolver aplicativos clientes de serviços da Web no WebSphere Application Server Versões 4, 5 ou 5.1, poderá precisar migrar seus aplicativos ou os arquivos de segurança para seus aplicativos. A seguinte tabela resume as especificações de serviços da Web suportadas pelos produtos WebSphere.
WebSphere Application Server Versão | Especificações de Serviços da Web Suportadas |
---|---|
4.0 | Apache SOAP 2.2 |
5.0 e 5.0.1 | Apache SOAP 2.3 |
5.0.2 ou posterior | J2EE (Java™ 2 Platform, Enterprise Edition), também conhecido como (JSR 109) |
6.0.x e 6.1 | J2EE (JSR 109) |
7.0 ou posterior | Web Services for Java EE (Java Platform, Enterprise Edition) 5 também conhecido como JSR 109 |

Para obter informações adicionais sobre como migrar seus serviços da web, leia sobre como migrar serviços da web Apache SOAP para serviços da web JAX-RPC com base nos padrões Java EE.
É recomendado que os novos serviços da Web sejam desenvolvidos usando os serviços da Web para a especificação Java EE. Para saber mais, consulte a implementação de aplicativos de serviços da Web.
A segurança não pode ser migrada diretamente do SOAP 2.3 para os padrões Java EE. Depois de ter migrado seus serviços da Web para os padrões do Java EE, considere proteger seus aplicativos de serviços da Web. Para saber mais, consulte a proteção de aplicativos de serviços da Web usando a segurança no nível de mensagem.
Siga estas boas práticas para a experiência de migração mais ideal:
O servidor de aplicativos suporta o modelo de programação JAX-WS (Java API for XML-Based Web Services) e o modelo de programação JAX-RPC (Java API for XML-based RPC). O JAX-WS é a próxima geração do modelo de programação de serviços da Web que estende a base fornecida pelo modelo de programação JAX-RPC.
Os aplicativos da JAX-RPC existentes que desejam usar os recursos JAX-WS devem ser reescritos utilizando o modelo de programação JAX-WS.
Reiplementar Serviços da Web JAX-RPC Existentes Depois de Migrar para um Novo Release do Servidor de Aplicativos
Quando migrar para uma nova liberação do servidor de aplicativos, é recomendado reimplementar seus aplicativos de serviços da Web. Você deve reimplementar seu aplicativo de serviços da Web no novo ambiente do servidor de aplicativos devido às possíveis mudanças nos níveis suportados das especificações de serviços da Web e descritores de implementação de serviços da Web em cada liberação. Para reimplementar seu serviço da Web, selecione Implementar Serviços da Web no assistente Instalar Novo Aplicativo ou use o comando wsdeploy. Para saber mais sobre esse processo, consulte a implementação dos aplicativos de serviços da Web na documentação dos servidores de aplicativos.
Migrando um Cliente Java API for XML-based remote procedure call (JAX-RPC) Versão 5 que Usa o SOAP Sobre Java Message Service (JMS) para Chamar um Serviço da Web
Um cliente JAX-RPC que é executado em umWebSphere Application Server Versão 5, pode usar o SOAP sobre JMS para chamar o serviço da Web que é executado em um Application Server Versão 5.
SibMessage W [:] CWSIT0009W: Um pedido do cliente falhou no servidor de aplicativos com o
terminal <endpoint name> no barramento <bus_name> com a razão: CWSIT0016E: O ID do usuário
nulo falhou na autenticação do barramento <bus_name>.
Quando o servidor de aplicativos é migrado para a Versão 6.x e o provedor de sistemas de mensagens padrão (tecnologia de integração de serviços) é usado e a segurança administrativa e de aplicativo é ativada para o servidor ou a célula, o destino de fila do barramento de integração de serviços herda as características de segurança do servidor ou da célula, por padrão. Se o servidor ou a célula tiver a autenticação básica ativada, o pedido do cliente falhará.
- Desative a segurança administrativa e de aplicativos no painel de segurança principal dentro do console administrativo. Para desativar a segurança administrativa e do aplicativo, clique em Ativar Segurança Administrativa e Ativar Segurança de Aplicativos. . Desmarque as opções
- Modifique as configurações para o barramento de integração de serviços que hospeda o destino de fila de maneira que a segurança do barramento seja desativada e o barramento não herde as características de segurança do servidor ou da célula. Essa opção é equivalente ao nível de segurança que você pode configurar na Versão 5.
- Configure a autenticação básica em cada cliente que utiliza o serviço. Para saber mais, consulte as informações sobre a configuração de autenticação básica HTTP para os serviços da Web JAX-RPC com o console administrativo.
Migrando Serviços da Web Apache SOAP
É possível migrar os serviços da Web que foram desenvolvidos usando o Apache SOAP para os serviços da Web que são desenvolvidos com base na especificação do Web Services for Java 2 Platform, Enterprise Edition (J2EE). Consulte as informações sobre a migração dos serviços da Web Apache SOAP para os serviços da Web JAX-RPC baseados nos padrões do Java EE.
Migrando os Serviços da Web Montados com Versões Anteriores do Application Server Toolkit ou do Assembly Toolkit
- Os serviços da Web seguros não são migrados pelo Assistente de Migração J2EE quando os serviços da Web são migrados a partir do J2EE 1.3 para J2EE 1.4.
- A migração de serviços da Web protegidos requer etapas manuais.
- Após a migração de J2EE, os arquivos de ligação protegida e extensão devem ser migrados manualmente para o J2EE 1.4 da seguinte maneira:
- Clique duas vezes no arquivo webservices.xml para abrir o editor de serviços da Web.
- Selecione a guia Configurações de Ligação para editar o arquivo de ligação.
- Inclua todas as configurações de ligação necessárias sob as novas seções Detalhes de Configuração de Ligação de Consumidor de Pedido e Detalhes de Configuração de Ligação de Gerador de Resposta.
- Selecione a guia Extensão para editar o arquivo de extensão.
- Inclua todas as configurações de extensão necessárias sob as novas seções Detalhes de Configuração de Serviço de Consumidor de Pedido e Detalhes de Configuração de Serviço de Gerador de Resposta.
- Salve e saia do editor.
Migrando um nó do WebSphere Application Server Pré-8.5 para 8.5 ou Posterior
[7/31/12 14:48:34:323 CDT] 0000043f EditionHelper E Unexpected Error: ibmasyncrsp -- The Application's Directory in the Repository is EMPTY.
[7/31/12 14:48:34:339 CDT] 0000043f FfdcProvider W com.ibm.ws.ffdc.impl.FfdcProvider logIncident FFDC1003I: FFDC Incident emitted on c:\opt\WAS85\profiles\dmgr.xd61\logs\ffdc\dmgr_483a68e7_12.07.31_14.48.34.3396174315962980574983.txt com.ibm.ws.xd.appeditionmgr.EditModuleTargetsTaskHandler 104
[7/31/12 14:48:34:339 CDT] 0000043f EditModuleTar E ERROR_IN_EDIT_MODULE_TARGETS_TASK_HANDLER
Esse erro é exibido somente se houver servidores de aplicativos diferentes dos WebSphere Application Servers federados na célula. A mensagem é registrada considerando o arquivo ibmasyncrsp.ear, que é um aplicativo do sistema interno que é usado pelo mecanismo JAX-WS interno do servidor de aplicativos. Como o mecanismo JAX-WS não tem nenhuma relevância para os servidores de aplicativos diferentes do WebSphere Application Servers, não há nenhuma interrupção da funcionalidade. A mensagem pode ser ignorada.