LOGO OA教程 ERP教程 模切知识交流 PMS教程 CRM教程 开发文档 其他文档  
 
网站管理员

【C#】快速实现.NET(.net framework/.net core+)动态访问webservice服务

admin
2024年6月19日 18:57 本文热度 1005

前言:访问webservice,大多数人都是用服务引用的方式,但是这种方式比较麻烦,例如遇到服务更新了,你还需要手动更新你的服务引用,再重新发布,很麻烦。或者已有的一些例子,至少我看到的很多案例,动态访问也只能止步于使用.net framework环境,没看到有啥.net core上面动态访问的案例。于是我就来抛砖引玉一下,自己写一个支持.net framework也可以支持.netcore或以上环境使用的动态访问webservice服务接口的方法,供大家使用或参考。

先创建一个webservice服务,用来测试使用。提供三个服务接口,一个无参数、一个字符串参数、一个含有多个实体类参数(实体类参数也含有嵌套和集合)以及返回带有嵌套和集合的返回数据,用来做测试使用,基本上可以涵盖几乎所有的webservice服务的情况了。

有关测试实体类

启动webservice服务备用

请求端程序,支持.netframework 4.6.1+、.net core+和.net 5+所有版本,都可以通过nuget来引用 Wesky.Net.OpenTools 包。需要引用最新的版本,以保证功能完善。我此处使用.net 8的控制台来引用,大佬们可以根据自己程序情况进行引用,framework4.6以下版本不适用。

为了方便使用,我本地也直接编写几个实体类,用来传参和做返回值接收使用:

先实例化一个WebserviceHelper对象,如果有用IOC容器的大佬,比如说使用asp.net core程序等,可以对该接口和类进行依赖注入的注册。如果没用IOC容器的大佬,可以直接这样new一个使用。此处我用new一个对象的使用方式来使用。并且获取到asmx的url地址,地址此处需要添加?wsdl后缀。

申明要访问的服务的名称,例如HelloWorld,然后直接调用。由于没有参数,所以参数直接设为null

运行程序进行调用,可以看到获取到了返回值的xml文档。

直接调用的时候,返回值是一个 OpenToolResult类型,类型定义如下:

由于咱们的返回值就一个基础类型string,所以需要调用解析基础类型值的方法,得到最终的返回消息为 Hello World。

基础类型值解析方法定义如下:

传入参数为:获取到的返回值、节点名称(一般是方法名称+“Result”)、命名空间,命名空间在调用的时候,会被存储到类型OpenWebserviceInfo的属性OpenWebservice集合(是一个OpenWebserviceDocCache类型的集合)里面去,通过url地址和接口方法名字可以匹配到对应的命名空间。

OpenWebserviceDocCache类型定义如下:

接着试一下传入一个基础类型参数的情况。访问Hola方法,传入Wesky字符串,成功获取到返回值 Wesky World。

接下来试一下传入多个实体类参数,并且按照上面webservice的内容,会返回一个其他一个实体类消息。

回看一下TestService服务接口的实现,说明动态访问是成功的。

访问webservice方法定义说明。参数可以传0个或多个参数,会用来和解析度wsdl地址的同名方法服务参数个数做匹配,如果不匹配,则会提示错误信息。返回值Result.IsSuccess如果是true,代表发送请求成功;如果解析错误或者发送请求失败等,则提示false,并且Message属性会有具体错误信息描述。

返回值为实体类的解析方法定义说明。以上请求TestSevice服务接口时候,返回值是实体类,如果需要匹配本地的实体类,需要访问 ExtractCustomerValueFromXml方法进行解析处理。例如上面传入的是ResultInfo类型作为返回值接收类。

一些核心代码:

/// <summary>

/// 调用Web服务

/// Calls a web service.

/// </summary>

/// <param name="url">服务URL / Service URL</param>

/// <param name="apiName">API名称 / API name</param>

/// <param name="expireSecond">过期时间(秒)/ Expiration time in seconds</param>

/// <param name="parameters">调用参数 / Invocation parameters</param>

/// <returns>调用结果 / Invocation result</returns>

public OpenToolResult<string> CallWebservice(string url, string apiName,long expireSecond = 86400,params object[] parameters)

{

    OpenToolResult<string> result = new HttpExtensions.OpenToolResult<string>();


    CheckExpireTime(url, apiName, expireSecond);


    var wsInfo = OpenWebserviceInfo.OpenWebservice.FirstOrDefault(x => x.WebserviceUrl == url && x.OperationName == apiName);


    if (wsInfo == null)

    {

        result.IsSuccess = false;

        result.Message = "本地无法加载远程webservice服务。Cannot load the remote webservice locally.";

        return result;

    }


    if ((parameters == null && wsInfo.ParameterNames.Count > 0) || (parameters!=null && parameters.Length != wsInfo.ParameterNames.Count))

    {

        result.IsSuccess = false;

        result.Message = $"远程服务接口参数个数和你传入的参数个数不匹配。远程服务参数个数:{wsInfo.ParameterNames.Count}, 本地传入参数个数:{parameters?.Length ?? 0}。Parameter count mismatch: remote service has {wsInfo.ParameterNames.Count}, provided {parameters?.Length ?? 0}.";

        return result;

    }



    Dictionary<string, string> dicParams = new Dictionary<string, string>();

    if (parameters != null)

    {

        for (int i = 0; i < wsInfo.ParameterNames.Count; i++)

        {

            dicParams.Add(wsInfo.ParameterNames[i], XmlConvertor.SerializeObjectToXml(parameters[i]));

        }

    }

    var response = InvokeService(url, apiName, dicParams,wsInfo.Namespace);


    result.Result = response;

    result.IsSuccess = true;

    result.Message = "success";


    return result;

}


该文章在 2024/6/19 18:57:08 编辑过
关键字查询
相关文章
正在查询...
点晴ERP是一款针对中小制造业的专业生产管理软件系统,系统成熟度和易用性得到了国内大量中小企业的青睐。
点晴PMS码头管理系统主要针对港口码头集装箱与散货日常运作、调度、堆场、车队、财务费用、相关报表等业务管理,结合码头的业务特点,围绕调度、堆场作业而开发的。集技术的先进性、管理的有效性于一体,是物流码头及其他港口类企业的高效ERP管理信息系统。
点晴WMS仓储管理系统提供了货物产品管理,销售管理,采购管理,仓储管理,仓库管理,保质期管理,货位管理,库位管理,生产管理,WMS管理系统,标签打印,条形码,二维码管理,批号管理软件。
点晴免费OA是一款软件和通用服务都免费,不限功能、不限时间、不限用户的免费OA协同办公管理系统。
Copyright 2010-2024 ClickSun All Rights Reserved