diff --git a/src/docbkx/preface.xml b/src/docbkx/preface.xml index bd0596ef..ec8b9db4 100644 --- a/src/docbkx/preface.xml +++ b/src/docbkx/preface.xml @@ -4,15 +4,25 @@ Preface - Web services development is a complicated affair. There is SOAP, there is REST. There is SOAP 1.1, and there is - SOAP 1.2. There is rpc/encoded, and there is document/literal. There is WS-Addressing, WS-Security, WS-Policy, - and various other Web service specifications. Implementing Web services using abstractions that magically turn - Java into XML, but turn out to be leaky abstractions makes it even harder. Spring Web Services provides a - solution for building interoperable Web services, while making it clear what XML is received and sent across the - wire. Spring-WS provides a powerful message dispatching framework, various XML marshalling techniques that can be used outside a Web service environment, and a interlingua of SOA. When developing or using Web services, the focus should be + on this XML, and not on Java. + + + Spring Web Services focusses on creating these document-driven Web services. + Spring Web Services facilitates contract-first SOAP service development, allowing for the creation of + flexible web services using one of the many ways to manipulate XML payloads. + Spring-WS provides a powerful message dispatching framework, various XML marshalling techniques that can be used outside a Web service environment, a WS-Security solution that integrates with your existing application security - solution. + solution, and a Client-side API that follows the familiar Spring template pattern. This document provides a reference guide to Spring-WS's features. Since this document is still a