本文逐个分析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中