WCF学习

相关链接

http://www.cnblogs.com/iamlilinfeng/p/4083827.html

http://www.cnblogs.com/iamlilinfeng/archive/2012/10/01/2706353.html

1、项目目录

主目录

服务库目录

 

三种宿主目录

两种客户端访问方式

代码见StudyNoteOfCsharp项目。

2、WCF开发步骤

2.1、定义和现实服务协定，在WcfServiceLibrary1服务库项目里

 

namespace WcfServiceLibrary1
{
    // 注意: 使用“重构”菜单上的“重命名”命令，可以同时更改代码和配置文件中的接口名“IService1”。
    [ServiceContract]
    public interface IService1
    {
        [OperationContract]
        int Add(int a, int b);
        [OperationContract]
        int Multiply(int a, int b);
    }

}

namespace WcfServiceLibrary1
{
    // 注意: 使用“重构”菜单上的“重命名”命令，可以同时更改代码和配置文件中的类名“Service1”。
    public class Service1 : IService1
    {
        int IService1.Add(int a, int b)
        {
            return a + b;
        }
        
        int IService1.Multiply(int a, int b)
        {
            return a * b;
        }
    }
}

<?xml version="1.0" encoding="utf-8" ?>
<configuration>

  <appSettings>
    <add key="aspnet:UseTaskFriendlySynchronizationContext" value="true" />
  </appSettings>
  <system.web>
    <compilation debug="true" />
  </system.web>
  <!-- 部署服务库项目时，必须将配置文件的内容添加到 
  主机的 app.config 文件中。System.Configuration 不支持库的配置文件。-->
  <system.serviceModel>
    <services>
      <service name="WcfServiceLibrary1.Service1">
        <host>
          <baseAddresses>
            <add baseAddress = "http://localhost:8733/Design_Time_Addresses/WcfServiceLibrary1/Service1/" />
          </baseAddresses>
        </host>
        <!-- Service Endpoints -->
        <!-- 除非完全限定，否则地址将与上面提供的基址相关 -->
        <endpoint address="" binding="basicHttpBinding" contract="WcfServiceLibrary1.IService1">
          <!-- 
              部署时，应删除或替换下列标识元素，以反映
             用来运行所部署服务的标识。删除之后，WCF 将
              自动推断相应标识。
          -->
          <identity>
            <dns value="localhost"/>
          </identity>
        </endpoint>
        <!-- Metadata Endpoints -->
        <!-- 元数据交换终结点供相应的服务用于向客户端做自我介绍。 --> 
        <!-- 此终结点不使用安全绑定，应在部署前确保其安全或将其删除-->
        <endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange"/>
      </service>
    </services>
    <behaviors>
      <serviceBehaviors>
        <behavior>
          <!-- 为避免泄漏元数据信息，
          请在部署前将以下值设置为 false -->
          <serviceMetadata httpGetEnabled="True" httpsGetEnabled="True"/>
          <!-- 要接收故障异常详细信息以进行调试，
          请将以下值设置为 true。在部署前设置为 false 
            以避免泄漏异常信息-->
          <serviceDebug includeExceptionDetailInFaults="False" />
        </behavior>
      </serviceBehaviors>
    </behaviors>
  </system.serviceModel>

</configuration>

此项目里调用wcf服务没有用到上面app.config里的配置，所以用处不大

2.2、将wcf服务寄宿到winform程序、console控制台程序、或是web程序里

       寄宿到winform程序里

       winform项目app.config

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <startup> 
        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />
    </startup>
  <!--下面是加上去的-->
  <system.serviceModel>
    <services>
      <service name="WcfServiceLibrary1.Service1">
        <host>
          <baseAddresses>
            <add baseAddress="http://localhost:8081/Service1"/>
          </baseAddresses>
        </host>
        <endpoint address="" binding="wsHttpBinding" contract="WcfServiceLibrary1.IService1"></endpoint>
      </service>
    </services>
    <behaviors>
      <serviceBehaviors>
        <behavior>
          <serviceMetadata httpGetEnabled="True"/>
          <serviceDebug includeExceptionDetailInFaults="False"/>
        </behavior>
      </serviceBehaviors>
    </behaviors>
  </system.serviceModel>
</configuration>

winform界面

代码如下

namespace WcfServiceWinformHost
{
    public partial class Form1 : Form
    {
        //host的地址和service在app.config里设置了
        ServiceHost host = new ServiceHost(typeof(WcfServiceLibrary1.Service1));
        public Form1()
        {
            InitializeComponent();
            
        }

        private void button1_Click(object sender, EventArgs e)
        {
            this.Text = "wcf服务监听已经开启";            
            host.Open();

        }

        private void button2_Click(object sender, EventArgs e)
        {
            host.Close();
            this.Text = "wcf服务监听已经停止";
        }
    }
}

但“开始监听”时，在浏览器里输入http://localhost:8081/Service1会看到wcf服务已经启动，客户端程序引用http://localhost:8081/Service1地址的服务就可以。

  寄宿到console控制台

app.config配置如下，但配置是无效的，在Program.cs程序里没有用app.config里的配置

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <startup> 
        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />
    </startup>
    <system.serviceModel>
        <bindings>
            <wsHttpBinding>
                <binding name="WSHttpBinding_IService1" />
            </wsHttpBinding>
        </bindings>
        <client>
            <endpoint address="http://localhost:8081/Service1" binding="wsHttpBinding"
                bindingConfiguration="WSHttpBinding_IService1" contract="ServiceWinformReference1.IService1"
                name="WSHttpBinding_IService1">
                <identity>
                    <userPrincipalName value="SHENGYUAdministrator" />
                </identity>
            </endpoint>
        </client>
    </system.serviceModel>
</configuration>

 主程序代码如下：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.ServiceModel;
using System.ServiceModel.Description;
using WcfServiceLibrary1;

namespace ConsoleApplication1
{
    class Program
    {
        static void Main(string[] args)
        {
            // Step 1 Create a URI to serve as the base address.
            Uri baseAddress = new Uri("http://localhost:8733/WcfServiceLibrary1/Service1/");

            // Step 2 Create a ServiceHost instance
            ServiceHost selfHost = new ServiceHost(typeof(Service1), baseAddress);

            try
            {
                // Step 3 Add a service endpoint.
                selfHost.AddServiceEndpoint(typeof(IService1), new WSHttpBinding(), "Service1");

                // Step 4 Enable metadata exchange.
                ServiceMetadataBehavior smb = new ServiceMetadataBehavior();
                smb.HttpGetEnabled = true;
                selfHost.Description.Behaviors.Add(smb);

                // Step 5 Start the service.
                selfHost.Open();
                Console.WriteLine("The service is ready.");
                Console.WriteLine("Press <ENTER> to terminate service.");
                Console.WriteLine();
                Console.ReadLine();

                // Close the ServiceHostBase to shutdown the service.
                selfHost.Close();
            }
            catch (CommunicationException ce)
            {
                Console.WriteLine("An exception occurred: {0}", ce.Message);
                selfHost.Abort();
            }


        }
    }
}

可以看到，宿主程序将wcf服务发布到了http://localhost:8733/WcfServiceLibrary1/Service1/而不是app.config里的http://localhost:8081/Service1，客户端程序要引用 http://localhost:8733/WcfServiceLibrary1/Service1/就能访问服务

 寄宿到web网站上，wcf将寄宿到iis上

此时服务可以写在wcf服务应用程序里

 web.config配置如下

<?xml version="1.0" encoding="utf-8"?>
<configuration>

  <appSettings>
    <add key="aspnet:UseTaskFriendlySynchronizationContext" value="true" />
  </appSettings>
  <system.web>
    <compilation debug="true" targetFramework="4.5" />
    <httpRuntime targetFramework="4.5"/>
  </system.web>
  <system.serviceModel>
    <behaviors>
      <serviceBehaviors>
        <behavior>
          <!-- 为避免泄漏元数据信息，请在部署前将以下值设置为 false -->
          <serviceMetadata httpGetEnabled="true" httpsGetEnabled="true"/>
          <!-- 要接收故障异常详细信息以进行调试，请将以下值设置为 true。在部署前设置为 false 以避免泄漏异常信息 -->
          <serviceDebug includeExceptionDetailInFaults="false"/>
        </behavior>
      </serviceBehaviors>
    </behaviors>
    <protocolMapping>
        <add binding="basicHttpsBinding" scheme="https" />
    </protocolMapping>    
    <serviceHostingEnvironment aspNetCompatibilityEnabled="true" multipleSiteBindingsEnabled="true" />
  </system.serviceModel>
  <system.webServer>
    <modules runAllManagedModulesForAllRequests="true"/>
    <!--
        若要在调试过程中浏览 Web 应用程序根目录，请将下面的值设置为 True。
        在部署之前将该值设置为 False 可避免泄露 Web 应用程序文件夹信息。
      -->
    <directoryBrowse enabled="true"/>
  </system.webServer>

</configuration>

定义和现实服务协定

namespace WcfServiceWebHost
{
    // 注意: 使用“重构”菜单上的“重命名”命令，可以同时更改代码和配置文件中的接口名“IService1”。
    [ServiceContract]
    public interface IService1
    {

        [OperationContract]
        int Subtract(int a, int b);
    }    
}

namespace WcfServiceWebHost
{
    // 注意: 使用“重构”菜单上的“重命名”命令，可以同时更改代码、svc 和配置文件中的类名“Service1”。
    // 注意: 为了启动 WCF 测试客户端以测试此服务，请在解决方案资源管理器中选择 Service1.svc 或 Service1.svc.cs，然后开始调试。
    public class Service1 : IService1
    {
        public int Subtract(int a, int b)
        {
            return a - b;
        }
    }
}

web运行后的地址为：http://localhost:7234/Service1.svc，在客户端调用时只要引用此地址上的服务就可

3、客户端调用

     console控制台客户端调用console控制台服务宿主程序里的wcf服务

   在console控制台客户端引用服务，服务地址是http://localhost:8733/WcfServiceLibrary1/Service1/

   console控制台客户端程序代码如下：

namespace WcfServiceConsoleClient
{
    class Program
    {
        static void Main(string[] args)
        {   
           ServiceWcfServiceConsoleHostReference1.Service1Client client = new ServiceWcfServiceConsoleHostReference1.Service1Client();
           do
           {
               var a = int.Parse(Console.ReadLine());
               var b = int.Parse(Console.ReadLine());
               var result = client.Multiply(a, b);
               Console.WriteLine("Multiply({0},{1}) = {2}", a, b, result);
           } while (Console.ReadLine() != "exit");
          client.Close();
        }
    }
}

运行console控制台宿主程序WcfServiceConsoleHost.exe

运行console控制台客户端程序WcfServiceConsoleClient.exe

     console控制台客户端调用winform服务宿主程序里的wcf服务

   在console控制台客户端引用服务，服务地址是http://localhost:8081/Service1，即winform宿主程序app.config里配置的地址（其实地址也可以像上面console控制台宿主上样写在程序里而不写在app.config里）

console控制台客户端代码如下：

namespace WcfServiceConsoleClient
{
    class Program
    {
        static void Main(string[] args)
        {
            ServiceWcfServiceWinformHostReference1.Service1Client client = new ServiceWcfServiceWinformHostReference1.Service1Client();
           do
           {
               var a = int.Parse(Console.ReadLine());
               var b = int.Parse(Console.ReadLine());
               var result = client.Add(a, b);
               Console.WriteLine("Add({0},{1}) = {2}", a, b, result);
           } while (Console.ReadLine() != "exit");
          client.Close();
        }
    }
}

运行winform宿主程序，启动服务

运行console控制台客户端程序WcfServiceConsoleClient.exe

     console控制台客户端调用web服务宿主程序里的wcf服务

在console控制台上引用web服务宿主端http://localhost:7234/Service1.svc的服务

确保web端开启

console控制台客户端代码如下：

namespace WcfServiceConsoleClient
{
    class Program
    {
        static void Main(string[] args)
        {
            ServiceWcfServiceWebHostReference1.Service1Client client = new ServiceWcfServiceWebHostReference1.Service1Client();
           do
           {
               var a = int.Parse(Console.ReadLine());
               var b = int.Parse(Console.ReadLine());
               var result = client.Subtract(a, b);
               Console.WriteLine("Subtract({0},{1}) = {2}", a, b, result);
           } while (Console.ReadLine() != "exit");
          client.Close();
        }
    }
}

运行console控制台客户端程序WcfServiceConsoleClient.exe

winform客户端调用winform服务端的wcf服务

winform客户端代码和界面如下

namespace WcfServiceWinformClient
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        private void button1_Click(object sender, EventArgs e)
        {
            //ServiceWinformHostReference1引用的是WcfServiceWinformHost项目里app.config里baseAddress的地址
            ServiceWinformHostReference1.Service1Client client = new ServiceWinformHostReference1.Service1Client();
            textBox3.Text=client.Add(int.Parse(textBox1.Text), int.Parse(textBox2.Text)).ToString();
        }

        private void button2_Click(object sender, EventArgs e)
        {
            ServiceWinformHostReference1.Service1Client client = new ServiceWinformHostReference1.Service1Client();
            textBox3.Text = client.Multiply(int.Parse(textBox1.Text), int.Parse(textBox2.Text)).ToString();
        }
    }
}

运行客户端，调用wcf的加法和乘法方法界面如下

总结：wcf步骤为

1、写服务接口和实现服务

2、写宿主程序，可以是console控制台、winform、web等等应用程序，并调用服务类，配置好wcf，可以用app.config或是web.config来配置，也可以写在程序里，记录好配置后的服务url地址

3、启用宿主程序，在浏览器上确保服务url地址能访问

4、写客户端程序，程序引用宿主的服务url地址，调用服务里的方法

宿主程序在配置wcf时，可能用以下的代码方式

            Uri baseAddress = new Uri("http://localhost:8733/WcfServiceLibrary1/Service1/");

            // Step 2 Create a ServiceHost instance
            ServiceHost selfHost = new ServiceHost(typeof(Service1), baseAddress);

 baseAddress用来设置服务的地址，ServiceHost类将地址和服务类关联起来

也可以用config配置文件来配置

<system.serviceModel>
    <services>
      <service name="WcfServiceLibrary1.Service1">
        <host>
          <baseAddresses>
            <add baseAddress="http://localhost:8081/Service1"/>
          </baseAddresses>
        </host>
        <endpoint address="" binding="wsHttpBinding" contract="WcfServiceLibrary1.IService1"></endpoint>
      </service>
    </services>
    <behaviors>
      <serviceBehaviors>
        <behavior>
          <serviceMetadata httpGetEnabled="True"/>
          <serviceDebug includeExceptionDetailInFaults="False"/>
        </behavior>
      </serviceBehaviors>
    </behaviors>
  </system.serviceModel>

然后在程序里直接调用：

//host的地址和service在app.config里设置了
        ServiceHost host = new ServiceHost(typeof(WcfServiceLibrary1.Service1));

 认识wcf中的“ABC"，A指address，就是配置文件里baseaddress的地址，说明去哪里访问服务，B指binding，说明能用什么方式去访问，如wsHttpBinding，C指Contract描述了Service能提供的各种服务。Contract有四种，包括Service Contract, Data Contract, Fault Contract和Message Contract