The Complete Reference To Professional SOA With Visual Studio 2005 (C# & VB 2005).NET 3.0

Transcription

1

2 The Complete Reference To Professional SOA With Visual Studio 2005 (C# & VB 2005).NET 3.0 Tom Yuan Gao

3 Published By LULU Press Copyright 2007 by Tom Yuan Gao All rights reserved. No part of the content of this book may be reproduced or transmitted in any form or by any means without the written permission of the author.

4 About The Author Tom Yuan Gao has been developing software for over ten years. Having completed Unisys Scholarship at University of Sydney at the age of 16. He is current a Microsoft Certified Application Developer (MCAD), Microsoft Certified Solution Developer (MCSD), Microsoft Certified Database Administrator (MCDBA), Microsoft Certified Trainer (MCT) as well as Nationaly Accredited IT Trainer within Australia. He has also given lecture at universities on the benefits of Service Orientated Architecture. Tom is currently completing his Doctorate in Distributed Software Security. In his spare time he can be found on his Windows Communication Foundation Community Center at ran for solution/enterprise architects. Tom is currently working as the National Technical Manager for EuroRSCG World Wide.

5 Letter from the Author The concept of service orientation has been around for a very long time. The idea of service orientation is about developing structured reusable solutions that can be used over and over again. Although the concept itself is simplistic there has been no consistent and uniform means of achieving service orientation until recently when Microsoft has targeted the service orientation area with the release of ASP.NET. Microsoft s support for service orientation through ASP.NET XML Web service has generated overwhelming support within the industry. The.NET framework coupled with the revolutionary development environment Visual Studio 2005 will revolutionize the way you view and develop future applications. In this book I will take you through the hype and myth of service orientation and into the real world of experience that will help you understand and transform the way you view and develop applications within your enterprise architecture. We will investigate the reasons to why service oriented architecture can help application infrastructures in terms of flexibility, interoperability, and integration. The book is divided into two parts. The first part deals with theory and concepts of service orientation. We will be exploring the risks and trade offs that are required. We will also learn how to meet enterprise requirements for availability, scalability and security. For IT managers and business stakeholders we will explore the concept of generating additional customer base through the previously taboo subject of exposing and yet protecting your intellectual property. The second part of the book focuses on the application of service orientation through ASP.NET XML Web Services. You will learn to use and take advantage of the newly released Visual Studio 2005 development environment, through step by step guides for each and every example in both Visual C# and Visual Basic.NET. You will also learn to develop XML Web Services to supplement the concepts you have learnt in part one of the book. This book is a worthwhile investment and I thank you for purchasing it. I thank you for taking the effort to take one step beyond everyone else, beyond your competitors. Tom Yuan Gao MCAD, MCSD, MCDBA, MCT, Accredited Trainer Voting Member of OASIS for Web Service Standards Founder of Microsoft Windows Communication Foundation Community Center (

6 Acknowledgement I have to say that this book would not have been possible without the support from my family and friends. To my dad, who was my role model in persistence and hard work. To my mum, who has always taught to be efficient and smart. There are a few that I would be enternally grateful to. I would have to thank Todd Meister and Fabio Claudio Ferracchiati for their relentless effort in technical review and in getting every detail perfect as it were intended. Thanks to Peter Hovany, Bill Heish, David Abraham and Marlon Deleon for their encouragements during some very difficult times. Chinese proverb The journey of 1000 miles begins with a single step.

7 Resource As a reward for purchasing this book I have also made The Complete Reference to Professional SOA with Visual Studio 2005 (Visual C# & VB 2005) available for you to download. You will be able to find the book on Source code for both series can be found on

8 Foreword The concepts behind SOA has been with us for many years, but it s not until recent times with advances in Microsoft.NET and Sun s Java that some of the services that architects, business decision takers and visionaries have envisioned, can finally be implemented in a reusable and platform agnostic manner. The hype behind SOA in recent years has helped increase the knowledge and the request for Serviceoriented solutions; which in essence is all about moving away from data silos (where information often are proprietary and hard to access), to open and interchangeable services that deliver the data you need, when you need it, and allowing you to form these services to fit your business processes and create tangible benefits. Government, military and private customers are rapidly increasing their demand for service-oriented platforms that are secure and easy-to-use. This means it has become more important to learn and understand the concepts and gain the technical skills to implement service-oriented solutions. This book delivers great content for developers and it can empower you (as a developer and architect) to better educate others about the benefits and reality behind Service-oriented solutions. It also delivers comprehensive technical content that is easily understood by business people and decision makers. This is a book I will promote to everyone involved in business and IT process improvement. The book can enable you to become better at providing new and innovative solutions that help solve your customer s most challenging problems, and can give you inspiration to look at your own internal business processes in a new light. Tom delivers the content in a clear and concise way. Tom will guide you through how to start building a Web Service, how to consume it, how to debug it, and how to finally deploy it into your testing, staging or production environments. This book is a book for professionals who want to develop quality service-oriented solutions. Tom starts out by explaining the core concepts of SOA, allowing you to better understand and start learning some of the new and innovative ways of thinking. Then going through and giving you a real description what Web Services is all about without the hype. If you are new to the whole concept of Web Services, Tom explains the basics of XML based technologies like XML Schema, SOAP and WSDL which are the foundations of Web Services. You will learn some of the more advanced topics with building Web Services, important topics like security and logging. Tom will show you how to use some of the WS-* standard specification, especially WS-Security with encryption and signing of messages, how to make a custom username service on WSE 3.0 (Web Service Enhancements), and much more. There is a special chapter dedicated to Windows Communication Foundation which is the new and unified communication platform coming with the release of Microsoft.NET Framework 3.0, released around Windows Vista timeframe. This can prepare you for the future changes for developing communication solutions with Visual Studio. Microsoft released a version of Visual Studio for software architects, where they introduced some new features that can help you plan your overall architecture of your distributed service-oriented solutions. Part of this initiative is the Distributed System Designers that Tom covers comprehensively in this book. These give you capabilities to model and manage distributed solutions directly from Visual Studio, making deployment packages and validating them against your server-farms amongst other things. Look no further for a full in-depth review of Service-oriented architecture and technologies. Tom has written an excellent book for professionals, that will guide you through the process of building services the way they where meant to be. Hope you all enjoy this book as much as I did!

9 Sondre Bjellås Microsoft Regional Director Software Architect & Product Manager

10 Table of Contents ABOUT THE AUTHOR... 3 LETTER FROM THE AUTHOR... 4 ACKNOWLEDGEMENT... 5 RESOURCE... 6 FOREWORD... 7 PART 1 CORE CONCEPTS CHAPTER 1: INTRODUCTION TO SERVICE ORIENTED ARCHITECTURE WHAT IS SERVICE ORIENTED ARCHITECTURE? EXPLAINING SERVICE ORIENTED ARCHITECTURE USING METROPOLIS Cities as Software Vendors Factories and Buildings as Applications Transportation as Communication Manufactured Goods as Standardization Manufactured Components as Virtual Enterprises Urban Infrastructure as IT Infrastructure Evolution ENTERPRISE ARCHITECTURE ARCHITECTURAL TRADEOFF TRIANGLE ARCHITECTURAL TRADEOFF MATRIX UNDERSTANDING BUSINESS BENEFITS OF SOA BETTER VISIBILITY INTO OPERATIONS AND PERFORMANCE MORE EFFICIENT OPERATIONS BETTER BUSINESS AGILITY WHAT IS A WEB SERVICE? LOOSE COUPLING SERVICES XML WEB SERVICES XML and XML Schema XPath SOAP WSDL UDDI SERVICE ORIENTED ARCHITECTURE WITH WEB SERVICE WEB SERVICE AND SOA TECHNOLOGY SOUP SERVICE ORIENTED ENTERPRISE ARCHITECTURE ADOPTING THE LEGACY ENTERPRISE ARCHITECTURE BEAST ENTERPRISE ARCHITECTURE USING SOA SO IS SERVICE ORIENTED ARCHITECTURE A BREAKTHROUGH? CASE STUDIES WHICH INDUSTRY IS BEST FOR SOA The Drive for SOA CASE STUDY: STARWOOD HOTELS USES SOA TO IMPROVE GUEST SERVICES AND CUT COSTS CASE STUDY: HARLEY-DAVIDSON CASE STUDY: IBM TOWARDS SOA CASE STUDY: MICROSOFT SOA (MILTON KEYNES GENERAL HOSPITAL) CASE STUDY: GFK MARKET RESEARCH CASE STUDY: PUREPROFILE... 42

11 CASE STUDY: AMAZING PEOPLE CASE STUDY: SUNSHINE SUGAR CASE STUDY: INTELLIFIELD SUMMARY CHAPTER 2 IMPLEMENTING SERVICE ORIENTED ARCHITECTURE SOA ARCHITECTURAL ROADMAP WHAT IS A SOA ROADMAP AND WHY DO YOU NEED ONE? HOW TO BUILD A SOA ROADMAP SOA planning SOA maturity assessment SOA future vision SOA roadmap definition Iterative Quality Assurance SOA GOVERNANCE ENTERPRISE SERVICE ENABLING ARCHITECTURES SERVICE TYPES Basic services Data-Centric Services Logic-Centric Services Transitional Services Public Services SOA WEB SERVICE TRANSFORMING LOGICAL LAYERS TO PHYSICAL TIERS STARTING YOUR ENTERPRISE SOA WITH ENTITY AGGREGATION Single View of Entity Horizontal Partitions Cross Entities Query ENTERPRISE APPLICATION INTEGRATION (EAI) Web Service Choreography Interface (WSCI) Business Process Execution Language for Web Services (BPEL4WS) Coordination Services DISTRIBUTED EVENT DRIVEN ARCHITECTURE AND SOA ENTERPRISE SERVICE BUS & SERVICES Mediation support Protocol independence Web Service Management Orchestration SECURITY IN SERVICE ORIENTED ARCHITECTURE Security Basics Web Service Security Message Reliability in Service Oriented Architecture SUMMARY CHAPTER 3 BUSINESS ADAPTATION OF SOA SERVICE ORIENTATION AND ITS ROLE IN OUR CONNECTED SYSTEM STRATEGY WHY DO WE NEED FLEXIBILITY? AGILITY Technology Communication & Location Issue Business Process Business Functionality Integration Support REDUCTION IN COST OF DEVELOPMENT IT Cost Savings Business Cost Saving from SOA OPENING OUR INTELLECTUAL PROPERTY... 77

12 SUPPLIERS CONSUMERS PROMOTING INTER-PLATFORM CONNECTION MEASURING A SOA ORGANIZATIONAL ROADMAP IDENTIFYING STAKEHOLDERS AND CONFLICTS Business and IT Internal Politics ORGANIZATION VISION BUDGET CONSIDERATION GATHERING INTERNAL SUPPORT SOA DRIVEN PROJECT DEVELOPMENT USING MSF CHALLENGES AND OPPORTUNITIES MSF TRACKS MSF CMMI MSF Agile ENVISIONING TRACK PLANNING TRACK DEVELOPING TRACK STABILIZING TRACK DEPLOYING TRACK GOVERNANCE OPERATIONAL MANAGEMENT CONTINUOUS TRACK PROJECT TEAMS Program Management Architecture Development Test Release/Operations User Experience Product Management MSF RISK MANAGEMENT SIMPLIFYING SOA DEVELOPMENT USING.NET AND VISUAL STUDIO USING VISUAL STUDIO 2005 TO CREATE A WEB SERVICE USING VISUAL STUDIO 2005 TO CONSUME A WEB SERVICE SUMMARY PART 2 USING.NET WEB SERVICE 2.0 WITH VISUAL STUDIO CHAPTER 4 INTRODUCING.NET NET FRAMEWORK FEATURES OF THE COMMON LANGUAGE RUNTIME MANAGED DEVELOPMENT NET FRAMEWORK VISUAL STUDIO 2005 TEAM ROLES VISUAL STUDIO 2005 EDITIONS THE VISUAL STUDIO IDE WEB SERVICE TEMPLATE VISUAL STUDIO 2005 PROJECTLESS DEVELOPMENT MIGRATING TO VISUAL STUDIO 2005 PROJECT

13 VISUAL STUDIO IDE SOLUTION EXPLORER DOCUMENT WINDOW TOOLBOX ERROR LIST TASK LIST SERVER EXPLORER CODE WINDOW Outlining IntelliSense Code Member List Error Underlining SUMMARY CHAPTER 5 XML WEB SERVICES STANDARDS AND CONCEPTS NET WEB SERVICE MESSAGE FLOW HTTP THE GET AND POST METHODS HTTP WITH.NET XML ELEMENTS ELEMENTS, NAMESPACES, AND NAMESPACE DECLARATIONS ATTRIBUTES AND NAMESPACES COMMENTS WHITESPACE PROHIBITED CHARACTER LITERALS CDATA SECTIONS The XML declaration WELL-FORMED XML XML WITH VISUAL STUDIO XML SCHEMA DEFINITION (XSD) DATATYPES Numeric types Date and time types Name and string types Boolean Byte Date datetime decimal double duration gday gmonth gmonthday gyear gyearmonth hexbinary int integer language long Name NCName negativeinteger nonnegativeinteger nonpositiveinteger

14 normalizedstring positiveinteger QName short string time token unsignedbyte unsignedint unsignedlong unsignedshort FACETS enumeration fractiondigits length maxexclusive maxinclusive maxlength minexclusive mininclusive minlength pattern totaldigits whitespace LANGUAGE CONSTRUCTS simpletype restriction list Union XML SCHEMA STRUCTURES XSD WITH VISUAL STUDIO SOAP WEB SERVICES DESCRIPTION LANGUAGE (WSDL) DEFINITIONS TYPES MESSAGE PORTTYPE BINDING SERVICE NET WEB SERVICE WSDL UDDI V SUPPORT FOR DIGITAL SIGNATURE UDDI SDK WS-* STANDARDS SUMMARY CHAPTER 6 DATABASE PROGRAMMING WITH ADO.NET ADO.NET WHAT IS NEW IN.NET Async Data Access Metadata Schemas Query Notification Multiple Active Result Sets User Defined, XML Data Types

15 THE ADO.NET ARCHITECTURE NET DATASETS DATA PROVIDERS Connection Command DataReader DataAdapter XML Interoperability Maintainability Programmability Performance Scalability In-Memory Representations of Data Minimized Open Connections Sharing Data Between Applications OLE DB DATA PROVIDER IN.NET NET Data Provider THE OLEDBCONNECTION CLASS THE SQLCONNECTION CLASS OPENING AND CLOSING CONNECTIONS The OleDbCommand Class The ExecuteScalar Method The ExecuteReader Method The ExecuteNonQuery Method The SqlCommand Class Using Data Adapters The SelectCommand Property The InsertCommand Property The UpdateCommand Property The DeleteCommand Property The DataReader Class The SqlDataReader Class The IsClosed() Method The RecordsAffected Property The OleDbDataReader Class DATA ACCESS USING VISUAL STUDIO WORKING WITH DATASETS CREATING ADO.NET DATASETS MANIPULATING AN ADO.NET DATASET MERGING THE CONTENTS OF DATASETS CHECK PRIMARY KEYS PRESERVE CHANGES APPLY CONSTRAINTS COPYING DATASET CONTENTS Creating Data Views Handling ADO.NET DataSet Events CREATING A TYPED ADO.NET DATASET MANUALLY CREATING A TYPED DATASET MANUALLY DEFINE TYPED DATASET RELATIONSHIPS WITH TYPED DATASET ADO.NET EXCEPTION HANDLING IN.NET WRITING SQLCLR STORED PROCEDURE WITH MS SQL SERVER THE CONTEXT CONNECTION

16 .NET STORED PROCEDURE WITH EXECUTEREADER() SUMMARY CHAPTER 7 ACCESSING MANIPULATING XML WITH.NET DOCUMENT OBJECT MODEL THE XML PARSER XMLREADER AND XMLWRITER READING XML USING XMLTEXTREADER WRITING XML USING XMLTEXTWRITER XPATHNAVIGATOR XPATH XML SCHEMA XSD XML VALIDATION XML AND DATASET SUMMARY CHAPTER 8.NET XML SERIALIZATION NET SERIALIZATION ENABLE SERIALIZATION USING ATTRIBUTES SERIALIZATION FORMATTER XML SERIALIZATION CONTROLLING SERIALIZATION XMLROOT AND XMLELEMENT IGNORING ELEMENTS SERIALIZING ARRAYS XMLANYELEMENT AND XMLANYATTRIBUTE XMLINCLUDE - DERIVED DATA TYPES DATATYPE MAPPING STRONGLY TYPED XML SERIALIZATION OPEN SCHEMA WITH XMLANYATTRIBUTE AND XMLANYELEMENT SUMMARY CHAPTER 9 CREATING AND CONSUMING WEB SERVICE USING VISUAL STUDIO WEB SERVICE SUMMARY CREATING XML WEB SERVICES DEPLOYING WEB SERVICE WEB SERVICE FILE TYPES XML WEB SERVICES DISCOVERY MECHANISM ADDING CUSTOM DISCOVERY INFORMATION FOR A WEB SERVICE CONSUMING WEB SERVICE CLIENT APPLICATION SUMMARY CHAPTER 10 TESTING AND DEBUGGING AN XML WEB SERVICE OVERVIEW OF THE TESTING PROCESS ORGANIZING THE TESTING EFFORT

17 REQUIREMENTS-BASED TESTING DEVELOPING A TEST PLAN APPROACHES TO DEVELOP TEST PLANS The Waterfall Approach The Evolutionary/Agile Approach THE FOUR PILLARS OF SUCCESSFUL TESTING PILLAR I: FUNCTIONAL & REGRESSION TESTING PILLAR II: PERFORMANCE PILLAR III: INTEROPERABILITY PILLAR IV: VULNERABILITY ASSESSMENT DEBUGGING CORDBG.EXE DEBUGGING USING VISUAL STUDIO The Watch Window The Call Stack Window The Locals Window The Autos Window The Breakpoint Window TESTING WITH VISUAL STUDIO UNIT TESTING RUNNING TESTS CODE COVERAGE INITIALIZING AND CLEANING UP TESTS STATIC ANALYSIS PROFILING SAMPLING INSTRUMENTATION IMPLEMENTING SAMPLING SUMMARY CHAPTER 11 DEPLOYMENT NET DEPLOYMENT MAINTAINING ASSEMBLY VERSIONS PACKAGING AND DISTRIBUTION OPTIONS PUBLISHING WEB SERVICE PUBLISHING CLIENT APPLICATION USING CLICKONCE DEPLOYMENT ClickOnce and Windows Installer Comparison Table Using ClickOnce Deployment Publishing to File System Publishing To a Web Location How ClickOnce Deployment Works USING WEB DEPLOYMENT PROJECTS WITH VISUAL STUDIO INSTALLING WEB DEPLOYMENT PROJECTS BUILD MENU COMMAND WEB DEPLOYMENT PROJECT PROPERTY PAGES MANAGING CUSTOM BUILD CONFIGURATIONS WEB SETUP PROJECTS CREATING A WEB SETUP PROJECT FOR XML WEB SERVICE SUMMARY WEBMETHOD PROPERTIES

18 BUFFERING RESPONSE FOR A WEB METHOD CACHING THE RESULTS FOR A WEB METHOD SPECIFYING A DESCRIPTION FOR A WEB METHOD ENABLING SESSION STATE IN WEB METHOD IDENTIFYING OVERLOADED WEB METHODS USING AN ALIAS WEB METHOD TRANSACTION ASYNCHRONOUS WEB SERVICE ASYNCHRONOUS DELEGATES CONCURRENT ASYNCHRONOUS CALLS IMPROVING RESPONSIVENESS IN WINDOWS CLIENT SOAP EXTENSIONS USING SOAP EXTENSIONS USING SOAPLOGGER SUMMARY CHAPTER 13.NET REMOTING NET REMOTING PROXY ARCHITECTURE REMOTABLE AND NONREMOTABLE OBJECTS MARSHAL-BY-VALUE OBJECTS MARSHAL-BY-REFERENCE OBJECTS SERVER ACTIVATED AND CLIENT ACTIVATED OBJECTS SERVER ACTIVATED OBJECTS (SAOS) Using Configuration File CLIENT ACTIVATED OBJECTS (CAOS) Using Configuration File Using Lifetime Leases Renewing Lifetime Leases DIFFERENCES BETWEEN SERVER ACTIVATED OBJECTS AND CLIENT ACTIVATED OBJECTS TRANSPORT CHANNELS TCP CHANNEL HTTP CHANNEL IPC Channel CHANNEL SINKS REMOTABLE BANK DEBIT LOG The Server The Client SUMMARY CHAPTER 14 WEB SERVICE SECURITY WINDOWS AUTHENTICATION MANAGING USERS BY USING MEMBERSHIP CREATING A MEMBERSHIP DATABASE ON SQL SERVER CONFIGURING AN APPLICATION TO USE MEMBERSHIP Using Web.Config Using ASP.NET Configuration Settings Implementing Membership CUSTOM AUTHENTICATION AND AUTHORIZATION WITH SOAP HEADERS DEFINING SOAP HEADERS DEFINING A SOAP HEADER CLIENT IMPLEMENTING TOKEN AUTHENTICATION WITH SOAP HEADERS

19 IMPLEMENTING SECURITY TOKEN SERVICE IMPLEMENT CLIENT FOR TOKEN SECURITY SUMMARY CHAPTER 15 WEB SERVICES ENHANCEMENTS WEB SERVICES ENHANCEMENTS OVERVIEW WS-SECURITY Security Tokens INSTALLING WEB SERVICES ENHANCEMENTS USING WEB SERVICES ENHANCEMENTS WSE COMMUNICATION PROCESS REQUESTING PROCESS RESPONSE PROCESS IMPLEMENTING WSE SERVICE IMPLEMENTING WSE CLIENT IMPLEMENTING CUSTOM USERNAME SERVICE X. 509 CERTIFICATE THE X.509 CERTIFICATE MANAGEMENT TOOL WSECERTIFICATE3.EXE SIGN AND ENCRYPT A SOAP MESSAGE (END-TO-END SECURITY) Configuring WSE Web service to Sign and Encrypt Configuring WSE Client Application to Sign and Encrypt BEST SECURITY PRACTICE BINARY EXCHANGE WITH MESSAGE TRANSMISSION OPTIMIZATION MECHANISM (MTOM) IMPLEMENTING MTOM SERVICE IMPLEMENTING MTOM CLIENT SUMMARY CHAPTER 16. WINDOWS COMMUNICATION FOUNDATION (WCF) WCF FOUNDAMENTALS CONTRACTS Defining Service Contracts Defining Data Contracts RPC/Messaging BINDING AND ADDRESS (ENDPOINT) IMPLEMENTING WCF SERVICES IMPLEMENTING WCF SERVICE IMPLEMENTING A WCF SERVICE CLIENT IMPLEMENTING HOSTING IMPLEMENTING SECURE RELIABABLE MESSAGING IMPLEMENTING CUSTOM BINDING, RELIABLE MESSAGING AND SECURITY IMPLEMENTING WCF WITH MICROSOFT MESSAGE QUEUE WCF SESSIONS WCF TRANSACTIONS DUPLEX COMMUNICATION SUMMARY CHAPTER 17. ARCHITECTURE CONCEPTUALIZATION WITH DISTRIBUTED SYSTEM DESIGNERS APPLICATION DESIGNER IMPLEMENTING APPLICATION DESIGNER

20 Connecting the Applications Defining Web Service Prototypes Adding an Endpoint through WSDL Implement the Application UPDATING THE DESIGN ADDING A WEB APPLICATION SETTINGS AND CONSTRAINTS SYSTEM DESIGNER SPECIFYING LOGICAL DATACENTER DIAGRAM SETTINGS AND CONSTRAINTS Importing IIS Server Settings DEPLOYMENT DIAGRAM CREATING THE DEPLOYMENT DIAGRAM VALIDATING THE DEPLOYMENT SCENARIO GENERATING DEPLOYMENT REPORT SUMMARY INDEXES