在後臺業務管理系統中使用Autofac實現微信介面的處理

.Net · 發表 2019-02-26 11:55:00

摘要：在後臺業務管理系統中使用Autofac實現微信介面的處理，我們只需要把相關使用到的DLL放到BIN目錄裡面即可，通過IOC控制反轉方式實現對介面的呼叫。在實現在業務系統裡面，我們本身程式可能已經依賴了很多相關的DLL類庫，這種可以降低對相關DLL的強依賴，而以一種鬆耦合的方式使用我們所需要的微...

在後臺業務管理系統中使用Autofac實現微信介面的處理，我們只需要把相關使用到的DLL放到BIN目錄裡面即可，通過IOC控制反轉方式實現對介面的呼叫。在實現在業務系統裡面，我們本身程式可能已經依賴了很多相關的DLL類庫，這種可以降低對相關DLL的強依賴，而以一種鬆耦合的方式使用我們所需要的微信介面。

在之前隨筆《 C#開發微信門戶及應用(42)--使用Autofac實現微信介面處理的控制反轉處理》裡面介紹了Autofac元件實現IOC控制反轉的一些實現細節，本篇隨筆介紹在業務管理系統中，我們需要呼叫微信介面推送一些業務訊息，如待辦實現、通知資訊等等。使用Autofac元件的控制反轉方式，使得我們只需要關注介面的處理即可，不需要過於關注實現的具體細節。

1、功能處理的介面和實現專案

如我們建立一個專案，用於處理對微信或者第三方元件的一些封裝處理，通過建立處理功能的介面，以及對應的實現，如下所示。

如對微信的處理，我們需要呼叫微信框架裡面相關的介面封裝專案，首先定義一個訊息推送的介面

namespace WHC.Common.Handler
{
/// <summary>
/// 企業微信訊息推送介面
/// </summary>
public interface ICorpMessage
{
/// <summary>
/// 企業微信的APPID
/// </summary>
string CorpId { get; set; }

/// <summary>
/// 企業微信的APPSecret
/// </summary>
string CorpSecret { get; set; }

/// <summary>
/// 企業微信應用的ID
/// </summary>
string AgentId { get; set; }

/// <summary>
/// 傳送訊息內容（如任務通知）
/// </summary>
/// <param name="touser">傳送給的使用者企業微信ID</param>
/// <param name="title">訊息標題</param>
/// <param name="description">訊息正文（512位元組內）</param>
/// <param name="url">跳轉URL</param>
/// <returns></returns>
CommonResult SendMessageTextCard(string touser, string title, string description, string url);
}

我們定義了幾個屬性，就是希望介面能夠少傳一些引數，而且可以在多個實現函式裡面通用的。

具體的傳送訊息實現類如下所示。

namespace WHC.Common.Handler
{
/// <summary>
/// 企業微信訊息推送實現
/// </summary>
public class CorpMessage : ICorpMessage
{
/// <summary>
/// 企業微信的APPID
/// </summary>
public string CorpId { get; set; }

/// <summary>
/// 企業微信的APPSecret
/// </summary>
public string CorpSecret { get; set; }

/// <summary>
/// 企業微信應用的ID
/// </summary>
public string AgentId { get; set; }

/// <summary>
/// 傳送訊息內容（如任務通知）
/// </summary>
/// <param name="touser">傳送給的使用者企業微信ID</param>
/// <param name="title">訊息標題</param>
/// <param name="description">訊息正文（512位元組內）</param>
/// <param name="url">跳轉URL</param>
/// <returns></returns>
public CommonResult SendMessageTextCard(string touser, string title, string description, string url)
{
CommonResult result = new CommonResult();
ICorpBasicApi baseBLL = new CorpBasicApi();
string token = baseBLL.GetAccessToken(CorpId, CorpSecret);
if (!string.IsNullOrEmpty(token))
{
ICorpMessageApi bll = new CorpMessageApi();
CorpSendTextCard msg = new CorpSendTextCard(title, description, url);
msg.agentid = AgentId;
msg.touser = touser;

result = bll.SendMessage(token, msg);
}
else
{
result.ErrorMessage = "無法獲取Token資訊";
}
return result;
}
}

這裡最終呼叫的是微信框架裡面的專案模組，如下程式碼所示

ICorpBasicApi baseBLL = new CorpBasicApi();

這裡我們通過呼叫介面傳送TextCard 文字卡片資訊的。

2、在後臺業務管理系統對推送資訊介面的呼叫

首先為了使用IOC的控制反轉處理，我們專案需要引用Autofac和Autofac.Configuration

然後把需要的配置資訊解除安裝Autofac.Config檔案裡面，如下檔案內容所示，紅框裡面的就是我們這裡使用到的訊息傳送介面。

但我們完成了配置檔案，並把配置檔案放在專案根目錄下，就可以通過IOC介面控制反轉的方式，獲得對應的介面實現了，如下程式碼所示

 //獲取對應的企業微信訊息推送介面
 var handler = AutoFactory.Instatnce.Container.Resolve<ICorpMessage>();

有了這個介面，我們就可以在實際專案中呼叫這個介面進行處理企業微信的訊息推送了。

例如我們在Web的MVC控制器端實現一個處理函式，如下所示。

/// <summary>
/// 批量處理多個任務下發企業微信
/// </summary>
/// <param name="billNo">多個billno組成的列表</param>
/// <returns></returns>
public ActionResult SendTask(string billNoList)
{
CommonResult result = new CommonResult();
try
{
if (!string.IsNullOrEmpty(billNoList))
{
//獲取對應的企業微信訊息推送介面
var handler = AutoFactory.Instatnce.Container.Resolve<ICorpMessage>();
if (handler != null)
{
//把逗號分隔的字串轉換為列表
List<string> list = billNoList.ToDelimitedList<string>(",");
foreach (string billNo in list)
{
//獲取盤點主表資訊
AssetCheckInfo info = BLLFactory<AssetCheck>.Instance.FindByBillNo(billNo);
if (info != null)
{
//獲取盤點明細~資訊~
var detailList = BLLFactory<AssetCheckDetail>.Instance.FindByBillNo(billNo);

//讀取配置資訊
AppConfig config = new AppConfig();
handler.CorpId = config.AppConfigGet("CorpId");
handler.CorpSecret = config.AppConfigGet("CorpSecret");
handler.AgentId = config.AppConfigGet("AgentId");

//構建推送的訊息體內容
string touser = info.CorpUserId;
string title = "您有一個盤點任務待處理";
StringBuilder sb = new StringBuilder();
sb.AppendFormat("盤點單號:{0}\r\n", info.BillNo);
//sb.AppendFormat("盤點公司:{0}\r\n", info.Company_ID);
//sb.AppendFormat("盤點部門:{0}\r\n", info.Dept_ID);
sb.AppendFormat("盤點數量:{0}\r\n", info.CheckQty);
sb.AppendFormat("指定盤點人:{0}\r\n", info.CorpUserId);
sb.AppendFormat("申請日期:{0}\r\n", info.ApplyDate.ToString("yyyy-MM-dd"));
string description = sb.ToString();
string url = "http://www.iqidi.com";

//呼叫企業微信訊息介面推送訊息
result = handler.SendMessageTextCard(touser, title, description, url);
if (result.Success)
{
//更新盤點表狀態
Hashtable ht = new Hashtable();
ht.Add("TaskStatus", 1);//下發 1
BLLFactory<AssetCheck>.Instance.UpdateFields(ht, info.ID);
}
}
}
}
}
else
{
result.ErrorMessage = "單號為空";
}
}
catch (Exception ex)
{
LogHelper.Error(ex);
result.ErrorMessage = ex.Message;
}

return ToJsonContent(result);
}

而在前端的介面裡面，我們可以通過定義一個JS函式來發起任務訊息的推動處理。

$("#add").modal("hide");
//構造引數傳送給後臺
var postData = {
billNoList: billnos,
}
url = '/AssetCheck/SendTask';
$.post(url, postData, function (json) {
var data = $.parseJSON(json);
if (data.Success) {
//可增加其他處理

//儲存成功1.關閉彈出層，2.重新整理表格資料
showTips("下發盤點任務給微信成功");
$("#checkUser").modal("hide");
RefreshAsset();
}
else {
showError("下發盤點任務給微信失敗:" + data.ErrorMessage, 3000);
}
}).error(function () {
showTips("您未被授權使用該功能，請聯絡管理員進行處理。");
});

最終在我們完成盤點任務建立的時候，通知資訊推送到了企業微信客戶端和手機端的企業微信介面上。

當然其他客戶端如果處理這種對IOC的介面呼叫，一樣的原理，如Winform客戶端，或者是其他.net的專案裡面，我們都可以通過IOC實現對介面實現的控制反轉，進一步解放強依賴的關係，實現鬆耦合的介面管理。

我們在部署的時候，把使用到的對應DLL複製過去對應的BIN目錄下就可以執行起來了，在我們獲取對應的介面的時候，相關的DLL會進行關聯處理的。

在後臺業務管理系統中使用Autofac實現微信介面的處理

1、功能處理的介面和實現專案

2、在後臺業務管理系統對推送資訊介面的呼叫

您可能也會喜歡…