Contenidos
Tipos de servicios web
Construirá un cliente que obtenga los datos del país desde un servicio web remoto basado en WSDL utilizando SOAP. Puede obtener más información sobre el servicio de países y ejecutar el servicio usted mismo siguiendo esta guía.
La interfaz de un servicio web SOAP se captura en WSDL. JAXB proporciona una forma de generar clases Java a partir del WSDL (o mejor dicho, del XSD contenido en la sección <Types/> del WSDL). Puede encontrar el WSDL para el servicio del país en http://localhost:8080/ws/countries.wsdl.
Esta configuración generará clases para el WSDL encontrado en la URL especificada, poniendo esas clases en el paquete com.example.consumingwebservice.wsdl. Para generar ese código ejecuta ./mvnw compile y luego mira en target/generated-sources si quieres comprobar que ha funcionado.
Como Gradle no tiene (todavía) un plugin JAXB, implica una tarea Ant, lo que lo hace un poco más complejo que en Maven. Para generar ese código ejecuta ./gradlew compileJava y luego mira en build/generated-sources si quieres comprobar que ha funcionado.
Para crear un cliente de servicio web, tienes que extender la clase WebServiceGatewaySupport y codificar tus operaciones, como muestra el siguiente ejemplo (de src/main/java/com/example/consumingwebservice/CountryClient.java):
Tutorial de servicios web
Una API web es un desarrollo de los servicios web en el que se ha hecho hincapié en comunicaciones más sencillas basadas en la transferencia de estado representacional (REST)[2] Las APIs Restful no requieren protocolos de servicios web basados en XML (SOAP y WSDL) para soportar sus interfaces.
Un servicio web es un sistema de software diseñado para soportar la interacción interoperable entre máquinas a través de una red. Tiene una interfaz descrita en un formato procesable por la máquina (concretamente, WSDL). Otros sistemas interactúan con el servicio web de la manera prescrita por su descripción utilizando mensajes SOAP, normalmente transmitidos usando HTTP con una serialización XML en conjunto con otros estándares relacionados con la web.- W3C, Web Services Glossary[3]
Los servicios web del W3C pueden utilizar el protocolo SOAP sobre HTTP, lo que permite interacciones menos costosas (más eficientes) a través de Internet que mediante soluciones propietarias como EDI/B2B. Además de SOAP sobre HTTP, los servicios web también pueden implementarse sobre otros mecanismos de transporte fiables como el FTP. En un documento de 2002, el Grupo de Trabajo de Arquitectura de Servicios Web definió una arquitectura de servicios web, que requiere una implementación estandarizada de un “servicio web”.
Ejemplo de servicio web de jabón
Los servicios web permiten a las empresas compartir la funcionalidad de las aplicaciones independientemente del lenguaje de origen, el sistema operativo o el hardware utilizado para crear esa funcionalidad. Los servicios web superan las incompatibilidades de implementación utilizando protocolos estándar de Internet y mensajería basada en XML para proporcionar una comunicación entre componentes.
Las aplicaciones invocan los Servicios Web como si fueran llamadas a procedimientos remotos, con la diferencia de que la llamada al procedimiento y la respuesta se gestionan mediante mensajes SOAP incrustados en las peticiones y respuestas HTTP. Una aplicación llama a un Servicio Web enviando un mensaje SOAP incrustado en una petición HTTP a una ubicación web asociada a ese servicio. El Servicio Web realiza la lógica de la aplicación para ese mensaje y luego devuelve cualquier resultado de la aplicación en forma de otro mensaje SOAP incrustado en una respuesta HTTP.
Un proveedor de servicios web es una organización que crea y aloja servicios web. Normalmente, un proveedor publica información sobre su organización y los servicios que ofrece en un registro de Servicios Web que puede ser consultado por los miembros de la organización o posiblemente por otras empresas.
API de servicios web
Aprender a usar las APIs por primera vez es complicado: no sólo hay muchos términos técnicos, sino que estos términos a menudo se solapan en su significado. Esto, comprensiblemente, provoca cierta confusión, ya que algunas palabras significan casi lo mismo, pero no exactamente.
Sin embargo, es importante entender lo que distingue a los servicios web de las API, ya que tienen diferentes usos dependiendo de las necesidades de su software. En esta guía, repasaremos brevemente lo que son las API y los servicios web individualmente, para luego comparar ambos y destacar sus diferencias.
Una interfaz de programación de aplicaciones, o API para abreviar, es un componente de software que permite que dos aplicaciones no relacionadas entre sí se comuniquen. Una API consiste en reglas y funciones estandarizadas que determinan qué datos pueden tomarse o modificarse dentro de una aplicación, y cómo se produce este proceso.
Las API se utilizan para las integraciones de software, ya que exponen algunos de los datos y funcionalidades internos de una aplicación para que los desarrolladores los utilicen. Esto es lo que hace que una API sea una “interfaz”: actúa como una interfaz en la que se pueden solicitar datos de una aplicación que, de otro modo, estaría cerrada.