Problemas e limitações conhecidos para aplicativos de serviço da web
Vários problemas e limitações conhecidos se aplicam quando você está trabalhando com aplicativos de serviço da web e WebSphere Developer Tools. Problemas incluem, entre outros, problemas quando você usar um WebSphere Application Server protegido e quando você usa os assistentes de serviços da web.
Para obter mais informações sobre limitações e dicas de resolução de problemas, consulte Problemas e Limitações Conhecidos do WebSphere Application Server Developer Tools for Eclipse Beta.
As limitações que você pode encontrar ao trabalhar com serviços da web são divididas nas seções a seguir:- Limitações gerais para serviços da web
- Problemas encontrados ao usar um WebSphere Application Server protegido
- Problemas encontrados quando você usa os assistentes de serviços da web
- Problemas encontrados quando você usa o ambiente de tempo de execução do WebSphere JAX-WS e JAXB
- Limitações ao criar um cliente de serviço da web
- Limitações das JSPs de amostra do serviço da web
- Problemas do Web Services Explorer
- Problemas ao usar ferramenta de linha de comandos de serviços da web
Limitações gerais para serviços da web
Usando a JSP do cliente de teste, se você selecionar Ativar chamada assíncrona e, em seguida, chamar o serviço, esta mensagem de erro será exibida: A Classe de Resposta não está definida.
É possível solucionar o problema testando o serviço de forma síncrona.
O Liberty não suporta publicação no UDDI. Entretanto, Publicar o serviço da web continua selecionado no assistente de serviço da web.
Você pode contornar esse problema. Desmarque a seleção Publicar a verificação de serviço da web. A página Publicação de Serviço da Web também continua aparecendo; desmarque todas as caixas de seleção nessa página.
O Liberty não suporta thin clients por padrão.
Você pode contornar esse problema. Para incluir suporte para thin clients, é possível instalar o WebSphere Application Server tradicional e obter os arquivos JAR do thin client a partir da pasta runtimes. Em seguida, você pode incluí-los em seu projeto Java.
Também é possível usar um tipo de projeto diferente, tal como um projeto da web.
O Generic Service Client não é suportado no OS X. Use o WSE ou JSPs de amostra para testar o serviço da web.
- Se você destinar um servidor Liberty e estiver gerando um serviço da web JAX-WS bottom-up usando o assistente de serviço da web, poderá receber uma exceção de ponteiro nulo.
- Ao selecionar o modelo REST no assistente Novo projeto da web, a versão inicial da máscara JAX-RS pode ser 2.0. Isso deve ser alterado manualmente para 1.1, para que a Biblioteca JAX-RS e a Classe IBMRestServlet do IBM® WebSphere Application Server Liberty apareçam previamente preenchidas na página de configuração do Serviço REST.
- [Liberty] A criação de um cliente de serviço
da web JAX-WS com o assistente de serviço da web pode falhar se o serviço da web JAX-WS estiver em um projeto de
pacote configurável OSGi. Esse problema pode ocorrer se você criar um serviço da web em um projeto de pacote configurável OSGi, não selecionar
Copiar WSDL para o projeto no assistente de serviço da web e, em seguida, implementar o projeto de pacote configurável OSGi no Liberty.Esse processo poderá falhar quando você criar o cliente JAX-WS a partir da URL de serviço da web com o arquivo Web Services Description Language (WSDL) anexado. As ferramentas exibem a mensagem de erro a seguir:
[ERRO] Uma classe/interface com o mesmo nome "sample.ObjectFactory" já está em uso. Use uma customização de classe para resolver esse conflito.Este processo pode falhar porque o arquivo WSDL de serviço no servidor Liberty que o assistente de serviços da web usa para criar o cliente contém o elemento a seguir:<xs:complexType name="objectFactory"> <xs:sequence></xs:sequence> </xs:complexType>Para solucionar esse problema, é possível selecionar Copiar WSDL no projeto no assistente de serviço da web ao criar um projeto de serviço da web em um projeto de pacote configurável OSGi. Como alternativa, é possível concluir as etapas a seguir:- Visualize a URL de WSDL em um navegador e salve o arquivo WSDL em seu computador local.
- Remova o elemento complexType do arquivo WSDL.
- Copie o arquivo WSDL no diretório WEB-INF/wsdl de seu projeto de pacote configurável OSGi.
- Inclua o atributo wsdlLocation no elemento @WebService de
seu arquivo de origem Java de serviço da web.O atributo wsdlLocation deve ter um valor que aponta para seu arquivo WSDL local. A linha a seguir é um exemplo desse atributo.
wsdlLocation="WEB-INF/wsdl/Sample.wsdl"
Dica: Se você criar o serviço da Web em um projeto da web em vez de um projeto de pacote configurável OSGi, a geração de cliente de serviço da web será bem-sucedida. As ferramentas não exibem uma mensagem de erro. - [WebSphere Application Server tradicional] Depois de criar um projeto da web JAX-RS, é possível usar as ferramentas para alterar a versão da máscara. Ao mudar a versão da máscara entre JAX-RS 1.1 e 2.0, o contêiner do caminho de classe não atualiza automaticamente os arquivos .jar incluídos. É possível solicitar que as ferramentas atualizem os arquivos .jar incluídos atualizando quaisquer outros níveis de máscara, como os níveis de máscara JPA. Em seguida, é possível reverter as mudanças para os níveis de máscara JPA.Dica: Ao criar um projeto JAX-RS sem especificar um nível de máscara, por padrão as ferramentas utilizarão JAX-RS 2.0.
Problemas encontrados ao usar um WebSphere Application Server protegido
Você pode encontrar a mensagem de erro a seguir: Mensagem de erro SSLSocketFactory: java.net.SocketException: java.lang.ClassNotFoundException: Não é possível localizar a classe especificada com.ibm.websphere.ssl.protocol.SSLSocketFactory
Antes de usar o Web Services Explorer, gerar JSPs de amostra, criar um serviço ou cliente da web a partir de um arquivo WSDL HTTPS, ou implementar um serviço da web do Axis, você deve configurar o ambiente de trabalho para se comunicar com um servidor via Secure Sockets Layer (SSL). As informações sobre esta tarefa podem ser localizadas aqui: Problemas ao trabalhar com um servidor protegido usando conexões SSL.
Você pode encontrar a mensagem de erro a seguir: Erro ao abrir soquete: javax.net.ssl.SSLHandshakeException: certificado desconhecido
Para usar o assistente de serviços da web para recuperar um WSDL HTTPS ou para usar o Web Services Explorer em um WebSphere Application Server protegido, conclua as etapas em Configurando o IBM JRE para conversar com um WebSphere Application Server protegido.
Problemas encontrados quando você usa os assistentes de serviços da web
Problemas encontrados quando você usa o ambiente de tempo de execução do WebSphere JAX-WS e JAXB
- Se você tentar criar uma biblioteca de esquema onde há documentos de esquemas diferentes que usam o mesmo namespace, a função gera projetos e código com erros de compilação. Os erros de compilação estão no arquivo ObjectFactory.java. O problema é que, para um esquema, o código JAXB é gerado em um pacote cujo nome é baseado no targetNamespace do esquema. Uma classe ObjectFactory.java também é gerada para esse pacote e seu conteúdo é baseado em todos os esquemas do mesmo namespace. Ele não pode ser dividido ou duplicado para resolver os erros de compilação, porque o ambiente de tempo de execução espera esta classe por pacote. Portanto, o recurso de biblioteca de esquema funciona somente se todas as dependências do esquema estão em diferentes targetNamespaces.
- Novo no JAXB, o ambiente de tempo de execução do IBMWebSphere JAX-WS
não é mais responsável por resolver colisões de nomes. Quando essas
colisões ocorrerem, você poderá ver uma mensagem de erro tal como erro:
A propriedade "property_name" já está definida.
O tutorial a seguir fornece mais informações e alguns exemplos de como solucionar colisões de nomenclaturas: O Tutorial de serviços da web Java Tutorial: Customizando Ligações JAXB
Limitações ao criar um cliente de serviço da web
Quando você implementa um cliente de serviço da web em um projeto EJB, na página de configuração de proxy, você deve selecionar o EJB para o qual o cliente de serviço da web tem escopo definido. Esta seleção é um requisito definido pelo JSR-109 no qual o component-name de um elemento component-scoped-refs deve corresponder ao ejb-name de um EJB no módulo.
Quando há pelo menos um EJB no projeto, não ocorrem erros. No entanto, se não há EJBs no projeto, as opções na página de configuração de proxy são editáveis e possuem um valor padrão igual ao nome de serviço do WSDL sufixado por "EJB". Além disso, o assistente de cliente exibe um aviso que indica que a implementação está incompleta porque o cliente de serviços da web não tem escopo definido para um EJB existente. Você pode corrigir este erro criando um EJB com o mesmo nome que o component-name usado em webservicesclient.xml.
No entanto, se você optar por encerrar a criação do cliente cancelando a partir do assistente, o assistente não removerá o component-scoped-refs incompleto de webservicesclient.xml. Remova o component-scoped-refs incompleto manualmente antes da reimplementação.
Limitações das JSPs de amostra do serviço da web
- JSPs de amostra do serviço da web não possuem suporte para métodos que utilizam matrizes ou coletas como parâmetros. Estes métodos são omitidos da área de janela Métodos da JSP de amostra.
Problemas do Web Services Explorer
- Quando o Web Services Explorer carrega arquivos WSDL que usam vários esquemas sequenciais, são geradas mensagens de aviso para os tipos que são referenciados entre esses esquemas. A mensagem de aviso é semelhante a: Referência de tipo <qualified_type_name> não foi resolvida. Estes são avisos e não erros e não interferem na capacidade do Web Services Explorer de iniciar operações e, portanto, podem ser ignorados com segurança.
- O Web Services Explorer não suporta a chamada de serviços da web por meio da autenticação de servidores proxy que usam um protocolo diferente da autenticação básica HTTP, como NTLM. Se o Web Services Explorer falhar ao se conectar ao serviço da web escolhido por este ou qualquer outro motivo, será exibido em sua área de janela de resultados o erro IWAB0135E Ocorreu um erro inesperado seguido por informações sobre a falha, conforme recuperadas da resposta HTTP. Para resolver esse problema, alterne para um servidor proxy HTTP Basic Authenticating.
- O Web Services Explorer possui problemas quando você alterna da visualização de origem para a visualização de formulário, se o esquema usa opções que contêm sequências. Ao utilizar um elemento de opção em um complexType, a opção contém dois ou mais elementos que incluem uma sequência e, caso você alterne da visualização de formulário para a visualização de origem, o Web Services Explorer pode não ser capaz de converter corretamente o fragmento XML correspondente na visualização de origem novamente para visualização de formulário sem que haja perda de dados. Para resolver esse problema, inicie a sequência a partir da visualização do formulário quando os dados forem inseridos inicialmente. Quando ocorre essa configuração, não é recomendado que a visualização de origem seja usada. Se a visualização de origem for usada, não alterne de volta para a visualização do formulário.
- O Web Services Explorer importa o WSDL sem resolver URLs de importação relativas. Ao utilizar o Web Services Explorer, há um problema ao importar um WSDL a partir da Página de WSDL para a área de trabalho. Se a opção Importar como uma referência de serviço para um documento WSIL for escolhida, isto se refere à URL original do WSDL e, portanto, todas as importações relativas estão acessíveis. Se Importar Documento WSDL for escolhido e o arquivo WSDL contiver importações relativas, estas importações não estarão mais acessíveis, deixando a cópia do WSDL difícil ou impossível de processar em outro local nas ferramentas. Se houver importações relativas no WSDL que você está importando, use o método WSIL. Se houver necessidade de uma cópia do WSDL, verifique manualmente as importações relativas após a importação para resolver quaisquer links quebrados.
- O Web Services Explorer não funciona ao utilizar a versão Java 8 da Java virtual machine (JVM) no Eclipse. Se você iniciar o Web Services Explorer com o Java 8, a janela principal exibirá Erro HTTP 500. Para resolver esse problema, use Java 7 como a JVM do Eclipse, ou use o cliente de serviço genérico.
- Ao instalar o WebSphere Developer Tools em um ambiente de trabalho do Eclipse 4.5.1, o Web Services Explorer não funciona. Se você tentar usar o Web Services Explorer, a seção Resposta/Status do Web Services Explorer ficará em branco e as ferramentas exibirão o seguinte erro:
Para solucionar esse problema, instale o WebSphere Developer Tools em um ambiente de trabalho do Eclipse 4.5.2. Para obter mais informações sobre esse problema, consulte Erro 476132 - Problema do Web Services Explorer com o Java 8 - Carregamento de página falhou com o erro: não é possível analisar a respota.Page load failed with error: cannot parse response.
Problemas ao usar ferramenta de linha de comandos de serviços da web
- Ao importar para a área de trabalho um EAR que contém um cliente EJB gerado pelas ferramentas de linha de comandos utilizando o Java EE 1.4 ocorrem erros de compilação. Para corrigir os erros, clique com o botão direito no projeto EJB e selecione Propriedades. Acesse Caminho de construção Java e selecione a guia Bibliotecas. Remova a entrada EJBClientProject/imported_classes(class folder). Inclua a pasta de classe EJBServiceClient/imported_classes/Meta-inf/classess. Clique em OK.
- [WebSphere Application Server tradicional] Depois de importar para a área de trabalho um EAR que contém um aplicativo cliente gerado pelas ferramentas de linha de comandos utilizando o Java EE 1.4, você obtém um erro ClassNotFoundException ao executar o cliente. Para corrigir os erros, clique com o botão direito no projeto Aplicativo Cliente e selecione Propriedades. Acesse Caminho de construção Java e selecione a guia Bibliotecas. Remova a entrada ApplicationClientProject/imported_classes(class folder). Inclua a pasta de classe ApplicationClientProject/imported_classes/Meta-Inf/classess. Clique em OK.
- As tarefas Ant de serviços da web que têm como alvo o tempo de execução Axis, manipulam a geração de serviços da web, mas não a implementação deles. Como resultado, serviços da web do Axis que são criados usando as tarefas Ant não são acessíveis no servidor em execução até que você implemente manualmente seus serviços com o utilitário nativo do Apache Axis, AdminClient. Implemente o arquivo deploy.wsdd gerado em subdiretórios sob o diretório WebContent/WEB-INF do projeto da web para Axis manualmente usando a ferramenta Axis AdminClient. Consulte a seção "Utilizando o AdminClient" do Guia do usuário do Axis 1.4 para obter mais detalhes.