微信公眾平臺開發(fā)教程（三） 基礎(chǔ)框架搭建
首先我們設(shè)計了模塊層次圖，當(dāng)然圖中只是給出一種實(shí)現(xiàn)方式，不局限于此。具體見下圖。
主要功能介紹如下：
1）請求接口層。處理HTTP請求，及響應(yīng)
2）分發(fā)層。由接口層傳入請求，然后具體分析請求類型，分發(fā)至不同的處理器
3）業(yè)務(wù)邏輯層。這里是我們的具體業(yè)務(wù)邏輯了，根據(jù)請求，實(shí)現(xiàn)具體的業(yè)務(wù)邏輯。
4）數(shù)據(jù)層。我們在實(shí)現(xiàn)某個應(yīng)用時可能需要訪問數(shù)據(jù)，可以是數(shù)據(jù)庫或者是文件。如果是簡單應(yīng)用，可能沒有這一層。
其實(shí)，具體的應(yīng)用可以在這個結(jié)構(gòu)上去擴(kuò)展，可以擴(kuò)展消息對象層、業(yè)務(wù)對象層、數(shù)據(jù)訪問層、功能管理層等。這里只是提供一種思路，不局限于此。
根據(jù)層次圖，設(shè)計流程圖，具體講述實(shí)現(xiàn)的各個過程。以便了解整個處理過程。如下圖所示：
根據(jù)流程圖，我們能夠清晰的了解整個流程，消息處理的具體實(shí)現(xiàn)步驟。
下面我們針對每個流程進(jìn)行代碼實(shí)現(xiàn)。
一、接收HTTP請求
我們需要一個HttpHandler或者一個網(wǎng)頁，來處理微信服務(wù)端HTTP請求。
這里我們使用了HttpHandler。因?yàn)槠潇`活性高，性能好。
具體實(shí)現(xiàn)如下。
public class WeiXinHttpHandler:IHttpHandler
{
/// <summary>
///
/// </summary>
public bool IsReusable
{
get { return true; }
}
/// <summary>
/// 處理請求
/// </summary>
/// <param name="context"></param>
public void ProcessRequest(HttpContext context)
{
//由微信服務(wù)接收請求，具體處理請求
WeiXinService wxService = new WeiXinService(context.Request);
string responseMsg = wxService.Response();
context.Response.Clear();
context.Response.Charset = "UTF-8";
context.Response.Write(responseMsg);
context.Response.End();
}
}
如果是HTTPHandler，需要在配置文件中，配置具體的應(yīng)用。具體的節(jié)點(diǎn)配置，我們不作說明。直接給出例子，配置HttpHandler節(jié)點(diǎn)如下
<httpHandlers> <add verb="*" path="WXService.ashx" type="namespace.WeiXinHttpHandler,WXWeb" validate="true"/> </httpHandlers>
二、分發(fā)請求
為了能功能封裝，我們也將此封裝在了處理組件中。其實(shí)可以放置在HttpHandler中的。
1）驗(yàn)證簽名
如果是首次請求，需要驗(yàn)證簽名。就相當(dāng)于一次HTTP握手。之前在上一章中，設(shè)置的服務(wù)器URL以及token值，這個功能就是檢驗(yàn)是否鏈接成功。
這個請求是GET請求。以下具體說明（官方）：
業(yè)務(wù)邏輯：
加密/校驗(yàn)流程：
<1> 將token、timestamp、nonce三個參數(shù)進(jìn)行字典序排序
<2> 將三個參數(shù)字符串拼接成一個字符串進(jìn)行SHA1加密
<3> 開發(fā)者獲得加密后的字符串可與signature對比，標(biāo)識該請求來源于微信
而官方只提供了PHP的代碼示例，很多東西在C#中并非直譯既得。所以這里面也有一些具體處理。先看官方的代碼：
private function checkSignature()
{
$signature = $_GET["signature"];
$timestamp = $_GET["timestamp"];
$nonce = $_GET["nonce"];
$token = TOKEN;
$tmpArr = array($token, $timestamp, $nonce);
sort($tmpArr);
$tmpStr = implode( $tmpArr );
$tmpStr = sha1( $tmpStr );
if( $tmpStr == $signature ){
return true;
}else{
return false;
}
}
我們將其翻譯成C#版本：
/// <summary>
/// 檢查簽名
/// </summary>
/// <param name="request"></param>
/// <returns></returns>
private bool CheckSignature()
{
string signature = Request.QueryString[SIGNATURE];
string timestamp = Request.QueryString[TIMESTAMP];
string nonce = Request.QueryString[NONCE];
List<string> list = new List<string>();
list.Add(TOKEN);
list.Add(timestamp);
list.Add(nonce);
//排序
list.Sort();
//拼串
string input = string.Empty;
foreach (var item in list)
{
input += item;
}
//加密
string new_signature = SecurityUtility.SHA1Encrypt(input);
//驗(yàn)證
if (new_signature == signature)
{
return true;
}
else
{
return false;
}
}
這里需要SHA1加密，具體的算法如下：
/// <summary>
/// SHA1加密
/// </summary>
/// <param name="intput">輸入字符串</param>
/// <returns>加密后的字符串</returns>
public static string SHA1Encrypt(string intput)
{
byte[] StrRes = Encoding.Default.GetBytes(intput);
HashAlgorithm mySHA = new SHA1CryptoServiceProvider();
StrRes = mySHA.ComputeHash(StrRes);
StringBuilder EnText = new StringBuilder();
foreach (byte Byte in StrRes)
{
EnText.AppendFormat("{0:x2}", Byte);
}
return EnText.ToString();
}
2）分發(fā)請求
接下來就是具體的消息請求了，這里都是POST請求。
因?yàn)橛卸喾N消息類型，我們通過工廠類來進(jìn)行封裝，然后每種消息都有專門的處理器來進(jìn)行處理。具體實(shí)現(xiàn)邏輯：
/// <summary>
/// 處理請求
/// </summary>
/// <returns></returns>
private string ResponseMsg()
{
string requestXml = Common.ReadRequest(this.Request);
IHandler handler = HandlerFactory.CreateHandler(requestXml);
if (handler != null)
{
return handler.HandleRequest();
}
return string.Empty;
}
處理請求的對外方法（HttpHandler調(diào)用的方法就是這個了），即：
/// <summary>
/// 處理請求，產(chǎn)生響應(yīng)
/// </summary>
/// <returns></returns>
public string Response()
{
string method = Request.HttpMethod.ToUpper();
//驗(yàn)證簽名
if (method == "GET")
{
if (CheckSignature())
{
return Request.QueryString[ECHOSTR];
}
else
{
return "error";
}
}
//處理消息
if (method == "POST")
{
return ResponseMsg();
}
else
{
return "無法處理";
}
}
三、消息處理器具體處理消息
1）消息類型
首先我們來看下，具體的消息類型，其實(shí)上一張中已經(jīng)明確給了消息的接口。
這里再看具體看一下，請求的消息類型有哪些，回復(fù)的消息類型有哪些等。
千萬要注意，請求的消息是文本類型，回復(fù)的消息，不一定也是文本哦，可以是圖文、音樂等任意一種可回復(fù)的消息。具體見下表所示。
2）根據(jù)具體的消息接口，設(shè)計消息類。
這里給出類圖，供參考。
3）針對不同的消息，會有不同的處理器，來看下具體的類圖。
4）具體業(yè)務(wù)處理
每個handler里面就是可以處理具體請求。輸入的什么消息，訪問那些數(shù)據(jù)，調(diào)用服務(wù)等，都在這里處理。
還是建議大家對具體的業(yè)務(wù)進(jìn)行單獨(dú)封裝，在Handler中，只提供調(diào)用的接口。
因?yàn)殡S著業(yè)務(wù)的增加，一個Handler可能要處理很多業(yè)務(wù)，如果所有的操作邏輯都寫在這里，勢必影響閱讀，也不易于維護(hù)與擴(kuò)展。
5）產(chǎn)生回復(fù)消息
在處理完請求后，需要生成回復(fù)消息，響應(yīng)到終端。消息格式，就是我們介紹那些消息類型，但必須是可用于回復(fù)的，當(dāng)前支持的有：文本、圖文、音樂等。
一定要明確：回復(fù)的消息類型不一定要與請求的消息類型一樣，比如，請求是文本，回復(fù)的可以是圖文、音樂。
產(chǎn)生回復(fù)消息的過程，其實(shí)，就是特定的消息對象格式化為對應(yīng)的XML的過程，然后將XML響應(yīng)至微信服務(wù)器。
6）實(shí)例
這里以微信用戶關(guān)注公眾賬號，然后服務(wù)端處理處理事件請求，登記用戶，并提示歡迎信息。
class EventHandler : IHandler
{
/// <summary>
/// 請求的xml
/// </summary>
private string RequestXml { get; set; }
/// <summary>
/// 構(gòu)造函數(shù)
/// </summary>
/// <param name="requestXml"></param>
public EventHandler(string requestXml)
{
this.RequestXml = requestXml;
}
/// <summary>
/// 處理請求
/// </summary>
/// <returns></returns>
public string HandleRequest()
{
string response = string.Empty;
EventMessage em = EventMessage.LoadFromXml(RequestXml);
if (em.Event == EventType.Subscribe)
{
//注冊用戶
User user = new User();
user.OpenID = em.FromUserName;
UserManager.Regester(user);
//回復(fù)歡迎消息
TextMessage tm = new TextMessage();
tm.ToUserName = em.FromUserName;
tm.FromUserName = em.ToUserName;
tm.CreateTime = Common.GetNowTime();
tm.Content = "歡迎您關(guān)注xxx，我是小微。有什么我能幫助您的嗎？";
response = tm.GenerateContent();
}
return response;
}
}
四、HTTP響應(yīng)
最后將處理結(jié)果返回至最初HttpHandler，響應(yīng)給微信服務(wù)器，直接Response處理。這也是在最開始設(shè)計的HttpHandler中實(shí)現(xiàn)的。
下面是代碼片段，具體可見一、Http請求
context.Response.Clear(); context.Response.Charset = "UTF-8"; context.Response.Write(responseMsg); context.Response.End();
以上就是本文的全部內(nèi)容，希望對大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。
相關(guān)文章
這篇文章主要為大家詳細(xì)介紹了C#開發(fā)教程之FTP上傳下載功能，具有一定的參考價值，感興趣的小伙伴們可以參考一下2017-04-04
這篇文章主要介紹了C#簡單的向量用法,需要的朋友可以參考下2014-07-07
本文主要介紹了C#中Lambda的相關(guān)知識。具有一定的參考價值，下面跟著小編一起來看下吧2017-01-01
這篇文章主要介紹了C#遍歷指定目錄下所有文件的方法,實(shí)例分析了C#中GetFiles()方法遍歷文件的使用技巧,非常具有實(shí)用價值,需要的朋友可以參考下2015-04-04
C# Process調(diào)用外部程序的實(shí)現(xiàn)
這篇文章主要介紹了C# Process調(diào)用外部程序的實(shí)現(xiàn)，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2021-02-02
基于C# 寫一個 Redis 數(shù)據(jù)同步小工具
Redis支持主從同步。數(shù)據(jù)可以從主服務(wù)器向任意數(shù)量的從服務(wù)器上同步，從服務(wù)器可以是關(guān)聯(lián)其他從服務(wù)器的主服務(wù)器。這篇文章主要介紹了用 C# 寫一個 Redis 數(shù)據(jù)同步小工具,需要的朋友可以參考下2020-02-02
這篇文章主要介紹了C#動態(tài)創(chuàng)建button的方法,涉及C#按鈕屬性動態(tài)設(shè)置的相關(guān)技巧,具有一定參考借鑒價值,需要的朋友可以參考下2015-08-08
這篇文章主要介紹了C#虛方法的聲明和使用實(shí)例教程,對于初學(xué)者理解C#的虛方法有一定的幫助,需要的朋友可以參考下2014-07-07
WPF+ASP.NET?SignalR實(shí)現(xiàn)簡易在線聊天功能的示例代碼
這篇文章將以一個簡單的聊天示例，簡述如何通過WPF+ASP.NET?SignalR實(shí)現(xiàn)消息后臺通知，僅供學(xué)習(xí)分享使用，如有不足之處，還請指正2022-09-09
C#使用BinaryFormatter類、ISerializable接口、XmlSerializer類進(jìn)行序列化和反序列
這篇文章介紹了C#使用BinaryFormatter類、ISerializable接口、XmlSerializer類進(jìn)行序列化和反序列化的方法，文中通過示例代碼介紹的非常詳細(xì)。對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值，需要的朋友可以參考下2022-09-09