= Spring Web Services Reference Documentation
Arjen Poutsma, Rick Evans, Tareq Abed Rabbo, Greg Turnquist, Jay Bryant, Corneil du Plessis, Stéphane Nicoll
:doctype: book
:revnumber: {gradle-project-version}
:revdate: {localdate}
:toc: left
:toclevels: 4
:source-highlighter: prettify
:sectnumlevels: 3
:docs-site: https://docs.spring.io
:spring-framework-docs-root: {docs-site}/spring-framework/docs
:spring-framework-api: {spring-framework-docs-root}/{spring-framework-version}/javadoc-api/org/springframework
:spring-framework-docs: https://docs.spring.io/spring-framework/reference
:spring-ws-docs-root: {docs-site}/spring-ws/docs
:spring-ws-api: {spring-ws-docs-root}/{spring-ws-version}/api/org/springframework/ws

NOTE: Copies of this document may be made for your own use and for distribution to others, provided that you do not charge any fee for such copies and further provided that each copy contains this Copyright Notice, whether distributed in print or electronically.

:sectnums!:

[[spring-framework-reference]]
include::preface.adoc[leveloffset=+1]

:sectnums!:
= I. Introduction
:sectnums:

This first part of the reference documentation <<what-is-spring-ws,is an overview>> of Spring Web Services and the underlying concepts.
Then, <<why-contract-first,the concepts>> behind contract-first web service development are explained.
Finally, the third section provides <<tutorial,a tutorial>>.

include::what-is-spring-ws.adoc[leveloffset=+1]

include::why-contract-first.adoc[leveloffset=+1]

include::tutorial.adoc[leveloffset=+1]

:sectnums!:
= II. Reference
:sectnums:

This part of the reference documentation details the various components that comprise Spring Web Services.
This includes <<common,a chapter>> that discusses the parts common to both client- and server-side WS, a chapter devoted to the specifics of <<server,writing server-side web services>>, a chapter about using web services on <<client,the client-side>>, and a chapter on using <<security,WS-Security>>.

include::common.adoc[leveloffset=+1]

include::server.adoc[leveloffset=+1]

include::client.adoc[leveloffset=+1]

include::security.adoc[leveloffset=+1]

:sectnums!:
[[resources]]
= III. Other Resources
:sectnums:

In addition to this reference documentation, a number of other resources may help you learn how to use Spring Web Services.
These additional, third-party resources are enumerated in this section.

:sectnums!:

include::bibliography.adoc[leveloffset=+1]
