首页 > 代码库 > 年前辞职-WCF入门学习(3)

年前辞职-WCF入门学习(3)

前言

[2了,刚写好的,手贱,点了删除,还真TMD的删除了,只好重写]

今天周六,去同事家聚了一个餐,感觉各种豪华。

废话不多说,前两集大致介绍了一下什么是WCF以及和WCF相关的WebService和.net Remoting的一些东西,今天主角要上场,开始WCF的实现相关的东西。

第三集 Create a WCF Service

挂了vpn来看youtube的视频,感觉还是慢,算了,干脆下载了看。

这一集主要有以下四个点

  • 创建一个WCF服务
  • 用一个控制台程序来托管这个服务
  • 提供两个Endpoint
  • 创建一个windows 和一个 Web客户端程序

 

先上一张上一集的图,

技术分享

从图中可以看到,为了给java 和.net 两个客户端提供他们需要的服务,我们需要实现两个东西,一个是WebService   一个是 .net Remoting ,虽然他们的功能是一样的。

接下去是WCF的实现方式:

技术分享

从图中可以知道,我们只需要写一个服务,然后配置两个Endpoint即可满足需求。

Let ‘s do IT。

首先,创建一个解决方案,添加一个新类库,取名HelloService

技术分享

然后,删除vs 自动生成的Class1.cs 再添加一个WCF服务 新项(右上角可以搜索)取名HelloService。

技术分享

确定之后我们看一下项目目录结构。

技术分享

首先是引用这块。vs 自动添加了对System.ServiceModel 命名空间的引用,这个是WCF的核心命名空间。

然后是vs生成了2个文件,一个HelloService  一个 IHelloService。

让我们来看一下这两个文件。

首先是IHelloService文件

    [ServiceContract]    public interface IHelloService    {        [OperationContract]        void DoWork();    }

看名字就知道这是一个接口,接口所具有的ServiceContract 特性来自于ServiceModel 命名空间,接口里面包含一个方法定义,DoWork(),方法有一个OperationContract特性也是来自ServiceModel 。

接下去是HelloService文件

    public class HelloService : IHelloService    {        public void DoWork()        {        }    }

只是简单的实现了IHelloService 接口。

现在,我们对两个文件做些修改,来实现我们自己的服务。

把IHelloService 改成如下:

    [ServiceContract]    public interface IHelloService    {        [OperationContract]        string GetMessage(string name);    }

即删除了原先的DoWork方法,改成一个返回String类型的GetMessage方法,传入一个name参数。

相应的,HelloService也要变。

    public class HelloService : IHelloService    {        public string GetMessage(string name)        {            return "Hello " + name;        }    }

我们实现了里面的GetMessage方法,让他返回我们需要字符串。

至此,创建工作就已完成,接下去就是在控制台程序中托管这个服务。需要说明一点,WCF的托管对象可以是Winform,Console ,或者IIS,或者windows 服务以及其他。为了简化问题,这里选中托管到Console中。

首先,在当前解决方案中新添加一个控制台项目,取名HelloServiceHost

技术分享

点击确定,

然后,要对这个Host添加两个引用,一个上面的System.ServiceModel,另一个是上面的WCF项目。

技术分享 技术分享

然后会得到如下的引用目录。

技术分享

为了托管这个WCF服务,我们需要给项目添加一个配置文件,用于托管这个WCF服务。

右键Host项目,选择添加新项,应用程序配置文件,名字就是默认的App.config

技术分享

重头戏来了,写这个配置文件,然他可以给两个不同的客户端提供服务。

完整版如下:

<?xml version="1.0" encoding="utf-8" ?><configuration>  <system.serviceModel>    <services>      <service name="HelloService.HelloService" behaviorConfiguration="mexBehavior">        <endpoint address="HelloService" binding="basicHttpBinding" contract="HelloService.IHelloService"></endpoint>        <endpoint address="HelloService" binding="netTcpBinding" contract="HelloService.IHelloService"></endpoint>        <endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange"></endpoint>        <host>          <baseAddresses>            <add baseAddress="http://localhost:8080"/>            <add baseAddress="net.tcp://localhost:8090"/>          </baseAddresses>        </host>      </service>    </services>        <behaviors>      <serviceBehaviors>        <behavior name="mexBehavior">          <serviceMetadata httpGetEnabled="true"/>        </behavior>      </serviceBehaviors>    </behaviors>      </system.serviceModel></configuration>

解释一下,首先是这个endpoint,他有3个参数,很好记,缩写ABC。

  • Address 地址,用来指定服务的位置。注意,如果没有特殊描述,那么就是一个相对地址,实际的地址由下面的baseAddress+address构成。
  • Binding 绑定,给出了协议和编码信息,详细的编码列表如下。技术分享 如图在serviceModel节点下面输入一个bindings元素,然后输入一个小于号,就可以看到所有的列表。我们前期如果不熟悉用什么,可以用这种方式来复制粘贴到endpoint里面
  • Contract 协议,定义了服务提供的操作。具体的内容就是我们定义的IHelloService WCF服务所在位置,即他的命名空间HelloService + 名字 IHelloService = HelloService.IHelloService。

endpoint根据需要,我们只要定义2个,但是,一般来说,我们会再定义一个用于元数据交换的mex 端点,关于什么这个端点的作用,如果你写过WebService,知道WSDL,那就很好理解了,他就是WCF中的WSDL,用来描述服务的操作很消息。

上面说了,我们用的endpoint里面的地址是相对地址,所以要定义一个baseAddresses,在host元素里面,里面两个baseAddress,一个http协议的地址,一个tcp协议的地址。

接着是behaviors节点,里面定义了serviceMetadata是否允许httpGet

配置文件方面介绍完毕,下面要在控制台中托管这个服务。

打开program.cs ,

因为原先已经引用过system.ServiceModel 命名空间,所以编写如下代码:

        static void Main(string[] args)        {            using(var host = new ServiceHost(typeof(HelloService.HelloService))) {                host.Open();                Console.WriteLine("Host 在" + DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss") + "启动");                Console.ReadLine();//防止控制台程序自动关闭            }        }
然后运行该Host,得到如下界面。
技术分享 

可知,host已经启动生效。

自己在写的时候碰到个问题,

如果vs不是以管理员方式运行,会得到下面这个异常提示:

技术分享

提示无权访问这个命名空间。所以,只要重启vs,并且以管理员方式运行即可。

 

启动了Host之后,接下来就要调用了。

java没有装,所以就用web项目来代替了。

重新打开一个vs,记得以 管理员 方式运行,新建一个网站,简单起见,就用aspx网站。然后给该网站添加服务引用。

技术分享

因为上面已经启动了Host,输入地址http://localhost:8080 点击转到,得到一个服务,然后把命名空间改成HelloService,点击确定,然后我们看一下根目录下的web.config 文件。

    <system.serviceModel>        <bindings>            <basicHttpBinding>                <binding name="BasicHttpBinding_IHelloService" />            </basicHttpBinding>            <netTcpBinding>                <binding name="NetTcpBinding_IHelloService" />            </netTcpBinding>        </bindings>        <client>            <endpoint address="http://localhost:8080/HelloService" binding="basicHttpBinding"                bindingConfiguration="BasicHttpBinding_IHelloService" contract="HelloService.IHelloService"                name="BasicHttpBinding_IHelloService" />            <endpoint address="net.tcp://localhost:8090/HelloService" binding="netTcpBinding"                bindingConfiguration="NetTcpBinding_IHelloService" contract="HelloService.IHelloService"                name="NetTcpBinding_IHelloService">                <identity>                    <userPrincipalName value="此处省略~~" />                </identity>            </endpoint>        </client>    </system.serviceModel>

可以看到,config里面添加了一个serviceModel 节点,内容是我们前面定义的binding 和 endpoint。

右键该网站然后新添一个页面,然后添加一个textbox,一个button,一个label,得到如下:

技术分享 button的Text 改成GetMessage,然后给click添加事件。

内容如下:

        var client = new HelloServiceClient("BasicHttpBinding_IHelloService");        Label1.Text = client.GetMessage(TextBox1.Text);
先构造一个服务的实例,然后调用服务给我们提供的GetMessage方法,运行该网站。

技术分享 输入内容,点击GetMessage,下面的lebel内容就变成了我们服务返回的结果。

Http调用的介绍完毕,视频还举了第二个winform的例子,和webform的基本一样,就不贴出来了。

我也想知道tcp是怎么调用的,但是视频上没说,今天太迟了,有空再google一下吧。

Thankyou!

年前辞职-WCF入门学习(3)