diff --git a/docs/guide/aop.md b/docs/guide/aop.md index be803b49ec..4bd9b774b9 100644 --- a/docs/guide/aop.md +++ b/docs/guide/aop.md @@ -216,3 +216,52 @@ fsql.Aop.ParseExpression += (s, e) => 这个解析有点复杂,当 `e.Expression` 很复杂的时候,我们还提供了 `e.FreeParse` 方法,使用它相当于调用 `FreeSql` 内置表达式解析引擎,辅助您进行解析。 +## 自定义全局类型转换 +框架中,除基础类型以外可以使用`TypeHandlers`添加转换器,一个具体的类对应一个转换器。 + +现在假定你有个BT需求:把数据库中的“A10” 转换成 枚举的 TestType.A(int值10) + +- 在EF中,框架遍历所有实体,在ctx创建时根据具体的Enum类型添加转换器。 +- 在FreeSql中,思路类似。ConfigEntityProperty委托中可以获取到属性的类型,然后创建一个具体的转换器即可。 + +```csharp + //配置代码 + freeSql.Aop.ConfigEntityProperty += (s, e) => + { + if(e.Property.PropertyType.IsEnum) + { + EnumToValueStringHandler hander = new EnumToValueStringHandler(e.Property.PropertyType); + FreeSql.Internal.Utils.TypeHandlers.TryAdd(hander.ModelType, hander); + } + }; + + //转换器代码 + public class EnumToValueStringHandler : ITypeHandler + { + private readonly Type enumType; + + //我这里传递具体的 type 信息,就能针对具体的枚举执行转换了 + public EnumToValueStringHandler(Type enumType) + { + this.enumType = enumType; + } + + Type ITypeHandler.Type { get => this.enumType; } + + // xxEnum -> string 附加A + object ITypeHandler.Serialize(object value) + { + return "A" + ((TestType)value).ToString("D"); + } + + // string -> xxEnum 去掉A + object ITypeHandler.Deserialize(object value) + { + return Enum.Parse(((string)value).Replace("A", "")); + } + } + +``` +核心思路是`ITypeHandler.Type`变成变量,可以从外部传递。额外有些问题要注意: +1. 所有的"xxxEnum"都会执行这个转换,如果有多个数据库多种格式,需要在`Handler`中处理 +2. 实体类超级多,枚举属性超级多时,**可能影响性能** 。确实很多时建议不在实体类上修改,可以通过部分类,新加一个属性去处理。(属性设置为IsIgnore,getter、seter中执行转换)