WCF作为.NET Framework3.0就被引入的用于构建面向服务的框架在众多项目中发挥着重大作用。时至今日,虽然已有更新的技术可以替代它,但对于那些既存项目或产品,使用新框架重构的代价未必能找到人愿意买单。
而在.NET Core平台环境中,WCF也并没有被完全列入迁移目标。WCF的服务端被搁置一旁,只有客户端已被移植入.NET Core之中。
这意味着,如果有需求在.NET Core中,尤其是非Windows系统环境,调用现有的WCF服务,也并非一件不可能的事情。
以一个实验来证明,先建一个解决方案工程,再加入两个类库项目及一个控制台应用程序。
WcfService.Contract项目,这是WCF服务的接口,即服务契约。
namespace WcfService.Contract{ [ServiceContract] public interface ICommunication { [OperationContract] string Ping(string msg); } }
WcfService项目,是对服务的实现。
namespace WcfService{ public class Communication : ICommunication { public string Ping(string msg) { return string.Format("Pong: {0}", msg); } } }
WcfService.Host项目,实现对服务的托管。
namespace WcfService.Host{ class Program { static void Main(string[] args) { using (var host = new ServiceHost(typeof(Communication))) { host.AddServiceEndpoint(typeof(ICommunication), new BasicHttpBinding(), new Uri("http://192.168.1.2:6666")); host.Open(); Console.WriteLine("Service is being hosted..."); Console.Read(); } } } }
以上三个项目皆使用.NET framework 4.5.2作为目标框架。
通过运行WcfService.Host应用程序,可以将WCF服务端启动起来。当然此服务端只能运行在Windows系统环境之上。(为了实验,建议将系统的防火墙暂时关闭,以免无法连通)
再找一个非Windows系统的环境,比如我使用的Mac Air。再创建一个控制台应用程序。
dotnet new console -o WcfClientApp
用Visual Studio Code打开工程,建议安装Nuget Package Manager插件,因为这里需要引入System.ServiceModel.Http类库。
使用快捷键Ctrl(Command)+p,输入>nuget,选中Nuget Package Manager: Add Package,输入System.ServiceModel.Http,再选取最新版本的安装选项,对应的类库便会自动下载下来。
除了这个类库之外,还需要使用之前创建的WcfService.Contract的dll文件。将其复制到某个目录下,并在csproj文件指明其具体位置即可。
<Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <OutputType>Exe</OutputType> <TargetFramework>netcoreapp2.1</TargetFramework> </PropertyGroup> <ItemGroup> <PackageReference Include="System.ServiceModel.Http" Version="4.5.3"/> </ItemGroup> <ItemGroup> <Reference Include="WcfService.Contract"> <HintPath>bin\Debug\netcoreapp2.1\WcfService.Contract.dll</HintPath> </Reference> </ItemGroup></Project>
WCF客户端的代码如下:
using System;using System.ServiceModel;using WcfService.Contract;namespace WcfClientApp{ class Program { static void Main(string[] args) { var factory = new ChannelFactory<ICommunication>( new BasicHttpBinding(), new EndpointAddress(new Uri("http://192.168.1.2:6666"))); var channel = factory.CreateChannel(); Console.WriteLine("Ping..."); var result = channel.Ping("Hi"); Console.WriteLine(result); ((ICommunicationObject)channel).Close(); Console.Read(); } } }
将此客户端运行起来,可以看到这个实验成功了。
当然WCF Client在.NET Core上的使用一定是有限制,其仅支持HTTP与TCP两种通信协议,如NamedPipe(命名管道),MSMQ这种Windows平台特有的通信协议,肯定是不被支持的。不过一般最常用的也就是这两种,所以大多数应用场景下也是够用了。
上面提到了WCF服务端不被.NET Core所支持,但如果只是想建一个SOAP的服务,还是有解决方案的。
同样是在macOS系统上,新建一个Web应用程序。
dotnet new web -o SOAPApp
通过Nuget Package Manager安装SoapCore类库,并将WcfService.dll与WcfService.Contract.dll一并引入。
<Project Sdk="Microsoft.NET.Sdk.Web"> <PropertyGroup> <TargetFramework>netcoreapp2.1</TargetFramework> </PropertyGroup> <ItemGroup> <Folder Include="wwwroot\"/> </ItemGroup> <ItemGroup> <PackageReference Include="Microsoft.AspNetCore.App"/> <PackageReference Include="SoapCore" Version="0.9.8.1"/> </ItemGroup> <ItemGroup> <Reference Include="WcfService"> <HintPath>bin\Debug\netcoreapp2.1\WcfService.dll</HintPath> </Reference> <Reference Include="WcfService.Contract"> <HintPath>bin\Debug\netcoreapp2.1\WcfService.Contract.dll</HintPath> </Reference> </ItemGroup></Project>
然后在Startup文件中注入所需的服务,并增加SOAP服务的端点。
namespace SOAPApp{ public class Startup { // This method gets called by the runtime. Use this method to add services to the container. // For more information on how to configure your application, visit https://go.microsoft.com/fwlink/?LinkID=398940 public void ConfigureServices(IServiceCollection services) { services.AddSingleton(new Communication()); } // This method gets called by the runtime. Use this method to configure the HTTP request pipeline. public void Configure(IApplicationBuilder app, IHostingEnvironment env) { if (env.IsDevelopment()) { app.UseDeveloperExceptionPage(); } app.UseSoapEndpoint<Communication>("/Communication.svc", new BasicHttpBinding()); } } }
运行此Web应用程序,注意将默认的local地址改成实际的Url。
再在Windows系统环境下建立一个控制台应用程序作为客户端用于检测。
namespace WcfService.Client{ class Program { static void Main(string[] args) { var factory = new ChannelFactory<ICommunication>(new BasicHttpBinding(), new EndpointAddress(new Uri("http://192.168.1.6:5000/Communication.svc"))); var channel = factory.CreateChannel(); Console.WriteLine("Ping..."); var result = channel.Ping("Hi"); Console.WriteLine(result); ((ICommunicationObject)channel).Close(); Console.Read(); } } }
运行结果,同样正常,这次的的尝试完美结尾。