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包,點選確定安裝即可。
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包。
那怎樣指定依賴呢,只需要通過[DependsOn]特性指定即可。
[DependsOn(typeof(AbpWebApiModule))]
public class LearningMpaAbpWeixinModule:AbpModule
{
//....
}
好了,一個微信公眾號模組的基礎專案框架搭好了,是不是很簡單!
到這一步,你可能會問,你這只是簡單建立微信公眾號模組,但如何與我們Demo進行整合互動呢?
對的,是隻簡單建立了微信模組,但這一節我不打算講如何與Demo進行整合互動。因為在介紹如何通過webapi與系統互動之前,梳理下Abp模組化的設計,更能幫助我們瞭解模組化設計思想。
下面我們就簡單梳理下ABP模組化的設計。
3. ABP模組化設計
說到模組,突然想到幾個單詞考考大家,model、modal、module分別是什麼意思?
不知道的就自行查詞典吧。
下面迴歸正題。
3.1. 模組化相關型別
先來看看模組相關型別依賴圖:
從型別依賴圖中可以看出設計的並不複雜:
- 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_Start
和Application_End
虛方法。
Application_Start
方法中呼叫了AbpBootstrapper.Initialize()
方法。相當於AbpBootstrapper.Create<TStartupModule>().Initialize();
程式碼是不是看累了,上圖,咱們直接來看web專案啟動時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
node(koa)完成微信公眾號自動回覆功能
首先需要在微信公眾平臺 - 基礎設定 - 設定伺服器地址 配置伺服器地址時可能出現“引數錯誤,。。。。”的情況,可能是因為域名被攔截,不能使用。 如果前端人員進行測試,可以使用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