在这个例子中我们将使用VS 2010 U 创建一个WCF服务,其中会了解
[DataContract] [ServiceContract] 等特性。
内置的 WCFSVCHost ,并使用“WCF测试客户端”来测试我们创建的服务。
注意下面的所有类、接口及方法都添加了public 的访问级别。
一,建立一个WCF服务库
创建一个WCF服务库项目,
在解决方案中会自动为我们生成两个类文件“IService.cs”和“Service.cs”。
这两个类文件是两个WCF示例文件,对我们开发没有什么用处,现在我们删掉这两个文件。
在弹出的“添加新项”窗口中,选择“类”,并在“名称”文本框中写入项名称“Person.cs”。
Person.cs
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Runtime.Serialization;
namespace WcfServiceLibrary1
{
/
/// <summary>
/// DataContract数y据Y约?定¨,?Person 就í是?传?递Y的?消?息¢中D的?内ú容Y。£好?比è信?中D的?文?字?。£
/// 为a了?保£证¤此?类à在úWCF调÷用?中D能ü够?被?序ò列D化ˉ,?我ò们?在úBook类à上?面?加ó入?[DataContract]标ê签?,?在ú每?个?需è要a序ò列D化ˉ的?成é员±变?量?上?加ó入?[DataMember]标ê签?。£
/// 这a两?个?标ê签?在ú使1用?的?进?候ò需è要a导?入?using System.Runtime.Serialization命ü名?空?间?。£
/// </summary>
[DataContract]
public class Person
{
//数y据Y成é员±
[DataMember]
public string Id;
[DataMember]
public string Name;
[DataMember]
public int Age;
}
}
/// DataContract数据约定,Person 就是传递的消息中的内容。好比信中的文字。
/// 为了保证此类在WCF调用中能够被序列化,我们在Book类上面加入[DataContract]标签,在每个需要序列化的成员变量上加入[DataMember]标签。
/// 这两个标签在使用的进候需要导入using System.Runtime.Serialization命名空间。
由于注释又出现乱码,估计是字符版本的问题,下面是用黑体复制
创建服务接口,声明对外发布的类和方法。
IPersonService.cs
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.ServiceModel;
namespace WcfServiceLibrary1
{
/// <summary>
/// ServiceContract:服务约定,代表我们所能操作的接口集合,提供功能点。
/// 在IPersonService接口上面,我们定义了[ServiceContract]标签,此标签代表此接口及实现此接口的类都是对外发布的Service类,
/// 在每个需要对外发布的方法上都加上[OperationContract]标签,以使外部可以访问到此方法。
/// [ServiceContract]和[OperationContract]这两个标签需要导入using System.ServiceModel命名空间。
/// </summary>
[ServiceContract]
public interface IPersonService
{
/// <summary>
/// OperationContract 操作约定,定义每个操作的接口点方法。
/// </summary>
/// <param name="person">要添加的人员实体</param>
[OperationContract]
void AddPerson(Person person);
[OperationContract]
List<Person> GetAllPersons();
[OperationContract]
void RemovePerson(string id);
}
}
实现我们上面声明的服务接口,实现对Book的添加、删除和检索的具体功能。
PersonService.cs
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.ServiceModel;
namespace WcfServiceLibrary1
{
/// <summary>
/// 此类是对IBookService接口的具体实现,在此类的上面我们声明了[ServiceBehavior(InstanceContextMode=InstanceContextMode.Single)]标签,
/// 此标签代表这个类采用SingleTone(单类模式)来生成对象。
/// 使用[ServiceBehavior(InstanceContextMode=InstanceContextMode.Single)]接口需要导入using System.ServiceModel;命名空间。
/// </summary>
[ServiceBehavior(InstanceContextMode = InstanceContextMode.Single)]
public class PersonService : IPersonService
{
List<Person> _Persons = new List<Person>();
public void AddPerson(Person person)
{
person.Id = Guid.NewGuid().ToString();
_Persons.Add(person);
}
public List<Person> GetAllPersons()
{
return _Persons;
}
public void RemovePerson(string id)
{
//拉姆达语句,谓词 p.Id == id
Person person = _Persons.Find(p => p.Id == id);
_Persons.Remove(person);
}
}
}
Ctrl + Shift + B 编译一下
二,配置服务运行
到目前为至,我们建立好了WCF服务,那我们如何让WCFSVCHost(WCF服务主机)理解我们编写的服务类,并能够运行我们编写的服务呢。这需要我们在App.Config里面注册一下我们的WCF服务。
VS为我们提供了可视化的操作界面。
在Services项目中右击“App.Config”配置文件,在弹出的右键菜单中选择“编辑WCF配置”。
打开之后如下图
在此界面中暴露两个对外的终结点(外部可以访问到的类或接口),其中下面一个是元数据终结点,用来向外提供服务信息的终结点。
而另一个(即上面的终结点),是向外公布我们编写的[ServiceContract]的类,但我们可以看到它的Contract还是我们在第一步中删掉的WcfServiceLibrary1.IService1这个终结点。
不仅如此,在右侧上面的黑字的服务中还依旧是我们在第一步中删除的WcfServiceLibrary1.Service1服务。这说明虽然在第一步中我们删除了那两个自动生成的类文件,但配置文件中仍没有删除这两个类文件的配置信息。
下面我们把它们改变一下。
单击左侧的“服务”-“WcfServiceLibrary1.Service1”在右侧的Name,弹出“服务类型浏览器”对话框,在此类型中我们找到此WCF服务项目编译出来的WcfServiceLibrary1.dll文件,双击它就可以出现此服务中的对外公布的服务,点击选中它单击确定。
这样我们就可以把对外公司的服务改变为我们刚编写的服务了。
然后,我们展开左侧“服务”->“WcfServiceLibrary1.PersonService”->“终结点”,单击第一个“空名称”,从右边的“终结点属性”中的Contract中我们可以看到,这里的Contract仍然用的是WcfServiceLibrary1.IService1。
我们按照上面的做法,找到此WCF服务项目编译出来的WcfServiceLibrary1.dll,双击它找到里面对应的ServiceContract点击确定就可以了。
在高级目录树中,为服务行为配置命名,名字你自己决定。
在服务中选中,刚才的行为配置。
重点一定要记着保存,点击菜单“文件”-“保存”就可以把我们对App.Config的修改保存回配置文件了。
App.Config
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<system.web>
<compilation debug="true" />
</system.web>
<system.serviceModel>
<services>
<service behaviorConfiguration="Services.ServiceBehavior" name="WcfServiceLibrary1.PersonService">
<endpoint address="" binding="wsHttpBinding" contract="WcfServiceLibrary1.IPersonService">
<identity>
<dns value="localhost" />
</identity>
</endpoint>
<endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange" />
<host>
<baseAddresses>
<add baseAddress="http://localhost:8732/Design_Time_Addresses/WcfServiceLibrary1/IPersonService/" />
</baseAddresses>
</host>
</service>
</services>
<behaviors>
<serviceBehaviors>
<behavior name="Services.ServiceBehavior">
<serviceMetadata httpGetEnabled="true" />
<serviceDebug includeExceptionDetailInFaults="false" />
</behavior>
</serviceBehaviors>
</behaviors>
</system.serviceModel>
</configuration>
三,测试WCF
在Visual Studio 中为我们提供了测试WCF的工具,按F5启动WCF会出现两个东西
一个是在右下角的托盘图标中会出现WCFSVCHost(WCF服务主机),它为我们在开发时候提供了一个运行WCF的服务器,用来为测试客户端提供WCF服务。
另一个是“WCF测试客户端”
“测试客户端”从WcfSVCHost中取得WCF服务的元数据,解析为左侧的“服务结构树”,从这里面我们可以看到此WCF服务为我们提供了一个服务契约“IPersonService”,此服务契约中对外提供了三个可调用的方法。
点击AddPerson() 方法 输入参数 点击 Invoke 调用
点击GetAllPersons() ,在Response 中我们看到了返回的结果。
源代码下载:WcfServiceLibrary1.rar
分享到:
相关推荐
Microsoft Visual Studio 2010 Service Pack 1(SP1)是一个重要的更新,它针对2010版本的Visual Studio进行了一系列改进和优化,以解决用户在实际使用过程中遇到的问题,并提升其性能和兼容性。尤其是在SQL Server ...
- **报表、WCF、WF、客户端应用程序服务、同步服务、WCF RIA服务、配置文件、连接字符串和资源文件**:了解Visual Studio 2010中这些服务和工具的使用。 - **调试技术**:从基本的调试窗口使用到高级调试技术,掌握...
WCF是Microsoft推出的一个统一的编程模型,用于创建服务导向和分布式应用程序。它简化了不同通信协议和消息格式之间的差异,允许开发者使用一致的API来构建安全、可靠的连接服务。在Visual Studio 2008中,WCF提供了...
Visual Studio 2010 Service Pack 1(简称SP1)是一个重要的更新,它针对Microsoft的旗舰开发工具Visual Studio 2010进行了多项改进和修复。这个在线升级包的出现,旨在解决用户在使用原版VS2010时遇到的各种问题,...
在Visual Studio 2008中,可以使用内置的“WCFSVCHost”工具来启动服务,然后利用“WCF测试客户端”进行服务功能的验证。通过这种方式,可以确保服务按预期工作,并且能够正确处理各种请求。 #### 三、总结 通过...
1. **新建项目**:在Visual Studio中,选择“新建项目”,然后在模板中找到“WCF库项目”创建服务。 2. **定义服务契约**:创建一个接口,比如`IService1`,并添加一个方法,如`SayHello()`,然后用`...
学完本书源码之后,会对C#有一个全面、透彻的理解,并能用它来构建Windows Presentation Foundation(WPF)应用程序,访问Microsoft SQL Server 数据库,开发ASP.NET Web 应用程序以及创建和使用Windows ...
Microsoft Visual Studio 2010 Professional(简称VS2010)是微软公司推出的一款强大的集成开发环境(IDE),专为专业软件开发者设计,提供了全面的工具和服务,支持多种编程语言,包括C#、VB.NET、C++、Python、...
【标题】"我的第一个完整的WCF实例"是一个展示如何在Visual Studio 2010环境下创建和运行一个功能完备的Windows Communication Foundation (WCF)服务的教程。这个实例不同于网络上常见的简略示例,它提供了更为详尽...
1. **使用WCF测试客户端**:Visual Studio自带的工具,可以快速测试服务操作。 2. **日志记录**:启用WCF的日志功能,跟踪服务的运行情况和潜在问题。 3. **性能监控**:使用性能计数器检查服务性能,识别瓶颈。 **...
根据所提供的文件信息,可以看出这是一本关于Visual Studio 2012的教材《Professional Visual Studio 2012》,涵盖了从基础使用到高级开发技巧的广泛内容。下面将对各部分内容进行知识点的详细解读: ### 部分内容...
6. **Entity Framework 4.0**:数据库访问技术的重大升级,引入了模型第一和数据库第一的设计模式,支持Poco(Plain Old CLR Objects)实体,以及改进的Code First开发体验。 7. **Visual Studio 2010**:作为.NET ...
Visual Studio 是一个功能强大的集成开发环境(IDE),而 MySQL 是一个流行的关系数据库管理系统。本文档旨在介绍如何在 Visual Studio 中连接 MySQL 数据库,涵盖了 MySQL 的安装、配置、ODBC 数据源配置等方面的...
1. 首先,你需要创建一个新的WCF服务项目,在Visual Studio中选择"新建项目" -> "WCF库"模板。 2. 在服务接口(IService1.cs)中定义服务操作契约(OperationContract)。 3. 实现服务接口(Service1.svc.cs),编写...