Web Service Contract Design and Versioning for SOA

Web Service Contract Design and Versioning for SOA

by Thomas Erl

  • Authors (in alphabetical order)
  • Thomas Erl
  • Hugo Haas
  • Anish Karmarkar
  • Canyang Kevin Liu
  • David Orchard
  • James Pasley
  • Andre Tost
  • Priscilla Walmsley
  • Umit Yalcinalp
  • Foreword by David Chappell
  • Prentice Hall/PearsonPTR
  • ISBN: 013613517X
  • Hardcover, 826 pages

About this Book

For Web services to succeed as part of SOA, they require balanced, effective technical contracts that enable services to be evolved and repeatedly reused for years to come. Now, a team of industry experts presents the first end-to-end guide to designing and governing Web service contracts.

Writing for developers, architects, governance specialists, and other IT professionals, the authors cover the following areas:

Understanding Web Service Contract Technologies

Initial chapters and on-going supplementary content help even the most inexperienced professional get up to speed on how all of the different technologies and design considerations relate to the creation of Web service contracts. For example, a visual anatomy of a Web Service contract documented from logical and physical perspectives is provided, along with a chapter dedicated to describing namespaces in plain English. The book is further equipped with numerous case study examples and many illustrations.

Fundamental and Advanced WSDL

Tutorial coverage of WSDL 1.1 and 2.0 and detailed descriptions of their differences is followed by numerous advanced WSDL topics and design techniques, including extreme loose coupling, modularization options, use of extensibility elements, asynchrony, message dispatch, service instance identification, non-SOAP HTTP binding, and WS-BPEL extensions. Also explained is how WSDL definitions are shaped by key SOA design patterns.

Fundamental and Advanced XML Schema

XML Schema basics are covered within the context of Web services and SOA, after which advanced XML Schema chapters delve into a variety of specialized message design considerations and techniques, including the use of wildcards, reusability of schemas and schema fragments, type inheritance and composition, CRUD-style message design, and combining industry and custom schemas.

Fundamental and Advanced WS-Policy

Topics, such as Policy Expression Structure, Composite Policies, Operator Composition Rules, and Policy Attachment establish a foundation upon which more advanced topics, such as policy reusability and centralization, nested, parameterized, and ignorable assertions are covered, along with an exploration of creating concurrent policy-enabled contracts and designing custom policy assertions and vocabularies.

Fundamental Message Design with SOAP

A broad range of message design-related topics are covered, including SOAP message structures, SOAP nodes and roles, SOAP faults, designing custom SOAP headers and working with industry-standard SOAP headers.

Advanced Message Design with WS-Addressing

The art of message design is taken to a new level with in-depth descriptions of WS-Addressing endpoint references (EPRs) and MAP headers and an exploration of how they are applied via SOA design patterns. Also covered are WSDL binding considerations, related MEP rules, WS-Addressing policy assertions, and detailed coverage of how WS-Addressing relates to SOAP Action values.

Versioning Techniques and Strategies

Fundamental versioning theory starts off a series of chapters that dive into a variety of versioning techniques based on proven SOA design patterns including backwards and forwards compatibility, version identification strategies, service termination, policy versioning, validation by projection, concurrency control, partial understanding, and versioning with and without wildcards.

Web Service Contracts and SOA

The constant focus of this book is on the design and versioning of Web service contracts in support of SOA and service-orientation. Relevant SOA design principles and design patterns are periodically discussed to demonstrate how specific Web service technologies can be applied and further optimized. Furthermore, several of the advanced chapters provide expert techniques for designing Web service contracts while taking SOA governance considerations into account.


SOA Certified Professional Program

This book is part of the official curriculum for the SOA School SOA Certified Professional Program.

For more information, visit www.soaschool.com


To be notified of new book releases and other updates to this site, please connect with the social media channels at: www.arcitura.com/community


"This compendium is the new bible for WS-* design and SOA. The structured approach allows beginners, experts and executives to understand and execute successfully on an SOA Strategy. Thomas Erl and his team did once again a great job."

- Sascha Kuhlmann, Global Program Lead Enterprise Architecture, SAP

"A first-rate and in-depth dive into service contract and interface design that elaborates on the best book in the field, SOAPrinciples of Service Design. Over the years Thomas's books have provided a foundation for defining our SOA standards (for over 200 services) and contain the latest material and case studies which comprise the singular most important advice for those implementing large-scale SOAs."

- Bob Hathaway, Senior SOA Architect, SOA Object Systems, Starwood Hotels

"Anyone tasked with publishing and evolving Web services 'contract first' will welcome this book, packed full of authoritative explanations and advice from authors who truly understand their subject."

- Paul Downey, Chief Web Services Architect, BT

"This book is an excellent resource for anybody trying to get a comprehensive understanding of the technical foundation of Web services based service-oriented architecture. It is written by the experts who have worked on the development of the underlying world-wide standards."

- Michael Bechauf, Vice President of Standards Strategy and Developer Programs, SAP AG

"This book is a great guide to designing Web service contracts. All aspects of contract design one encounters in real-life SOA projects are described clearly and in detail by the authors. Whether it concerns namespaces, versioning mechanisms, schemas or policies, this book tells you how to deal with them."

"An absolute must-read for every architect and developer involved in SOA projects."AG"

- Linda Terlouw, Solution Architect, Ordina, Researcher, Delft University of Technology

"Web Service Contract Design and Versioning for SOA is a clear, authoritative, and integrated treatment of the five W3C specifications that form the core of classic Web service description: XML Schema, SOAP, WSDL, WS-Policy, and WS-Addressing. Its authors include committee members who developed these specifications as well as recognized experts in this field."

"This book is both an excellent starting point for developers who are seeking to acquire Web service design skills and a reference for experienced designers who want to understand the finer points of this topic. The advanced material on designing flexible message formats and on versioning contracts is especially relevant for building Web services that can evolve gracefully over time."

- Arthur Ryman, Distinguished Engineer, IBM, BT

"While service-orientation is delivering on its promises in many organizations, service contracts must withstand the evolution of maturing service-oriented enterprises. The expert design advice in this work enables enterprise architects to build flexibility into service interfaces and meet the needs of the dynamic modern technology organization."

"From WSDL and schema design to advanced WS-Policy and WS-Addressing, the authors simplify complex topics through practical, plain-English examples that will benefit anyone responsible for service design and delivery."

- Kevin P. Davis, Ph. D., Software Architect BT

Table of Contents

  • Chapter 1: Introduction
  • Chapter 2: Case Study Background
  • Part I: Fundamental Service Contract Design
  • Chapter 3: SOA Fundamentals and Web Service Contracts
  • Chapter 4: Anatomy of a Web Service Contract
  • Chapter 5: A Plain English Guide to Namespaces
  • Chapter 6: Fundamental XML Schema: Types and Message Structure Basics
  • Chapter 7: Fundamental WSDL Part I: Abstract Description Design
  • Chapter 8: Fundamental WSDL Part II: Concrete Description Design
  • Chapter 9: Fundamental WSDL 2.0: New Features, and Design Options
  • Chapter 10: Fundamental WS-Policy: Expression, Assertion, and Attachment
  • Chapter 11: Fundamental Message Design: SOAP Envelope Structure and Header Block Processing
  • Part II: Advanced Service Contract Design
  • Chapter 12: Advanced XML Schema Part I: Message Flexibility, and Type Inheritance and Composition
  • Chapter 13: Advanced XML Schema Part II: Reusability, Derived Types, and Relational Design
  • Chapter 14: Advanced WSDL Part I: Modularization, Extensibility, MEPs, and Asynchrony
  • Chapter 15: Advanced WSDL Part II: Message Dispatch, Service Instance Identification, and Non-SOAP HTTP Binding
  • Chapter 16: Advanced WS-Policy Part I: Policy Centralization and Nested, Parameterized, and Ignorable Assertions
  • Chapter 17: Advanced WS-Policy Part II: Custom Policy Assertion Design, Runtime Representation, and Compatibility
  • Chapter 18: Advanced Message Design Part I: WS-Addressing EPRs and MAP Headers
  • Chapter 19: Advanced Message Design Part II: WS-Addressing Messaging Rules and Design Techniques
  • Part III: Service Contract Versioning
  • Chapter 20: Versioning Fundamentals
  • Chapter 21: Versioning WSDL Definitions
  • Chapter 22: Versioning Message Schemas
  • Chapter 23: Advanced Versioning
  • Part IV: Appendices
  • Appendix A: Case Study Conclusion
  • Appendix B: How Technology Standards Are Developed
  • Appendix C: Alphabetical Pseudo Schema Reference
  • Appendix D: Namespaces and Prefixes Used in this Book
  • Appendix E: SOA Design Patterns Related to this Book