1. 程式人生 > >ABP入門系列(15)——建立微信公眾號模組

ABP入門系列(15)——建立微信公眾號模組

1. 引言

現在的網際網路已不在僅僅侷限於網頁應用,IOS、Android、平板、智慧家居等平臺正如火如荼的迅速發展,移動應用的需求也空前旺盛。所有的網際網路公司都不想錯過這一次移動浪潮,佈局移動市場分一份移動紅利。
的確,智慧手機作為我們日常生活已必不可少的一部分,通過手機app能夠獲得更好的體驗,比如社交、購物、娛樂、生活。

但這也引入了一個問題,如果佈局移動市場,就意味著要維護好幾條產品線,比如網頁、Android、IOS、微信公眾號等。這對公司來說無疑是一項大的投入。
產品對於使用者來說,使用者只關心體驗。
而對於開發者來說,開發者更關心在保證業務流程及資料的正確流轉下,如何對產品線進行整合,來避免做重複工作。

而恰好ABP框架就已經幫我們解決了這一問題,Abp是基於【模組化設計思想】構建的,開發人員可以將自定義的功能以模組(module)的形式整合到ABP中。
不同的模組通過組裝就可以組成一個新的功能。

那你肯定很好奇如何玩轉Abp模組,下面我們就以我們的Demo為例,來進行微信公眾號模組的開發。

2. 建立微信公眾號模組

定義一個模組很簡單,只需建立微信專案,然後定義WeixinModule類繼承自AbpModule即可,再然後為WeixinModule定義[DependsOn]特性指定依賴的模組即可。

2.1. 建立微信公眾號專案

新建mvc專案,命名專案名為LearningMpaAbp.Weixin。因為要使用到Abp定義的模組功能,首先要安裝Abp Nuget包,選擇後會提示需要以下Nuget包,點選確定安裝即可。

安裝Abp需要依賴安裝的Nuget包

2.2. 定義微信公眾模組

新建LearningMpaAbpWeixinModule繼承自AbpModule。程式碼如下:

public class LearningMpaAbpWeixinModule:AbpModule
{
    /// <summary>
    /// 預初始化,通常是用來配置框架以及其它模組
    /// </summary>
    public override void PreInitialize()
    {
        base.PreInitialize();
    }

    /// <summary>
    /// 初始化,一般用來依賴注入的註冊
    /// </summary>
    public override void Initialize()
    {
        //把當前程式集的特定類或介面註冊到依賴注入容器中
        IocManager.RegisterAssemblyByConvention(Assembly.GetExecutingAssembly());
    }

    /// <summary>
    /// 提交初始化,一般用來解析依賴關係
    /// </summary>
    public override void PostInitialize()
    {
        base.PostInitialize();
    }

    /// <summary>
    /// 應用關閉時呼叫
    /// </summary>
    public override void Shutdown()
    {
        base.Shutdown();
    }
}

從程式碼中可以看出主要包括四個過載方法,每個過載方法負責不同的職責。

2.3. 指定依賴模組

因為我們需要通過webapi與現有demo進行互動,所以還需要安裝Abp.Web.Api Nuget包。

安裝Abp.Web.Api需要依賴安裝的Nuget包

那怎樣指定依賴呢,只需要通過[DependsOn]特性指定即可。

[DependsOn(typeof(AbpWebApiModule))]
public class LearningMpaAbpWeixinModule:AbpModule
{
    //....
}

好了,一個微信公眾號模組的基礎專案框架搭好了,是不是很簡單!

到這一步,你可能會問,你這只是簡單建立微信公眾號模組,但如何與我們Demo進行整合互動呢?

對的,是隻簡單建立了微信模組,但這一節我不打算講如何與Demo進行整合互動。因為在介紹如何通過webapi與系統互動之前,梳理下Abp模組化的設計,更能幫助我們瞭解模組化設計思想。

下面我們就簡單梳理下ABP模組化的設計。

3. ABP模組化設計

說到模組,突然想到幾個單詞考考大家,model、modal、module分別是什麼意思?
不知道的就自行查詞典吧。

下面迴歸正題。

3.1. 模組化相關型別

先來看看模組相關型別依賴圖:

Module相關型別依賴圖

從型別依賴圖中可以看出設計的並不複雜:

  • AbpModule:所有定義的模組均需繼承此抽象類。
  • AbpModuleInfo:可以理解為AbpModule的元資料,封裝AbpModule的基本資訊,主要包括Assembly(所屬程式集)、Type(型別)、Dependencies(依賴的模組)、IsLoadedAsPlugIn(是否外掛模組)。
  • AbpModuleCollection:從類的申明:class AbpModuleCollection : List可知它是一個AbpModuleInfo的集合。
  • AbpModuleManager:模組管理類,主要用來進行模組管理,比如啟動關閉模組。
  • DependsOnAttribute:依賴特性,用來標明模組的依賴項。

3.2. Abp如何發現並載入模組

Abp中定義了一個啟動類AbpBootstraper,該類的職責是啟動整個Abp系統,主要負責依賴注入和註冊模組以供啟動。而該類必須在應用程式啟動時最先被例項化。
而作為Abp生成的模板專案,啟動專案自然是web應用,所以AbpBootstrapper肯定在Web專案中被初始化。眾所周知,web專案的啟動是從Global.asax檔案的Application_Start專案開始的。

public class MvcApplication : AbpWebApplication<LearningMpaAbpWebModule>
{
    protected override void Application_Start(object sender, EventArgs e)
    {
        AbpBootstrapper.IocManager.IocContainer.AddFacility<LoggingFacility>(
            f => f.UseAbpLog4Net().WithConfig("log4net.config")
        );

        base.Application_Start(sender, e);
    }
}

我們先來觀察下類的申明,有沒有發現什麼特別之處?
繼承的是泛型基類且指定的泛型為LearningMpaAbpWebModule,指定了一個Module,當前web專案的Moduel。
對MVC比較熟悉的同學應該知道,MVC應用程式啟動類預設是繼承自HttpApplication的。從該段程式碼可以看出,Abp修改了MvcApplication的預設繼承類。那自然AbpWebApplication<T>是繼承自HttpApplication了。廢話不多說,來看一看具體的定義:

public abstract class AbpWebApplication<TStartupModule> 
: HttpApplication where TStartupModule : AbpModule
{
  /// <summary>
  /// Gets a reference to the <see cref="P:Abp.Web.AbpWebApplication`1.AbpBootstrapper" /> instance.
  /// </summary>
  public static AbpBootstrapper AbpBootstrapper { get; } = AbpBootstrapper.Create<TStartupModule>();

  /// <summary>
  /// This method is called by ASP.NET system on web application's startup.
  /// </summary>
  protected virtual void Application_Start(object sender, EventArgs e)
  {
    ThreadCultureSanitizer.Sanitize();
    AbpWebApplication<TStartupModule>.AbpBootstrapper.Initialize();
  }

  /// <summary>
  /// This method is called by ASP.NET system on web application shutdown.
  /// </summary>
  protected virtual void Application_End(object sender, EventArgs e)
  {
    AbpWebApplication<TStartupModule>.AbpBootstrapper.Dispose();
  }
//省略了部分程式碼
}

首先映入眼簾的是基類中定義的AbpBootstraper屬性,然後看到的是Application_StartApplication_End虛方法。
Application_Start方法中呼叫了AbpBootstrapper.Initialize()方法。相當於AbpBootstrapper.Create<TStartupModule>().Initialize();

程式碼是不是看累了,上圖,咱們直接來看web專案啟動時Module動態載入的呼叫堆疊。

Module動態載入的呼叫堆疊

是不是一目瞭然,總結以下:

Abp在啟動專案時根據指定的啟動模組(StartupModule)首先載入該模組,然後再去檢查該模組的自定義特性是否定義有[DependsOn]特性,若有則按序載入所有依賴的模組,也就是鏈式動態依賴載入。然後再依次呼叫Module的PreInitialize,Initialize和PostInitialize以完成初始化。

好了模組的啟動載入就講到這裡,感興趣的還是建議大家直接看看原始碼。
這裡推薦一篇文章ABP原始碼分析三:ABP Module,來幫助大家理解Abp的模組化思想。

4. 總結

這一節有點標題黨的味道,但內容也算點題了。下一篇我將介紹微信公眾號模組如何通過WebApi與系統進行互動,盡情期待。

相關推薦

ABP入門系列15——建立公眾模組

1. 引言 現在的網際網路已不在僅僅侷限於網頁應用,IOS、Android、平板、智慧家居等平臺正如火如荼的迅速發展,移動應用的需求也空前旺盛。所有的網際網路公司都不想錯過這一次移動浪潮,佈局移動市場分一份移動紅利。 的確,智慧手機作為我們日常生活已必不可少的一部分,通過手機app能夠獲得更好的體驗,比如

ABP入門系列4——建立應用服務

一、解釋下應用服務層 應用服務用於將領域(業務)邏輯暴露給展現層。展現層通過傳入DTO(資料傳輸物件)引數來呼叫應用服務,而應用服務通過領域物件來執行相應的業務邏輯並且將DTO返回給展現層。因此,展現層和領域層將被完全隔離開來。 以下幾點,在建立應用服務時需要注意: 在ABP中,一個應用服務需要實現IAp

nodekoa完成公眾自動回覆功能

首先需要在微信公眾平臺 - 基礎設定 - 設定伺服器地址 配置伺服器地址時可能出現“引數錯誤,。。。。”的情況,可能是因為域名被攔截,不能使用。 如果前端人員進行測試,可以使用ngrok,花生殼

ABP入門系列2——領域層建立實體

這一節我們主要和領域層打交道。首先我們要對ABP的體系結構以及從模板建立的解決方案進行一一對應。網上有程式碼生成器去簡化我們這一步的任務,但是不建議初學者去使用。 一、首先來看看ABP體系結構 領域層就是業務層,是一個專案的核心,所有業務規則都應該在領域層實現。 實體(Entity): 實體代表業務領域的

ABP入門系列1——通過模板建立MAP版本專案

一、從官網建立模板專案 依次按下圖選擇: 輸入驗證碼開始下載 下載提示: 二、啟動專案 使用VS2015開啟專案,還原Nuget包: 設定以Web結尾的專案,設定為啟動專案: 開啟Web.config,修改連線字串。(因為我本地裝的sqlserver是例項是.sqlexpress,所以需要

ABP入門系列12——如何升級Abp並除錯原始碼

1. 升級Abp 本系列教程是基於Abp V1.0版本,現在Abp版本已經升級至V1.4.2(截至至文章釋出時間),其中新增了New Feature,並對Abp做了相應的Enhancements,以及Bug fixs。現在我們就把它升級至最新版本,那如何升級呢? 下面就請按我的步驟來將Abp由V1.0升級

ABP入門系列16——通過webapi與系統進行互動

1. 引言 上一節我們講解了如何建立微信公眾號模組,這一節我們就繼續跟進,來講一講公眾號模組如何與系統進行互動。 微信公眾號模組作為一個獨立的web模組部署,要想與現有的【任務清單】進行互動,我們要想明白以下幾個問題: 如何進行互動? ABP模板專案中預設建立了webapi專案,其動態webapi技術允

ABP入門系列14——應用BootstrapTable表格外掛

1. 引言 之前的文章ABP入門系列(7)——分頁實現講解了如何進行分頁展示,但其分頁展示僅適用於前臺web分頁,在後臺管理系統中並不適用。後臺管理系統中的資料展示一般都是使用一些表格外掛來完成的。這一節我們就使用BootstrapTable進行舉例說明。 2. BootstrapTable 基於 B

ABP入門系列6——定義導航選單

完成了增刪改查以及頁面展示,這一節我們來為任務清單新增【導航選單】。 在以往的專案中,大家可能會手動在layout頁面中新增一個a標籤來新增導航選單,這也是一種方式,但是如果要針對不同使用者不同許可權決定是否顯示某個選單,那麼直接在layout頁面中去控制就不方便了。 不過,ABP已經為大家考慮了這一點,集

ABP入門系列8——Json格式化

講完了分頁功能,這一節我們先不急著實現新的功能。來簡要介紹下Abp中Json的用法。為什麼要在這一節講呢?當然是做鋪墊啊,後面的系列文章會經常和Json這個東西打交道。 一、Json是幹什麼的 JSON(JavaScript Object Notation) 是一種輕量級的資料交換格式。 易於人閱讀和編寫

ABP入門系列19——使用領域事件

1.引言 最近剛學習了下DDD中領域事件的理論知識,總的來說領域事件主要有兩個作用,一是解耦,二是使用領域事件進行事務的拆分,通過引入事件儲存,來實現資料的最終一致性。若想了解DDD中領域事件的概念,可參考DDD理論學習系列(9)-- 領域事件。 Abp中使用事件匯流排來實現領域事件,而關於事件匯流排的

ABP入門系列9——許可權管理

完成了簡單的增刪改查和分頁功能,是不是覺得少了點什麼? 是的,少了許可權管理。既然涉及到了許可權,那我們就細化下任務清單的功能點: 登入的使用者才能檢視任務清單 使用者可以無限建立任務並分配給自己,但只能對自己建立的任務進行查詢、修改 管理員可以建立任務並分配給他人 管理員具有刪除任務的許可權 從以上

ABP入門系列5——展現層實現增刪改查

這一章節將通過完善Controller、View、ViewModel,來實現展現層的增刪改查。最終實現效果如下圖: 一、定義Controller ABP對ASP.NET MVC Controllers進行了整合,通過引入Abp.Web.Mvc名稱空間,建立Controller繼承自AbpControlle

ABP入門系列18—— 使用領域服務

1.引言 自上次更新有一個多月了,發現越往下寫,越不知如何去寫。特別是當遇到DDD中一些概念術語的時候,尤其迷惑。如果只是簡單的去介紹如何去使用ABP,我只需參照官方文件,實現到任務清單Demo中去就可以了,不勞神不費力。但是,這樣就等於一知半解。 知之為知之,不知為不知,是知也。知其然知其所以然,方能舉

ABP入門系列11——編寫單元測試

1. 前言 In computer programming, unit testing is a software testing method by which individual units of source code, sets of one or more computer program

ABP入門系列3——領域層定義倉儲並實現

一、先來介紹下倉儲 倉儲(Repository): 倉儲用來操作資料庫進行資料存取。倉儲介面在領域層定義,而倉儲的實現類應該寫在基礎設施層。 在ABP中,倉儲類要實現IRepository介面,介面定義了常用的增刪改查以及聚合方法,其中包括同步及非同步方法。主要包括以下方法: ABP針對不同的ORM框架對

ABP入門系列13——Redis快取用起來

1. 引言 建立任務時我們需要指定分配給誰,Demo中我們使用一個下拉列表用來顯示當前系統的所有使用者,以供使用者選擇。我們每建立一個任務時都要去資料庫取一次使用者列表,然後繫結到使用者下拉列表顯示。如果就單單對一個demo來說,這樣實現也無可厚非,但是在正式專案中,顯然是不合理的,浪費程式效能,有待優化

ABP入門系列7——分頁實現

完成了任務清單的增刪改查,咱們來講一講必不可少的的分頁功能。 首先很慶幸ABP已經幫我們封裝了分頁實現,實在是貼心啊。 來來來,這一節咱們就來捋一捋如何使用ABP的進行分頁吧。 一、分頁請求DTO定義 資料傳輸物件(Data Transfer Objects)用於應用層和展現層的資料傳輸。 展現層傳入資料

ABP入門系列17——使用ABP整合的郵件系統傳送郵件

ABP中對郵件的封裝主要整合在Abp.Net.Mail和Abp.Net.Mail.Smtp名稱空間下,相應原始碼在此。 #一、Abp整合的郵件模組是如何實現的 分析可以看出主要由以下幾個核心類組成: EmailSettingNames:靜態常量類,主要定義了傳送郵件需要的相關引數:Port、Host、Us

vue 開發系列 企業整合

狀態 choose tin getent reset .post hal imp random 概述 手機端程序可以和企業微信進行整合,我們也可以使用企業微信JSSDK功能,實現一些原生的功能。 整合步驟 在整合之前需要閱讀 整合步驟。 http://work