Web Service Contract Design and Versioning for SOA

The Ultimate Guide for Designing and Governing Web Service Contracts

 

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 ongoing 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.

 

Advanced Message Design with MTOM, and SwA

Developing SOAP messages capable of transporting large documents or binary content is explored with a documentation of the MTOM packaging and serialization framework (including MTOM-related policy assertions), together with the SOAP with Attachments (SwA) standard and the related WS-I Attachments Profile.

 

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 backward and forward 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.

 

 

 

Foreword

Preface

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 Vocabularies

Chapter 19: Advanced Message Design Part II: WS-Addressing 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: A Comparison of Web Services and REST Services

Appendix C: How Technology Standards are Developed

Appendix D: Alphabetical Pseudo Schema Reference

Appendix E: SOA Design Patterns Related to This Book

 

《設計和管理網路服務合約的終極指南》

為了使網路服務在SOA的框架下成功，它們需要平衡、有效的技術合約，以便服務能夠在未來多年中進行演進並重複使用。現在，一個由行業專家組成的團隊呈現了第一本從頭到尾指導設計和管理網路服務合約的書籍。作者針對開發人員、架構師、治理專家和其他IT專業人員撰寫，涵蓋以下領域：

- 瞭解網路服務合約技術
初級章節和持續的補充內容幫助即使是最沒經驗的專業人員也能快速掌握不同技術和設計考慮因素與網路服務合約的建立之間的關係。例如，書中提供了一個從邏輯和物理角度記錄的網路服務合約的視覺解剖圖，以及一章專門用平易近人的語言描述命名空間。該書還配有眾多案例研究和插圖。

- 基礎和高級WSDL
教學式介紹了WSDL 1.1和2.0，並詳細描述了它們之間的差異，然後介紹了許多高級WSDL主題和設計技巧，包括極度鬆散耦合、模塊化選項、可擴展元素的使用、非同步、消息分派、服務實例識別、非SOAP HTTP綁定和WS-BPEL擴展。書中還解釋了WSDL定義如何受到關鍵SOA設計模式的影響。

- 基礎和高級XML Schema
在Web服務和SOA的背景下介紹了XML Schema的基礎知識，然後進一步深入探討了各種專業化的消息設計考慮因素和技術，包括通配符的使用、模式和模式片段的可重用性、類型繼承和組合、CRUD風格的消息設計，以及結合行業和自定義模式。

- 基礎和高級WS-Policy
主題包括政策表達結構、組合政策、運算符組合規則和政策附件，為更高級的主題奠定了基礎，例如政策的可重用性和集中化、嵌套、參數化和可忽略的斷言，以及創建並行政策啟用的合約和設計自定義政策斷言和詞彙。

- 使用SOAP進行基礎消息設計
涵蓋了各種與消息設計相關的主題，包括SOAP消息結構、SOAP節點和角色、SOAP錯誤，以及設計自定義SOAP標頭和使用行業標準SOAP標頭。

- 使用WS-Addressing進行高級消息設計
通過深入描述WS-Addressing端點引用（EPRs）和MAP標頭，以及它們如何通過SOA設計模式應用，將消息設計提升到一個新的水平。書中還涵蓋了WSDL綁定考慮因素、相關MEP規則、WS-Addressing政策斷言，以及WS-Addressing與SOAP Action值的詳細關聯。

- 使用MTOM和SwA進行高級消息設計
探討了開發能夠傳輸大型文件或二進制內容的SOAP消息，並提供了MTOM封裝和序列化框架的文檔（包括與MTOM相關的政策斷言），以及如何通過SOA設計模式應用它們。