Essential Windows Communication Foundation (WCF): For .NET Framework 3.5

Essential Windows Communication Foundation......Page 1
Contents......Page 10
Foreword......Page 26
Preface......Page 28
Acknowledgments......Page 34
Why WCF Matters......Page 38
Introduction......Page 40
Implementing a WCF Service......Page 43
Writing a WCF Service Entirely in Code......Page 44
Writing a Service with Code and Configuration Files......Page 47
More on Configuration Files......Page 49
More on Service Hosting......Page 50
Exposing the Metadata Exchange (MEX) Endpoint......Page 51
Writing a WCF Client Entirely in Code......Page 55
Writing a Client with Code and Configuration......Page 56
Discussion......Page 60
Hosting a Service in IIS in Three Steps......Page 61
Tools Support......Page 64
Generating Client Proxy Class and Configuration Files......Page 65
2 Contracts......Page 70
Service Contracts......Page 74
Synchronous Request-Response Operations......Page 75
Asynchronous Request-Response Operations......Page 78
One-Way Operations......Page 81
Duplex Operations......Page 83
Multiple Contracts and Endpoints in a Service......Page 91
Names of Operations, Types, Actions, and Namespaces in WSDL......Page 94
Data Contracts......Page 97
Defining XML Schema for a .NET Class......Page 99
Defining Class Hierarchies......Page 102
Exposing Additional Types in WSDL with KnownTypes......Page 104
Versioning Data Contracts......Page 109
Data Contract Equivalence......Page 112
Working with Collections......Page 113
Message Contracts......Page 115
Typed Messages......Page 116
Untyped Messages......Page 119
Using SOAP Headers with Untyped Messages......Page 122
3 Channels......Page 128
One-Way Communication Pattern......Page 131
Duplex Communication......Page 132
Request-Reply Communication......Page 134
Shape Changing......Page 135
Operation Contract and Channel Shapes......Page 136
Channel Listeners......Page 138
Channel Factories......Page 139
ChannelFactory<>......Page 141
ICommunicationObject......Page 142
4 Bindings......Page 148
Choosing an Appropriate Binding......Page 153
Sample Application......Page 156
netTcpBinding......Page 160
Local Machine Communication Between .NET Applications......Page 164
netNamedPipeBinding......Page 165
Communication Using Basic Web Services......Page 168
basicHttpBinding......Page 169
Communication Using Advanced Web Services......Page 172
wsHttpBinding......Page 174
ws2007HttpBinding......Page 177
wsDualHttpBinding......Page 180
Comparing Binding Performance and Scalability......Page 189
Communication Using Queued Services......Page 191
netMsmqBinding......Page 192
msmqIntegrationBinding......Page 202
Creating a Custom Binding......Page 205
Binding Elements......Page 208
Transports......Page 209
Encoders......Page 210
Security......Page 211
Transport Upgrades/Helpers......Page 212
Shape Change......Page 213
Exposing a Service Contract over Multiple Bindings......Page 214
5 Behaviors......Page 218
Concurrency and Instancing (Service Behavior)......Page 221
Default Concurrency and Instancing with Sessionless Binding......Page 224
Multithreading a Single Instance......Page 226
Implementing a Singleton......Page 227
Session-Level Instances......Page 230
Controlling the Number of Concurrent Instances......Page 232
Controlling the Number of Concurrent Calls......Page 236
Controlling the Number of Concurrent Sessions......Page 238
Exporting and Publishing Metadata (Service Behavior)......Page 241
Implementing Transactions (Operation Behavior)......Page 244
Transactional Operations Within a Service......Page 245
Flowing Transactions Across Operations......Page 252
Choosing a Transaction Protocol—OleTx or WS-AT......Page 258
Transaction Service Behaviors......Page 260
Implementing Custom Behaviors......Page 261
Implementing a Message Inspector for Service Endpoint Behavior......Page 264
Exposing a Parameter Inspector for Service Operation Behavior as an Attribute......Page 267
Exposing a Service Behavior Through Configuration......Page 270
Security Behaviors......Page 274
Serialization Versus Encoding......Page 278
DataContractSerializer......Page 280
NetDataContractSerializer......Page 284
XmlSerializer......Page 286
DataContractJsonSerializer......Page 289
Preserving References and Cyclical References......Page 291
Sharing Type with the NetDataContractSerializer......Page 297
Roundtrip Serialization Using IExtensibleDataObject......Page 301
Serializing Types Using Surrogates......Page 307
Streaming Large Data......Page 313
Using the XmlSerializer for Custom Serialization......Page 314
Custom XmlSerialization Using Attributes......Page 315
Custom XmlSerialization Using IXmlSerializable......Page 316
Choosing an Encoder......Page 318
Text Versus Binary Encoding......Page 319
Sending Binary Data Using MTOM Encoding......Page 320
Getting to Know the WebMessageEncoder......Page 321
7 Hosting......Page 324
Hosting a Service in Windows Process Activation Services......Page 325
Hosting a Service in IIS 7......Page 329
Enabling ASMX Features in an IIS-Hosted Service......Page 331
Self-Hosting......Page 338
Self-Hosting in a Managed Windows Service......Page 339
Hosting Multiple Services in One Process......Page 342
Defining Service and Endpoint Addresses......Page 345
8 Security......Page 352
Authorization......Page 353
Transport and Message Security......Page 354
Concepts......Page 356
Setup......Page 357
Transport-Level Security......Page 359
Encryption Using SSL......Page 360
Client Authentication......Page 364
Service Identity......Page 369
Message-Level Security......Page 371
Authenticating with wsHttpBinding......Page 372
Securing Services with Windows Integrated Security......Page 377
Section Examples Introduction......Page 378
Authenticating Users with Windows Credentials......Page 380
Authorizing Users with Windows Credentials......Page 383
Authorization Using AzMan......Page 385
Impersonating Users......Page 390
Securing Services over the Internet......Page 395
ASP.NET Integration......Page 397
Authentication Using Membership Providers......Page 398
Role-Based Authorization Using Role Providers......Page 401
Using Forms Authentication......Page 403
Logging and Auditing......Page 408
9 Diagnostics......Page 412
Tracing......Page 413
End-to-End Tracing......Page 414
Activities and Correlation......Page 415
Enabling Tracing......Page 416
Enabling Message Logging......Page 418
Additional Configuration Options......Page 420
Message Filters......Page 421
Trace Source Auto Flushing......Page 422
Performance Counters......Page 423
Using the Service Configuration Editor......Page 424
Logging Options......Page 426
Configuring Sources......Page 427
Configuring Listeners......Page 428
Activity View......Page 430
Graph View......Page 432
Analyzing Logs from Multiple Sources......Page 434
Filtering Results......Page 437
10 Exception Handling......Page 440
WCF Exception Communication via SOAP......Page 441
Unhandled Exception Example......Page 442
Detecting and Recovering a Faulted Channel......Page 445
Communicating Exception Details......Page 446
Managing Service Exceptions with FaultException......Page 448
Using FaultCode and FaultReason to Extend FaultException......Page 449
Limitations of Basic FaultExceptions......Page 451
Declaring Fault Definitions with FaultContract......Page 452
Defining a FaultContract......Page 454
Throwing a FaultException<> with a Defined FaultContract......Page 455
Implementing Client Fault Handlers......Page 456
Error-Handling Application Block......Page 457
Exception Shielding......Page 458
11 Workflow Services......Page 460
Integration Points......Page 461
Calling a WCF Service from WF......Page 463
Using a Send Activity......Page 464
Writing a Custom Activity......Page 467
Exposing a Service from WF......Page 470
Define the Interface......Page 471
Receive Activity......Page 472
Configuration in app.config......Page 476
Hosting a Service-Enabled Workflow......Page 478
Self-Hosting a Service-Enabled Workflow......Page 479
Hosting a Service-Enabled Workflow in IIS......Page 480
Correlation and Durable Services......Page 481
Long-Running Workflow......Page 482
Handling the Context......Page 487
Persisting Workflow State on the Server......Page 489
Controlling Access to Service-Enabled Workflows......Page 491
Programmatic Access Control......Page 492
Approaches to Building Distributed Applications......Page 496
N-Tier Applications......Page 497
Peer-to-Peer Applications......Page 498
Mesh Networks......Page 499
Message Flooding Versus Directional Messaging......Page 501
netPeerTcpBinding......Page 502
Resolving Peers Using PNRP......Page 505
Windows Internet Computer Names......Page 506
PnrpPeerResolver......Page 507
Registering Names Using PNRP......Page 508
System.Net.Peer......Page 509
Implementing a Custom Peer Resolver......Page 511
Limiting the Number of Hops for a Message......Page 515
Collaboration Using Windows Vista......Page 517
People Near Me......Page 518
Windows Contacts......Page 519
Invitations......Page 520
System.Net.PeerToPeer.Collaboration......Page 522
Directional Messaging Using Custom Binding......Page 529
13 Programmable Web......Page 540
All About the URI......Page 541
The Ubiquitous GET......Page 543
Web Programming with WCF......Page 544
URI and UriTemplates......Page 545
Building URIs......Page 546
Parsing URIs......Page 547
Creating Operations for the Web......Page 548
Hosting Using WebHttpBinding......Page 549
WebInvoke......Page 551
ASP.NET AJAX Integration......Page 553
Using the WebOperationContext......Page 560
WebScriptServiceHostFactory......Page 567
Content Syndication with RSS and ATOM......Page 568
Publishing Metadata Endpoints......Page 574
mexTcpBinding......Page 575
Creating Clients from Metadata......Page 576
Creating Silverlight Clients from Metadata......Page 578
Sharing Ports Between Services......Page 579
Configuring Service Quota Settings......Page 580
Configuring HTTP Connections......Page 582
Adjusting Connection Lifetime......Page 583
Disabling HTTP Keep-Alives......Page 584
Recycling Idle Connections......Page 586
Exposing LINQ-to-SQL Entities......Page 587
A......Page 590
B......Page 591
C......Page 592
D......Page 593
E......Page 594
G–H......Page 595
M......Page 596
O......Page 597
Q–R......Page 598
S......Page 599
T......Page 601
V–W......Page 602
X–Z......Page 603