About This E-Book EPUB is an open, industry-standard format for e-books. However, support for EPUB and its many features varies across reading devices and applications. Use your device or app settings to customize the presentation to your liking. Settings that you can customize often include font, font size, single or double column, landscape or portrait mode, and figures that you can click or tap to enlarge. For additional information about the settings and features on your reading device or app, visit the device manufacturer’s Web site. Many titles include programming code or configuration examples. To optimize the presentation of these elements, view the e-book in single-column, landscape mode and adjust the font size to the smallest setting. In addition to presenting code and configurations in the reflowable text format, we have included images of the code that mimic the presentation found in the print book; therefore, where the reflowable format may compromise the presentation of the code listing, you will see a “Click here to view code image” link. Click the link to view the print-fidelity code image. To return to the previous page viewed, click the Back button on your device or app. Service-Oriented Architecture Analysis and Design for Services and Microservices Thomas Erl With contributions by Paulo Merson and Roger Stoffers BOSTON • COLUMBUS • INDIANAPOLIS • NEW YORK • SAN FRANCISCO AMSTERDAM • CAPE TOWN • DUBAI • LONDON • MADRID • MILAN • MUNICH PARIS • MONTREAL • TORONTO • DELHI • MEXICO CITY • SAO PAULO SIDNEY • HONG KONG • SEOUL • SINGAPORE • TAIPEI • TOKYO Many of the designations used by manufacturers and sellers to distinguish their products are claimed as trademarks. Where those designations appear in this book, and the publisher was aware of a trademark claim, the designations have been printed with initial capital letters or in all capitals. The authors and publisher have taken care in the preparation of this book, but make no expressed or implied warranty of any kind and assume no responsibility for errors or omissions. No liability is assumed for incidental or consequential damages in connection with or arising out of the use of the information or programs contained herein. For information about buying this title in bulk quantities, or for special sales opportunities (which may include electronic versions; custom cover designs; and content particular to your business, training goals, marketing focus, or branding interests), please contact our corporate sales department at [email protected] or (800) 382-3419. For government sales inquiries, please contact [email protected]. For questions about sales outside the U.S., please contact [email protected]. Visit us on the Web: informit.com/ph Library of Congress Control Number: 2016952031 Copyright © 2017 Arcitura Education Inc. All rights reserved. Printed in the United States of America. This publication is protected by copyright, and permission must be obtained from the publisher prior to any prohibited reproduction, storage in a retrieval system, or transmission in any form or by any means, electronic, mechanical, photocopying, recording, or likewise. For information regarding permissions, request forms and the appropriate contacts within the Pearson Education Global Rights & Permissions Department, please visit www.pearsoned.com/permissions/. ISBN-13: 978-0-13-385858-7 ISBN-10: 0-13-385858-8 First printing: December 2016 Publisher Mark Taub Editor-in-Chief Greg Wiegand Senior Acquisitions Editor Trina MacDonald Managing Editor Sandra Schroeder Senior Project Editors Lori Lyons Betsy Gratner Copyeditors Paula Lowell Language Logistics Infinet Creative Group Maria Lee Teejay Keepence Indexer Cheryl Lenser Proofreaders Williams Woods Publishing Abigail Gavin Melissa Mok Kam Chiu Mok Shivapriya Nagaraj Catherine Shaffer Pamela Janice Yau Maria Lee Editorial Assistant Olivia Basegio Cover Design Thomas Erl Photos Thomas Erl Cover Compositor Chuti Prasertsith Compositor Bumpy Design Graphics Jasper Paladino Zuzana Cappova Infinite Creative Group Spencer Fruhling Tami Young Demian Richardson Kan Kwai Lui Briana Lee Educational Content Development Arcitura Education Inc. To Markus, who recently joined our team with a keen sense of curiosity and a relentless desire to analyze and redesign even the most micro of things. —Thomas Erl Contents at a Glance CHAPTER 1: Introduction CHAPTER 2: Case Study Backgrounds PART I: FUNDAMENTALS CHAPTER 3: Understanding Service-Orientation CHAPTER 4: Understanding SOA CHAPTER 5: Understanding Layers with Services and Microservices PART II: SERVICE-ORIENTED ANALYSIS AND DESIGN CHAPTER 6: Analysis and Modeling with Web Services and Microservices CHAPTER 7: Analysis and Modeling with REST Services and Microservices CHAPTER 8: Service API and Contract Design with Web Services CHAPTER 9: Service API and Contract Design with REST Services and Microservices CHAPTER 10: Service API and Contract Versioning with Web Services and REST Services PART III: APPENDICES APPENDIX A: Service-Orientation Principles Reference APPENDIX B: REST Constraints Reference APPENDIX C: SOA Design Patterns Reference APPENDIX D: The Annotated SOA Manifesto About the Author Index Contents Acknowledgments Reader Services CHAPTER 1: Introduction 1.1 How Patterns Are Used in this Book 1.2 Series Books That Cover Topics from the First Edition 1.3 How this Book Is Organized Part I: Fundamentals Chapter 3, Understanding ServiceOrientation Chapter 4, Understanding SOA Chapter 5, Understanding Layers with Services and Microservices Part II: ServiceOriented Analysis and Design Chapter 6, Analysis and Modeling with Web Services and Microservices Chapter 7, Analysis and Modeling with REST Services and Microservices Chapter 8, Service API and Contract Design with Web Services Chapter 9, Service API and Contract Design with REST Services and Microservices Chapter 10, Service API and Contract Versioning with Web Services and REST Services Part III: Appendices Appendix A, ServiceOrientation Principles Reference Appendix B, REST Constraints Reference Appendix C, SOA Design Patterns Reference Appendix D, The Annotated SOA Manifesto 1.4 Page References and Capitalization for Principles, Constraints, and Patterns Additional Information Symbol Legend Updates, Errata, and Resources (www.servicetechbooks.com) ServiceOrientation (www.serviceorientation.com) What Is REST? (www.whatisrest.com) Referenced Specifications (www.servicetechspecs.com) SOASchool.com® SOA Certified Professional (SOACP) CloudSchool.com™ Cloud Certified Professional (CCP) BigDataScienceSchool.com™ Big Data Science Certified Professional (BDSCP) Notification Service CHAPTER 2: Case Study Backgrounds 2.1 How Case Studies Are Used 2.2 Case Study Background #1: Transit Line Systems, Inc. 2.3 Case Study Background #2: Midwest University Association PART I: FUNDAMENTALS CHAPTER 3: Understanding ServiceOrientation 3.1 Introduction to ServiceOrientation Services in Business Automation Services Are Collections of Capabilities ServiceOrientation as a Design Paradigm ServiceOrientation Design Principles 3.2 Problems Solved by ServiceOrientation Silo-based Application Architecture It Can Be Highly Wasteful It’s Not as Efficient as It Appears It Bloats an Enterprise It Can Result in Complex Infrastructures and Convoluted Enterprise Architectures Integration Becomes a Constant Challenge The Need for ServiceOrientation Increased Amounts of Reusable Solution Logic Reduced Amounts of Application-Specific Logic