Abstract
In this article I am going to take you a little bit in depth of WCF(Windows Communication Foundation), the latest technology and framework introduced by Microsoft to make developer life easy in distributed applications.
Introduction
To make developer's life easy, Microsoft continuously brings new technologies in the market. Sometimes those are similar to their predecessors and sometimes they bring large enhancements in the current technologies. As a result we can see the processing architecture of web page is totally changed in .NET 2.0. Now .NET 2.0 does not bring significant enhancements in Winform application development. So how can we go with a Windows application that can be distributed across diverse operating systems and that will gain the performance benefit while used on the same OS? The answer is WCF, i.e. Windows Communication Foundation (WCF) code name INDIGO.
In this article we will learn the basic components of WCF and also dive into some of the details of these components. We will try to address the issues faced in previous versions and find out why to use WCF.
What is WCF
As mentioned earlier, WCF is the Windows Communication Foundation built on .NET 2.0 framework. It is a type of service execution framework especially made for establishing communication between diverse systems and to gain performance benefits on similar systems. It consolidates the best features of web service, remoting, MSMQ, System.Messaging
and Microsoft enterprise services. One of the biggest advantages of WCF is that it supports most of the open industry standards hence it can produce the best results across heterogeneous operations systems. Other benefits are that it is developed using managed code and uses the power and features of .NET 2.0. As it supports WS-* standards, it supports transaction, security, reliability. WCF uses SOAP as its native protocol for communication.
Prerequisite
You need the following to develop a WCF service:
- OS: Windows VISTA, Windows XP SP2, Windows 2003 Server SP1
- VS 2005 professional edition with SP1
- Microsoft Windows Software Development KIT
- .NET 3.0 runtime
- WCF extensions (while working on VS 2005 editor)
Key Components of WCF
WCF is based upon the following key components that are used to build a WCF service. We will go in the details of each component in the sections below:
- Contract definitions
- Data contracts and data member
- Service contracts
- Fault contracts
- Message contracts
- End points
- Bindings
BasicHttpBinding
WSHttpBinding
WSDualHttpBinding
WSFederationHttpBinding
MsmqIntegrationBinding
NetMsmqBinding
NetNamedPipeBinding
NetPeerTcpBinding
NetTcpBinding
- Hosting environments
- Windows application
- Console application
- Windows service
- IIS
- WAS (Windows activation service) comes with IIS 7.0
- Windows Presentation Foundation
Problems addressed by WCF
Till now we have seen what WCF is and what WCF components are. But unless and until we come to know the issues addressed by WCF, we will never know the power of WCF.
Imagine you are developing an enterprise application for a bank. Now when you start designing the system, the requirements are very complex and critical. Say for example, the application is used by bank staff, outside customers, some of payment gateway systems. You are not sure that what operating system and what type of clients will be used by outside customers. You want performance with security, reliability when used on intranet and security, reliability when used from outside. Previously you could have gone for web services exposing web methods for outside clients and a remoting or COM+ application for Windows OS. Both these applications are using the same business logic and the same database. Suppose you want to add some new business logic like introducing a new loan system, imagine how much it will take to change all the systems. This is perhaps the simplest example. What if you are going to modify business logic or add 3-4 additional schemes in a span of 6 months? The current design will not scale. You will start thinking, what if I would have a single application exposing multiple endpoints for diverse and similar clients and will give me all benefits of industry-wide open standards. That's it. WCF is the answer to your question. WCF, with managed code, using power and features of .NET 2.0, giving all the benefits of performance, security, transaction, reliability by supporting all open industry standards makes life easy for the developer and the organization by unifying the programming model with the best features from all available technologies.
WCF is interoperable with:
- Web services
- .NET - .NET communication
- Distributed transactions
- Support for WS-* specifications
- Queued messaging
Key subsystems of WCF
- Service model
- Connector framework
- Hosting environment
- System services
- Messaging services
Key components in WCF
- Contracts
- Bindings
- End point definitions
- Hosting environment
We will go in details of each component in the coming sections.
Contracts
Contracts are one of the most important components of WCF. Contracts make developing interoperable services possible. It is a common understanding between the client and server of available methods, data structures, and message structures. They remain loosely coupled and platform independent. WCF contains the following contracts. As SOAP is the native protocol of WCF for communication, interfaces, classes are translated to SOAP types by CLR.
Service contract
Data contract
- Translated to XML schema (XSD). Basically describes data structure. When we want to pass or return more values, then we go for data contract. It is a serializable object that can be passed or returned to or from a service. It supports versioning provided you do not change the name of the existing members, name of the namespace to maintain compatibility.
- Data contract can be defined annotating
[DataContract]
attribute on a class, structure or enum. The data members that are to be exposed outside are annotated with [DataMember]
attribute for class and structure and [EnumMember]
attribute for enum. [DataContract]
tells WCF how to serialize the object. Depending upon the client WCF serializes the members. If the communication is between WCF and WCF then it uses binary serialization over SOAP to optimize the performance. While in case of WCF to Non-Windows client, it uses SOAP serialization. - Here also access modifiers do not play any role.
- There are some cases when you do not have proxy generated for the given service. This may be the case when the WCF service using only TCP endpoints to allow interaction. In that case WSDL will not be available unless and until it is explicitly defined in service behavior with HTTP end point. Even if the client does not have WSDL with us, we can create the same WCF dummy class or proxy class at client side. WCF service will remain as it is, the implementer will derive from
ClientBase<iwcfservice />
and implement the WCF service (IWCFService). In such a case, the operation contract method will call base.Channel.GetSystemIPAddress()
and it will be routed to the server by foundation. In this case we can have data contract members defined in the same way. The only thing and most important thing is that namespace must have same names as that of server. Also method names and data member names should remain the same.
Fault contract
- Translated to SOAP faults. Allows developer to document the errors that a service can produce. We can define service contract only on
[OperationContract]
by annotating with [FaultContract(typeof(System.Exception))]
attribute. Here the exception type can be exception to want to document. Custom exception should be marked as serializable.
Message contract
Bindings
Bindings are communication channels between a WCF service and client. They decide how the WCF service will communicate with the client. Depending upon the different protocols like HTTP, TCP, MSMQ, there are different types of binding. Binding supports encoding of messages using text encoding, binary encoding and Message Transmission Optimization mechanism (MTOM, interoperable message format used for effective transmission of large attachments greater than 64K) As WCF supports all industry open standards, it supports security using SSL and WS-Security (schema defined security) standards.If we want
session enabled service then binding determines whether the service is session enabled or not. Not all binding supports sessions. As WCF is extendible, we can define our own custom bindings. But this is very rare case because WCF has nine in-built bindings that are sufficient for most of the applications. The exceptions can be: RSS feed of a site or SMTP protocol.
1 | BasicHttpBinding | : | Basic web service communication with no security by default |
2 | WSHttpBinding | : | Web services with WS-* standards, supports transactions |
3 | WSDualHttpBinding | : | Web services with duplex contract and transaction support |
4 | WSFederationHttpBinding | : | Web services with federated security with transaction support |
5 | MsmqIntegrationBinding | : | Direct communication with MSMQ, supports transaction |
6 | NetMsmqBinding | : | Communication between WCF applications using queuing with transaction support |
7 | NetNamedPipeBinding | : | Communication between WCF applications on the same computer with duplex contracts support and transaction support |
8 | NetPeerTcpBinding | : | Communication between computers across peer-to-peer services with duplex contracts support |
9 | NetTcpBinding | : | Communication between WCF applications across computers supports duplex contracts and transactions |
Here is the mapping of base address schemes to the transport protocols:
http | : | HTTP |
net.tcp | : | TCP |
net.pipes | : | Names pipes |
net.msmq | : | MSMQ |
End points
End points are nothing but a URI which are exposed to the outside world and from where the client can connect to the WCF service.
Each end point consists of:
- Base address: Where to send message (A)
- Type of binding: How to send message (B)
- Contract: What to send in a message (C)
We can define as many end points as the application requires. For example, if the application is to be used by a JAVA client and WPF client then we can expose an endpoint with TCP binding where the WPF client will communicate and an end point with basic HTTP binding where JAVA client will communicate. We can control and configure the behavior of an end point programmatically and using application configuration file.
Hosting environments
The architecture of an WCF application is usually like this:
Database layer => Business logic layer => WCF service => Hosting environment
As the diagram shows, we need a host to run a WCF service. Fortunately there are many options that can be used for hosting a WCF service. This actually depends upon the application requirement. Following is the list of hosts:
- Windows application: Simple winform application
- Console application: Simple console application
- Windows service: WCF service can be controlled by the Service control manager
- IIS: Can be hosted in IIS provided the service exposes at least one HTTP end point
- WAS (Windows Activation Service) comes with IIS 7.0: Removes dependability upon HTTP
- Windows Presentation Foundation
Security in WCF
When you go for a distributed application, the most important aspect is security. As mentioned earlier, WCF supports security using binding. Binding supports security using SSL, WS-Security standards. You can also use Windows authentication. One of the primary goals behind WCF development was to make it easy for the development of secured applications. WCF service can be secured using four ways:
- Authentication
- Message integrity
- Message confidentiality
- Authorization
There are some guidelines about using security mechanisms. Depending upon the application need and requirement, we can easily select the suitable one and implement with few efforts. Here are the guidelines:
- Use a standard binding that directly supports security. For example, applications that
require end-to-end security for messages that go through multiple SOAP intermediaries can use a binding that supports WS-Security, such as WsHttpBinding
. - Use a standard binding that optionally supports security, and then configure it as needed. For example, applications that need only transport-based security can choose
BasicHttpBinding
, configuring it to use HTTPS rather than HTTP. It's also possible to customize other more-advanced security behaviors. For example, the authentication mechanism used by a binding such as WsHttpBinding
can be changed if desired. - Create a custom binding that provides exactly the security behavior a developer needs. Doing this is not for the faint of heart, but it can be the right solution for some advanced scenarios.
- Use a standard binding that provides no support for security, such as
BasicHttpBinding
. While using no security is a risky thing to do, it can be the only option in some situations.
Other important features
There are many other features which are present in WCF and can be used to achieve reliable communication. Those are as follows:
Application outline
The attached application solution contains six projects:
- Console client: It calls the WCF service without creating a proxy. Contract and data members are created manually at client side. It uses simple TCP binding.
MsmqClient
: As the name says, it uses MSMQ binding. The MSMQ must be installed and the private queue with the given name should be created before running this application. SystemInfo
: Simple data access class. It does nothing special. WCF service calls methods of this class. WCFClient
: Simple Windows application to demonstrate working of WSDL created using svcutil. Uses Basichttp
binding. WCFHost
: A simple console application acting as a host for WCF service. WCFservice
: Actual WCF service with service contract and data contract. Also contains .SVC file so that it can be hosted in IIS directly. It also contains other details required for MSMQ binding. There is one implementer class which implements service contracts. Most of the code is self explanatory. Your suggestions are always welcome.
Conclusion
We can conclude that WCF simplifies the creation of distributed applications on Windows. Because it implements SOAP and the most important WS-* specifications, WCF provides full-featured interoperability with other Web services platforms. And because it offers explicit support for a service-oriented approach, WCF gives developers a natural environment for building modern software.