ABP源码分析四十三：ZERO的本地化

ABP Zero模块扩展了ABP基础框架中的本地化功能，实现了通过数据库管理本地化的功能。其通过数据库保存本地化语言及其资源。

ApplicationLanguage：代表本地化语言的实体类。一种语言就是一个ApplicationLanguage实例。

ApplicationLanguageProvider：实现了ILanguageProvider接口，通过IApplicationLanguageManager实例设置DefaultLanguage和获取应用所配置的Language的列表。

ApplicationLanguageManager/IApplicationLanguageManager：通过IRepository<ApplicationLanguage>实例完成ApplicationLanguage实体的CRUD操作。同时实现ApplicationLanguage实体的更改事件，具体就是当ApplicationLanguage实体状态变化时，将对应的ApplicationLanguage实体从缓存中移除。

---

ApplicationLanguageText：代表数据库中的本地化资源的实体类。在ABP 基础框架中，是用资源文件保存本地化资源的，但是Zero中使用数据库保存本地化资源。

ApplicationLanguageTextManager/IApplicationLanguageTextManager: 通过IRepository<ApplicationLanguageText, long>实例完成ApplicationLanguageText实体的CRUD操作。

---

关于ILocalizationSource，ILocalizationDictionary和ILocalizationDictionaryProvider的定义和用法参见ABP核心框架中的本地化模块。ABP.Zero中重新实现了这三个接口，以完成从数据库中读取资源。如果明白了ABP核心框架中的本地化模块的用法，下面几个对象是很容易理解的。

IMultiTenantLocalizationSource : 扩展了ABP中的ILocalizationSource接口。重载了GetString和GetStringOrNull以提供根据tenant信息返回本地化字符串的方法。

MultiTenantLocalizationSource：实现了IMultiTenantLocalizationSource 接口。通过MultiTenantLocalizationDictionaryProvider实例完成本地化资源的读取。

IMultiTenantLocalizationDictionary : 扩展了ABP核心框架中的ILocalizationDictionary，重载了GetOrNull和GetAllStrings以提供根据tenant信息返回本地化字符串的方法。

MultiTenantLocalizationDictionary：实现了IMultiTenantLocalizationDictionary接口，通过IRepository<ApplicationLanguageText, long> 实例从数据库读取与指定tenant相关的本地化资源。并且通过ICacheManager实例缓存本地化资源

MultiTenantLocalizationDictionaryProvider：实现了ILocalizationDictionaryProvider接口，通过MultiTenantLocalizationDictionary获取与指定tenant相关的本地化资源。

MultiTenantLocalizationDictionaryCacheHelper：提供了两个静态方法一个用于获取localization cache，另一个方法CalculateCacheKey用于生成CacheKey。一个cacheKey对应一个本地化资源（字典类型）。

MultiTenantLocalizationDictionaryCacheCleaner：将一个指定的本地化资源从缓存中删除。

---

ILanguageManagementConfig：提供EnableDbLocalization方法激活是否使用Database作为本地化资源的数据源

LanguageManagementConfig：实现了ILanguageManagementConfig接口中的EnableDbLocalization方法。具体就是将其他本地化Source从configuration中移除，替换为Database Source。

返回ABP源码分析系列文章目录