Course Number: 2524B Released: 05/2002 Delivery Guide Developing XML Web Services Using Microsoft® ASP.NET Part Number: X08-85030 Information in this document, including URL and other Internet Web site references, is subject to change without notice. Unless otherwise noted, the example companies, organizations, products, domain names, e-mail addresses, logos, people, places, and events depicted herein are fictitious, and no association with any real company, organization, product, domain name, e-mail address, logo, person, places or events is intended or should be inferred. Complying with all applicable copyright laws is the responsibility of the user. Without limiting the rights under copyright, no part of this document may be reproduced, stored in or introduced into a retrieval system, or transmitted in any form or by any means (electronic, mechanical, photocopying, recording, or otherwise), or for any purpose, without the express written permission of Microsoft Corporation. Microsoft may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering subject matter in this document. Except as expressly provided in any written license agreement from Microsoft, the furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other intellectual property.  2001-2002 Microsoft Corporation. All rights reserved. Microsoft MS-DOS, Windows, Windows NT Active Directory, Authenticode, IntelliSense, FrontPage, Jscript, MSDN, PowerPoint, Visual C#, Visual Studio, Visual Basic, Windows NT, and Win32 are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. The names of actual companies and products mentioned herein may be the trademarks of their respective owners. Course Number: 2524B Part Number: X08-85030 Released: 05/2002 Developing XML Web Services Using Microsoft® ASP.NET iii Contents Introduction Course Materials 2 Prerequisites 3 Course Outline 4 Setup 8 Microsoft Official Curriculum 9 Microsoft Certified Professional Program 11 Facilities 13 Module 1: The Need for XML Web Services Overview 1 Evolution of Distributed Applications 2 Problems with Traditional Distributed Applications 4 Introducing XML Web Services 14 The Web Technology Stack and .NET 16 The .NET Alternatives to XML Web Services 18 Common XML Web Service Scenarios 20 Review 22 Module 2: XML Web Service Architectures Overview 1 Service-Oriented Architecture 2 XML Web Services Architectures and Service-Oriented Architecture 4 Roles in an XML Web Services Architecture 8 The XML Web Services Programming Model 16 Review 18 Module 3: The Underlying Technologies of XML Web Services Overview 1 HTTP Fundamentals 2 Using HTTP with the .NET Framework 8 XML Essentials 17 XML Serialization in the .NET Framework 26 SOAP Fundamentals 29 Using SOAP with the .NET Framework 36 Lab 3.1: Issuing HTTP and SOAP Requests Using the .NET Framework 45 Review 54 Module 4: Consuming XML Web Services Overview 1 WSDL Documents 2 XML Web Service Discovery 8 XML Web Service Proxies 19 Implementing an XML Web Service Consumer Using Visual Studio .NET 27 Lab 4.1: Implementing an XML Web Service Consumer Using Visual Studio .NET 34 Review 43 iv Developing XML Web Services Using Microsoft® ASP.NET Module 5: Implementing a Simple XML Web Service Overview 1 Creating an XML Web Service Project 2 Implementing XML Web Service Methods 11 Managing State in an ASP.NET XML Web Service 33 Debugging XML Web Services 42 Lab 5.1: Implementing a Simple XML Web Service 61 Review 77 Module 6: Publishing and Deploying XML Web Services Overview 1 Overview of UDDI 2 Publishing an XML Web Service 16 Finding an XML Web Service 21 Publishing an XML Web Service on an Intranet 24 Configuring an XML Web Service 26 Lab 6.1: Publishing and Finding Web Services in a UDDI Registry 29 Review 39 Module 7: Securing XML Web Services Overview 1 Overview of Security 2 Built-In Authentication 10 Custom Authentication: SOAP Headers 18 Authorization: Role-Based Security 25 Authentication and Authorization with HttpModules 34 Authorization: Code Access Security 39 Encryption 46 Lab 7.1: Securing XML Web Services 54 Review 70 Course Evaluation 72 Module 8: Designing XML Web Services Overview 1 Data Type Constraints 2 Performance 11 Lab 8.1: Implementing Caching in an XML Web Service 28 Reliability 33 Versioning 37 HTML Screen Scraping XML Web Services 39 Aggregating XML Web Services 47 Demonstration: Example of an Aggregated XML Web Service 52 Lab 8.2: Implementing an Aggregated XML Web Service 53 Review 67 Module 9: Global XML Web Services Architecture Overview 1 Introduction to GXA 2 Routing and Referral 8 Security and License 16 Review 19 Course Evaluation 20 Developing XML Web Services Using Microsoft® ASP.NET v About This Course This section provides you with a brief description of the course, audience, suggested prerequisites, and course objectives. This three-day instructor-led course teaches experienced software developers how to use XML Web services in solving common problems in the distributed application domain. This course teaches developers how to build, deploy, locate, and consume XML Web services. This course is designed for experienced software developers who have previously built component-based applications. This course requires that students meet the requirements listed in the following knowledge and skills matrix. Understand Concepts Written simple applications Written real- world applications Prerequisites Preferred Required Preferred Required Preferred Required Familiarity with C#  Programming in C++, Java, or Microsoft ® Visual Basic ®  Familiarity with Extensible Markup Language (XML)  After completing this course, the student will be able to:  Explain how XML Web services emerged as a solution to the problems with traditional approaches to designing distributed applications.  Describe the architecture of an XML Web services-based solution.  Explain how to use the Microsoft .NET Framework to implement XML Web services.  Implement an XML Web service consumer by using Microsoft Visual Studio ® .NET.  Implement a simple XML Web service by using Microsoft Visual Studio .NET.  Publish and deploy an XML Web service.  Secure a XML Web service.  Evaluate the trade-offs and issues that are involved in designing a real-world XML Web service.  Implement nonstandard XML Web services such as Hypertext Markup Language (HTML) screen scraping and aggregating XML Web services.  Describe the Global XML Architecture and explain how to design XML Web services to anticipate the new services. Description Audience Student Prerequisites Course Objectives vi Developing XML Web Services Using Microsoft® ASP.NET Course Timing The following schedule is an estimate of the course timing. Your timing may vary. Day 1 Start End Module 9:00 9:20 Introduction 9:20 10:20 Module 1: The Need for XML Web Services 10:20 10:30 Break 10:30 11:30 Module 2: XML Web Service Architecture 11:30 12:15 Lunch 12:15 2:15 Module 3: The Underlying Technologies of XML Web Services 2:15 2:25 Break 2:25 3:10 Lab 3.1: Issuing HTTP and SOAP Requests Using the .NET Framework 3:10 5:10 Module 4: Consuming XML Web Services Day 2 Start End Module 9:00 10:15 Lab 4.1: Implementing an XML Web Service Consumer Using Visual Studio .NET 10:15 10:25 Break 10:25 12:00 Module 5: Implementing a Simple XML Web Service 12:00 12:45 Lunch 12:45 1:40 Module 5: Implementing a Simple XML Web Service (continued) 1:40 2:30 Lab 5.1: Implementing a Simple XML Web Service 2:30 2:40 Break 2:40 3:05 Lab 5.1: Implementing a Simple XML Web Service (continued) 3:05 4:35 Module 6: Publishing and Deploying XML Web Services 4:35 5:05 Lab 6.1: Publishing and Finding XML Web Services in a UDDI Registry Developing XML Web Services Using Microsoft® ASP.NET vii Day 3 Start End Module 9:00 9:30 Lab 6.1: Publishing and Finding XML Web Services in a UDDI Registry (continued) 9:30 10:30 Module 7: Securing XML Web Services 10:30 10:40 Break 10:40 11:40 Module 7: Securing XML Web Services (continued) 11:40 12:25 Lunch 12:25 1:25 Lab 7.1: Securing XML Web Services 1:25 2:25 Module 8: Designing XML Web Services 2:25 2:35 Break 2:35 3:15 Lab 8.1: Implementing Caching in an XML Web Service 3:15 3:45 Module 8: Designing XML Web Services (continued) 3:45 5:15 Lab 8.2: Implementing an Aggregated XML Web Service 5:15 5:45 Module 9: Global XML Web Services Architecture viii Developing XML Web Services Using Microsoft® ASP.NET Trainer Materials Compact Disc Contents The Trainer Materials compact disc contains the following files and folders:  Autorun.exe. When the compact disc is inserted into the CD-ROM drive, or when you double-click the Autorun.exe file, this file opens the compact disc and allows you to browse the Student Materials or Trainer Materials compact disc.  Autorun.inf. When the compact disc is inserted into the compact disc drive, this file opens Autorun.exe.  Default.htm. This file opens the Trainer Materials Web page.  Readme.txt. This file explains how to install the software for viewing the Trainer Materials compact disc and its contents and how to open the Trainer Materials Web page.  2524B_ms.doc. This file is the Manual Classroom Setup Guide. It contains the steps for manually installing the classroom computers.  2524B_sg.doc. This file is the Automated Classroom Setup Guide. It contains a description of classroom requirements, classroom configuration, instructions for using the automated classroom setup scripts, and the Classroom Setup Checklist.  Powerpnt. This folder contains the Microsoft PowerPoint® slides that are used in this course.  Pptview. This folder contains the Microsoft PowerPoint Viewer 97, which can be used to display the PowerPoint slides if Microsoft PowerPoint 2002 is not available. Do not use this version in the classroom.  Setup. This folder contains the files that install the course and related software to computers in a classroom setting.  StudentCD. This folder contains the Web page that provides students with links to resources pertaining to this course, including additional reading, review and lab answers, lab files, multimedia presentations, and course- related Web sites.  Tools. This folder contains files and utilities used to complete the setup of the instructor computer.  Webfiles. This folder contains the files that are required to view the course Web page. To open the Web page, open Microsoft Windows ® Explorer, and in the root directory of the compact disc, double-click Default.htm or Autorun.exe. Developing XML Web Services Using Microsoft® ASP.NET ix Student Materials Compact Disc Contents The Student Materials compact disc contains the following files and folders:  Autorun.exe. When the compact disc is inserted into the CD-ROM drive, or when you double-click the Autorun.exe file, this file opens the compact disc and allows you to browse the Student Materials compact disc or install Internet Explorer.  Autorun.inf. When the compact disc is inserted into the compact disc drive, this file opens Autorun.exe.  Default.htm. This file opens the Student Materials Web page. It provides resources pertaining to this course, including additional reading, review and lab answers, lab files, multimedia presentations, and course-related Web sites.  Readme.txt. This file explains how to install the software for viewing the Student Materials compact disc and its contents and how to open the Student Materials Web page.  2524B_ms.doc. This file is the Manual Classroom Setup Guide. It contains a description of classroom requirements, classroom setup instructions, and the classroom configuration.  Database. This folder contains databases used in the course.  Democode. This folder contains demonstration code.  Flash. This folder contains the installer for the Macromedia Flash 5.0 browser plug-in.  Fonts. This folder contains fonts that are required to view the Microsoft PowerPoint presentation and Web-based materials.  Labfiles. This folder contains files that are used in the hands-on labs. These files may be used to prepare the student computers for the hands-on labs.  Mplayer. This folder contains the setup file to install Microsoft Windows Media ™ Player.  UDDI. This folder contains files that are used to initialize the Universal Description, Discovery, and Integration (UDDI) registry. The folder also contains files that are used to install the UDDI Services and the UDDI SDK, and to register the XML Web services that UDDI registry uses in this course.  Webfiles. This folder contains the files that are required to view the course Web page. To open the Web page, open Windows Explorer, and in the root directory of the compact disc, double-click Default.htm or Autorun.exe.  Wordview. This folder contains the Word Viewer that is used to view any Word document (.doc) files that are included on the compact disc. x Developing XML Web Services Using Microsoft® ASP.NET Document Conventions The following conventions are used in course materials to distinguish elements of the text. Convention Use Bold Represents commands, command options, and syntax that must be typed exactly as shown. It also indicates commands on menus and buttons, dialog box titles and options, and icon and menu names. Italic In syntax statements or descriptive text, indicates argument names or placeholders for variable information. Italic is also used for introducing new terms, for book titles, and for emphasis in the text. Title Capitals Indicate domain names, user names, computer names, directory names, and folder and file names, except when specifically referring to case-sensitive names. Unless otherwise indicated, you can use lowercase letters when you type a directory name or file name in a dialog box or at a command prompt. ALL CAPITALS Indicate the names of keys, key sequences, and key combinations — for example, ALT+SPACEBAR. Monospace Represents code samples or examples of screen text. [ ] In syntax statements, enclose optional items. For example, [filename] in command syntax indicates that you can choose to type a file name with the command. Type only the information within the brackets, not the brackets themselves. { } In syntax statements, enclose required items. Type only the information within the braces, not the braces themselves. | In syntax statements, separates an either/or choice.  Indicates a procedure with sequential steps. In syntax statements, specifies that the preceding item may be repeated. . . . Represents an omitted portion of a code sample. [...]... scenarios where XML Web services might be an appropriate solution You are encouraged to share other scenarios as appropriate with your students Module 1: The Need for XML Web Services 1 Overview Evolution of Distributed Applications Problems with Traditional Distributed Applications Introducing XML Web Services The Web Technology Stack and NET The NET Alternatives to XML Web Services Common XML Web Service... Simple XML Web Service,” explains how to implement a simple XML Web service by using Microsoft ASP. NET The module also explains how to manage state in ASP. NET XML Web services Some of the techniques for debugging XML Web services are also covered After completing this module, you will be able to implement a simple XML Web service by using Microsoft Visual Studio NET Module 6, “Publishing and Deploying XML. .. completing this module, you will be able to implement an XML Web service consumer by using Microsoft Visual Studio® NET 5 6 Introduction Course Outline (continued) Module 5: Implementing a Simple XML Web Service Module 6: Publishing and Deploying XML Web Services Module 7: Securing XML Web Services Module 8: Designing XML Web Services Module 9: Global XML Web Services Architecture *****************************ILLEGAL... that the NET Framework provides The NET Alternatives to XML Web Services Explain that the NET Framework supports many patterns for building distributed applications, with XML Web services being just one type Many students will be interested in NET remoting solutions Be sure to contrast the tighter coupling of NET remoting solutions vs the loose coupling of XML Web service solutions Common XML Web Service... 2524B, Developing XML Web Services Using Microsoft ASP. NET, you can take either of the following courses: Course 2349B, Programming with the Microsoft NET Framework (Microsoft Visual C#™ NET) Course 2415B, Programming with the Microsoft NET Framework (Microsoft Visual Basic NET) 10 Introduction Course Title and description 2349B Programming with the Microsoft NET Framework (Microsoft Visual C# NET) This... architectural pattern Explain how the Web has provided a new environment in which distributed applications can be developed and define what some of the benefits and challenges of the Web are Introducing XML Web Services Briefly describe what XML Web services are Emphasize the fact that the underlying technologies for XML Web services are Internet technologies Explain how XML Web services are an evolution of... Applications 2 Problems with Traditional Distributed Applications 4 Introducing XML Web Services 14 The Web Technology Stack and NET 16 The NET Alternatives to XML Web Services 18 Common XML Web Service Scenarios 20 Review 22 Information in this document, including URL and other Internet Web site references, is subject to change without notice Unless otherwise noted, the example companies, organizations,... hands-on experience with each of these technologies After completing this module, you will be able to describe the underlying technologies of XML Web services and explain how to use the NET Framework to communicate with XML Web services using these technologies Introduction Module 4, “Consuming XML Web Services, ” is the first of the modules that discusses the implementation details of an XML Web service-based... This module specifically focuses on how to implement an XML Web service consumer to consume (use) XML Web services Web Service consumers are implemented based on the service description documents of XML Web services In this context, this module discusses the structure of a Web Service Description Language (WSDL) document and how to find XML Web services and their service descriptions at known endpoints... XML Web Services, ” explains how to publish an XML Web service in a Universal Description, Discovery, and Integration (UDDI) registry to facilitate XML Web services discovery at unknown endpoints This module covers both publishing and finding an XML Web service in a UDDI registry The options for publishing an XML Web service on an intranet and the options for modifying the default configuration of an XML . Simple XML Web Service Overview 1 Creating an XML Web Service Project 2 Implementing XML Web Service Methods 11 Managing State in an ASP. NET XML Web Service 33 Debugging XML Web Services 42.  Module 6: Publishing and Deploying XML Web Services  Module 7: Securing XML Web Services  Module 8: Designing XML Web Services  Module 9: Global XML Web Services Architecture ***************************** ILLEGAL. The .NET Alternatives to XML Web Services 18 Common XML Web Service Scenarios 20 Review 22 Module 2: XML Web Service Architectures Overview 1 Service-Oriented Architecture 2 XML Web Services