spring-web-services

Structure contract-first SOAP endpoints and clients with Spring Web Services.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/ririnto/sinon --skill spring-web-services
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spring-web-services
Source: https://github.com/ririnto/sinon/tree/main/plugins/spring/skills/spring-web-services
Command: npx skills add https://github.com/ririnto/sinon --skill spring-web-services

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill helps developers implement contract-first SOAP services and clients in Spring by aligning XSD/WSDL contracts with Spring-WS, JAXB marshalling, and WS-Security integration.

Core Features & Use Cases

  • Contract-first SOAP endpoint and client design using XSD/WSDL contracts
  • JAXB-based data binding and WebServiceTemplate integration
  • WS-Security-aware configuration for signing and encryption (when required)
  • Guidance for SOAP fault handling, endpoint mapping, and contract testing
  • Use Case: Expose a Holidays-like SOAP service with contract-driven payloads

Quick Start

Boot a Spring Boot app with spring-ws, define an XSD/WSDL contract, and implement an @Endpoint to expose a SOAP service.

Frequently Asked Questions about spring-web-services

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build contract-first SOAP services in Spring using XSD and WSDL contracts?

To build contract-first SOAP services in Spring, you define XSD and WSDL contracts first, then implement @Endpoint handlers using Spring Web Services to map incoming XML payloads to JAXB-marshalled objects for structured endpoint exposure.

What is the best way to configure WS-Security for signing and encryption in Spring Web Services?

Configuring WS-Security in Spring Web Services involves applying security interceptors to your endpoint mappings to handle XML signing and encryption, ensuring SOAP messages are protected across both server and client WebServiceTemplate integrations.

How does JAXB marshalling work with Spring Web Services endpoints?

JAXB marshalling in Spring Web Services works by automatically converting XML request payloads into Java objects for @Endpoint handlers, and then serializing response objects back into XML payloads using the configured WebServiceTemplate.

How do I handle SOAP faults and errors when building contract-first Spring endpoints?

Handling SOAP faults in contract-first Spring endpoints requires defining fault details within your XSD or WSDL contract, then mapping Java exceptions to corresponding SOAP fault responses through Spring Web Services endpoint exception resolvers.

Can I use Spring Web Services to generate and publish WSDL from an existing XSD schema?

Yes, Spring Web Services supports publishing WSDL from an existing XSD schema through its DefaultWsdl11Definition configuration, automatically exposing the WSDL contract while keeping your contract-first SOAP service structure aligned with the defined schema.

Do I need a Spring Boot application to expose a contract-first SOAP endpoint?

You need a Spring Boot application configured with the spring-ws dependency to expose a contract-first SOAP endpoint, which provides the necessary servlet infrastructure to automatically map and route incoming SOAP requests to your @Endpoint classes.