Asp.NET Core 如何調用WebService的方法

這篇文章主要介紹了Asp.NET Core 如何調用WebService的方法,小編覺得挺不錯的,現在分享給大家,也給大家做個參考。一起跟隨小編過來看看吧

0.使用背景

因爲現在的項目都是基於 .NET Core 的,但是某些需要調用第三方的 WebService 服務,故有了此文章。其基本思路是通過微軟提供的 Svcutil 工具生成代理類,然後通過 System.ServiceModel 來調用代理類所提供的對象與方法。

1.配置準備

1.1 新建並編輯項目

首先新建一個新的 .NET Core 控制檯程序,通過命令行窗口或者 Powershell 執行以下命令新建一個項目。

dotnet new console

然後編輯項目文件 WebServiceConsole.csproj ,並在其中加入以下內容:

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

這樣最終 WebServiceConsole.csproj 的內容會是這樣子的。

<Project Sdk="Microsoft.NET.Sdk">

 <PropertyGroup>
 <OutputType>Exe</OutputType>
 <TargetFramework>netcoreapp2.1</TargetFramework>
 </PropertyGroup>

 <ItemGroup>
 <DotNetCliToolReference Include="dotnet-svcutil" Version="1.0.*" />
 </ItemGroup>
</Project>

繼續打開命令行窗口或者 Powershell 執行以下命令,還原項目文件的包。

dotnet restore

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

成功之後會看到文件夾裏面多了一個文件夾。

注意,在生成代理類之後,我們還需要再執行一次 dotnet restore 來還原代理類當中所使用到的 NuGet 包。

2.調用 WebService 接口

生成代理類之後,重新打開項目,可以看到多了一個 ServiceModel1 的文件夾,在裏面還有一個 Reference.cs 的文件,這個文件裏面的內容就是根據我們之前提供的 Url 生成的代理類了。

用法的話很簡單,需要三步,在這裏我直接在 Main() 方法內部寫調用方法了,注意這裏基本上所有生成的方法都是異步方法。

using System;
using System.ServiceModel;
using System.Threading.Tasks;

namespace WebServiceConsole
{
 class Program
 {
 static async Task Main(string[] args)
 {
  // 創建 HTTP 綁定對象
  var binding = new BasicHttpBinding();
  // 根據 WebService 的 URL 構建終端點對象
  var endpoint = new EndpointAddress(@" http://localhost:3000/bsp-oisp/ws/sfexpressService?wsdl](http://localhost:3000/bsp-oisp/ws/sfexpressService?wsdl");
  // 創建調用接口的工廠,注意這裏泛型只能傳入接口
  var factory = new ChannelFactory<IExpressService>(binding, endpoint);
  // 從工廠獲取具體的調用實例
  var callClient = factory.CreateChannel();
  // 調用具體的方法,這裏是 sfexpressServiceAsync 方法。
  var result = await callClient.sfexpressServiceAsync(new sfexpressService());

  Console.ReadLine();
 }
 }
}

3.注意事項

報文長度問題,我在call 一個QAS service時,因爲報文過長,出過錯誤,所以報文長度最好手動設置一下,防止默認長度不夠(默認長度我測試是65536)。

binding.MaxReceivedMessageSize=2000000

https需要設置。代碼如下:

channelFactory.Credentials.ServiceCertificate.SslCertificateAuthentication =
new X509ServiceCertificateAuthentication()
{
CertificateValidationMode = X509CertificateValidationMode.None,
RevocationMode = X509RevocationMode.NoCheck
};

在call某些特殊的Web Service時,生成的代理類model無法解析服務返回報文,這種情況我只在Call QAS時遇到,在這裏就詳細描述下問題,QAS是一個國外提供地址校驗的服務提供商,我們用他們提供的一個軟件安裝後生成的Web Service服務在轉發到他們自己的服務上。所以在生成代理類的時候,就出現生成代理類裏面的model無法解析他的返回報文,經過查閱代理類代碼,發現他在生成返回報文的model中,返回字段有些會加上一個特性標記,而這些標記是錯誤的,所以只要去掉就行。
例:

[System.Xml.Serialization.XmlElementAttribute(Order=0)]
public string Country { get; set; }

Update如下即可

public string Country { get; set; }

4.參考資料:

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

以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持神馬文庫。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章