Uso de especificaciones y estándares de servicios web
- Área: Integración
- Tipo de pauta: Directriz
- Carácter de la pauta: Recomendada
Se deben seguir las recomendaciones sobre la conveniencia o no de utilizar cada una de las especificaciones y estándares relacionados con el mundo de ws recogidos en MADEJA, y que se relacionan a continuación
Pautas
Título | Carácter |
---|---|
SOAP v1.1, 1.2 | Obligatoria |
WSDL 2.0 | Recomendada |
JAX-RPC | No Recomendada |
JAX-WS v2.0/2.1 | Obligatoria |
REST | No Recomendada |
JAXB | Recomendada |
WS Basic Profile v1.1 | Obligatoria |
WS-ReliableMessaging | Recomendada |
SOAP v1.1, 1.2
Obligatorio para Servicios Web que se integren con PLATINA
Se recomienda el uso de los estándares SOAP (Simple Object Access Protocol) para el intercambio de información en entornos distribuidos, siendo obligatorio para aquellos servicios que vayan a integrarse con PLATINA.
WSDL 2.0
Se recomienda el uso de WSDL 2.0
Los servicios web en sí son simples y versátiles, se trata de comunicaciones basadas en XML, descritos por una gramática basada en XML, llamada lenguaje descriptivo de servicios web (WSDL), el cual tiene interfaces abstractas de servicios, que consisten en mensajes expresados como un esquema XML.
Aunque no es un requerimiento, el formato elegido actualmente es SOAP sobre http. Esto significa que las interfaces de los servicios web están descritas en términos de los mensajes SOAP de entrada y salida, transmitidos sobre el protocolo HTTP.
Como modelo para la descripción de los servicios se recomienda el uso de WSDL 2.0 (Web Services Descripcion Language).
JAX-RPC
No se recomienda el uso de JAX-RPC
Se trata de una API Java para RPC (Remote Procedure Call) basado en XML que permite la invocación de servicios web desarrollados en Java cuya descripción está basada en WSDL. JAX-RPC 2.0 fue renombrado a JAX-WS 2.0 (Java API for XML WebServices), quedando obsoleto a partir de Java EE 6.
Puede emplearse en versiones de java inferiores a la versión 1.5
JAX-WS v2.0/2.1
Obligatorio para Java 1.5 y superiores
Se recomienda el uso de JAX-WS v2.0/2.1, siendo obligatorio a partir de la versión Java 1.5
REST
No recomendado para servicios que se integren con PLATINA
Se trata de una arquitectura de servicios distribuidos que sigue una serie de requisitos:
- En REST se publican son recursos en vez de un conjunto de métodos u operaciones (RPC). Un recurso se puede considerar como una entidad que representa un concepto de negocio que puede ser accedido públicamente.
- Cada recurso posee un identificador único y global, que lo distingue de cualquier otro recurso, aunque ambos tuvieran exactamente los mismos datos.
- Cada recurso posee un estado interno, que no puede ser accedido directamente desde el exterior.
JAXB
Recomendado para su uso con JAX-WS cuando el Servicio Web se implemente siguiendo el Modelo de Mensajes (SOA)
Se trata de una tecnología java que provee un API y una herramienta para ligar el esquema XML a una representación en código java. Con el uso de un esquema, se realiza una definición de los elementos que pueden estar contenidos en un documento XML. el esquema también es utilizado para la definición de la firma y la relación entre los elementos existentes.
WS Basic Profile v1.1
Es obligatorio el uso de WS Basic Profile v1.1
Se trata de un conjunto de especificaciones para servicios web que promueven la interoperabilidad, como SOAP y WSDL.
WS-ReliableMessaging
Se recomienda el uso de WS-ReliableMessaging
Describe un protocolo que permite el envío confiable de mensajes entre dos nodos frente a fallas en sistemas, componentes o conexión. El protocolo es independiente de la forma de transporte sin embargo se definió en esta especificación un enlace utilizando SOAP.
Se pueden especificar garantías de envío utilizando WS-Policy.
Contenidos relacionados
Código | Título | Tipo | Carácter |
---|---|---|---|
RECU-0100 | Especificaciones y estándares de servicios web | Especificación | Recomendado |
Código | Título | Tipo | Carácter |
---|---|---|---|
RECU-0217 | WS-Security | Especificación | Recomendado |
RECU-0598 | WS-Addressing | Especificación | Recomendado |