Cómo crear un servicio web SOAP en Java con Spring Boot ======================================================= **Introducción** En este artículo, aprenderemos cómo crear un **servicio web basado en SOAP** utilizando Spring Boot Starter Web Services. A medida que las empresas buscan maneras más eficientes de comunicarse y compartir datos, los servicios web han tomado un rol central en la interacción entre sistemas. Los servicios web basados en SOAP son conocidos por su robustez y contratos bien definidos, y combinan perfectamente un enfoque de desarrollo de «contrato primero». Si eres un programador Java en busca de fortalecer tus habilidades en la creación de servicios web, este tutorial te proporcionará una guía paso a paso. **¿Qué son los Servicios Web SOAP?** **Definición Básica** En términos sencillos, un servicio web es un servicio que permite la comunicación entre máquinas, sin depender de la plataforma que se utilice. **SOAP (Simple Object Access Protocol)** es un protocolo de mensajería que se basa en el intercambio de documentos XML sobre HTTP. A continuación, se detallan algunos de los conceptos esenciales relacionados con SOAP: * **Mensajes**: Tanto las solicitudes como las respuestas son documentos XML. * **WSDL (Web Services Description Language)**: Proporciona un conjunto de reglas para definir los mensajes, los enlaces, las operaciones y la ubicación del servicio [WSDL en Spring](https://docs.spring.io/spring-ws/sites/1.5/reference/html/why-contract-first.html). Debido a la complejidad del XML que se utiliza en SOAP, es recomendable utilizar frameworks como JAX-WS o Spring, como veremos en este tutorial. **Estilo de Desarrollo «Contrato Primero»** **Enfoques Disponibles** Existen dos enfoques principales al crear un servicio web: 1. **Contrato Atrasado (Contract-Last)**: Iniciamos con el código Java y generamos el contrato del servicio (WSDL) a partir de las clases. 2. **Contrato Primero (Contract-First)**: **Comenzamos con el contrato WSDL, a partir del cual generamos las clases en Java.** Spring-WS solo admite el estilo de desarrollo «contrato primero». Este enfoque es ventajoso porque permite definir claramente el servicio antes de implementarlo. **Configuración del Proyecto Spring Boot** A continuación, procederemos a configurar nuestro proyecto Spring Boot para definir nuestro servidor de WS SOAP. **1\. Dependencias de Maven** Comencemos añadiendo el **spring-boot-starter-parent** a nuestro proyecto: org.springframework.boot spring-boot-starter-parent Luego añadiremos el **spring-boot-starter-web-services** y **wsdl4j**: org.springframework.boot spring-boot-starter-web-services wsdl4j wsdl4j **2\. El Archivo XSD** El enfoque «contrato primero» exige que primero creemos el dominio (métodos y parámetros) para nuestro servicio. Utilizaremos un archivo de esquema XML (XSD) que Spring-WS convertirá automáticamente en un WSDL. Aquí está un ejemplo básico de un archivo XSD que define cómo se verán nuestras solicitudes y respuestas: Este archivo define cómo se verá la solicitud **getCountryRequest**, que acepta un parámetro de tipo **string**, y la respuesta **getCountryResponse**, que contiene un objeto tipo **country**. **3\. Generar Clases Java del Dominio** Generaremos ahora las clases Java del archivo XSD definido anteriormente. El **jaxb2-maven-plugin** se encargará de esto automáticamente en el momento de la construcción. Usaremos el plugin para compilar el archivo XSD en clases Java totalmente anotadas. Agreguemos y configuremos el plugin en nuestro archivo **pom.xml**: org.codehaus.mojo jaxb2-maven-plugin 3.1.0 xjc xjc src/main/resources/countries.xsd src/main/java false Para generar las clases Java, ejecutamos el siguiente comando en la terminal: mvn compile **4\. Añadir el Endpoint del Servicio Web SOAP** La clase del endpoint del servicio SOAP manejará todas las solicitudes entrantes del servicio. Antes de definirlo, crearemos un repositorio **Country** para proporcionar datos al servicio web: @Component public class CountryRepository { private static final Map countries = new HashMap<>(); @PostConstruct public void initData() { countries.put("Spain", new Country("Spain", 46704314, "Madrid", "EUR")); // Inicializar otros países... } public Country findCountry(String name) { return countries.get(name); } } Ahora, definamos el endpoint: @Endpoint public class CountryEndpoint { private static final String NAMESPACE_URI = "http://www.baeldung.com/springsoap/gen"; private CountryRepository countryRepository; @Autowired public CountryEndpoint(CountryRepository countryRepository) { this.countryRepository = countryRepository; } @PayloadRoot(namespace = NAMESPACE_URI, localPart = "getCountryRequest") @ResponsePayload public GetCountryResponse getCountry(@RequestPayload GetCountryRequest request) { GetCountryResponse response = new GetCountryResponse(); response.setCountry(countryRepository.findCountry(request.getName())); return response; } } **Detalles Importantes** 1. **@Endpoint**: Registra la clase como un Endpoint del Servicio Web de Spring WS. 2. **@PayloadRoot**: Define el método manejador según los atributos de **namespace** y **localPart**. 3. **@ResponsePayload**: Indica que este método devuelve un valor que se mapea al payload de respuesta. 4. **@RequestPayload**: Indica que este método acepta un parámetro que se mapea a la solicitud entrante. **5\. Beans de Configuración del Servicio Web SOAP** Crearemos una clase para configurar el servlet del despachador de mensajes de Spring para recibir las solicitudes: @EnableWs @Configuration public class WebServiceConfig extends WsConfigurerAdapter { // definiciones de beans } La anotación **@EnableWs** habilita las características del Servicio Web SOAP en esta aplicación Spring Boot. La clase **WebServiceConfig** extiende de la clase base **WsConfigurerAdapter**, que configura el modelo de programación de Spring-WS impulsado por anotaciones. Ahora, crearemos un **MessageDispatcherServlet**, que se utiliza para manejar solicitudes SOAP: @Bean public ServletRegistrationBean messageDispatcherServlet(ApplicationContext applicationContext) { MessageDispatcherServlet servlet = new MessageDispatcherServlet(); servlet.setApplicationContext(applicationContext); servlet.setTransformWsdlLocations(true); return new ServletRegistrationBean<>(servlet, "/ws/*"); } Configura el objeto **ApplicationContext** del **servlet** para que Spring-WS pueda encontrar otros beans de Spring y habilita la transformación de la ubicación del WSDL. Esto transforma el atributo **location** de **soap:address** en el WSDL de manera que refleje la URL de la solicitud entrante. Finalmente, crearemos un objeto **DefaultWsdl11Definition** para exponer un WSDL 1.1 utilizando un **XsdSchema**: @Bean(name = "countries") public DefaultWsdl11Definition defaultWsdl11Definition(XsdSchema countriesSchema) { DefaultWsdl11Definition wsdl11Definition = new DefaultWsdl11Definition(); wsdl11Definition.setPortTypeName("CountriesPort"); wsdl11Definition.setLocationUri("/ws"); wsdl11Definition.setTargetNamespace("http://www.baeldung.com/springsoap/gen"); wsdl11Definition.setSchema(countriesSchema); return wsdl11Definition; } @Bean public XsdSchema countriesSchema() { return new SimpleXsdSchema(new ClassPathResource("countries.xsd")); } **Prueba del Proyecto SOAP** Una vez que la configuración del proyecto está completa, estamos listos para probarlo. **1\. Compilar y Ejecutar el Proyecto** Podemos crear un archivo WAR y desplegarlo en un servidor de aplicaciones externo, pero utilizaremos Spring Boot, lo que es más rápido y sencillo. Para hacer la aplicación ejecutable, añadimos la siguiente clase: @SpringBootApplication public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } Con esto, ejecutamos la aplicación: mvn spring-boot:run Para verificar que la aplicación está funcionando correctamente, podemos abrir el WSDL a través de la URL: [http://localhost:8080/ws/countries.wsdl](http://localhost:8080/ws/countries.wsdl). **2\. Probar una Solicitud SOAP** Para probar una solicitud, crearemos el siguiente archivo llamado **request.xml**: Spain Usaremos herramientas externas como SoapUI o la extensión Wizdler de Google Chrome. Otra forma de enviar la solicitud es usando el siguiente comando en nuestra terminal: curl --header "content-type: text/xml" -d @request.xml http://localhost:8080/ws La respuesta resultante podría no ser fácil de leer sin formato. Para ver el resultado de forma más clara, podemos copiarlo y pegarlo en nuestro IDE o utilizar **xmllint**: curl [command-line-options] | xmllint --format - La respuesta debería contener información sobre España:

Spain 46704314 Madrid EUR

**Conclusión** En este artículo, aprendimos cómo crear un servicio web SOAP utilizando Spring Boot. También demostramos cómo generar código Java a partir de un archivo XSD y configuramos los beans de Spring necesarios para procesar las solicitudes SOAP. Implementar y probar un servicio web SOAP puede parecer complicado al principio, pero siguiendo estos pasos verás que es un proceso manejable. Este enfoque «contrato primero» ayuda a establecer una base clara para tu servicio desde el principio. Si deseas profundizar más, considera explorar documentación adicional sobre Spring WS y SOAP, así como las mejores prácticas en el desarrollo de servicios web.