Problemas y limitaciones conocidos para las aplicaciones de servicio web
Cuando se trabaja con Aplicaciones de servicio web y WebSphere Developer Tools surgen una serie de problemas y limitaciones conocidos. Entre ellos, problemas al utilizar un producto WebSphere Application Server protegido y cuando se utilizan los asistentes de servicios web.
Para obtener información sobre las limitaciones y consejos relacionados con la resolución de problemas, consulteProblemas y limitaciones conocidos para WebSphere Application Server Developer Tools for Eclipse Beta.
Las limitaciones que puede encontrar cuando trabaja con los servicios web se dividen en las siguientes secciones:- Limitaciones generales para servicios web
- Problemas encontrados cuando se utiliza un WebSphere Application Server protegido
- Problemas encontrados cuando se utilizan los asistentes de servicios web
- Problemas encontrados cuando se utiliza un entorno de ejecución JAX-WS de WebSphere y JAXB
- Limitaciones cuando crea un cliente de servicio web
- Limitaciones de los JSP de ejemplo de servicio web
- Problemas de Web Services Explorer
- Problemas cuando utiliza la herramienta de línea de mandatos de los servicios web
Limitaciones generales para servicios web
Al utilizar el JSP de cliente de prueba, si selecciona Habilitar invocación asíncrona y después invoca el servicio, se visualiza el mensaje de error siguiente: La clase de respuesta no está definida.
Puede resolver este problema probando el servicio de forma síncrona.
Liberty no soporta la publicación en UDDI. Sin embargo, Publicar el servicio web sigue estando seleccionado en el asistente de servicio web.
Puede utilizar un método alternativo para este problema. Quite la marca de la selección Publicar el servicio web. La página Publicación de servicio web sigue apareciendo; quite la marca de todos los recuadros de selección de esta página.
De forma predeterminada, Liberty no da soporte a clientes ligeros.
Puede utilizar un método alternativo para este problema. Para añadir soporte para clientes ligeros, puede instalar la versión tradicional de WebSphere Application Server y conseguir los archivos JAR del cliente ligero de la carpeta runtimes. A continuación, puede añadirlos a su proyecto Java.
También puede utilizar un tipo de proyecto distinto como, por ejemplo, un proyecto web.
Generic Service Client no está soportado en OS X. Utilice el WSE o las JSP de ejemplo para probar el servicio web.
- Si el destino es el perfil de Liberty y está generando un servicio web JAX-WS ascendente mediante el asistente de servicio web, puede recibir una excepción de puntero nulo.
- Al seleccionar la plantilla REST en el asistente Proyecto web nuevo, la versión de faceta JAX-RS inicial podría ser 2.0. Esta versión se debe cambiar manualmente a 1.1 para que IBM® WebSphere Application Server Liberty JAX-RS Library e IBMRestServlet Class aparezcan completadas de antemano en la página de configuración del servicio REST.
- [Liberty]La creación de un cliente de servicio web JAX-WS con el asistente de servicio web puede fallar si el servicio web JAX-WS se halla en un proyecto de paquete OSGi.
Este problema puede ocurrir si se crea un servicio web en un proyecto de paquete OSGi, no
selecciona Copiar WSDL en el proyecto en el asistente de servicio
web y, a continuación, despliega el proyecto de paquete OSGi en Liberty.Este proceso puede fallar cuando se crea el cliente JAX-WS desde el URL de servicio web con el archivo WSDL (Web Services Description Language) añadido. Las herramientas muestran el siguiente mensaje de error:
[ERROR] Ya se está utilizando una clase/interfaz con el mismo nombre "sample.ObjectFactory". Utilice una personalización de clase para resolver este conflicto.Este proceso puede fallar porque el archivo WSDL de servicio en el servidor de Liberty que utiliza el asistente de servicios web para crear el cliente contiene el elemento siguiente:<xs:complexType name="objectFactory"> <xs:sequence></xs:sequence> </xs:complexType>Para solucionar este problema, puede seleccionar Copiar WSDL en el proyecto en el asisten de servicios web cuando cree un proyecto de servicio web en un proyecto de paquete OSGi. Como alternativa, puede llevar a cabo los pasos siguientes:- Ver el URL de WSDL en un navegador y guardar el archivo WSDL en su sistema local.
- Eliminar el elemento complexType del archivo WSDL.
- Copiar el archivo WSDL en el directorio WEB-INF/wsdl de su proyecto de paquete OSGi.
- Añadir el atributo wsdlLocation al elemento @WebService de su archivo de origen Java de servicio web. El atributo wsdlLocation debe tener un valor que apunte a su archivo WSDL local. La línea siguiente es un ejemplo de este atributo.
wsdlLocation="WEB-INF/wsdl/Sample.wsdl"
Consejo: Si crea un el servicio web en un proyecto web en lugar de hacerlo en un proyecto de paquete OSGi, la generación del cliente de servicio web será satisfactoria. Las herramientas no muestran ningún mensaje de error. - [WebSphere Application Server traditional]
Después de crear un proyecto web JAX-RS, puede utilizar las herramientas para cambiar la
versión de la faceta. Cuando cambia la versión de la faceta entre JAX-RS 1.1 y 2.0, el
contenedor de la vía de acceso de clases no actualiza automáticamente los archivos
.jar incluidos. Puede solicitar a las herramientas que actualicen
los archivos .jar incluidos mediante la actualización de otros
niveles de faceta, como los niveles de faceta JPA.
A continuación, puede invertir los cambios a los niveles de faceta JPA. Consejo: Si crea un proyecto JAX-RS sin especificar un nivel de faceta, las herramientas utilizan JAX-RS 2.0 de manera predeterminada.
Problemas encontrados cuando se utiliza un WebSphere Application Server protegido
Puede encontrar los siguientes mensajes de error: Mensaje de error de SSLSocketFactory: java.net.SocketException: java.lang.ClassNotFoundException: No se puede encontrar la clase especificada com.ibm.websphere.ssl.protocol.SSLSocketFactory
Para poder utilizar Web Services Explorer, generar los JSP de ejemplo, crear un servicio web o un cliente a partir de un archivo HTTPS WSDL, o desplegar un servicio web de Axis, primero debe configurar el entorno de trabajo para que se comunique con un servidor a través de SSL (capa de sockets seguros). Puede encontrar información sobre esta tarea en: Problemas al trabajar con un servidor protegido utilizando conexiones SSL.
Puede encontrar el siguiente mensaje de error: Error al abrir el socket: javax.net.ssl.SSLHandshakeException: certificado desconocido
Para utilizar el asistente de servicios web para recuperar un WSDL HTTPS o utilizar Web Services Explorer en un WebSphere Application Server protegido, siga los pasos de Configuración de IBM JRE para comunicarse con un WebSphere Application Server protegido.
Problemas encontrados cuando se utilizan los asistentes de servicios web
Problemas encontrados cuando se utiliza un entorno de ejecución JAX-WS de WebSphere y JAXB
- Si intenta crear una biblioteca de esquemas donde hay distintos documentos de esquema que utilizan el mismo espacio de nombres, la función genera proyectos y código con errores de compilación. Los errores de compilación están en el archivo ObjectFactory.java. El problema es que, para un esquema, el código JAXB se genera en un paquete cuyo nombre se basa en el targetNamespace del esquema. También se genera una clase ObjectFactory.java en este paquete y su contenido se basa en todos los esquemas del mismo espacio de nombres. No puede dividirse o duplicarse para resolver los errores de compilación, ya que el entorno de ejecución espera esta clase específica para cada paquete. Por lo tanto, la característica de biblioteca de esquemas sólo funciona si todas las dependencias de esquema se encuentran en targetNamespaces diferentes.
- Como novedad en JAXB, el entorno de ejecución JAX-WS de IBM WebSphere ya no es responsable de resolver los conflictos de nombres. Cuando se producen estos conflictos, puede aparecer un mensaje de error como Error: La propiedad "nombre_propiedad" ya está definida.
La guía de aprendizaje siguiente proporciona más información y algunos ejemplos de cómo solucionar conflictos de nombres: Guía de aprendizaje de servicios web Java: Personalización de enlaces JAXB
Limitaciones cuando crea un cliente de servicio web
Cuando despliega un cliente de servicio web en un proyecto EJB, en la página de configuración del proxy, debe elegir el EJB en el que tendrá el ámbito el cliente de servicio web. Esta selección es un requisito definido por JSR-109, donde el nombre de componente de un elemento component-scoped-refs debe coincidir con el ejb-name de un EJB en el módulo.
Cuando hay al menos un EJB en el proyecto, no se producen errores. No obstante, si no hay EJB en el proyecto, las opciones en la página de configuración del proxy son editables y tienen un valor predeterminado igual al nombre de servicio del WSDL con el sufijo "EJB". Asimismo,el asistente del cliente muestra un aviso que indica que el despliegue está incompleto porque el cliente de servicios web no tiene el ámbito en un EJB existente. Puede solucionar este error creando un EJB con el mismo nombre que el nombre de componente utilizado en webservicesclient.xml.
No obstante, si opta por finalizar la creación del cliente cancelándola desde el asistente, el asistente no elimina el component-scoped-refs incompleto de webservicesclient.xml. Elimine el component-scoped-refs incompleto manualmente antes del nuevo despliegue.
Limitaciones de los JSP de ejemplo de servicio web
- Los JSP de ejemplo de servicio web no tienen soporte para los métodos que utilizan matrices o colecciones como parámetros. Estos métodos se omiten del panel Métodos de JSP de ejemplo.
Problemas de Web Services Explorer
- Cuando Web Services Explorer carga los archivos WSDL que utilizan varios esquemas incorporados, se generan mensajes de aviso para los tipos a los que se hace referencia en estos esquemas. El mensaje de aviso es similar al siguiente: La referencia de tipo <nombre_tipo_completo> no está resuelta. Se trata de avisos, no de errores, y no interfieren con la capacidad de Web Services Explorer para iniciar operaciones, por lo que pueden ignorarse de forma segura.
- Web Services Explorer no da soporte a la invocación de servicios web mediante la autenticación de servidores proxy que utilizan un protocolo distinto de la autenticación básica HTTP como, por ejemplo, NTLM. Si Web Services Explorer no puede conectarse al servicio web elegido por este o cualquier otro motivo, aparece en el panel de resultados el error IWAB0135E: Se ha producido un error inesperado seguido de información sobre la anomalía tal como se ha recuperado de la respuesta HTTP. Para resolver este problema, cambie a un servidor proxy de autenticación básica HTTP.
- Web Services Explorer tiene problemas cuando cambia desde la vista de origen a la vista de formulario si el esquema utiliza opciones que contienen secuencias. Si utiliza un elemento de opción en un complexType, la opción contiene dos o más elementos que incluyen una secuencia y cambia de la vista de formulario a la vista de origen, Web Services Explorer no podrá convertir correctamente el fragmento XML correspondiente de la vista de origen a la vista de formulario sin perder datos. Para resolver este problema, inicie la secuencia desde la vista de formulario cuando se especifiquen inicialmente los datos. Cuando se produce esta configuración, no se recomienda utilizar la vista de origen. Si se utiliza la vista de origen, no cambie de nuevo a la vista de formulario.
- Web Services Explorer importa WSDL sin resolver los URL de importación relativos. Cuando utiliza Web Services Explorer, existe un problema cuando se importa un WSDL desde la página WSDL al espacio de trabajo. Si se elige la opción Importar como referencia de servicio a un documento WSIL, hace referencia al URL original del WSDL y, por lo tanto, todas las importaciones relativas son accesibles. Si se elige Importar documento WSDL y el archivo WSDL contiene importaciones relativas, estas importaciones ya no son accesibles, lo que deja la copia del WSDL difícil o imposible de procesar en otro lugar en las herramientas. Si hay importaciones relativas en el WSDL que está importando, utilice el método WSIL. Si necesita una copia del WSDL, compruebe manualmente si hay importaciones relativas después de la importación para resolver los enlaces rotos.
- Web Services Explorer no funciona si utiliza la versión 8 de Java de JVM (máquina virtual Java) en Eclipse. Si inicia Web Services Explorer con la versión 8 de Java, la ventana principal mostrará HTTP Error 500. Para resolver este problema, utilice la versión 7 de Java como JVM de Eclipse o utilice el cliente de servicio genérico.
- Si instala WebSphere Developer Tools en un
entorno de trabajo Eclipse 4.5.1, Web Services Explorer no funciona. Si intenta
utilizar Web Services Explorer, la sección Response/Status de Web Services
Explorer está en blanco, y las herramientas muestran el error siguiente:
Para solucionar este problema, instale WebSphere Developer Tools en un entorno de trabajo de Eclipse 4.5.2. Para obtener más información sobre este problema, consulte Defecto 476132 - Problema de Web Services Explorer con Java 8 - La página se ha cargado con un error: no se puede analizar la respuesta.La página se ha cargado con un error: no se puede analizar la respuesta.
Problemas cuando utiliza la herramienta de línea de mandatos de los servicios web
- La importación de un EAR que contiene un cliente EJB generado por las herramientas de línea de mandatos utilizando Java EE 1.4 en el espacio de trabajo da como resultado errores de compilación. Para solucionar los errores, pulse con el botón derecho el proyecto EJB y seleccione Propiedades. Vaya a Vía de construcción Java y seleccione la pestaña Bibliotecas. Elimine la entrada EJBClientProject/imported_classes(carpeta de clases). Añada la carpeta de clases EJBServiceClient/imported_classes/Meta-inf/classess. Pulse Aceptar.
- [WebSphere Application Server traditional] Después de importar un EAR que contiene un cliente de aplicaciones generado por las herramientas de línea de mandatos utilizando Java EE 1.4 en el espacio de trabajo, aparecerá un error ClassNotFoundException cuando ejecute el cliente. Para corregir los errores, pulse con el botón derecho del ratón en el proyecto del cliente de aplicaciones y seleccione Propiedades. Vaya a Vía de construcción Java y seleccione la pestaña Bibliotecas. Elimine la entrada ApplicationClientProject/imported_classes(carpeta de clases). Añada la carpeta de clases ApplicationClientProject/imported_classes/Meta-Inf/classess. Pulse Aceptar.
- Las tareas Ant de servicios web que se dirigen al tiempo de ejecución de Axis manejan la generación de servicios web, pero no su despliegue. Como resultado, los servicios web de Axis que se crean utilizando las tareas Ant no son accesibles en el servidor en ejecución hasta que despliegue manualmente los servicios con el programa de utilidad AdminClient nativo de Apache Axis. Despliegue el archivo deploy.wsdd generado en los subdirectorios del directorio WebContent/WEB-INF del proyecto web en Axis manualmente utilizando la herramienta AdminClient de Axis. Consulte la sección "Utilización del AdminClient" en la Guía del usuario de Axis 1.4 para conocer más detalles.