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.

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:
    1. Visualize a URL de WSDL em um navegador e salve o arquivo WSDL em seu computador local.
    2. Remova o elemento complexType do arquivo WSDL.
    3. Copie o arquivo WSDL no diretório WEB-INF/wsdl de seu projeto de pacote configurável OSGi.
    4. 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

Importante: Aplicável ao WebSphere Application Server tradicional
  • 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

  • Se você clicar em Cancelar em uma certa altura de qualquer um dos assistentes de serviços da web, poderá ter entradas do serviço da web nos descritores de implementação e arquivos gerados em sua área de trabalho. Exclua manualmente esses arquivos depois de fechar o assistente.
  • Os assistentes de serviços da web falham ao publicar os EARs:

    Problema: Quando um servidor remoto é criado usando o tempo de execução de stub, o EAR não é publicado.

    Causa: O assistente de serviço da web não tem nenhuma maneira de descobrir se um servidor pode ser iniciado ou não.

    Solução: Em qualquer perspectiva onde a visualização Servidores estiver disponível, clique com o botão direito no servidor remoto e selecione Incluir e Remover Projetos. Selecione o projeto e inclua-o no servidor.

  • Os assistentes de serviços da web não conseguem consumir o tipo de projeto escolhido:

    Problema: ao tentar executar os assistentes de serviço da web em um EAR que contém um projeto de aplicativo cliente Java™ EE com a opção Instalar serviço no servidor selecionada ou um projeto EJB que não contém um EJB, não é possível usar o assistente para gerar o serviço da web.

    Causa: Os assistentes de serviço da web verificam para assegurar que eles possam consumir o tipo de projeto que está selecionado na página três do assistente. Se eles não puderem, o assistente impedirá que você continue.

    Solução: Se você cancelar o assistente e executar novamente com Instalar serviço no servidor não selecionado, ou incluir um EJB no projeto EJB, poderá progredir no assistente.

  • Se um arquivo WSIL for selecionado na área de trabalho e, em seguida, o assistente de serviços da web for ativado, o assistente informará que a seleção é inválida porque um arquivo WSDL deve ser selecionado a partir do arquivo WSIL. Para resolver isso, clique em Procurar no assistente de serviços da web para selecionar um arquivo WSDL específico.
  • O assistente de serviços da web pode produzir um erro durante a criação de um serviço da web se o nome do projeto da web de destino inclui caracteres non-latin-1. O problema ocorre porque os geradores de código de serviços da web calculam as URLs HTTP com base no nome do projeto, e caracteres non-Latin-1 não são permitidos em URLs HTTP. Para resolver isso, use nomes de projeto que contenham apenas caracteres latin-1.
  • Se houver mais de um projeto EAR na área de trabalho e você selecionar Enterprise JavaBeans em um projeto EJB e ativar o assistente de serviço da web, o enterprise bean selecionado pode não ser selecionado quando o assistente for ativado. Na caixa de diálogo Selecionar Implementação de Serviço, o projeto EAR que é selecionado é o primeiro EAR na área de trabalho em ordem alfabética, e não o EAR associado ao projeto EJB que contém o bean. Para resolver isto, na caixa de diálogo Selecionar Implementação de Serviço, selecione manualmente o projeto EAR desejado.
  • Quando você seleciona para monitorar o tráfego de serviços da web na primeira página do assistente de serviços da web, ocasionalmente, a visualização Monitor TCP/IP não é exibida automaticamente. É possível abrir a visualização manualmente selecionando Windows > Mostrar Visualização > Depurar > Monitor TCP/IP. A solicitação e a resposta para o serviço da web são mostradas nessa visualização.

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:
    Page load failed with error: cannot parse response.
    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.

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.
Icon that indicates the type of topic Reference topic
Timestamp icon Last updated: last_date

File name: rlimit.html