何鎮(zhèn)汐的技術(shù)博客

摘要： 本節(jié)介紹Util應(yīng)用框架如何操作緩存. 概述 緩存是提升性能的關(guān)鍵手段之一. 除了提升性能,緩存對系統(tǒng)健壯性和安全性也有影響. 不同類型的系統(tǒng)對緩存的依賴程度不同. 對于后臺管理系統(tǒng),由于是給管理人員使用的,用戶有限,而且操作基本都需要身份認(rèn)證和授權(quán),甚至可能部署在局域網(wǎng)內(nèi),一般僅對耗時操作使用緩存 閱讀全文

摘要： 本文是Util應(yīng)用框架日志記錄的第四篇,介紹安裝和寫入 Exceptionless 日志系統(tǒng)的配置方法. Exceptionless 是一個日志管理系統(tǒng),使用 Asp.Net Core 開發(fā),比 Seq 的模糊搜索能力弱,使用它可能需要一些技巧. Util應(yīng)用框架目前主要使用 Seq 和 Excep 閱讀全文

摘要： 本文是Util應(yīng)用框架日志記錄的第三篇,介紹安裝和寫入 Seq 日志系統(tǒng)的配置方法. 安裝 Seq Seq是一個日志管理系統(tǒng),對結(jié)構(gòu)化日志數(shù)據(jù)擁有強(qiáng)大的模糊搜索能力. Util應(yīng)用框架目前主要使用 Seq 和 Exceptionless 管理日志. 你可以從中選擇一個合適的. 本節(jié)介紹使用 Dock 閱讀全文

摘要： 本文是Util應(yīng)用框架日志記錄的第二篇,介紹寫入日志文件的配置方法. 概述 將日志寫入文本文件,不方便查看和管理,但在開發(fā)階段可以作為臨時查看日志的手段. 日志配置 引用Nuget包 Nuget包名: Util.Logging.Serilog AddSerilog 使用 AddSerilog 擴(kuò)展方 閱讀全文

摘要： 本文介紹Util應(yīng)用框架如何記錄日志. 日志記錄共分4篇,本文是正文,后續(xù)還有3篇分別介紹寫入不同日志接收器的安裝和配置方法. 概述 日志記錄對于了解系統(tǒng)執(zhí)行情況非常重要. Asp.Net Core 抽象了日志基礎(chǔ)架構(gòu),支持使用日志提供程序進(jìn)行擴(kuò)展,提供控制臺日志等簡單實現(xiàn). Serilog 是 . 閱讀全文

摘要： 本節(jié)介紹Util應(yīng)用框架如何處理系統(tǒng)錯誤. 概述 系統(tǒng)在運行過程中可能發(fā)生錯誤. 系統(tǒng)錯誤可以簡單分為兩類: 系統(tǒng)異常 系統(tǒng)本身出現(xiàn)的錯誤. 業(yè)務(wù)異常 不滿足業(yè)務(wù)規(guī)則出現(xiàn)的錯誤. 如何處理系統(tǒng)異常 如果發(fā)生系統(tǒng)異常,大多數(shù)情況下,你除了記錄異常日志外,可能無法處理它們. 一個例外是并發(fā)異常. 當(dāng)發(fā)生 閱讀全文

摘要： 本節(jié)介紹Util應(yīng)用框架如何進(jìn)行驗證. 概述 驗證是業(yè)務(wù)健壯性的基礎(chǔ). .Net 提供了一套稱為 DataAnnotations 數(shù)據(jù)注解的方法,可以對屬性進(jìn)行一些基本驗證,比如必填項驗證,長度驗證等. Util應(yīng)用框架使用標(biāo)準(zhǔn)的數(shù)據(jù)注解作為基礎(chǔ)驗證,并對自定義驗證進(jìn)行擴(kuò)展. 基礎(chǔ)用法 引用Nuge 閱讀全文

摘要： 本節(jié)介紹Util應(yīng)用框架對AspectCore AOP的使用. 概述 有些問題需要在系統(tǒng)中全局處理,比如記錄異常錯誤日志. 如果在每個出現(xiàn)問題的地方進(jìn)行處理,不僅費力,還可能產(chǎn)生大量冗余代碼,并打斷業(yè)務(wù)邏輯的編寫. 這類跨多個業(yè)務(wù)模塊的非功能需求,被稱為橫切關(guān)注點. 我們需要把橫切關(guān)注點集中管理起來 閱讀全文

摘要： 本節(jié)介紹Util應(yīng)用框架相似對象之間的轉(zhuǎn)換方法. 文章分為多個小節(jié),如果對設(shè)計原理不感興趣,只需閱讀基礎(chǔ)用法部分即可. 概述 現(xiàn)代化分層架構(gòu),普遍采用了構(gòu)造塊DTO(數(shù)據(jù)傳輸對象). DTO是一種參數(shù)對象,當(dāng)Web API接收到請求,請求參數(shù)被裝載到DTO對象中. 我們需要把 DTO 對象轉(zhuǎn)換成實體 閱讀全文

摘要： 本節(jié)介紹Util應(yīng)用框架依賴注入的使用和配置擴(kuò)展. 文章分為多個小節(jié),如果對設(shè)計原理不感興趣,只需閱讀基礎(chǔ)用法部分即可. 概述 當(dāng)你想調(diào)用某個服務(wù)的方法完成特定功能時,首先需要得到這個服務(wù)的實例. 最簡單的辦法是直接 new 一個服務(wù)實例,不過這樣就把服務(wù)的實現(xiàn)牢牢綁死了,當(dāng)你需要更換實現(xiàn),除了直接 閱讀全文

摘要： 本節(jié)介紹服務(wù)注冊器的開發(fā). 如果你不需要擴(kuò)展Util應(yīng)用框架,直接跳過. 當(dāng)你把某些功能封裝到自己的類庫,并希望啟動時自動執(zhí)行初始化代碼進(jìn)行配置時,定義服務(wù)注冊器. 服務(wù)注冊器概述 服務(wù)注冊器是Util項目啟動時自動執(zhí)行的代碼塊. Util應(yīng)用框架的某些類庫使用服務(wù)注冊器進(jìn)行配置,比如 Util.O 閱讀全文

摘要： 本節(jié)介紹 Util 項目啟動初始化過程. 文章分為多個小節(jié),如果對設(shè)計原理不感興趣,只需閱讀基礎(chǔ)用法部分即可. 基礎(chǔ)用法 查看 Util 服務(wù)配置,范例: var builder = WebApplication.CreateBuilder( args ); builder.AsBuild() .A 閱讀全文

摘要： 本文介紹在項目中如何配置 Util 依賴服務(wù). 文章分為多個小節(jié),如果對設(shè)計原理不感興趣,只需要閱讀基礎(chǔ)用法部分即可. 基礎(chǔ)用法 Asp.Net Core 項目服務(wù)配置 調(diào)用 WebApplicationBuilder 實例的 AsBuild 方法, 并以鏈?zhǔn)秸{(diào)用Util服務(wù)擴(kuò)展. 范例 var b 閱讀全文

摘要： 本文將引導(dǎo)你運行Util權(quán)限管理模塊,并對UI按鈕和API操作進(jìn)行訪問控制. Util平臺介紹 Util應(yīng)用框架是一組類庫,它們提供了有用的功能. 雖然Util配套代碼生成器能夠幫助你創(chuàng)建項目基架,但直接使用它們的成本依然高昂. 第一個擋在前面的障礙是權(quán)限功能,它是任何業(yè)務(wù)項目的基石. 為了減輕使用 閱讀全文

摘要： 本文演示Util應(yīng)用框架開發(fā)的項目中如何編寫集成測試. 準(zhǔn)備 完成 Web Api 快速入門,本文將在之前生成的示例項目上講解集成測試的開發(fā). 測試概述 自動化測試對于Util應(yīng)用框架的開發(fā)非常重要,它能保證基礎(chǔ)功能的穩(wěn)定性. 對于使用 Util 開發(fā)的業(yè)務(wù)項目,自動化測試不是必須的,但掌握它可能很 閱讀全文

摘要： 本文是Util應(yīng)用框架 Angular UI 開發(fā)快速入門教程. Util前端技術(shù)概述 Util 應(yīng)用框架目前僅支持用于開發(fā)管理后臺的 UI. 本文介紹了 Util UI 的技術(shù)特點和功能支持. UI 技術(shù)選型 Js語言 TypeScript TypeScript 是 微軟開發(fā)的腳本語言, 擴(kuò)展了弱 閱讀全文

摘要： 本文是使用Util應(yīng)用框架開發(fā) Web Api 項目快速入門教程. 前面已經(jīng)詳細(xì)介紹了環(huán)境搭建,如果你還未準(zhǔn)備好,請參考前文. 開發(fā)流程概述 創(chuàng)建代碼生成專用數(shù)據(jù)庫. Util應(yīng)用框架需要專門用來生成代碼的數(shù)據(jù)庫,該數(shù)據(jù)庫僅用于代碼生成. 約定: 代碼生成數(shù)據(jù)庫應(yīng)以 .Generator 結(jié)尾. 當(dāng) 閱讀全文

摘要： 要使用Util應(yīng)用框架開發(fā)項目,首先需要搭建合適的開發(fā)環(huán)境. 邁出第一步,對于很多.Net新人可能并不簡單. 如果你對.Net環(huán)境并不熟悉,請盡量按照本文檔進(jìn)行操作. 操作系統(tǒng) 請安裝 Windows 10 以上版本操作系統(tǒng). 你也可以使用MAC操作系統(tǒng),但需要自行解決開發(fā)環(huán)境問題. 安裝 Visu 閱讀全文

摘要： 前面介紹了Util是如何封裝以降低Angular應(yīng)用的開發(fā)成本。 現(xiàn)在把關(guān)注點移到服務(wù)端，本文將介紹分層架構(gòu)各構(gòu)造塊及基類，并對不同層次的開發(fā)人員應(yīng)如何進(jìn)行業(yè)務(wù)開發(fā)提供一些建議。 Util分層架構(gòu)介紹 為了控制業(yè)務(wù)邏輯復(fù)雜性，Util引入了DDD分層架構(gòu)，這意味著如果你想使用DDD，Util會為你提 閱讀全文

摘要： 上篇簡要介紹了Util在Angular Ts方面的封裝情況，本文介紹Angular封裝的另一個部分，即Html的封裝。 標(biāo)準(zhǔn)組件與業(yè)務(wù)組件 對于管理后臺這樣的表單系統(tǒng)，你通常會使用Angular Material或Ng-Zorro這樣的UI組件庫，它們提供了標(biāo)準(zhǔn)化的UI組件。 標(biāo)準(zhǔn)組件將Ts封裝起來 閱讀全文

摘要： 上篇介紹了Util Angular Demo的目錄結(jié)構(gòu)和運行機(jī)制，本文介紹Util封裝Angular的基本手法及背后的動機(jī)。 Angular應(yīng)用由Ts和Html兩部分構(gòu)成，本文介紹第一部分。 Angular Ts的封裝 Ts是Angular的代碼部分，用于編寫頁面邏輯。 依賴注入( Dependen 閱讀全文

摘要： 上篇介紹了Util的開發(fā)環(huán)境，并讓你把Demo運行起來。本文將介紹該Demo的前端Angular運行機(jī)制以及目錄結(jié)構(gòu)。 目錄結(jié)構(gòu) 在VS上打開Util Demo，會看見如下的目錄結(jié)構(gòu)。 現(xiàn)代前端通常采用VS Code開發(fā)，不過我們?yōu)榱耸褂肨agHelper，需要采用VS開發(fā)，這為你提供了更多的選擇。 閱讀全文

摘要： Util的開源地址 https://github.com/dotnetcore/util Util的開源協(xié)議 Util以MIT協(xié)議開源，這是目前最寬松的開源協(xié)議，你不僅可以用于商業(yè)項目，還能把Util的代碼放進(jìn)你的框架，放心使用。 Util的命名 Util這個名字看上去不怎么高大上，很多人勸我換個霸 閱讀全文

摘要： 距離上次發(fā)文，已經(jīng)過去了三年半，這幾年技術(shù)更新節(jié)奏異常迅猛，.Net進(jìn)入了跨平臺時代，前端也被革命性的顛覆。 回顧 2015年，正當(dāng)我還沉迷于JQuery + EasyUi的封裝時，突然意識到技術(shù)已經(jīng)過時。 JQuery在面對更加復(fù)雜的UI需求時顯得力不從心，EasyUi雖然組件比較完善，但界面風(fēng)格 閱讀全文

摘要： 進(jìn)行項目開發(fā)的第一步，是創(chuàng)建出適合自己團(tuán)隊習(xí)慣的VS解決方案，雖然我已經(jīng)提供了項目示例，但畢竟是我創(chuàng)建的，你直接使用可能并不合適，另外你如果嘗試模仿重新創(chuàng)建該示例，中間可能碰到各種障礙，特別是項目間的依賴關(guān)系。 本文的目的是幫助.Net架構(gòu)初學(xué)者能順利搭建起適合自己的VS解決方案，我會在本文演... 閱讀全文

摘要： 離上一篇又過去了一個月，時間比較緊，后續(xù)估計會更緊，所以這次將放出更多公共操作類及配套的CodeSmith模板，本篇將簡要介紹新放出的重要功能，供有興趣的同學(xué)參考。重要更新 這一次對兩個VS解決方案均做了大量調(diào)整，包含項目結(jié)構(gòu)及命名空間。 Util解決方案的目錄截圖如下。 除了少數(shù)需要配置... 閱讀全文

摘要： 從本篇開始，本系列將進(jìn)入實戰(zhàn)演練階段。 前面主要介紹了一些應(yīng)用程序框架的概念和基類，本來想把所有概念介紹完，再把框架內(nèi)部實現(xiàn)都講完了，再進(jìn)入實戰(zhàn)，這樣可以讓初學(xué)者基礎(chǔ)牢靠。不過我的精力很有限，文章進(jìn)度越來越慢，所以準(zhǔn)備切換一下介紹順序，把實戰(zhàn)演練提前，以方便你閱讀代碼。實戰(zhàn)演練介紹 本系列實... 閱讀全文

摘要： 上一篇介紹了我對幾種實體的認(rèn)識，本篇將介紹幾種服務(wù)的用法。 預(yù)告一下本系列后續(xù)計劃，本篇之后，準(zhǔn)備進(jìn)入實戰(zhàn)演練階段，先介紹如何快速解決CRUD操作，從如何使用PD數(shù)據(jù)建模到使用CodeSmith生成代碼，先帶你感受一下，再回過來介紹框架內(nèi)部元素，以免你在閱讀時昏昏欲睡。應(yīng)用服務(wù)介紹 對于一個... 閱讀全文

摘要： 本文將介紹DDD分層架構(gòu)中廣泛使用的數(shù)據(jù)傳輸對象Dto，并且與領(lǐng)域?qū)嶓wEntity，查詢實體QueryObject，視圖實體ViewModel等幾種實體進(jìn)行比較。領(lǐng)域?qū)嶓w為何不能一統(tǒng)江湖？ 當(dāng)你閱讀我或其它博主提供的示例代碼時，會發(fā)現(xiàn)幾種類型的實體，這幾種實體初步看上去區(qū)別不大，只是名稱不同，... 閱讀全文

摘要： 最近的更新速度越來越慢，主要是項目上比較忙，封裝EasyUi也要花很多時間。不過大家請放心，本系列不會半途夭折，并且代碼干貨也會持續(xù)更新。本文繼續(xù)介紹表現(xiàn)層和Asp.net Mvc，我將在本篇討論一些重要的設(shè)計問題和封裝技巧。是否需要將控制器分離為獨立項目 經(jīng)常有人問我，是否有必要將控制器從W... 閱讀全文

摘要： 本文將介紹表現(xiàn)層及ASP.NET MVC的一些要點，特別是ASP.NET MVC的一些抽象和封裝技巧，如果你對MVC還不了解，可以參考《ASP.NET MVC4 高級編程》，作者Jon Galloway等，這本書由ASP.NET MVC團(tuán)隊成員編寫，相當(dāng)不錯。表現(xiàn)層的職責(zé) 表現(xiàn)層的職責(zé)是展示和... 閱讀全文

摘要： 上文介紹了我選擇EasyUi作為前端框架的原因，并發(fā)放了最新Demo。本文將對這個Demo進(jìn)行一些介紹，以方便你能夠順利運行起來。 這個Demo運行起來以后，是EasyUi的一個簡單CRUD操作，數(shù)據(jù)庫中也只有一個簡單的表，整個操作不帶任何業(yè)務(wù)邏輯。 看到這里，不少朋友難免感到失望，搞這么復(fù)... 閱讀全文

摘要： 對于BS管理系統(tǒng)，我很長一段時間都工作在Asp.Net Web Form上，Web Form的主要優(yōu)勢是可以使用服務(wù)器端控件，以類似CS的開發(fā)模式進(jìn)行工作，通過拖拽控件和定義事件處理函數(shù)，極大的簡化了BS的開發(fā)。服務(wù)器端控件會在渲染階段把自身輸出為Html標(biāo)簽，對我們完全透明，當(dāng)需要設(shè)置相關(guān)屬性... 閱讀全文

摘要： 今天在開發(fā)一個簡單查詢時，發(fā)現(xiàn)我的Lambda操作類的GetValue方法無法正確獲取枚舉類型值，以至查詢結(jié)果錯誤。 我增加了幾個單元測試來捕獲錯誤，代碼如下。 /// /// 測試值為枚舉 /// [TestMethod] ... 閱讀全文

摘要： 信息系統(tǒng)的查詢需求千變?nèi)f化，在倉儲中為每個查詢需求創(chuàng)建一個特殊方法，將導(dǎo)致大量乏味而臃腫的接口。 一種更加可行的辦法是，在應(yīng)用層服務(wù)中描述查詢需求，并通過倉儲執(zhí)行查詢。 為了能夠更好的描述查詢需求，可以將查詢功能從倉儲中抽取出來，專門創(chuàng)建一個查詢對象。 查詢最復(fù)雜的部分是條件過濾，這也是查... 閱讀全文

摘要： 前面已經(jīng)做了一些準(zhǔn)備工作，本篇將介紹查詢條件的封裝，它是規(guī)約模式的一個應(yīng)用。 規(guī)約使用一個對象來封裝謂詞，我之前已經(jīng)介紹過它在驗證方面的應(yīng)用，本篇是規(guī)約模式在查詢方面的應(yīng)用。 規(guī)約的強(qiáng)大之處在于，能夠?qū)⒁欢央s亂無章的條件判斷或查詢條件封裝起來，以一個清晰的概念來表達(dá)，并使得這些謂詞具備了可復(fù)... 閱讀全文

摘要： 本篇介紹的表達(dá)式生成器，用于動態(tài)創(chuàng)建表達(dá)式。 在Util項目Lambdas目錄中，添加ExpressionBuilder，代碼如下。using System;using System.Linq.Expressions;namespace Util.Lambdas { /// //... 閱讀全文

摘要： 當(dāng)你使用可空的值類型時，你會發(fā)現(xiàn)取值很不方便，比如Guid? obj，你要從obj中獲取值，可以使用Value屬性obj. Value，但obj可能為null，這時候就會拋出一個異常。 可空值類型提供了一個HasValue屬性，它可以識別出obj是不是一個null值，每當(dāng)你獲取可空值都需要加上... 閱讀全文