WCF是Windows Communication Foundation的缩写,是微软发展的一组数据通信的应用程序开发接口,它是.NET框架的一部分,是WinFx的三个重要开发类库之一,其它两个是WPF和WF。在本系列文章
(我现在计划的应该是三篇,一篇WCF的开发和部署,另外是在.net平台上调用它,第二篇是PHP调用,第三篇是JAVA调用)。
在本次的跨平台集成通信开发示例中,使用到的各种技术,咱且走且看,一边开发一边讲解。
1.创建项目结构
使用VS2010一个名为IntergatedCommunication的空解决方案,在其下,新建Contracts、Implemention两个类库项目,分别为契约的设计与服务的实现,而后新建ConsoleHost、Client两个控制台应用程序,分别为在控制台中实现服务托管使用,一个作为.net平台上调用WCF的实例使用,如下图
2.契约的设计
本实例我还是想让它确实可以应用在实际项目中,所以我在设计的时候,将使用复杂类型(complex type),因为这并不同于普通类型,尤其在java和php在使用复杂类型参数是,调用方法是很不一样的。
首先对Contracts、Implemention和ConsoleHost项目中添加对System.ServiceModel和System.Runtime.Serialization的引用。这两个命名空间中包含ServiceContractAttribute等WCF需要的契约特性类,和对复杂类型序列化的类DataContractSerializer。
本示例使用员工信息(员工ID、员工姓名、所属部门)查询本员工上月的工资明细(员工ID、薪水、日期),所以首先建立两个类Employee类和SalaryDetail类,在类中引用System.Runtime.Serialization命名空间,并且,在类上添加DataContractAttribute并在每个类属性上添加DataMemberAttribute:
Employee.cs
using System.Runtime.Serialization;
namespace Contracts
{
[DataContract]
public class Employee
{
[DataMember]
public string Id { get; set; }
[DataMember]
public string Name { get; set; }
[DataMember]
public string Department { get; set; }
}
}
using System.Runtime.Serialization;
namespace Contracts
{
[DataContract]
public class SalaryDetail
{
[DataMember]
public string Id { get; set; }
[DataMember]
public decimal Salary { get; set; }
[DataMember]
public DateTime Date { get; set; }
}
}
using System.ServiceModel;
namespace Contracts
{
[ServiceContract]
public interface IEmployeeManagement
{
[OperationContract]
SalaryDetail GetSalaryOfLastMonth(Employee emp);
}
}
3.实现服务
在Implemention中添加对Contracts项目的引用,添加EmployeeManagement类,实现IEmployeeManagement接口
EmployeeManagement.cs
using Contracts;
namespace Implemention
{
public class EmployeeManagement:IEmployeeManagement
{
public SalaryDetail GetSalaryOfLastMonth(Employee emp)
{
SalaryDetail salaryDetail = new SalaryDetail();
salaryDetail.Id = emp.Id;
salaryDetail.Date = DateTime.Now.AddMonths(-1);
salaryDetail.Salary = 20000;
return salaryDetail;
}
}
}
4.控制台托管服务
在ConsoleHost中添加对以上两个项目的引用,这时,生成整个解决方案,然后在ConsoleHost中添加应用程序配置文件App.config。并使用WCF服务配置编辑器打开它,并配置服务托管地址和绑定类型等信息,最终配置结果为
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<system.serviceModel>
<behaviors>
<serviceBehaviors>
<behavior name="ExposeMetaDataBehavior">
<serviceMetadata httpGetEnabled="true" httpGetUrl="EmployeeManagement/MEX" />
</behavior>
</serviceBehaviors>
</behaviors>
<services>
<service behaviorConfiguration="ExposeMetaDataBehavior" name="Implemention.EmployeeManagement">
<endpoint address="EmployeeManagement"
binding="wsHttpBinding" bindingConfiguration="" contract="Contracts.IEmployeeManagement" />
<host>
<baseAddresses>
<add baseAddress="http://localhost:9876/"/>
</baseAddresses>
</host>
</service>
</services>
</system.serviceModel>
</configuration>
打开program.cs,在main方法中添加代码,托管服务
using System.ServiceModel;
using Implemention;
namespace ConsoleHost
{
class Program
{
static void Main(string[] args)
{
ServiceHost host = new ServiceHost(typeof(Implemention.EmployeeManagement));
try
{
Console.WriteLine("EmployeeManagement Service Starting");
host.Open();
Console.WriteLine("EmployeeManagement Service Started");
Console.ReadKey();
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
if (ex.InnerException != null)
{
Console.WriteLine(" " + ex.InnerException.Message);
}
}
finally
{
host.Close();
}
Console.ReadKey();
}
}
}
生成解决方案,并在VS外以管理员权限启动ConsoleHost.exe文件,这样就在控制台中托管了服务
5.在.net平台中调用WCF
在Client中,添加服务引用,命名空间设置为ServiceReference
在program.cs中添加代码,调用控制台中托管的服务
namespace Client
{
class Program
{
static void Main(string[] args)
{
ServiceReference.EmployeeManagementClient client = new ServiceReference.EmployeeManagementClient();
ServiceReference.Employee emp = new ServiceReference.Employee() { Id = "dev001", Name = "James White", Department = "Development" };
ServiceReference.SalaryDetail salaryDetail = client.GetSalaryOfLastMonth(emp);
Console.WriteLine("Employee number {0}'s salary of {1} month is ¥{2}", salaryDetail.Id, salaryDetail.Date.Month, salaryDetail.Salary);
Console.ReadKey();
}
}
}
在这里,我们已经简单的实现了WCF服务的实现和.net本平台调用WCF,这一篇不是最重要的,下一篇是使用IIS托管WCF并使用PHP调用WCF。