WCF中修改接口或方法名称而不影响客户端程序

本篇接着"从Web Service和Remoting Service引出WCF服务"中有关WCF的部分。

运行宿主应用程序。

运行Web客户端中的网页。

输入内容，点击按钮，能获取到WCF所提供的服务。

现在，WCF的接口如下：

namespace HelloWcf
{
    // 注意: 使用“重构”菜单上的“重命名”命令，可以同时更改代码和配置文件中的接口名“IFirstWcf”。
    [ServiceContract]
    public interface IFirstWcf
    {
        [OperationContract]
        string GetMessage(string name);
    }
}

修改接口的名称。

namespace HelloWcf
{
    // 注意: 使用“重构”菜单上的“重命名”命令，可以同时更改代码和配置文件中的接口名“IFirstWcf”。
    [ServiceContract]
    public interface IFirstWcfChanged
    {
        [OperationContract]
        string GetMessage(string name);
    }
}

接着修改WCF接口实现类。

namespace HelloWcf
{
    // 注意: 使用“重构”菜单上的“重命名”命令，可以同时更改代码和配置文件中的类名“FirstWcf”。
    public class FirstWcf : IFirstWcfChanged
    {
        public string GetMessage(string name)
        {
            return "Hello " + name;
        }
    }
}

重新生成WCF所在的类库。

再修改宿主应用程序的配置文件，主要修改endpoint节点中的contract属性值。

......
<endpoint address="HelloWcf" binding="basicHttpBinding" contract="HelloWcf.IFirstWcfChanged"></endpoint>
<endpoint address="HelloWcf" binding="netTcpBinding" contract="HelloWcf.IFirstWcfChanged"></endpoint>
......

重新运行宿主程序。

重新运行Web客户端，输入内容，点击按钮，程序报错：

如果每次更改WCF服务，按照目前的情况，会影响到客户端的使用。为此，在WCF的ServiceContract中为我们准备了Name属性，通过此属性可以避免如上问题的发生。

回到WCF接口，修改如下：

namespace HelloWcf
{
    // 注意: 使用“重构”菜单上的“重命名”命令，可以同时更改代码和配置文件中的接口名“IFirstWcf”。
    [ServiceContract(Name = "IFirstWcf")]
    public interface IFirstWcfChanged
    {
        [OperationContract]
        string GetMessage(string name);
    }
}

重新生成WCF所在类库。

再次运行宿主应用程序。

再次运行Web客户端，输入内容，点击按钮。

为什么为ServiceContract增加了Name属性，就不会影响客户端呢？

 

打开WCF所在的基地址base address。

点击页面中"http://localhost:9090/?wsdl"这个链接。

打开的页面列举了WCF服务的元数据，从中，发现了wsdl:portType节点的name属性值是IFirstWcf。

也就是说，当我们在WCF接口中，通过ServiceContract的Name属性显式设定了值，实际上是设定了WCF元数据中wsdl:portType节点的name属性值。

总结：当我们希望WCF的接口名、方法名的修改不影响到客户端的使用，就可以通过Name属性显式为接口名、方法名规定一个名称。