前言
FreeSql 目前版本號 0.5.5，預計明年元旦發布 1.0.0，切莫小看了版本號，目前單元測試方法1350+，並且每個方法內的涵蓋面又比較廣（不信的話見下圖），每一次版本發布都作了較多的測試工作。
最近的一段時間，關注我們的人時不時會看見擴展包發布，今天振奮人心的功能主要是核心部分實現（擴展包今天當配角）。就不多啰嗦了，咱們直接入主題。
功能一：MapType 類型映射
使用 codefirst 時序列化 json 或 jsonb 數據類型報錯
使用 postgresql + ef 配置數據映射關系，使用 FreeSql 的映射擴展時，對於json類型的數據映射出錯。
這是來自 github 上的某個 issue，原因是用戶的實體定義了 string，數據庫類型為 json。FreeSql 本身支持了豐富的類型，不限於 json，但是限定了類型的映射，比如 JToken/JObject/JArray 的實體類型才可以映射至 PostgreSQL 數據庫的 json 類型。另外雖然有 DbType 特性可以設置，但使用范圍有限，不可跨越類型（如使用 string 可使用 DbType="char(100)"）。
還有類似的，如：將 enum 映射到數據庫 varchar 的請求。。。。
到現在，我們已經徹底突破了這個障礙，基本可以做到隨意映射類型。作為新項目開發，我們提供本身的默認類型映射已經非常人性化，提這些需求的人主要還是歷史原因，咱們做程序維護工作的人員還是占比很高，千怪萬怪只能怪 FreeSql 來得太遲。。。。
目前為 MapType 功能增加了大約 400 個單元測試方法。貼一段 demo 配置方法：
class EnumTestMap {
public Guid id { get; set; }
[Column(MapType = typeof(string))]
public ToStringMapEnum enum_to_string { get; set; }
[Column(MapType = typeof(string))]
public ToStringMapEnum? enumnullable_to_string { get; set; }
[Column(MapType = typeof(int))]
public ToStringMapEnum enum_to_int { get; set; }
[Column(MapType = typeof(int?))]
public ToStringMapEnum? enumnullable_to_int { get; set; }
[Column(MapType = typeof(string))]
public BigInteger biginteger_to_string { get; set; }
[Column(MapType = typeof(string))]
public BigInteger? bigintegernullable_to_string { get; set; }
}
public enum ToStringMapEnum { 中國人, abc, 香港 }
應該不需要解釋了吧？
細看一下，實體內有 BigInteger 類型，這可是數據庫無法表示的類型，現在就是可以使用（沒轍）。但請注意：BigInteger 僅僅是 CURD 方便， Equals == 判斷可以使用，無法使用 + - * / < > 等操作；
默認映射
| csharp | MySql | SqlServer | PostgreSQL | Oracle | Sqlite |
|---|---|---|---|---|---|
| bool, bool? | bit(1) | bit | bool | number(1) | boolean |
| sbyte, sbyte? | tinyint(3) | smallint | int2 | number(4) | smallint |
| short, short? | smallint(6) | smallint | int2 | number(6) | smallint |
| int, int? | int(11) | int | int4 | number(11) | integer |
| long, long? | bigint(20) | bigint | int8 | number(21) | integer |
| byte, byte? | tinyint(3) unsigned | tinyint | int2 | number(3) | int2 |
| ushort, ushort? | smallint(5) unsigned | int | int4 | number(5) | unsigned |
| uint, uint? | int(10) unsigned | bigint | int8 | number(10) | decimal(10,0) |
| ulong, ulong? | bigint(20) unsigned | decimal(20,0) | numeric(20,0) | number(20) | decimal(21,0) |
| double, double? | double | float | float8 | float(126) | double |
| float, float? | float | real | float4 | float(63) | float |
| decimal, decimal? | decimal(10,2) | decimal(10,2) | numeric(10,2) | number(10,2) | decimal(10,2) |
| Guid, Guid? | char(36) | uniqueidentifier | uuid | char(36 CHAR) | character(36) |
| TimeSpan, TimeSpan? | time | time | time | interval day(2) to second(6) | bigint |
| DateTime, DateTime? | datetime | datetime | timestamp | timestamp(6) | datetime |
| DateTimeOffset DateTimeOffset? |
- | - | datetimeoffset | timestamp(6) with local time zone | - |
| Enum, Enum? | enum | int | int4 | number(16) | mediumint |
| FlagsEnum, FlagsEnum? | set | bigint | int8 | number(32) | bigint |
| byte[] | varbinary(255) | varbinary(255) | bytea | blob | blob |
| string | varchar(255) | nvarchar(255) | varchar(255) | nvarchar2(255) | nvarchar(255) |
| MygisPoint | point | - | - | - | - |
| MygisLineString | linestring | - | - | - | - |
| MygisPolygon | polygon | - | - | - | - |
| MygisMultiPoint | multipoint | - | - | - | - |
| MygisMultiLineString | multilinestring | - | - | - | - |
| MygisMultiPolygon | multipolygon | - | - | - | - |
| BitArray | - | - | varbit(64) | - | - |
| NpgsqlPoint NpgsqlPoint? |
- | - | point | - | - |
| NpgsqlLine NpgsqlLine? |
- | - | line | - | - |
| NpgsqlLSeg NpgsqlLSeg? |
- | - | lseg | - | - |
| NpgsqlBox NpgsqlBox? |
- | - | box | - | - |
| NpgsqlPath NpgsqlPath? |
- | - | path | - | - |
| NpgsqlPolygon NpgsqlPolygon? |
- | - | polygon | - | - |
| NpgsqlCircle NpgsqlCircle? |
- | - | circle | - | - |
| (IPAddress, int) (IPAddress, int)? |
- | - | cidr | - | - |
| IPAddress | - | - | inet | - | - |
| PhysicalAddress | - | - | macaddr | - | - |
| NpgsqlRange<int> NpgsqlRange<int>? |
- | - | int4range | - | - |
| NpgsqlRange<long> NpgsqlRange<long>? |
- | - | int8range | - | - |
| NpgsqlRange<decimal> NpgsqlRange<decimal>? |
- | - | numrange | - | - |
| NpgsqlRange<DateTime> NpgsqlRange<DateTime>? |
- | - | tsrange | - | - |
| PostgisPoint | - | - | geometry | - | - |
| PostgisLineString | - | - | geometry | - | - |
| PostgisPolygon | - | - | geometry | - | - |
| PostgisMultiPoint | - | - | geometry | - | - |
| PostgisMultiLineString | - | - | geometry | - | - |
| PostgisMultiPolygon | - | - | geometry | - | - |
| PostgisGeometry | - | - | geometry | - | - |
| PostgisGeometryCollection | - | - | geometry | - | - |
| Dictionary<string, string> | - | - | hstore | - | - |
| JToken | - | - | jsonb | - | - |
| JObject | - | - | jsonb | - | - |
| JArray | - | - | jsonb | - | - |
| 數組 | - | - | 以上所有類型都支持 | - | - |
以上類型和長度是默認值，可手工設置，如 string 屬性可指定 [Column(DbType = "varchar(max)")]
功能二：唯一鍵(Unique)
class AddUniquesInfo {
public Guid id { get; set; }
[Column(Unique = "uk_phone")]
public string phone { get; set; }
[Column(Unique = "uk_group_index")]
public string group { get; set; }
[Column(Unique = "uk_group_index")]
public int index { get; set; }
[Column(Unique = "uk_group_index222")]
public string index22 { get; set; }
}
Unique 指定相同的標識，代表聯合唯一鍵，現已支持遷移。
功能三：弱類型(實體)
之前在操作實體時，必須傳統泛型參數，現在可以實現弱類型實體的操作。以 Repository 為例：
var repos = fsql.GetGuidRepository<object>();
repos.AsType(typeof(AddUpdateInfo));
var item = new AddUpdateInfo();
repos.Insert(item);
item.Clicks += 1;
repos.InsertOrUpdate(item);
var item2 = repos.Find(item.Id) as AddUpdateInfo;
Assert.Equal(item.Clicks, item2.Clicks);
repos.DataFilter.Apply("xxx", a => (a as AddUpdateInfo).Clicks == 11);
Assert.Null(repos.Find(item.Id));
然后呢，DbContext 也支持同樣的操作。
dotnet add package FreeSql.DbContext
功能四：ToList & Mapper
現在支持 ToList(a => new Dto()) 這樣的簡單數據映射。
什么意思？即 Dto 只要有屬性名與實體屬性相同，就會根據匹配到的字段查詢（不是查詢所有字段回來再映射）。
然后這個騷操作，還支持多表查詢的映射，怎么解決多表存在相同名字的字段問題呢？優先級規則，它會依次序匹配 LeftJoin/InnerJoin/RightJoin 的實體。
功能五：ToList 貪婪加載
以前 .ToList() 會加載兩級Join對象；
現在 ISelect.ToList(includeNestedMembers: true) 貪婪加載所有 LeftJoin/InnerJoin/RightJoin 導航數據，不論對象的層級；
功能六：WhereDynamic 動態條件
支持傳入動態對象如：主鍵值 | new[]{主鍵值1,主鍵值2} | TEntity1 | new[]{TEntity1,TEntity2} | new{id=1}。
也就是說 WhereDynaimc 方法輸入類型為 object，是不是很方便？還支持聯合主鍵呢。
功能七：IAdo.Query 多個結果集
var result = fsql.Ado.Query<T1, T2>("select * from t1; select * from t2");
功能八：開發環境之利器：MVC 中間件 FreeSql.AdminLTE
大約是前一段時間的某一天（廢話），因為使用 FreeSql 的某項目需要做一個簡單的后台功能，以便錄入或管理數據。在實施的過程中好懷念當初 dotnetGen 生成器的味道，用它產生 curd 基本功能幾乎是秒做；
FreeSql.AdminLTE，是的就是它，前段時間發布過一次。
它是 FreeSql 衍生出來的 .NETCore MVC 中間件、中間件、中間件（重復三遍）擴展包，基於 AdminLTE 前端框架動態產生實體的增刪查改界面；
輸入：實體1、實體2、實體3
輸出：后台管理的功能
只需要傳入實體，就可以形成 curd 的管理功能，是不是有些騷啊~~~
先發一張運行后的圖片嘗個鮮：
這是根據實體產生 curd 界面的 mvc 中間件，開發時預覽數據好方便啊。看完預覽圖不由得再感嘆一次 FreeSql 的易用性，那句口號：做 .NETCore 最方便的 ORM！ 沒有說錯。。。作者多次提及：“我們是日式簡約風格，沒那么復雜的用法”，也驗證了這一點。。
添加/修改
中件間產生的界面包括添加、修改數據的功能，普通實體的根據屬性的類型與 Html5 UI 一一映射；
比較特殊的映射規則：
| c# 類型 | Html5 |
|---|---|
| 布爾 | 復選框 |
| 枚舉 | 下拉選擇 |
| 日期 | 日期控件 |
| ManyToOne 導航屬性 | 下拉選擇 |
| ManyToMany 導航屬性 | 多選器 |
等等。。。
什么情況會產生【上傳文件】控件？
有興趣的可以了解源碼，目前沒有開放在外部配置。
查詢/過濾
中件間為每個實體提供了分頁列表查詢，每頁為20條數據；
除此外，還提供了過濾條件的支持，規則是根據導航屬性（ManyToOne、ManyToMany）。比如【文章實體】，內含有【分類id】+【分類對象】，則【文章】列表頁會出現按【分類】篩選的UI，詳見上面的 demo 示意圖，或者下載對應的 demo 版本運行；
刪除
中件間為每個實體提供了批量刪除的功能；
測試 demo
我們習慣用 sqlite 做測試庫，測試完畢直接刪除目錄，不留垃圾數據，所以下面的 demo 不需要修改任何地方，運行時自動建庫、建表；
提供 .net core 2.1、2.2 兩種環境的測試 demo 下載：
Demo for dotnet 2.1.zip、Demo for dotnet 2.2.zip
第一步：
dotnet restore
第二步：
dotnet run
思考
一番驚喜過后，你應該會考慮實用性，這樣做有什么價值，可用於什么樣的場景？
這個擴展包簡單的輸入，產生巨量的功能反饋。目前來說它是死板的，對外提供的擴展性幾乎為零，這樣也就限定了它的應用場景。
不合適的場景
1、它不可替代我們自身開發的后台管理系統；
2、它不適合擺放在公網正式環境，存在數據安全問題；
3、歡迎補充。。。；
談談定位
目前的定位是這樣的，在開發環境中使用，查閱預覽實體數據，同時也比較方便的管理測試數據。
一段擁有無比力量的小段代碼，也是中間件界面的功能開啟：
//可以配置子目錄訪問，如：/testadmin/
app.UseFreeAdminLTE("/",
typeof(Entities.Song),
typeof(Entities.Tag));
觀后抽獎
我們一直在發布純技術干貨的分享文章，FreeSql 已經基本完成 .NETCore 最方便的 ORM 使命，我們正在籌備生態的建立，比如 ABP 中如何使用 FreeSql 的實現，需要各種各樣的擴展包，好多好多工作量。有沒有大神願意無償參與做這件事情，好吧。。應該沒有人！！如果你回心轉意了，歡迎聯系我們。
歡迎持續關注我們，做 .NETCore 最方便的 ORM ！
（QQ群：4336577）
github： https://github.com/2881099/FreeSql
說好的抽獎呢？？？