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 SOAPA 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. About the Web Sites www.soabooks.com supplements this book with a variety of resources, including a diagram symbol legend, glossary, supplementary articles, and source code available for download. www.soaspecs.com provides further support by establishing a descriptive portal to XML and Web services specifications referenced in all of Erl’s Service-Oriented Architecture books. 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
Author(s): Thomas Erl, Anish Karmarkar, Priscilla Walmsley, Hugo Haas, L. Umit Yalcinalp, Kevin Liu, David Orchard, Andre Tost, James Pasley
Edition: 1
Year: 2008
Language: English
Pages: 847
Contents......Page 10
Foreword......Page 36
Preface......Page 38
CHAPTER 1: Introduction......Page 42
1.1 About this Book......Page 43
1.2 Objectives of this Book......Page 44
1.5 Prerequisite Reading......Page 45
1.6 Supplementary Reading......Page 46
Part I: Fundamental Service Contract Design......Page 47
Part II: Advanced Service Contract Design......Page 50
Part III: Service Contract Versioning......Page 53
Part IV: Appendices......Page 54
1.9 Additional Information......Page 55
Supplementary Posters (www.soaposters.com)......Page 56
Notification Service (www.soabooks.com)......Page 57
CHAPTER 2: Case Study Background......Page 58
History and Culture......Page 59
Business Goals and Obstacles......Page 60
PART I: FUNDAMENTAL SERVICE CONTRACT DESIGN......Page 62
CHAPTER 3: SOA Fundamentals and Web Service Contracts......Page 64
3.1 Basic SOA Terminology......Page 65
3.2 Service-Oriented Computing Goals and Web Service Contracts......Page 78
3.3 Service-Orientation and Web Service Contracts......Page 80
3.4 SOA Design Patterns and Web Service Contracts......Page 85
CHAPTER 4: Anatomy of a Web Service Contract......Page 90
4.1 What is a Web Service Contract?......Page 91
4.2 The Parts of a Web Service Contract......Page 94
4.3 Technologies Used to Create Web Service Contracts......Page 107
4.4 Guidelines for Using Web Service Contract Technologies......Page 117
CHAPTER 5: A Plain English Guide to Namespaces......Page 122
5.1 Elements, Attributes, and Namespaces......Page 123
5.2 Namespace Terminology......Page 132
5.3 What's in a Name(space)?......Page 135
5.4 Namespace Syntax......Page 143
5.5 Namespaces and Web Service Contracts......Page 153
CHAPTER 6: Fundamental XML Schema: Types and Message Structure Basics......Page 158
"XML Schema" vs. "XML schema"......Page 159
Case Study Background......Page 160
6.1 XML Schema Structure......Page 162
6.2 Elements and Attributes......Page 163
6.3 Types......Page 170
6.4 Namespaces......Page 184
Case Study Example......Page 193
6.5 Message Structures......Page 195
Case Study Example......Page 196
Case Study Example......Page 204
CHAPTER 7: Fundamental WSDL Part I: Abstract Description Design......Page 208
IRI vs. URI vs. URL vs. URN......Page 209
7.1 WSDL Definition and Documentation......Page 210
Case Study Example......Page 215
7.2 Abstract Description Structure......Page 216
7.3 Type Definitions......Page 217
Case Study Example......Page 219
7.4 Message Definitions......Page 222
Case Study Example......Page 224
7.5 Operation Definitions......Page 227
7.6 Port Type Definitions......Page 231
Case Study Example......Page 233
CHAPTER 8: Fundamental WSDL Part II: Concrete Description Design......Page 238
8.1 Concrete Description Structure......Page 239
8.2 Binding Definition......Page 240
Case Study Example......Page 251
Case Study Example......Page 255
8.3 Service and Port Definitions......Page 256
Case Study Example......Page 258
8.4 A Complete WSDL Definition (Including the Concrete Description)......Page 259
Case Study Example......Page 260
CHAPTER 9: Fundamental WSDL 2.0: New Features and Design Options......Page 266
9.1 WSDL 2.0 Document Structure......Page 267
9.2 Interface Definition......Page 268
9.4 A Complete WSDL 2.0 Definition......Page 276
CHAPTER 10: Fundamental WS-Policy: Assertions, Expressions, and Attachments......Page 282
10.1 Policy Structure......Page 284
10.2 Composite Policies......Page 289
10.3 Operator Composition Rules......Page 292
10.4 Attaching Policies to WSDL Definitions......Page 298
Case Study Example......Page 307
CHAPTER 11: Fundamental Message Design: SOAP Envelope Structure, Fault Messages, and Header Processing......Page 312
What SOAP is Not......Page 313
Case Study Background......Page 314
11.1 SOAP Message Structure......Page 315
11.2 SOAP Nodes and Roles......Page 319
Case Study Example......Page 321
11.3 SOAP Header Blocks and Targeted Processing......Page 322
Case Study Example......Page 327
11.4 SOAP Intermediaries......Page 334
11.5 Fault Messages......Page 338
PART II: ADVANCED SERVICE CONTRACT DESIGN......Page 348
CHAPTER 12: Advanced XML Schema Part I: Message Flexibility, Type Inheritance, and Composition......Page 350
12.1 Message Flexibility and Constraint Granularity......Page 351
Case Study Example......Page 362
12.2 Type Inheritance and Composition......Page 368
12.3 Common CRUD Messages Types......Page 378
CHAPTER 13: Advanced XML Schema Part II: Reusability, Relational Design, and Industry Schemas......Page 394
13.1 Reusable Schema Design......Page 395
Case Study Example......Page 397
Case Study Example......Page 403
Case Study Example......Page 404
13.2 Representing Relationships in XML Schemas......Page 410
13.3 Narrative Content......Page 418
13.4 Incorporating Industry Schemas......Page 420
Case Study Example......Page 422
Case Study Example......Page 428
CHAPTER 14: Advanced WSDL Part I: Modularization, Extensibility, MEPs, and Asynchrony......Page 436
14.1 Modularization Mechanisms......Page 437
Case Study Example......Page 441
Case Study Example......Page 450
Case Study Example......Page 453
14.2 Extending the WSDL Language......Page 459
14.3 Special Message Exchange Patterns......Page 462
Case Study Example......Page 466
14.4 Designing Asynchronous Operations......Page 468
14.5 WS-BPEL and WSDL......Page 479
Case Study Example......Page 484
CHAPTER 15: Advanced WSDL Part II: Message Dispatch, Service Instance Identification, and Non-SOAP HTTP Binding......Page 486
15.1 Extreme Loose Coupling with WSDL 2.0......Page 487
15.2 Message Dispatch Challenges......Page 491
Case Study Example......Page 492
Case Study Example......Page 494
15.3 Messages that Point to Service Instances......Page 503
15.4 Custom Header Blocks and Header Faults......Page 507
Case Study Example......Page 510
15.5 Binding to HTTP Without SOAP......Page 513
Case Study Example......Page 518
Case Study Example......Page 524
CHAPTER 16: Advanced WS-Policy Part I: Policy Centralization and Nested, Parameterized, and Ignorable Assertions......Page 526
16.1 Reusability and Policy Centralization......Page 527
Case Study Example......Page 535
16.2 Nested and Parameterized Assertions......Page 539
Case Study Example......Page 542
16.3 Ignorable Assertions......Page 546
Case Study Example......Page 550
16.4 Concurrent Policy-Enabled Contracts......Page 553
CHAPTER 17: Advanced WS-Policy Part II: Custom Policy Assertion Design, Runtime Representation, and Compatibility......Page 558
17.1 Designing Custom Policy Assertions......Page 559
Case Study Example......Page 564
17.2 Maintaining Custom Policy Assertions......Page 571
17.3 Runtime Policy Representation......Page 574
17.4 Intersection and Consumer-Service Policy Compatibility......Page 583
CHAPTER 18: Advanced Message Design Part I: WS-Addressing Vocabularies......Page 590
18.1 EPRs and MAPs......Page 592
18.2 The EPR Vocabulary......Page 597
18.3 MAP Vocabulary......Page 602
Case Study Example......Page 608
CHAPTER 19: Advanced Message Design Part II: WS-Addressing Rules and Design Techniques......Page 610
19.1 WS-Addressing Messaging Rules......Page 611
Case Study Example......Page 617
19.2 EPRs and WSDL Binding......Page 621
Case Study Example......Page 626
19.3 WS-Addressing and Action Values......Page 628
19.5 WS-Addressing Policy Assertions......Page 633
Case Study Example......Page 636
PART III: SERVICE CONTRACT VERSIONING......Page 638
CHAPTER 20: Versioning Fundamentals......Page 640
20.1 Basic Concepts and Terminology......Page 642
20.2 Versioning and Compatibility......Page 644
20.3 Version Identifiers......Page 651
20.4 Versioning Strategies......Page 653
CHAPTER 21: Versioning WSDL Definitions......Page 658
21.1 Version Identifiers and WSDL Definitions......Page 659
21.2 Versioning Operation Definitions......Page 663
21.3 Versioning Port Type Definitions......Page 684
21.4 Versioning Concrete Descriptions......Page 691
21.5 WSDL Definitions and Forwards Compatibility......Page 693
CHAPTER 22: Versioning Message Schemas......Page 698
22.1 Basic Terms and Concepts......Page 699
22.2 XML Schema and WSDL Target Namespaces......Page 705
22.3 Strict Versioning......Page 706
22.4 Flexible Schema Versioning (Using Optional Components)......Page 709
22.5 Loose Schema Versioning (Using Wildcards)......Page 717
CHAPTER 23: Advanced Versioning......Page 730
23.1 Versioning Policies......Page 731
23.2 Defining "Non-Ignorable" Unknown Elements......Page 736
23.3 Versioning and Schema Centralization......Page 740
23.4 Expressing Termination Information......Page 742
23.5 Working with Unknown Content......Page 748
23.6 Partial Validation......Page 752
23.7 Versioning Message Instances......Page 755
23.8 Customizing a Versioning Strategy......Page 757
PART IV: APPENDICES......Page 760
APPENDIX A: Case Study Conclusion......Page 762
APPENDIX B: How Technology Standards are Developed......Page 766
How Standards are Developed......Page 767
The Standards Development Process......Page 768
APPENDIX C: Alphabetical Pseudo Schema Reference......Page 770
APPENDIX D: Namespaces and Prefixes Used in this Book......Page 788
APPENDIX E: SOA Design Patterns Related to this Book......Page 792
Canonical Schema......Page 794
Compatible Change......Page 795
Contract Centralization......Page 796
Decomposed Capability......Page 797
Distributed Capability......Page 798
Partial Validation......Page 799
Proxy Capability......Page 800
Service Messaging......Page 801
Validation Abstraction......Page 802
Version Identification......Page 803
Thomas Erl......Page 804
Priscilla Walmsley......Page 805
Umit Yalcinalp......Page 806
Andre Tost......Page 807
James Pasley......Page 808
A......Page 810
B......Page 811
C......Page 812
D......Page 819
E......Page 820
F......Page 821
G......Page 822
I–J......Page 823
K–L......Page 824
M......Page 825
N......Page 826
O......Page 827
P......Page 828
Q–R......Page 830
S......Page 831
U......Page 835
V......Page 836
W......Page 837
X–Z......Page 840
