Document

.NET Core 如何调用 WebService

0.使用背景

因为现在的项目都是基于 .NET Core 的,但是某些需要调用第三方的 WebService 服务,故有了此文章。其基本思路是通过微软提供的 Svcutil 工具生成代理类,然后通过 System.ServiceModel 来调用代理类所提供的对象与方法。

1.配置准备

1.1 新建并编辑项目

首先新建一个新的 .NET Core 控制台程序,通过命令行窗口或者 Powershell 执行以下命令新建一个项目。

dotnet new console

1203160-20180828114620050-596077955.gif

然后编辑项目文件 WebServiceConsole.csproj ,并在其中加入以下内容:

  1.  
    <ItemGroup>
  2.  
    <DotNetCliToolReference Include="dotnet-svcutil" Version="1.0.*" />
  3.  
    </ItemGroup>

这样最终 WebServiceConsole.csproj 的内容会是这样子的。

  1.  
    <Project Sdk="Microsoft.NET.Sdk">
  2.  
     
  3.  
    <PropertyGroup>
  4.  
    <OutputType>Exe</OutputType>
  5.  
    <TargetFramework>netcoreapp2.1</TargetFramework>
  6.  
    </PropertyGroup>
  7.  
     
  8.  
    <ItemGroup>
  9.  
    <DotNetCliToolReference Include="dotnet-svcutil" Version="1.0.*" />
  10.  
    </ItemGroup>
  11.  
    </Project>

继续打开命令行窗口或者 Powershell 执行以下命令,还原项目文件的包。

dotnet restore

1203160-20180828114631676-1891134728.gif

1.2 代理类生成

现在准备工作做好了,现在我们可以使用 dotnet svcutil 命令来生成代理类,或者你可以到 WindowsSDKs 的目录下找到 SvcUtil.exe 来执行代理类生成操作。

dotnet svcutil [WebService 地址]

上面是命令格式,比如说我这里有一个 WebService 提供的接口,其地址为 http://localhost:3000/bsp-oisp/ws/sfexpressService?wsdl ,那么我们需要打开命令行工具,执行以下命令来生成代理类。

dotnet svcutil http://localhost:3000/bsp-oisp/ws/sfexpressService?wsdl](http://localhost:3000/bsp-oisp/ws/sfexpressService?wsdl

1203160-20180828114641700-942591957.png

成功之后会看到文件夹里面多了一个文件夹。

注意,在生成代理类之后,我们还需要再执行一次 dotnet restore 来还原代理类当中所使用到的 NuGet 包。

2.调用 WebService 接口

生成代理类之后,重新打开项目,可以看到多了一个 ServiceModel1 的文件夹,在里面还有一个 Reference.cs 的文件,这个文件里面的内容就是根据我们之前提供的 Url 生成的代理类了。

用法的话很简单,需要三步,在这里我直接在 Main() 方法内部写调用方法了,注意这里基本上所有生成的方法都是异步方法。

  1.  
    using System;
  2.  
    using System.ServiceModel;
  3.  
    using System.Threading.Tasks;
  4.  
     
  5.  
    namespace WebServiceConsole
  6.  
    {
  7.  
    class Program
  8.  
    {
  9.  
    static async Task Main(string[] args)
  10.  
    {
  11.  
    // 创建 HTTP 绑定对象
  12.  
    var binding = new BasicHttpBinding();
  13.  
    // 根据 WebService 的 URL 构建终端点对象
  14.  
    var endpoint = new EndpointAddress(@" http://localhost:3000/bsp-oisp/ws/sfexpressService?wsdl](http://localhost:3000/bsp-oisp/ws/sfexpressService?wsdl");
  15.  
    // 创建调用接口的工厂,注意这里泛型只能传入接口
  16.  
    var factory = new ChannelFactory<IExpressService>(binding, endpoint);
  17.  
    // 从工厂获取具体的调用实例
  18.  
    var callClient = factory.CreateChannel();
  19.  
    // 调用具体的方法,这里是 sfexpressServiceAsync 方法。
  20.  
    var result = await callClient.sfexpressServiceAsync(new sfexpressService());
  21.  
     
  22.  
    Console.ReadLine();
  23.  
    }
  24.  
    }
  25.  
    }
  26.  
     

3.参考资料:

[1]https://docs.microsoft.com/en-us/dotnet/core/additional-tools/dotnet-svcutil-guide

[2]https://www.jianshu.com/p/aae85122f20f?tdsourcetag=s_pctim_aiomsg

转载于:https://www.cnblogs.com/myzony/p/9547254.html

posted @ 2021-05-11 14:24  从未被超越  阅读(1082)  评论(0)    收藏  举报