张靖

导航

WCF宿主-IIS

导语:

  前一段时间开始学习WCF,尽管MSDN和网上的资料很多,但是由于刚开始接触WCF且学习资料不够详尽,所以弄的一头雾水,不知其中所表达的思想,经过这段时间的学习,终于搞明白了WCF常用的宿主。现在把学习到的知识记录下来,供以后参考,也希望能为WCF初学者带来一些帮助。

步骤:

一、定义消息

  消息的语义是指:服务中使用的数据对象。

  创建类库项目WCFMessage:开始-程序-Microsoft Visual Studio 2010-Microsoft Visual Studio 2010-文件-新建-项目-VisualC#-Windows-类库,解决方案名称:WCFHost,名称:WCFMessage。

  引入新的类库:System.Runtime.Serialization.dll

  创建类Person:删除项目自动生成的Class1.cs,新建一个Person类,代码如下:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Runtime.Serialization;

namespace WCFMessage
{
    [DataContract]
    public class Person
    {
        [DataMember]
        public string Id;
        [DataMember]
        public string Name;
        [DataMember]
        public int Age;
    }
}
二、定义服务协定

  服务协定的语义是指:定义服务的接口。

  创建类库项目WCFContract:右键解决方案'WCFHost'-添加-新建项目-VisualC#-Windows-类库,解决方案名称:WCFHost,名称:WCFContract。

  引入新的类库:System.ServiceModel.dll

  引入项目:WCFMessage

  创建类Person:删除项目自动生成的Class1.cs,新建一个IPersonService接口,代码如下:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.ServiceModel;
using WCFMessage;

namespace WCFContract
{
    [ServiceContract]
    public interface IPersonService
    {
        [OperationContract]
        void AddPerson(Person person);
        [OperationContract]
        List<Person> GetPersons();
        [OperationContract]
        void RemovePerson(Person person);
    }
}
三、实现服务协定

  创建类库项目WCFService:右键解决方案'WCFHost'-添加-新建项目-VisualC#-Windows-类库,解决方案名称:WCFHost,名称:WCFService。

  引入项目:WCFMessage和WCFContract

  创建类PersonService:删除项目自动生成的Class1.cs,新建一个继承IPersonService接口的类PersonService,代码如下:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using WCFMessage;
using WCFContract;

namespace WCFService
{
    public class PersonService:IPersonService
    {
        List<Person> list = new List<Person>();
        public void AddPerson(Person person)
        {
            list.Add(person);
        }

        public List<Person> GetPersons()
        {
            return list;
        }

        public void RemovePerson(Person person)
        {
            list.Remove(list.Find(p => p.Id == person.Id));
        }
    }
}
四、使用IIS承载服务

  创建WCF服务IISHost:右键解决方案'WCFHost'-添加-新建网站-VisualC#-WCF服务,解决方案名称:WCFHost,名称:IISHost。

  引入项目:WCFMessage,WCFContract,WCFService。

  删除AppCode目录下自动生成的IService.cs接口和Service1.cs

      修改Service.svc文件,修改后的内容如下:

<%@ ServiceHost Language="C#" Debug="true" Service="WCFService.PersonService"%>
  修改Web.config配置文件,这一步很关键,这是导致错误的主要原因所在地,修改后的内容如下:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.web>
    <compilation debug="false" targetFramework="4.0" />
  </system.web>
  <system.serviceModel>
    <behaviors>
      <serviceBehaviors>
        <behavior>
          <!-- 为避免泄漏元数据信息,请在部署前将以下值设置为 false 并删除上面的元数据终结点 -->
          <serviceMetadata httpGetEnabled="true"/>
          <!-- 要接收故障异常详细信息以进行调试,请将以下值设置为 true。在部署前设置为 false 以避免泄漏异常信息-->
          <serviceDebug includeExceptionDetailInFaults="false"/>
        </behavior>
      </serviceBehaviors>
    </behaviors>
    <services>
      <!-- This section is optional with the default configuration
        model introduced in .NET Framework 4 -->
      <service  name="WCFService.PersonService">
    <endpoint address=""
                  binding="wsHttpBinding"
                  contract="WCFContract.IPersonService" />
      </service>
    </services>
    <serviceHostingEnvironment multipleSiteBindingsEnabled="true" />
  </system.serviceModel>
  <system.webServer>
    <modules runAllManagedModulesForAllRequests="true"/>
  </system.webServer>
  </configuration>  发布服务:右键IISHost-发布网站,按照向导把服务发布到你指定的目录下。

  发布目录的文件夹权限设置:一要Web共享,二要给ASP.NET用户(IUSER)足够的权限。

    在IIS上为发布的服务建立虚拟目录:开始-运行-inetmgr-Internet信息服务-XXX(本地计算机)-网站-默认网站,右键-新建-虚拟目录,按照向导完成。其中,别名:IISHost,目录:发布服务的目录,访问权限:除过写入,都勾选。

  测试:在虚拟目录下,浏览Service.svc,如果出现类似如下的页面显示,则表示成功。

PersonService 服务


已创建服务。

若要测试此服务,需要创建一个客户端,并将其用于调用该服务。可以使用下列语法,从命令行中使用 svcutil.exe 工具来进行此操作:

 

svcutil.exe http://localhost/IISHost/Service.svc?wsdl

这将生成一个配置文件和一个包含客户端类的代码文件。请将这两个文件添加到客户端应用程序,并使用生成的客户端类来调用服务。例如:


C#

class Test
{
    static void Main()
    {
        PersonServiceClient client = new PersonServiceClient();

        // 使用 "client" 变量在服务上调用操作。

        // 始终关闭客户端。
        client.Close();
    }
}

 

Visual Basic

Class Test
    Shared Sub Main()
        Dim client As PersonServiceClient = New PersonServiceClient()
        ' 使用 "client" 变量在服务上调用操作。

        ' 始终关闭客户端。
        client.Close()
    End Sub
End Class

有关安装IIS和运行WCF服务的更多信息,请参考http://msdn.microsoft.com/zh-cn/library/ms751518.aspxhttp://msdn.microsoft.com/zh-cn/library/ms752252.aspx

五、测试服务

  生成客户端代理文件:开始-程序-Microsoft Visual Studio 2010-Visual Studio Tools-Visual Studio 命令提示(2010),输入cd /d E:\outputFiles,再输入svcutil.exe http://localhost/IISHost/Service.svc?wsdl,则会生成两个文件PersonService.cs和output.config。

  建立客户端应用程序:新建一个控制台应用程序(或着Windows窗体应用程序,或者WPF应用程序),这里以控制台应用程序为例,添加刚才生成的两个客户端代理文件PersonService.cs和output.config。

  引用新的类库System.Runtime.Serialization.dll和System.ServiceModel.dll

     编辑Program.cs,如下:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using WCFMessage;

namespace ConsoleApplicationClient
{
    class Program
    {
        static void Main(string[] args)
        {
            PersonServiceClient client = new PersonServiceClient();
            Person person = new Person();
            person.Id = "610623195604230123";
            person.Name = "张三";
            person.Age = 54;
            client.AddPerson(person);
            Person[] list = client.GetPersons();
            Console.WriteLine("Person information Id:{0},Name:{1},Age:{2}",list[0].Id,list[0].Name,list[0].Age);
            client.RemovePerson(person);
            client.Close();
        }
    }
}到此为止,应该OK了。如果有什么疑问或好的建议请加QQ441046957,或者给我发邮件zhangjing13041@126.com

posted on 2010-12-13 11:29  张靖  阅读(1500)  评论(1编辑  收藏  举报