.NET Core 小程序開發零基礎系列（1）——開發者啓用並牽手成功

 

最近幾個月本人與團隊一直與小程序打交道，對小程序的實戰開發算比較熟悉，也因一些朋友常常問我各類小程序問題，無不能一一回答，想了好久，決定仍是空餘時間來寫寫文章吧，偶爾發現一我的安靜的時候寫文章特爽，不信大夥能夠試試哦^_^

通常項目開發已快速爲主，這時想到了一個小程序開源框架，盛派Senparc，這個項目使用過程當中確實很爽，開發速度賊快，想了解底層原理的同窗能夠下載盛派Senparc開源項目，開原址址附文章底部。

 

小程序開發系統文章就此誕生了，後面文章會覆蓋小程序的全部功能，但願對剛步入小程序開的同窗有所幫助。

 

目錄

1、微信公衆平臺開發者設置

2、新建.netcore 項目與微信服務器牽手

3、開發者服務器自動回覆

4、各類消息類型處理

5、總結

 

 

微信公衆平臺開發者設置

---

登陸微信公衆平臺小程序後臺，開發設置-消息推送，啓用開發者，填寫相關信息，以下圖

 

 

配置好後，點擊提交，會校驗與服務器牽手動做，此時要保證服務地址能正常訪問。

如不清楚的，請看下一步操做。

 

 

新建.netcore 項目與微信服務器牽手

---

新建.netcore api項目，項目結構以下圖：

 

引用盛派Senparc組件：

Senparc.Weixin.MP.MVC
Senparc.Weixin.WxOpen

 

使用盛派Senparc組件配置文件以下：

  "SenparcWeixinSetting": {
    //微信全局
    "IsDebug": true,
    //公衆號
    "Token": "#Token#",
    "EncodingAESKey": "#EncodingAESKey#",
    "WeixinAppId": "#WeixinAppId#",
    "WeixinAppSecret": "#WeixinAppSecret#",
    "Items": {
      "小程序1": {
        "WxOpenAppId": "#WxOpenAppId#",
        "WxOpenAppSecret": "#WxOpenAppSecret#",
        "WxOpenToken": "#WxOpenToken#",
        "WxOpenEncodingAESKey": "#WxOpenEncodingAESKey#"
      },
      "小程B": {
        "WxOpenAppId": "#WxOpenAppId#",
        "WxOpenAppSecret": "#WxOpenAppSecret#",
        "WxOpenToken": "#WxOpenToken#",
        "WxOpenEncodingAESKey": "#WxOpenEncodingAESKey#"
      }
    }
  }

 

使用盛派Senparc組件必須先進行註冊，在Startup類中ConfigureServices方法進行註冊

services.AddSenparcGlobalServices(Configuration)
.AddSenparcWeixinServices(Configuration);

 

在Startup類中Configure方法進行使用

public void Configure(IApplicationBuilder app, IHostingEnvironment env,  IOptions<SenparcSetting> senparcSetting,  IOptions<SenparcWeixinSetting> senparcWeixinSetting)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
                app.UseSwaggerUIV2();
            }
            app.UseStaticHttpContext();
            app.UseStaticFiles();
            app.UseMvc(routes =>
            {
                routes.MapRoute(
                    name: "default",
                    template: "{controller=Home}/{action=Index}/{id?}");
            });
         
            #region 公衆號，小程序
            IRegisterService register = RegisterService.Start(env,  senparcSetting.Value).UseSenparcGlobal(false, null);
            register.UseSenparcWeixin(senparcWeixinSetting.Value,  senparcSetting.Value);
            //配置
            var bInfo = senparcWeixinSetting.Value.Items["appid"];
            AccessTokenContainer.RegisterAsync(bInfo.WxOpenAppId,  bInfo.WxOpenAppSecret, bInfo.WxOpenAppId);
            //公衆號
             AccessTokenContainer.RegisterAsync(senparcWeixinSetting.Value.WeixinAppId,  senparcWeixinSetting.Value.WeixinAppSecret,  senparcWeixinSetting.Value.WeixinAppId);
            #endregion
        }

 

以上盛派Senparc組件的全局配置基本完成，能夠開始寫驗證服務器的接口啦。

 

新建HomeController類

靜態變量定義以下：

#region static
  /// <summary>
  /// 當前小程序的AppId
  /// </summary>
  public static readonly string AppId =  Senparc.Weixin.Config.SenparcWeixinSetting.Items["appid"].WxOpenAppId;
  /// <summary>
  ///
  /// </summary>
  public static readonly string Token =  Senparc.Weixin.Config.SenparcWeixinSetting.Items[AppId].WxOpenToken;
  /// <summary>
  ///
  /// </summary>
  public static readonly string EncodingAESKey =  Senparc.Weixin.Config.SenparcWeixinSetting.Items[AppId].WxOpenEncodingAESKey;
#endregion

 

驗證接口代碼以下：

  [HttpGet]
  [ActionName("Index")]
  public ActionResult Get(PostModel postModel, string echostr)
  {
      if (CheckSignature.Check(postModel.Signature, postModel.Timestamp,  postModel.Nonce, Token))
      {
          return Content(echostr); //返回隨機字符串則表示驗證經過
      }
      else
      {
          return Content("failed:" + postModel.Signature + "," +  Senparc.Weixin.MP.CheckSignature.GetSignature(postModel.Timestamp,  postModel.Nonce, Token) + "。" +
              "若是你在瀏覽器中看到這句話，說明此地址能夠被做爲微信小程序後臺的Url，請注意保持Token一致。1");
      }
  }

 

發佈項目到生產環境，在次點擊微信小程序後臺開發者配置，點擊提交，驗證成功說明已經與服務器牽手成功。

 

開發者服務器自動回覆

---

創建與開發者服務器成功後，在公衆號，小程序客服等功能發送的消息都會先通過微信服務器，微信服務器將已POST的請求方式中轉給咱們配置的URL地址，收到指令後，咱們開發者根據收到的類型消息進行處理。

 

統一處理消息的入口，代碼以下：

[HttpPost]
[ActionName("Index")]
public ActionResult Post(PostModel postModel)
{
    if (!CheckSignature.Check(postModel.Signature, postModel.Timestamp,  postModel.Nonce, Token))
    {
        return Content("參數錯誤！");
    }
    try
    {
        postModel.Token = Token;//根據本身後臺的設置保持一致
        postModel.EncodingAESKey = EncodingAESKey;//根據本身後臺的設置保持一致
        postModel.AppId = AppId;//根據本身後臺的設置保持一致（必須提供）
        var maxRecordCount = 10;
        var messageHandler = new  CustomWxOpenMessageHandler(Request.GetRequestMemoryStream(), postModel,  maxRecordCount);
      
        messageHandler.Execute();//執行微信處理過程（關鍵）
​
​
        var result = new FixWeixinBugWeixinResult(messageHandler);
        return result;
    }
    catch (Exception ex)
    {
        Logger.Info("異常消息：" + ex.Message);
        return Content("");
    }
}

 

全部消息都會通過管道處理即CustomWxOpenMessageHandler方法，CustomWxOpenMessageHandler主要代碼以下（遇到問題請與我聯繫）：

public CustomWxOpenMessageHandler(Stream inputStream, PostModel postModel, int  maxRecordCount = 0)
            : base(inputStream, postModel, maxRecordCount)
{
    //這裏設置僅用於測試，實際開發能夠在外部更全局的地方設置，
    //好比MessageHandler<MessageContext>.GlobalGlobalMessageContext.ExpireMinutes = 3。
    GlobalMessageContext.ExpireMinutes = 3;
    if (!string.IsNullOrEmpty(postModel.AppId))
    {
        appId = postModel.AppId;//經過第三方開放平臺發送過來的請求
    }
    //在指定條件下，不使用消息去重
    base.OmitRepeatedMessageFunc = requestMessage =>
    {
        var textRequestMessage = requestMessage as RequestMessageText;
        if (textRequestMessage != null && textRequestMessage.Content == "容錯")
        {
            return false;
        }
        return true;
    };
}

 

自動回覆處理方法，代碼以下：

public override IResponseMessageBase  OnEvent_UserEnterTempSessionRequest(RequestMessageEvent_UserEnterTempSession  requestMessage)
{
    //進入客服
    var msg = @"歡迎您！這條消息來自服務器";
    Senparc.Weixin.WxOpen.AdvancedAPIs.CustomApi.SendText(appId, OpenId,  msg);
    return DefaultResponseMessage(requestMessage);
}
​

 

效果圖以下：

 

各類消息類型處理

---

圖片消息處理代碼以下：

public override IResponseMessageBase OnImageRequest(RequestMessageImage  requestMessage)
{
    //發來圖片，進行處理
    Task.Factory.StartNew(async () =>
    {
        await  Senparc.Weixin.WxOpen.AdvancedAPIs.CustomApi.SendTextAsync(appId, OpenId, "剛纔您發送了這張圖片：");
        await  Senparc.Weixin.WxOpen.AdvancedAPIs.CustomApi.SendImageAsync(appId, OpenId,  requestMessage.MediaId);
    });
    return DefaultResponseMessage(requestMessage);
}

 

文字消息處理代碼以下：

public override IResponseMessageBase OnTextRequest(RequestMessageText  requestMessage)
{
   
    if (contentUpper == "1")
    {
        var uploadResult =  Senparc.Weixin.MP.AdvancedAPIs.MediaApi.UploadTemporaryMedia(appId,  UploadMediaFileType.image,  ServerUtility.ContentRootMapPath("~/wwwroot/imgs/fwh.jpg"));
        Senparc.Weixin.WxOpen.AdvancedAPIs.CustomApi.SendImage(appId,  OpenId, uploadResult.media_id);
    }
    else
    {
        var msg = "親，回覆「1」，關注服務號。";
        Senparc.Weixin.WxOpen.AdvancedAPIs.CustomApi.SendText(appId, OpenId,  msg);
       
    }
    return new SuccessResponseMessage();
}

 

統一默認處理，代碼以下：

public override IResponseMessageBase DefaultResponseMessage(IRequestMessageBase  requestMessage)
{
    return new SuccessResponseMessage();
​
}

 

總結

---

盛派Senparc組件適用於快速開發項目，我的以爲仍是很方便的，若是想進一步瞭解底層，能夠看底層接口，其實就是請求的微信的相關接口，處理返回的結果進行了封裝，若有在小程序開發過程當中遇到任何問題可與我聯繫

 

盛派Senparc開源項目： https://github.com/JeffreySu/WeiXinMPSDK/

 

做者：Dylan

公衆號：dotNET名人堂（sharecore）

微信：tangguo_9669

QQ：.NET Core 技術交流（18362376）

出處：https://www.cnblogs.com/hailang8/

本文文章版權歸做者和博客園共有，未經做者贊成不得隨意轉載，且在文章頁面明顯位置給出原文鏈接，不然保留追究法律責任的權利。若有問題或建議，請與我聯繫。