ToB企服应用市场:ToB评测及商务社交产业平台

标题: 基于EF Core存储的国际化服务 [打印本页]
作者: 农妇山泉一亩田    时间: 2024-7-11 11:56
标题: 基于EF Core存储的国际化服务
前言

.NET 官方有一个用来管理国际化资源的扩展包Microsoft.Extensions.Localization，ASP.NET Core也用这个来实现国际化功能。但是这个包的翻译数据是使用resx资源文件来管理的，这就意味着无法动态管理。虽然官方有在文档中提供了一些第三方管理方案，但是都不太方便。其中一个是基于Json文件的，虽然可以动态管理，但是正确的Key值有时很难猜对，特殊是对于嵌套类和泛型类之类名字比较特殊的。别的两个基于EF Core的一个只是个demo；另一个已多年未更新，且上下文生命周期和并发管理有缺陷（这个库还是我提交pr才支持的 .NET 5）。最近项目有用到国际化功能，只好重新写一个。
新书宣传

有关新书的更多介绍欢迎查看《C#与.NET6 开发从入门到实践》上市，作者亲自来打广告了！

相关旧文

Asp.Net Core 混合环球化与当地化支持
正文

这个扩展包代码不多也不算复杂，主要结构参考官方内置实现。对于 .NET 5以上支持上下文工厂的版本使用上下文工厂，而对于旧版本则创建内部作用域获取私有上下文，以此彻底避免并发问题。作用域和上下文都是需要查询时暂时获取和使用，查询完数据立刻销毁避免内存泄漏。如果使用池化上下文工厂性能会更好。
对代码感兴趣的朋侪可以移步Github。这里直接介绍一下基本用法。
这个库分为三个包：抽象包界说了所需接口，实体模型包界说基本实体类型，功能包界说了服务接口的实现类和用于注册服务的扩展方法。方便为分离项目的解决方案按需引用，淘汰无关类型的污染。
以在ASP.NET Core中使用为例：
实体模型和上下文
  1. public class YourLocalizationRecord : LocalizationRecord
  2. {
  3.     public int YourProperty { get; set; }
  4. }
  6. public class YourDbContext : DbContext
  7. {
  8.     protected override void OnModelCreating(ModelBuilder modelBuilder)
  9.     {
  10.         // 使用默认类型。
  11.         modelBuilder.UseLocalizationRecord();
  13.         // 使用自定义类型，需要继承LocalizationRecord。
  14.         modelBuilder.UseLocalizationRecord<YourLocalizationRecord>(b =>
  15.         {
  16.             b.Property(r => r.ResourceCulture).HasMaxLength(32);
  17.             b.ToTable($"{nameof(YourLocalizationRecord)}s");
  18.         });
  19.     }
  20. }
复制代码
服务注册
  1. // 对于 .NET 5 以上请使用上下文工厂。
  2. services.AddDbContextFactoty<YourDbContext>(options => options.UseSqlite("Localization.db"));
  3. // 或者池化工厂也是一样的，而且更好。
  4. services.AddPooledDbContextFactoty<YourDbContext>(options => options.UseSqlite("Localization.db"));
  5. // 注册一个自定义工厂服务模拟作用域上下文服务
  6. services.AddScoped<YourDbContext>(sp => sp.GetRequiredService<IDbContextFactory<YourDbContext>>().CreateDbContext());
  8. // 对于 .NETStandard 2.0 或 2.1 请使用上下文。
  9. services.AddDbContext<YourDbContext>(options => options.UseSqlite("Localization.db"));
  11. // 注册使用默认实体类型的服务。
  12. services.AddEntityFrameworkCoreLocalization<YourDbContext>(options =>
  13. {
  14.     options.ResourcesPath = "Resources";
  15.     // 是否自动创建缺失的资源记录
  16.     options.CreateLocalizationResourcesIfNotExist = true;
  17. });
  19. //  注册使用自定义实体类型的服务。
  20. services.AddEntityFrameworkCoreLocalization<YourDbContext, YourLocalizationRecord>(options =>
  21. {
  22.     options.ResourcesPath = "Resources";
  23.     // 是否自动创建缺失的资源记录
  24.     options.CreateLocalizationResourcesIfNotExist = true;
  25. });
复制代码
其他的和官方文档用法完全一致，如果需要清除缓存使资源能在下次读取时更新，可以使用服务IDynamicResourceStringLocalizerFactory。这个服务继承自内置服务，获取的IStringLocalizerFactory服务实际上也是IDynamicResourceStringLocalizerFactory的实现。
既然已经有上下文了，想怎么读写数据应该不必多言了吧。实体类的属性LocalizedContent就是翻译后的文本。如果使用自动创建记载，只需要查找所有这个属性为null的记载并翻译保存，最后清除缓存即可。

结语

为了实现对 .NETStantard 2.0 的兼容代码上使用了条件编译预处置惩罚实现一份代码一个项目同时编译到所有框架，最大程度共用代码简化代码管理。
附上国际化官方文档：使 ASP.NET Core 应用内容可当地化，在当地化 ASP.NET Core 应用中为每个哀求选择语言/区域性
许可证：MIT
代码仓库：CoreDX.Extensions.Localization.EntityFrameworkCore - Github
Nuget：CoreDX.Extensions.Localization.EntityFrameworkCore
Nuget：CoreDX.Extensions.Localization.EntityFrameworkCore.Abstractions
Nuget：CoreDX.Extensions.Localization.EntityFrameworkCore.Models
QQ群

读者互换QQ群：540719365

欢迎读者和广大朋侪一起互换，如发现本书错误也欢迎通过博客园、QQ群等方式告知笔者。
本文地点：https://www.cnblogs.com/coredx/p/18294729.html

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。



欢迎光临 ToB企服应用市场:ToB评测及商务社交产业平台 (https://dis.qidao123.com/) Powered by Discuz! X3.4