Programming Microsoft .NET XML Web Services

by Foggon, Damien; Maharry, Daniel; Ullman, Chris; Watson, Karli

• ISBN13: 9780735619128
• ISBN10: 0735619123
• Format: Paperback
• Copyright: 2003-08-27
• Publisher: Microsoft Pr

Summary

With this guide, the authors set an ambitious course to help professional programmers understand the architecture of XML Web services and implement the right solutions by creating and consuming best-of-breed XML Web services. The book provides a hands-on

Table of Contents

Acknowledgments	xv
Introduction	xvii
Part I The Core
Web Services 101	3	(44)
From Past to Present Platform	4	(8)
Web Applications	4	(1)
XML	5	(2)
Distributed Applications	7	(1)
Building the Platform	8	(1)
So Where Are We Now?	9	(3)
Web Service Scenarios	12	(3)
Simple Services	12	(1)
Application Integration Services	13	(1)
Framework Services	13	(1)
Web Services vs .NET Remoting	14	(1)
Developing a Web Service	15	(15)
A Simple Example in Notepad	15	(2)
The Life Cycle of a Web Service Request	17	(4)
A Simple Example in Web Matrix	21	(2)
A Simple Example in Visual Studio .NET	23	(4)
How Does It Work?	27	(3)
Developing a Web Service Client	30	(9)
A Simple Windows Forms Client	31	(1)
Finding Your Service	31	(1)
Adding a Reference	32	(4)
Adding a Reference Manually	36	(3)
Deploying Web Services	39	(2)
Manual Deployment	39	(1)
One-Click Hosting	40	(1)
Building on the Foundation	41	(4)
State Management	41	(1)
Incorporating Transactions	42	(1)
Asynchronous Services	43	(1)
Security	44	(1)
Summary	45	(2)
Web Services and SOAP	47	(50)
What Is SOAP?	48	(2)
SOAP and WSDL	50	(1)
The SOAP Message Structure	50	(3)
Namespaces	51	(1)
Namespaces in SOAP 1.2	52	(1)
The Current State of the SOAP Standard	53	(2)
SOAP 1.1	53	(1)
SOAP 1.2	54	(1)
Elements Defined in the SOAP Standard	55	(33)
The SOAP Envelope	55	(1)
The SOAP Body	56	(3)
Simple Types in a SOAP Body	59	(4)
SOAP Message Validation	63	(7)
Sending SOAP over HTTP	70	(1)
Sending Information via HTTP-POST	71	(1)
Changes to Bindings in SOAP 1.2	72	(1)
Binding to Other Protocols	73	(1)
Sending Datasets via an Application	73	(7)
The SOAP Header	80	(3)
Processing and Building a SOAP Header with .NET	83	(5)
SOAP Exceptions and Errors	88	(6)
The <fault> Element	89	(5)
Extending SOAP	94	(1)
Summary	94	(3)
Describing Web Services	97	(46)
The Anatomy of WSDL	98	(22)
Document Structure	101	(3)
The Core Framework	104	(8)
The Binding Extensions	112	(8)
.NET and WSDL	120	(16)
Supported Protocols	121	(1)
SOAP Message Formats	122	(3)
Other Configuration Options	125	(4)
Specifying Documentation Elements	129	(2)
SOAP Headers	131	(2)
Method Overloading	133	(3)
Using the WSDL Files	136	(5)
Wsdl.exe	136	(1)
Visual Studio .NET	137	(4)
Summary	141	(2)
Discovering Web Services	143	(62)
Microsoft Discovery (DISCO)	144	(8)
The DISCO Specification	144	(1)
Discovery Document Types	145	(4)
Visual Studio .NET and DISCO Files	149	(3)
Universal Description, Discovery, and Integration (UDDI)	152	(50)
The UDDI Business Registries	154	(1)
Categorization and Identification	155	(2)
Searching for Web Services	157	(3)
The UDDI API	160	(3)
The UDDI SDK	163	(3)
The Query Application	166	(16)
The UDDI Browser	182	(13)
Visual Studio .NET and UDDI	195	(4)
UDDI Enterprise Services in Windows 2003 Server	199	(3)
Summary	202	(3)
Raw Handlers and Clients	205	(36)
HTTP Handlers	206	(9)
Approximating the Default Handler	207	(8)
The HTTP Pipeline	215	(7)
From IIS to ASP.NET	215	(2)
Inside the ASP.NET HTTP Pipeline	217	(5)
Working with XML Directly	222	(9)
Using the XML Streaming API	222	(4)
Which XML API?	226	(1)
Using the XML DOM API	227	(4)
Two More Handler Classes	231	(3)
IHttpAsyncHandler	231	(1)
IHttpHandlerFactory	232	(2)
Coding Differences Between the Handler API and the Web Method API	234	(2)
Taking Care with Session State	235	(1)
Custom Clients	236	(4)
Summary	240	(1)
Writing Schemas for Your Services	241	(52)
The Role of Schemas in Web Services	242	(1)
Writing a Schema Explicitly	243	(17)
The Root <schema> Element	244	(1)
Associating Schemas with Instance Documents	245	(1)
Declaring Elements	246	(2)
Declaring Attributes	248	(1)
Declaring Custom Types	249	(9)
Element and Attribute Groups	258	(1)
Namespace Scoping Issues	258	(1)
Advanced Schema Features	259	(1)
Incorporating a Schema into Your Web Service	260	(7)
Using the XML Schema Definition Tool	260	(3)
What the Serializer Doesn't Do	263	(2)
Using Wsdl.exe	265	(2)
SOAP, WSDL, Encoding, and Styles	267	(1)
Writing Schemas Implicitly	268	(20)
Working with Document/Literal Services	269	(17)
Serialization Attributes for Encoded Services	286	(2)
Serializer-Unfriendly Classes	288	(1)
The Other .NET Serializer	288	(1)
Summary	289	(4)
Part II Building on the Core
Creating Web Methods	293	(44)
Building a Web Method	293	(1)
The XML Web Service Code Model	294	(6)
The @WebService Processing Directive	294	(2)
The WebService Attribute	296	(1)
The WebMethod Attribute	297	(1)
Configuring Web Methods Using Attributes	298	(2)
An Example Application	300	(5)
The Example Web Service	302	(1)
The Example Web Methods	302	(3)
Tweaking Your Web Methods	305	(6)
WSDL and Web Methods	306	(4)
Doc-Lit vs. RPC Encoding	310	(1)
Configuring Web Methods	311	(4)
The Machine.config File	312	(1)
The Web.config File	313	(2)
Managing State	315	(12)
When Should You Maintain State?	316	(2)
Maintaining State on the Server	318	(4)
Asynchronous Web Services	322	(1)
The OneWay Property	323	(1)
Dividing the Labor	323	(1)
Versioning with XSLT	324	(3)
Getting Your Web Method to Work	327	(9)
Debugging	327	(4)
Deployment	331	(3)
Discovery of the Web Service	334	(2)
Summary	336	(1)
Consuming Web Services	337	(40)
Types of Clients	337	(1)
The .NET Model of Web Service Consumption	338	(26)
Finding and Consuming a Web Service	338	(4)
The Proxy Client	342	(2)
Building a Client	344	(11)
Other Scenarios	355	(9)
When the Client Doesn't Use .NET	364	(8)
Consuming a Web Service from Old COM Applications	364	(5)
Using ASP 2.0 and 3.0	369	(3)
Working with XML in the Client	372	(4)
Using XSLT for User Interface Purposes	373	(3)
Using XSLT for Noninterface Purposes	376	(1)
Summary	376	(1)
ADO.NET and Web Services	377	(46)
Data Access Using ADO.NET	378	(13)
DataReader Objects	378	(4)
DataSet Objects	382	(7)
ADO.NET Data Access Recommendations	389	(2)
Using ADO.NET to Access Custom Data Sources	391	(26)
Custom Providers	392	(1)
FileSystemDataProvider	392	(25)
XML Data	417	(4)
Querying XML Data Sources	417	(2)
Addressing a DataSet as XML	419	(1)
SQLXML	420	(1)
Exposing Other Data as XML	421	(1)
Summary	421	(2)
Extending the Web Services Framework	423	(34)
HTTP Modules vs. SOAP Extensions	424	(3)
A Message's Life Cycle	424	(2)
Practical Applications	426	(1)
Building HTTP Modules	427	(10)
A Simple Example	427	(2)
The IHttpModule Interface	429	(2)
Events Exposed by Modules	431	(3)
Deploying a Module to a Web Application	434	(2)
A Final Module Example	436	(1)
Building SOAP Extensions	437	(18)
An Autonomous SOAP Extension	438	(8)
A Targetable SOAP Extension	446	(6)
Changing the SOAP Message Using Your Extension	452	(2)
SOAP Extensions on the Client	454	(1)
Summary	455	(2)
General Security	457	(36)
Windows Security	458	(1)
Authentication in ASP.NET	458	(14)
IIS Authentication	459	(6)
Custom Authentication	465	(7)
Authorization in ASP.NET	472	(5)
ASP.NET Process Identity	472	(2)
Authorizing Users	474	(3)
Controlling Access to Services	477	(1)
Secure Communication	477	(11)
SSL	478	(1)
Custom Cryptography	479	(9)
Summary	488	(5)
Part III Enhancing the Web Services Framework
The Global XML Web Services Architecture	493	(30)
GXA Specifications in WSE	495	(18)
WS-Attachments	495	(4)
WS-Security	499	(7)
WS-Timestamp	506	(1)
WS-Routing and WS-Referral	507	(6)
Other GXA Specifications	513	(8)
WS-Addressing	513	(1)
WS-Coordination	514	(1)
WS-Inspection	515	(1)
WS-Policy	515	(2)
WS-Reliable Messaging	517	(1)
WS-Security	518	(2)
WS-Transaction	520	(1)
Summary	521	(2)
Web Service Enhancements	523	(34)
Downloading and Installing WSE	523	(1)
The Structure of WSE	524	(9)
The WSE Pipeline	524	(5)
WSE at the Client	529	(3)
WSE at the Server	532	(1)
The Web Settings Tool	533	(2)
Individual Configuration Options	535	(1)
Controlling the Filters in the Pipeline	535	(4)
Adding Filters in the Configuration Files	538	(1)
Recommended Filter Configuration	539	(1)
The Trace Filters	539	(2)
Working with Attachments	541	(5)
Debugging Attachments	544	(2)
Using Timestamp Filters	546	(4)
Creating Custom Filters	550	(5)
Under the Covers	550	(1)
Building a Custom Filter	551	(1)
Adding a Custom Filter	552	(1)
Custom Filters on the Client	553	(2)
Summary	555	(2)
Routing and Referral	557	(24)
The Path Object	558	(1)
How WSE Routing Works	559	(1)
Routing and HTTP	560	(1)
The Destination Web Services	560	(1)
Server-Controlled Routing	561	(7)
The Web Service	561	(1)
Server Configuration	561	(2)
WSDL for the Router	563	(2)
The Client	565	(1)
The SOAP Messages	566	(1)
Multiple Routers on the Same Server	567	(1)
Custom Routing	568	(5)
Building the Custom Router	569	(2)
Creating the Web Services	571	(1)
WSDL for the Router	572	(1)
The Client	572	(1)
The SOAP Messages	573	(1)
Client-Controlled Routing	573	(4)
The Web Service	573	(1)
Server Configuration	573	(1)
WSDL for the Routers	574	(1)
The Client	574	(2)
The SOAP Messages	576	(1)
Working Routers	577	(1)
Routing and Timestamps	578	(1)
Summary	579	(2)
Web Service Security	581	(36)
Security Requirements	581	(1)
Username and Password Security	582	(1)
X509 Certificate Security	583	(6)
Generating Test X509 Certificates	584	(4)
Importing X509 Certificates	588	(1)
Getting Real X509 Certificates	588	(1)
Using Other Security Credentials	589	(1)
The SecurityToken Class	589	(2)
Message Authentication	591	(9)
The Client	592	(4)
The Web Service	596	(3)
Security Problems	599	(1)
Message Signing and Encrypting	600	(6)
Required Certificates	600	(1)
The Client	601	(2)
The Web Service	603	(3)
Shared Key Encryption	606	(5)
The Shared Key	607	(1)
The Client	608	(1)
The Web Service	609	(2)
Signing and Encrypting Parts of the Message	611	(5)
Signing Parts of the Message	611	(1)
Encrypting Parts of the Message	612	(1)
The Client	613	(1)
The Web Service	614	(2)
Summary	616	(1)
Looking to the Future	617	(20)
The Standards	617	(12)
The Basic Architecture	618	(7)
The Extended Architecture	625	(4)
The March Toward Interoperability	629	(5)
Solutions	630	(4)
Summary	634	(3)
Part IV Appendixes
A The XSD Simple Types	637	(20)
Conceptual Types	637	(1)
Numeric Types	638	(6)
Primitive Numeric Types	638	(2)
Derived Numeric Types	640	(4)
Date and Time Types	644	(4)
XML Types	648	(6)
Primitive XML Types	649	(1)
Derived XML Types	650	(4)
Miscellaneous Types	654	(3)
B Webliography	657	(10)
Standards and Standards Bodies	657	(1)
Web Service Development	658	(1)
Sites Referenced in the Book	659	(8)
Introduction	659	(1)
Chapter 1	659	(1)
Chapter 2	660	(1)
Chapter 3	660	(1)
Chapter 4	660	(1)
Chapter 5	661	(1)
Chapter 6	661	(1)
Chapter 7	661	(1)
Chapter 8	662	(1)
Chapter 9	662	(1)
Chapter 10	662	(1)
Chapter 11	662	(1)
Chapter 12	663	(1)
Chapter 13	663	(1)
Chapter 14	663	(1)
Chapter 15	663	(1)
Chapter 16	663	(4)
C Glossary	667	(8)
Index	675