無論是開發app還是網站，可能都需要一個廣告功能，比如我們常見的在首頁有個輪播廣告，里面會輪播顯示多個圖片，還有比如一個新聞門戶網站 很常見的 banner橫幅廣告，還有js特效廣告等，本篇說說在abp(5.9)中如何實作廣告模塊，
原始碼地址：https://gitee.com/bxjg1987/abp 基于abp一代5.9版
在線演示：http://git.weilaikj.cn/ 賬號密碼 admin 123qwe
廣告位
它代表某個頁面上，某個位置，比如：首頁頂部用來放輪播廣告那個位置，再比如：新聞串列頁右側廣告位，廣告位有個名字屬性，還有尺寸相關的屬性
廣告控制元件
它是在頁面用來展示廣告的頁面組件定義，比如：圖片輪播控制元件，再比如：靜態圖片展示控制元件，
這里的控制元件只是定義某個控制元件，在資料庫表中就是一條記錄，定義了控制元件名、控制元件型別（輪播、靜態圖、普通文本）、控制元件引數等屬性，前端可以根據這些資料來定義界面，因為可能有不同的前端，就算同樣是pc網站前端，我也無法限制你將來用什么樣的形式來展現一個輪播圖片的控制元件，所以我只能把后臺定義的輪播圖片控制元件的相關引數給你，至于如何使用這些引數來顯示輪播控制元件，只能由你來實作了，
廣告
它就表示一個廣告，這就代表廣告主將來要投放的廣告，比如客戶提供的一張圖片，它有廣告標題、廣告型別（是圖片？文本？一段html？一段js？）廣告內容（比如是圖片型別廣告，則它存盤圖片的url）、URL（點擊廣告時要跳轉到哪去）
廣告發布記錄
它是上面3個概念的多對多關系的建立，它是一條廣告發布記錄，什么時候，發布哪個廣告，使用什么樣的控制元件，發布到哪幾個廣告位，如：有個圖片廣告 要顯示到 首頁輪播控制元件中，同時顯示到新聞串列頁右側，用靜態圖片廣告控制元件展示
廣告 與 廣告發布記錄 合并
目前沒有這樣處理，不過可以說說思路，廣告、廣告位、廣告控制元件，最后通過廣告發布記錄將它們多對多關聯，這樣的設計非常靈活，但是也相對復雜，可以考慮將廣告和廣告發布記錄合并，這樣就沒那么靈活了，比如同一個廣告要同時發布到多個廣告位（首頁和串列頁和內容頁，甚至是多個欄目的不同位置都有同時顯示某個廣告），或者同一個廣告要用不同的控制元件展示時，合并這倆概念要實作前面說的這種需求，就需要將同一個廣告多次發布，其實本質上就是兩個廣告，只是廣告內容一樣
cms模塊中的廣告原始碼簡述
首先在CMS/BXJG.CMS.Core/Ad中建立上面各概念對應的物體類：廣告位(AdPositionEntity)、廣告控制元件(AdControlEntity)、廣告(AdEntity)、廣告發布記錄(AdRecordEntity)等物體
然后在CMS/BXJG.CMS.EFCore/EFMaps中建立相應的ef映射檔案 xxMap.cs
然后在CMS/BXJG.CMS.Application/Ad中建立應用服務介面及實作，當然還有對應的dto物件，這里需要注意，系統管理員需要在管理后臺對廣告進行管理，比如定義廣告位、對廣告的增、刪、改、查、發布、撤銷等操作，網站或app或小程式前臺展示廣告時則是不需要用戶登錄的，匿名用戶應該也可以看到這些廣告，所以這里將 分別定義后臺和前端對廣告的處理對應的介面，而不是定義在同一個介面中，具體來說IBXJGCMSFrontAdRecordAppService是專門給前端用的介面，里面只包含對廣告的查詢功能，IBXJGCMSAdAppService則是給后臺對廣告進行管理的介面，里面包含對廣告的增、刪、改、查、發布撤銷等，不過寫文章時此介面和實作還沒有做，
下面按abp的套路定義權限和選單
到此cms模塊中的廣告功能基本定義完成，
如何集成到主程式
上面大致說了下cms模塊中的廣告功能相關原始碼，在我們的專案中模塊與主程式盡量獨立，CMS是我們定義的一個內容管理模塊，廣告只是下面一個功能，原始碼中的ZLJ.XXX是我們的主程式，這個主程式會來集成不同的模塊，廣告模塊就是其中之一，你也可以在你的abp專案中來單獨引入這個廣告模塊，只是目前這個模塊沒有發布成nuget包，
下面說說如何在我們主程式中使用cms模塊中的廣告功能
在ZLJ.EntityFrameworkCore/EntityFrameworkCore/ZLJDbContext中定義廣告相關物體的 DbSet
public virtual DbSet<AdEntity> BXJGCMSAds { get; set; } public virtual DbSet<AdControlEntity> BXJGCMSAdControls { get; set; } public virtual DbSet<AdPositionEntity> BXJGCMSAdPositions { get; set; } public virtual DbSet<AdRecordEntity> BXJGCMSAdRecords { get; set; }
此時進入api頁面可以看到廣告服務介面https://git.weilaikj.cn/swagger/index.html，可以測驗了，（打開頁面，Ctrl + F搜索"BXJGCMSFrontAdRecord"）
在主程式中集成模塊時，手動在主程式的DbContext中定義DbSet比較繁瑣，網上有動態向DbContext加入DbSet的方法，著名的微信庫Senparc的SCF應該就是那種方式，不過我還不會，還有一個原因，有時候我們需要主程式在集成模塊注冊DbSet時提供物體泛型引數，手動方式最直觀，（動態DbSet應該也可以指定物體泛型引數）
由于廣告模塊足夠簡單，它不需要參考主程式的某些概念，也沒有考慮給模塊呼叫方提供擴展廣告、廣告位、廣告控制元件等的能力，因此在主程式集成廣告功能就很簡單，如果將來考慮允許模塊呼叫方通過繼承的方式，來為廣告添加更多自定義屬性，可以考慮在廣告相關的應用服務中，將廣告（AdEntity）變成泛型的，將來由模塊呼叫方來提供一個繼承至AdEntity的子類
另一種情況是模塊內部需要參考主程式的提供的一些概念時，比如 AdEntity中需要參考主程式中的XXX類，作為導航屬性，那么AdEntity本身就需要定義成泛型的AdEntity<xxx>，這樣模塊內部就不要直接依賴主程式的某個類，而是由將來主程式呼叫時指定
這里說的兩種情況后續會專門寫一篇來介紹，目前shop檔案夾中相關原始碼已有體現，
前端處理
通過IBXJGCMSFrontAdRecordAppService介面，前端頁面可以獲取當前發布的廣告資訊，里面包含了廣告位、廣告控制元件、廣告、發布相關屬性，前端可以根據這些資料自由控制前端廣告的展示，這部分功能模塊沒有也很難提供，
結束
這里簡單介紹了下專案中設計的abp cms模塊中的廣告功能，這個設計參考了部分cms系統，目前只有個骨架，后續會逐步完善，目前專案中類似的模塊還有幾個，沒來得及寫說明，后續再補充吧，希望找到熱愛abp的朋友，一個做模塊，互相分享，因為我們可能在做一樣的功能，沒必要重復勞動，
目前的目標是開發常用，簡單、實用，不考慮擴展性的模塊，將來逐步實作擴展性
轉載請註明出處，本文鏈接：https://www.uj5u.com/net/13556.html
標籤：.NET Core