我们通过实现一个简单的示例来对WCF有个直观而浅显的认识,希望对初次涉及WCF的朋友有所帮助。
可以简单地认为WCF程序分为4部分:契约、服务、宿主、客户端。我们通过一个例子来逐步完成各部分,示例程序中,客户端可以获取一个信息列表,列表中每一项包括ID、值、读值时刻、状态、状态变动时刻。这里我用的是VS2010。
首先,创建一个空白解决方案WCFDemo。
我们将在其中添加n个项目,分别实现契约、服务、宿主、客户端。如果用VS2010新建“WCF服务库”或者“WCF服务应用程序”,它会默认把契约和服务放在一个项目中,我们这个示例把契约和服务分别放在2个类库项目中。
第一步:契约
1、添加一个类库WCFDemo.Contracts。
2、在类库中添加2个文件DataContracts.cs和ServiceContracts.cs,分别放置数据契约和服务契约。
3、添加引用System.Runtime.Serialization和System.ServiceModel。
4、编写代码如下:
DataContracts.cs
using System;
using System.Runtime.Serialization;
namespace WCFDemo.Contracts
{
[DataContract]
public class DemoData
{
[DataMember]
public int ID { get; set; }
[DataMember]
public double Value { get; set; }
[DataMember]
public DateTime ValueTime { get; set; }
[DataMember]
public DeviceState State { get; set; }
[DataMember]
public DateTime StateTime { get; set; }
}
public enum DeviceState
{
Unknown,
Working,
Broken
}
}
(题外话:DemoData类中各个属性的写法有些偷懒,其实个人不建议这样。这里是为了代码简单……)
ServiceContracts.cs
using System.Collections.Generic;
using System.ServiceModel;
namespace WCFDemo.Contracts
{
[ServiceContract]
public interface IDemoService
{
[OperationContract]
List<DemoData> GetMonitorData();
}
}
第二步:服务
1、添加一个类库WCFDemo.Services。
2、在类库中加入一个文件Services.cs用来放置实现服务的类。
3、添加引用WCFDemo.Contracts。
4、编写代码如下:
using System;
using System.Collections.Generic;
using WCFDemo.Contracts;
namespace WCFDemo.Services
{
public class DemoService : IDemoService
{
Random random = new Random();
public List<DemoData> GetMonitorData()
{
List<DemoData> r = new List<DemoData>();
r.Add(new DemoData() { ID = 1, Value = random.Next(100), ValueTime = DateTime.Now, State = DeviceState.Unknown, StateTime = DateTime.Now });
r.Add(new DemoData() { ID = 2, Value = random.Next(100), ValueTime = DateTime.Now, State = DeviceState.Working, StateTime = DateTime.Now });
r.Add(new DemoData() { ID = 3, Value = random.Next(100), ValueTime = DateTime.Now, State = DeviceState.Broken, StateTime = DateTime.Now });
return r;
}
}
}
(题外话:第一步时说过DemoData的偷懒写法。如果DemoData中针对每个属性定义私有字段,并提供带参数的构造函数,构造函数中对字段赋值而不是对属性赋值,那么每个DemoData实例化时比这里的示例代码效率高。)
到这里,服务和契约已经完成。
剩下的就是宿主如何对外提供服务和客户端如何享受服务了,我们先使用最最简单的方式来实现。
我们先以最简单的方式来实现宿主和客户端:直接引用契约和服务项目、采用硬编码的方式。
第三步:宿主
1、添加一个Windows窗体应用程序WCFDemo.Host.WithoutConfig。
2、添加引用System.ServiceModel。
3、引用之前的两个项目。
4、在窗体放置两个Button和一个Label,并编写代码如下:
using System;
using System.Windows.Forms;
using System.ServiceModel;
using WCFDemo.Services;
using WCFDemo.Contracts;
namespace WCFDemo.Host.WithoutConfig
{
public partial class HostForm : Form
{
public HostForm()
{
InitializeComponent();
}
ServiceHost host;
private void button1_Click(object sender, EventArgs e)
{
host = new ServiceHost(typeof(DemoService));
host.AddServiceEndpoint(typeof(IDemoService), new BasicHttpBinding(), "http://localhost:5678/DemoService");
host.Opened += delegate { label1.Text = "服务启动"; };
host.Open();
}
private void button2_Click(object sender, EventArgs e)
{
if (host != null && host.State == CommunicationState.Opened)
{
host.Closed += delegate { label1.Text = "服务停止"; };
host.Close();
}
}
}
}
第四步:客户端
1、添加一个Windows窗体应用程序WCFDemo.Client.WithoutConfig。
2、添加引用System.ServiceModel。
3、引用之前契约项目。
4、在窗体放置一个Button和一个DataGridView,并编写代码如下:
using System;
using System.Windows.Forms;
using System.ServiceModel;
using WCFDemo.Contracts;
namespace WCFDemo.Client.WithoutConfig
{
public partial class ClientForm : Form
{
public ClientForm()
{
InitializeComponent();
}
private void button1_Click(object sender, EventArgs e)
{
using (ChannelFactory<IDemoService> f = new ChannelFactory<IDemoService>(new BasicHttpBinding(), "http://localhost:5678/DemoService"))
{
dataGridView1.DataSource = f.CreateChannel().GetMonitorData();
}
}
}
}
到这里,已经完成了一个最简单的WCF程序,也涉及到了WCF的基本概念:终结点、ABC(地址、绑定、契约)……。
这个示例很简单(甚至简陋,而且编码风格和习惯也不好☺),只是用来初识WCF,要做的还有很多,下次继续……