OSS.Social微信项目标准库介绍

Posted 2020-08-31 OSS开源实验室

　　经过本周的努力，昨晚终于完成OSS.Social微信项目的标准库支持，当前项目你已经可以同时在.net framework和.net core 中进行调用，调用方法也发生了部分变化，这里我简单分享下，主要包含下边几个部分：

· 移植后的变化

· 和OSS.Common，OSS.Http关系

· 异步（Task）使用介绍

 

一. 移植后的变化

    如果不了解OSS.Social的同学，可以参看我前面的几篇文章介绍，这里就不多说了。​这次移植的变化首先是对.net core项目能够提供直接的支持，当前的使用的.net standard标准库版本为1.3版，对应的framework支持为4.6版，对应.net core 的版本现在基本都支持，源码详见github，在项目我提供了Framework 4.6的单元测试项目，和.netcoreapp1.0的网站项目。由于时间不充裕，并没有做全部接口测试，如果发现有bug可以及时和我联系。

    ​其次是对异步的支持，这个也是这次变动最大的地方，几乎公号管理功能（Offcial）模块下的所有核心方法都转为异步方式提供，这些完全归功于HttpClient带来便利，在底层IO层面提供了最基础的异步支持。

​　　当前可以像如下方式调用：

　　当然，在很多情况下需要及时对结果进行处理给出对应的响应信息，为了这种同步需求，所以我通过调用Task的wait()方法，封装了一个简单的扩展方法WaitResult()，直接可以如下调用：

 

二. 和OSS.Common，OSS.Http关系

　　OSS.Common和OSS.Http我很早以前写的两个基础模块，现在都统一到OSS系列下，现在都已经提供了.Net Standard的支持。前者负责全局结果实体，加密算法，基础辅助类的实现。像在接口方法中所有的返回实体都会继承ResultMo实体，其中提供了IsSuccess属性，Ret和Message信息，统一项目中的传值以及结果判断，统一判断依据。后边会有针对它的文章介绍，这里略过，如果你想在项目中使用它，可以直接通过Nuget安装：

　　至于OSS.Http，主要负责对Rest接口请求的封装，底层已经由HttpWebRequest迁移至HttpClient模块，如果你感兴趣，可以参考我写的《完成OSS.Http底层HttpClient重构封装》的文章，当前也可以通过Nuget安装：

三. 异步（Task）使用介绍

　　1. 基本介绍

　　因为在这个项目中使用了大量的async异步关键字，所以对于这种情况使用较少的同学可能略微有些不适，那这里我主要把异步的常见使用情况给大家介绍下。

　　异步在我印象中，从.net体系下最开始的使用Thread，到后来的Task，再后来的async和wait关键字。它的语法越来越精简，在Framework2.0时代我们可能需要通过 new Thread(执行任务).Start()  方式来创建异步线程。因为系统线程的频繁创建会造成系统资源的大量消耗，所以.net维护了一个线程池，可以让我们通过 ThreadPool 来直接调用线程池中已经维护好的线程，我们可以很简单的通过 ThreadPool.QueueUserWorkItem(执行任务) 完成异步线程的调用。

　　再后边.net 提供了 Task.Run(()=>{ 执行任务 }) 这种形式的异步调用，这种形式默认使用线程池下的线程，同时返回一个 Task 对象，可以通过这个对象来等待或者判断任务的完成状态等。

　　虽然这个时候使用多线程异步操作已经相当简单了，但是有时候异步代码还是要单独进行处理，会造成一定的层级关系。所以后来就有 async和await 关键字，可以让我们能够像同步流程一样写异步代码。在下边我用一个简单的例子讲解一下。

 　　2. 使用形式：

　　　　这里我通过一个简单的例子来给大家分享一下，假如我们现在有一个需求，需要通过用户手机号，请求另外一个系统下的用户名，并给用户推送短信消息。下边是我使用asyn和await写的一个简单例子。

　　

在这个例子中，如果你把await和asyn拿开，那么流程就是一个完整的同步流程，但是加上之后就变成了一个异步。

这里要特殊说一下，await后边并不是立刻执行异步，他只有在真正的异步操作时才会处理，在这个例子中，也就是1，2,3 步会同步执行，4,5则是在异步线程中执行，同时在执行第4步时，UpdateUserInfo()方法结束返回

　　3. 异常注意问题：

 　　对于异步异常，我推荐这篇文章《关于C#中async/await中的异常处理（上）》，这里有一个问题需要强调一下，异步之后最好要对返回的 Task 有后续的操作， 这样如果有异常就会及时抛出，否则会在 GC 回收资源时触发，如果没有设置全局异常处理，很可能会引起应用程序池的崩溃。

 

如果你对我的代码感兴趣，可以直接查看我的GitHub，或者关注公众号（OSSCoder）：