Uso de especificaciones y estándares de servicios web

LIBP-0320 (Libro de pautas)

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ítuloCarácter
SOAP v1.1, 1.2Obligatoria
WSDL 2.0Recomendada
JAX-RPCNo Recomendada
JAX-WS v2.0/2.1Obligatoria
RESTNo Recomendada
JAXBRecomendada
WS Basic Profile v1.1Obligatoria
WS-ReliableMessagingRecomendada

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

Recursos
Área: Arquitectura » Integración
Código Título Tipo Carácter
RECU-0100 Especificaciones y estándares de servicios web Especificación Recomendado
Área: Desarrollo » Seguridad » Servicios Web
Código Título Tipo Carácter
RECU-0217 WS-Security Especificación Recomendado
RECU-0598 WS-Addressing Especificación Recomendado