LinqToDB中的单向类型转换器实现方案

在LinqToDB项目中，类型转换器(Converter)是一个强大的功能，它允许开发者在数据库类型和.NET类型之间进行双向转换。然而，在某些特定场景下，开发者可能需要实现单向的类型转换逻辑，即只在从.NET到数据库或者从数据库到.NET的一个方向上应用转换。

背景与需求

在实际开发中，我们经常会遇到需要特殊处理日期时间类型的场景。例如，由于历史原因，数据库中存储的日期时间可能没有时区信息，而应用代码中需要明确处理时区转换。典型的业务需求包括：

1. 当保存到数据库时，将所有未指定时区(DateTimeKind.Unspecified)的DateTime视为本地时间，然后转换为UTC时间存储
2. 当从数据库加载时，将所有未指定时区的DateTime视为UTC时间，然后转换为本地时间

这种需求本质上要求在数据流动的两个方向上采用不同的转换逻辑，而LinqToDB默认的转换器是双向工作的，无法直接满足这种单向转换的需求。

技术挑战

LinqToDB的MappingSchema提供了SetConvertExpression和SetConverter方法来定义类型转换。然而，这些方法默认创建的转换器是双向工作的。例如：

// 这种转换器会在两个方向上都起作用
mappingSchema.SetConvertExpression<DateTime,DateTime>(dt => dt.ToLocalTime());

当我们需要实现单向转换时，就面临以下技术挑战：

1. 如何确保转换逻辑只在特定方向上应用
2. 如何避免转换逻辑在相反方向上产生副作用
3. 如何保持代码的清晰性和可维护性

解决方案

经过深入分析LinqToDB的源码和实际测试，我们发现可以通过组合使用不同的转换器表达式来实现单向转换的效果。具体方案如下：

1. 对于从数据库到.NET方向的转换，使用标准的类型转换表达式
2. 对于从.NET到数据库方向的转换，使用DataParameter类型的转换表达式

// 创建专用的MappingSchema
var utcMappingSchema = new MappingSchema("UtcConvert");

// 设置从数据库到.NET的转换逻辑
utcMappingSchema.SetConvertExpression<DateTime,DateTime>(dt => dt.ToLocalTime());

// 设置从.NET到数据库的转换逻辑
utcMappingSchema.SetConvertExpression<DateTime,DataParameter>(
    dt => new DataParameter() { 
        Value = dt.ToUniversalTime(), 
        DataType = DataType.DateTime 
    });

这种方案之所以有效，是因为：

1. 当从数据库读取数据时，LinqToDB会使用第一种转换器将DateTime转换为本地时间
2. 当向数据库写入数据时，LinqToDB会优先匹配DataParameter类型的转换器，执行UTC转换
3. 两种转换器通过不同的类型签名实现了逻辑上的隔离

实际应用示例

以下是一个完整的应用示例，展示了如何处理未指定时区的DateTime：

// 初始化MappingSchema
var schema = new MappingSchema();
schema.SetConvertExpression<DateTime,DateTime>(dbTime => {
    // 从数据库读取时，将未指定时区的时间视为UTC，转为本地时间
    return dbTime.Kind == DateTimeKind.Unspecified 
        ? DateTime.SpecifyKind(dbTime, DateTimeKind.Utc).ToLocalTime()
        : dbTime;
});

schema.SetConvertExpression<DateTime,DataParameter>(localTime => {
    // 写入数据库时，将未指定时区的时间视为本地时间，转为UTC
    var timeToConvert = localTime.Kind == DateTimeKind.Unspecified
        ? DateTime.SpecifyKind(localTime, DateTimeKind.Local)
        : localTime;
    return new DataParameter() {
        Value = timeToConvert.ToUniversalTime(),
        DataType = DataType.DateTime
    };
});

// 使用配置好的MappingSchema
var options = new DataOptions()
    .UseMappingSchema(schema)
    .UseSQLite("Data Source=test.db");

using var db = new DataConnection(options);

// 创建测试表
db.CreateTable<TestEntity>();

// 插入数据 - 未指定时区的时间会被视为本地时间并转为UTC存储
db.Insert(new TestEntity {
    Id = 1,
    CreatedAt = new DateTime(2024, 1, 1, 10, 0, 0) // Unspecified kind
});

// 查询数据 - 从数据库读取的未指定时区时间会被视为UTC并转为本地时间
var entity = db.GetTable<TestEntity>().First();
Console.WriteLine(entity.CreatedAt.Kind); // 输出: Local

最佳实践

在实际项目中实现单向类型转换时，建议遵循以下最佳实践：

1. 为特殊转换逻辑创建专用的MappingSchema，而不是修改默认的MappingSchema
2. 在转换器中明确处理各种DateTimeKind情况，避免意外行为
3. 为转换逻辑编写单元测试，确保其在各种边界条件下的行为符合预期
4. 在团队内部分享和文档化这些特殊转换逻辑，避免其他开发者误解

总结

虽然LinqToDB没有直接提供"单向转换器"的概念，但通过巧妙地组合使用不同类型的转换器表达式，我们仍然可以实现单向转换的效果。这种方案特别适合处理日期时间、时区转换等需要双向不同逻辑的场景。理解这一技术方案可以帮助开发者更好地控制数据在应用层和持久层之间的转换行为，构建更加健壮的数据访问层。