[开源] FreeSql.Tools Razor 生成器
FreeSql 經過半年的開發和堅持維護,在 0.6.x 版本中完成了幾大重要事件:
1、按小包拆分,每個數據庫實現為單獨 dll;
2、實現 .net framework 4.5 支持;
3、同時支持 MySql.Data、MySqlConnector 的實現;
4、自定義導航屬性關系的配置;
5、配套工具 FreeSql.Tools 發布;
本文主要講解第5項,大主角往往在最后才出現!!!
在此之前一直被吐槽 FreeSql 臃腫,沒有小包開發理念。其實我是一點也不承認這種評價,雖然剛開發只有一個 FreeSql.dll,但是在開發和規劃上簡單了很多。
有一條開發原則講道:過早優化是惡夢!
大概意思是無論做什么項目,不要想著一開始就過度系統的、規范的執行。從外界來看是正規了,但是進度和穩定性會大大折扣。可以不信我,但是請一定要相信前人的總結啊!!!
從之前的一個 dll 到拆分成小包,我們總共耗時兩天,雖然都在一個項目內開發,但其實耦合性并不高。
車到山前必有路,時機到了自然會拆。這個時機也是奠定 FreeSql 走出了穩定關鍵的一步。這樣就會有更多人愿意加入 FreeSql 陣營。
各數據庫單獨包、延時加載包;
FreeSql.Extensions.LazyLoading
FreeSql.Provider.MySql
FreeSql.Provider.PostgreSQL
FreeSql.Provider.SqlServer
FreeSql.Provider.Sqlite
FreeSql.Provider.Oracle
早期 FreeSql 主要是在 .net core 最方便的 ORM!NETStandard 是新的標準,然而前段時間微軟又說 ..net5 將合并。。。變化真的太快。
在實現拆分小包后,其實 FreeSql 的模塊更加清淅,并且依賴項非常之少,然后比較容易的做出了 4.5 framework 的適配。
目前支持的版本:
| FreeSql.Provider.MySql | NETStandard2.0、net452 |
| FreeSql.Provider.PostgreSQL | NETStandard2.0、net45 |
| FreeSql.Provider.SqlServer | NETStandard2.0、net451 |
| FreeSql.Provider.Sqlite | NETStandard2.0、net45 |
| FreeSql.Provider.Oracle | NETStandard2.0、net45 |
| FreeSql.Extensions.LazyLoading | NETStandard2.0、net45 |
mysql 是一個神奇的流行數據庫,在 .net 陣營中使用量排名老二。mysql 的版本五花八門,從 5.6 開始有了不同的分支,分支的出現使得 ado.net 驅動不通用。
很多人不推薦使用 MySql.Data 官方驅動,但是 FreeSql 一直在使用官驅,并且支持了所有 5.6 類型,包括 enum/set 等。
然后就有一些人,特別是高手的那些來提出要求,適配一個 MySqlConnector 的實現,然后著名的 A大(茶叔)提了一道 PR ,創建了 FreeSql.Provider.MySqlConnector 項目,99.9999% 源碼和原來 FreeSql.Provider.MySql 相同,經過 266 個單元測試后發現,只需要兼容 enum/set 類型,參數化 ? @ 的處理就跑通了。然后就有了現在新的驅動包:
| FreeSql.Provider.MySqlConnector | NETStandard2.0、net45 |
然后 FreeSqlBuilder 使用反射決定使用哪個 mysql 驅動。代碼如下:
FreeSql 原先支持約定式導航關系配置,對于新項目開發無疑可約定,但是很多老項目命名不規范的就使用不了相關的功能。
有關約定配置可參考 github wiki 中心文檔
QQ 開發群真是個好平臺,在發起討論后,各位大佬都紛紛提出建議,最后以一票否決了各大建議,哈哈。。
主要從語法和用戶使用的感受上設計,還是那個理念:日式簡約!不能加入太多特性和功能,增加用戶的理解和使用成本。
最終效果如下:
[]
public virtual List<song_tag> Obj_song_tag { get; set; }
[]
public virtual song Obj_song { get; set; }
[]
public virtual tag Obj_tag { get; set; }
然后就能使用很多導航的騷操作功能了。
在此感謝這個工具的作者:mypeng1985,和參考者:movingsam
感謝有你們一幫熱心的使用者,幫助 FreeSql 生態添磚加瓦!!
FreeSql 在早期做過一套生成器模板,功能比較隱秘,一般人不知道如何使用。。之后就一直沉迷于 CodeFirst 的功能開發,無法自拔。
然后在10天前,突然感覺 FreeSql 多了好多使用者,這個時間當然需要有從數據庫生成實體的需求了!!
Q:沒必要搞這種東西了吧 市面上蠻多的,或者搞一套模板完全搞定了?
A:
無法100%類型兼容啊,因為 FreeSql 支持的類型真的深,然后市場上的類型映射做不到 100% 匹配;
為了挖掘更多功能,生成器還需要有導航屬性的支持,這是基本的,因為有導航屬性后,FreeSql 操作會騷許多;
本來我發起了一個純 winform 的生成器項目,界面都做好了如下:
是不是覺得很好看?我覺得好看。。。。其他人覺得丑。我在開發群發給大家看了之后,第二天 FreeSql.Tools 項目就搞出了新的界面,如下:
直接被秒殺了,這是來自作者:mypeng1985 的佳作。
界面看上去非常像 web,但其實不是的,仍然是一個 winform 程序,使用了 html 做界面,c# 做操作功能。
源碼地址:https://github.com/2881099/FreeSql.Tools
FreeSql 從 2018年11月28日立項,開發,到今天 0.6.x,單元測試 1600+,生態也逐漸完善,有得到許多網友的鼓勵和支持,感謝你們!感謝參與項目的你們!
原文地址:https://www.cnblogs.com/FreeSql/p/10975776.html
.NET社區新聞,深度好文,歡迎訪問公眾號文章匯總?http://www.csharpkit.com?
總結
以上是生活随笔為你收集整理的[开源] FreeSql.Tools Razor 生成器的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Asp.net core使用Mediat
- 下一篇: WebAssembly和Blazor:解