使用WCF进行跨平台开发之一(WCF的实现、控制台托管与.net平台的调用)

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; }

    }

}

 

 

SalaryDetail.cs

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; }

    }

}

 

以上所设计的是数据契约，在使用DataContract和DataMember修饰和类和属性后，可将这些类型和属性暴露在元数据中，而后设计服务契约

     定义一个借口名为IEmployeeManagement并添加一个方法签名GetSalaryOfLastMonth，并添加ServiceContractAttribute和OperationContractAttribute。

    IEmployeeManagement.cs

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;

        }

    }

}

 

因为这里实现的内容并不重要，所以没有具体的去实现它，知识简单的返回了一个SalaryDetail的实例，Id为传入参数的员工ID，时间为当前时间的前一个月，薪水为固定的20000。

 

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("\n" + 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。