ABP源码分析十二:本地化
本文逐个分析ABP中涉及到locaization的接口和类,以及相互之间的关系。本地化主要涉及两个方面:一个是语言(Language)的管理,这部分相对简单。另一个是语言对应得本地化资源(Localization)的管理,这部分稍显复杂。
LanguageInfo:用于封装language的基本信息。
ILanguageProvider:接口定义一个返回本地化语言集合的方法。这里使用接口做隔离是有必要的,因为ABP底层框架的DefaultLanguageProvider只是返回通过代码hardcode到系统中的LanguageInfo信息。如果需要从其他source(比如数据库)中获取配置的LanguageInfo信息,那么我们就必须实现自定义的LanguageProvider。
DefaultLanguageProvider:从LocalizationConfiguration读取LanguageInfo的集合。
ILanguageManager/LanguageManager:通过调用ILanguageProvider接口返回LanguageInfo的一个集合。以及返回服务器的当前语言设置,如果服务器的当前语言不在LocalizationConfiguration的本地化语言集合中,则返回LocalizationConfiguration的本地化语言集合中的第一项。
以下是上面介绍的接口和类之间的关系
ILocalizationConfiguration/LocalizationConfiguration: 用于配置支持本地化的语言的一个LanguageInfo集合,以及这些语言所对应的本地化资源。这两者分别对应ILocalizationConfiguration中的Lanugages和Sources属性。注意这个Sources是一个ILocalizationSourceList实例。
下面是一个具体的web项目中的本地化配置。
这里有个限制需要留意,本地化资源是以SourceName分组的。比如上面的SimpleTaskSystem就是一个SourceName,其就标注了一组本地化资源(实际项目中获取指定字符串的本地化资源时,必须同时指定一个SourceName,以告知ABP从那组资源文件中读取本地化字符串)。
不能给LocalizationConfiguration的source添加两组本地化资源,而这两组本地化资源却使用同一个SourceName。如果另一组本地化资源需要使用相同的SourceName的话,需要以LocalizationSourceExtensionInfo的形式添加到LocalizationConfiguration的source的Extensions中。
实际项目中本地化资源的路径。
上面图中的资源文件是以什么样的形式被装载到ABP中的呢?图上的代码已经说明,通过DictionaryBasedLocalizationSource实例的形式被添加到LocalizationConfiguration的Sources中。
Source就是一个ILocalizationSourceList实例,是一个List. 另外ILocalizationSourceList实例还有一个IList<LocalizationSourceExtensionInfo>属性,这是用于扩展同组资源文件使用的。
LocalizationSourceExtensionInfo:用于扩展本地化资源。ABP在LocalizationManager初始化的过程中将LocalizationSourceExtensionInfo所对应的本地化资源扩充到ILocalizationSource对象的相应本地化资源字典中。
ILocalizableString/LocalizableString:封装需要被本地化的string的信息,并提供Localize方法(调用ILocalizationManager的GetString方法)返回本地化的string. SourceName指定其从那个本地化资源读取本地化文本。
FixedLocalizableString:封装不需要被本地化的string
ILocalizationContext/LocalizationContext: 上下文类封装了LocalizationManager。一般用作方法调用时的参数。
ILocalizationSource/IDictionaryBasedLocalizationSource/DictionaryBasedLocalizationSource: 从下面的图可以看出这组接口和类大致就相当于Facade模式的实现。ILocalizationManager对象通过ILocalizationSource对象调用各种本地化相关的逻辑。一组本地化资源只对应一个ILocalizationSource实例。
ILocalizationDictionary:提供了索引器this[]方法的接口,该方法接受一个string返回的是本地化的string。当LocalizationManager初始化动作结束后,每一种本地化语言的都对应有且仅有的一个ILocalizationDictionary对象,这个对象用于保存该语言的所有本地化信息。
LocalizationDictionary:实现了ILocalizationDictionary和IEnumerable两个接口,他本身就是一个具有集合操作的类。其内部封装了一个Dictionary的实例,用于提供真正的集合操作。这个基类只提供了从其内部的Dictionary中根据原string查找返回本地化的string。 其本身并没有将本地化资源文件中的数据加载到其内部的Dictionary的功能,这部分是在其子类中实现的。
XmlLocalizationDictionary:实现BuildFomFile和BuildFomXmlString方法用于从XML文件读取本地化数据
JsonLocalizationDictionary:实现BuildFromFile和BuildFromJsonString方法用于从Json文件读取本地化数据
JsonLocalizationFile: 反序列化Json字符串到JsonLocalizationFile对象。
ILocalizationDictionaryProvider:它封装了一个IDictionary<string, ILocalizationDictionary>实例(这是ABP在runtime时候,唯一持有本地化资源的对象),其中key就是sourceName(比如上面的"SimpleTaskSystem")。并且提供了一个方法Initialize来初始化本地化这个Dictionary。可以通过实现这个接口来提供其他类型的本地化资源。比如Abp.Zero 就实现了数据库的本地化资源。
LocalizationDictionaryProviderBase:实现了ILocalizationDictionaryProvider的抽象类,实现了extend本地化Dictionary的方法,这个方法主要用于初始化完成以后,用于扩展相应的ILocalizationDictionary对象。
XmlFileLocalizationDictionaryProvider:提供从xml文件中读取本地化信息,并将本地化信息装载到DefaultDictionary(IDictionary<string, ILocalizationDictionary> 对象)中。
JsonFileLocalizationDictionaryProvider:提供从Json文件中读取本地化信息,并将本地化信息装载到DefaultDictionary(IDictionary<string, ILocalizationDictionary> 对象)中。
JsonEmbeddedFileLocalizationDictionaryProvider:提供从xml文件(本地资源)中读取本地化信息,并将本地化信息装载到DefaultDictionary(IDictionary<string, ILocalizationDictionary> 对象)中。
XmlEmbeddedFileLocalizationDictionaryProvider:提供从Json文件(本地资源)中读取本地化信息,并将本地化信息装载到DefaultDictionary(IDictionary<string, ILocalizationDictionary> 对象)中。
ILocalizationManager/LocalizationManager:遍历LocalizationConfiguration中的ILocalizationSourceList实例,通过其ILocalizationSource的ILocalizationDictionaryProvider实例完成本地化资源的初始化。提供GetString方法返回本地化的string.LocalizationManager维护了一个ILocalizationSource对象的字典用于维护所有的本地化资源。
LocalizationManager通过调用InitializeSources初始化和load本地化资源文件中的内容到IDictionary<string,ILocalizationSource>实例对象 _sources中
ABP源码分析十二:本地化的更多相关文章
- [Abp 源码分析]十二、多租户体系与权限验证
0.简介 承接上篇文章我们会在这篇文章详细解说一下 Abp 是如何结合 IPermissionChecker 与 IFeatureChecker 来实现一个完整的多租户系统的权限校验的. 1.多租户的 ...
- C# DateTime的11种构造函数 [Abp 源码分析]十五、自动审计记录 .Net 登陆的时候添加验证码 使用Topshelf开发Windows服务、记录日志 日常杂记——C#验证码 c#_生成图片式验证码 C# 利用SharpZipLib生成压缩包 Sql2012如何将远程服务器数据库及表、表结构、表数据导入本地数据库
C# DateTime的11种构造函数 别的也不多说没直接贴代码 using System; using System.Collections.Generic; using System.Glob ...
- ABP源码分析十:Unit Of Work
ABP以AOP的方式实现UnitOfWork功能.通过UnitOfWorkRegistrar将UnitOfWorkInterceptor在某个类被注册到IOCContainner的时候,一并添加到该类 ...
- ABP源码分析十四:Entity的设计
IEntity<TPrimaryKey>: 封装了PrimaryKey:Id,这是一个泛型类型 IEntity: 封装了PrimaryKey:Id,这是一个int类型 Entity< ...
- ABP源码分析十五:ABP中的实用扩展方法
类名 扩展的类型 方法名 参数 作用 XmlNodeExtensions XmlNode GetAttributeValueOrNull attributeName Gets an attribu ...
- ABP源码分析十六:DTO的设计
IDTO:空接口,用于标注Dto对象. ComboboxItemDto:用于combobox/list中Item的DTO NameValueDto<T>/NameValueDto:用于na ...
- ABP源码分析十八:UI Inputs
以下图中描述的接口和类都在Abp项目的Runtime/Validation, UI/Inputs目录下的.在当前版本的ABP(0.83)中这些接口和类并没有实际使用到.阅读代码时可以忽略,无需浪费时间 ...
- ABP源码分析十九:Auditing
审计跟踪(也叫审计日志)是与安全相关的按照时间顺序的记录,它们提供了活动序列的文档证据,这些活动序列可以在任何时间影响一个特定的操作. AuditInfo:定义如下图中需要被Audit的信息. Aud ...
- jQuery 源码分析(十二) 数据操作模块 html特性 详解
jQuery的属性操作模块总共有4个部分,本篇说一下第1个部分:HTML特性部分,html特性部分是对原生方法getAttribute()和setAttribute()的封装,用于修改DOM元素的特性 ...
随机推荐
- Xamarin+Prism开发详解六:DependencyService与IPlatformInitializer的关系
祝各位2017年事业辉煌!开年第一篇博客,继续探索Xamarin.Forms… 为什么我做Xamarin开发的时候中意于Prism.Forms框架?本章为你揭晓. 实例代码地址:https://git ...
- node服务的监控预警系统架构
需求背景 目前node端的服务逐渐成熟,在不少公司内部也开始承担业务处理或者视图渲染工作.不同于个人开发的简单服务器,企业级的node服务要求更为苛刻: 高稳定性.高可靠性.鲁棒性以及直观的监控和报警 ...
- 【探索】无形验证码 —— PoW 算力验证
先来思考一个问题:如何写一个能消耗对方时间的程序? 消耗时间还不简单,休眠一下就可以了: Sleep(1000) 这确实消耗了时间,但并没有消耗 CPU.如果对方开了变速齿轮,这瞬间就能完成. 不过要 ...
- 恋爱虽易,相处不易:当EntityFramework爱上AutoMapper
剧情开始 为何相爱? 相处的问题? 女人的伟大? 剧情收尾? 有时候相识即是一种缘分,相爱也不需要太多的理由,一个眼神足矣,当EntityFramework遇上AutoMapper,就是如此,恋爱虽易 ...
- 背后的故事之 - 快乐的Lambda表达式(一)
快乐的Lambda表达式(二) 自从Lambda随.NET Framework3.5出现在.NET开发者眼前以来,它已经给我们带来了太多的欣喜.它优雅,对开发者更友好,能提高开发效率,天啊!它还有可能 ...
- 23种设计模式--中介者模式-Mediator Pattern
一.中介者模式的介绍 中介者模式第一下想到的就是中介,房子中介,婚姻中介啊等等,当然笔者也希望来个婚姻中介给我介绍一个哈哈哈,,回归正题中介者模式分成中介者类和用户类,根据接口编程的方式我们再 ...
- DDD 领域驱动设计-谈谈 Repository、IUnitOfWork 和 IDbContext 的实践(3)
上一篇:<DDD 领域驱动设计-谈谈 Repository.IUnitOfWork 和 IDbContext 的实践(2)> 这篇文章主要是对 DDD.Sample 框架增加 Transa ...
- Autofac - 属性注入
属性注入不同于通过构造函数方式传入参数. 这里是通过注入的方式, 在类创建完毕之后, 资源释放之前, 给属性赋值. 这里, 我重新弄一些类来演示这一篇吧. public class ClassA { ...
- JavaScript基础
JavaScript基础 JavaScript是一门编程语言,浏览器内置了JavaScript语言的解释器,所以在浏览器上按照JavaScript语言的规则编写相应代码之,浏览器可以解释并做出相应的处 ...
- 图解DevExpress RichEditControl富文本的使用,附源码及官方API
9点半了,刚写到1.2. 该回家了,明天继续写完. 大家还需要什么操作,留言说一下,没有的我明天继续加. 好久没有玩DevExpress了,今天下载了一个玩玩,发现竟然更新到14.2.5了..我去 ...