[Asp.net 5] Localization-Asp.net运行时多语言
本节介绍的是Microsoft.AspNet.Localization工程。该工程是运行在Asp.net 5环境中的运行时多语言设置。
ASP.net 5中间件技术
在新的Asp.net 5中,可以将组件组册到asp.net环境中。注册是通过接口IApplicationBuilder的扩展方法实现的。
public static IApplicationBuilder UseMiddleware(this IApplicationBuilder builder, Type middleware, params object[] args)
[该扩展方法通过可变参数args传递所需要的参数以及外的RequestDelegate(delegate Task RequestDelegate(HttpContext context))类型(系统会在内部给该类型参数赋值)。创建Type(middleware)类型实例。之后调用Type(middleware)的Invoke方法,不过和构造函数不同的是,当Invoke方法参数大于一个时,参数全部来自于以来注入,而不是args]
通过IApplicationBuilder注入的中间件,必须有一个方法是Invoke,Invoke方法的参数是可变参数,长度不受限制,系统会从asp.net的反转控制中获取参数;系统之后会调用该Invoke方法。[此处有疑问:为啥不定义成包含invoke方法的接口,更加面向对象]
我们在Microsoft.AspNet.Localization工程中可以找到俩个类:
- IApplicationBuilderExtensions 中间注册方法,在Microsoft.AspNet.Localization工程中的实现。
- RequestLocalizationMiddleware 中间件类,是Microsoft.AspNet.Localization的入口。
public static class IApplicationBuilderExtensions
{
public static IApplicationBuilder UseRequestLocalization([NotNull] this IApplicationBuilder builder)
{
var options = new RequestLocalizationOptions(); return UseRequestLocalization(builder, options);
} public static IApplicationBuilder UseRequestLocalization(
[NotNull] this IApplicationBuilder builder,
[NotNull] RequestLocalizationOptions options)
=> builder.UseMiddleware<RequestLocalizationMiddleware>(options);
}
IApplicationBuilderExtensions
public class RequestLocalizationMiddleware
{
private readonly RequestDelegate _next;
private readonly RequestLocalizationOptions _options; public RequestLocalizationMiddleware([NotNull] RequestDelegate next, [NotNull] RequestLocalizationOptions options)
{
_next = next;
_options = options;
} public async Task Invoke([NotNull] HttpContext context)
{
var requestCulture = _options.DefaultRequestCulture ??
new RequestCulture(CultureInfo.CurrentCulture, CultureInfo.CurrentUICulture); IRequestCultureProvider winningProvider = null; if (_options.RequestCultureProviders != null)
{
foreach (var provider in _options.RequestCultureProviders)
{
var result = await provider.DetermineRequestCulture(context);
if (result != null)
{
requestCulture = result;
winningProvider = provider;
break;
}
}
} context.SetFeature<IRequestCultureFeature>(new RequestCultureFeature(requestCulture, winningProvider)); SetCurrentThreadCulture(requestCulture); await _next(context);
} private static void SetCurrentThreadCulture(RequestCulture requestCulture)
{
#if DNX451
Thread.CurrentThread.CurrentCulture = requestCulture.Culture;
Thread.CurrentThread.CurrentUICulture = requestCulture.UICulture;
#else
CultureInfo.CurrentCulture = requestCulture.Culture;
CultureInfo.CurrentUICulture = requestCulture.UICulture;
#endif
}
}
RequestLocalizationMiddleware
注册前的参数RequestLocalizationOptions
在IApplicationBuilderExtensions中,我们对于中间件RequestLocalizationMiddleware注册时,需要传入RequestLocalizationOptions类型的实例,大多数时候传入的都是默认的无参实例。
我们看RequestLocalizationOptions类只有4个属性,代码如下:
public class RequestLocalizationOptions
{
public RequestLocalizationOptions()
{
DefaultRequestCulture = new RequestCulture(CultureInfo.CurrentCulture, CultureInfo.CurrentUICulture); RequestCultureProviders = new List<IRequestCultureProvider>
{
new QueryStringRequestCultureProvider { Options = this },
new CookieRequestCultureProvider { Options = this },
new AcceptLanguageHeaderRequestCultureProvider { Options = this }
};
}
public RequestCulture DefaultRequestCulture { get; set; }
public IList<CultureInfo> SupportedCultures { get; set; }
public IList<CultureInfo> SupportedUICultures { get; set; }
public IList<IRequestCultureProvider> RequestCultureProviders { get; set; }
}
我们看到在无参的构造函数中,系统初始化了DefaultRequestCulture和RequestCultureProviders。系统会遍历RequestCultureProviders寻找适应的语言,当找不到合适的语言时,使用DefaultRequestCulture。
- RequestCultureProviders:默认初始化三种多语言提供源:queryString、cookie、acceptHeader。
- SupportedCultures:系统支持的语言
- SupportedUICultures:系统支持的UI语言
- DefaultRequestCulture:默认的语言源
[当我们需要自定义RequestCultureProvider时,我们有俩种方式,自定义类继承类RequestCultureProvider(或者直接继承接口IRequestCultureProvider),或者将CustomRequestCultureProvider注册到RequestCultureProviders中,并在CustomRequestCultureProvider类构造函数中注册Task<RequestCulture>方法]
注册时的顺序
系统是按照RequestLocalizationOptions中RequestCultureProviders的顺序获取合适的语言,如果没有则使用DefaultRequestCulture。默认情况,系统会根据queryString、cookie、acceptHeader(默认最多取前三项语言)的顺序读取<是短路算法>。
注册后的RequestCultureFeature
Asp.net5 的运行时环境Context可以注册不同类型的参数,所以系统最后注册了IRequestCultureFeature接口的实例。
context.SetFeature<IRequestCultureFeature>(new RequestCultureFeature(requestCulture, winningProvider));
整体结构
整个工程的文件可以用以下结构表示:
[Asp.net 5] Localization-Asp.net运行时多语言的更多相关文章
- ASP.NET Core3.0 中的运行时编译
运行时编译 通过 Razor 文件的运行时编译补充生成时编译. 当 .cshtml 文件的内容发生更改时,ASP.NET Core MVC 将重新编译 Razor 文件 . 通过 Razor 文件的运 ...
- [ASP.NET Core MVC] 如何实现运行时动态定义Controller类型?
昨天有个朋友在微信上问我一个问题:他希望通过动态脚本的形式实现对ASP.NET Core MVC应用的扩展,比如在程序运行过程中上传一段C#脚本将其中定义的Controller类型注册到应用中,问我是 ...
- Windows Store App 全球化:运行时响应语言变更
在应用程序运行过程中,系统的语言.像素.对比度等系统设置可能会发生改变,应用程序应根据系统环境的改变及时做出适当的响应.为了解决这样的问题,可以在应用程序中为系统状态更改事件注册事件处理方法,当语言. ...
- cefSharp 设置运行时系统语言
在使用用CefSharp使用过程中,系统用了很多第三方控件.这些控件很多能够根据浏览器设置的语言来进行控件展示对应语言. 在cefSharp可以设置系统语言,代码如下: CefSharp.Settin ...
- Runtime运行时的那点事儿
注:本文是对 Colin Wheeler 的 Understanding the Objective-C Runtime 的翻译. 初学 Objective-C(以下简称ObjC) 的人很容易忽略一个 ...
- ASP.NET 5运行时升级到Beta5
在Visual Studio 2015 RTM和Windows 10正式发布之前,微软把开源.NET升级到了beta5,带来了一些增强和改变.和Visual Studio 2015 RC一起安装的AS ...
- ASP.NET 运行时详解 揭开请求过程神秘面纱
对于ASP.NET开发,排在前五的话题离不开请求生命周期.像什么Cache.身份认证.Role管理.Routing映射,微软到底在请求过程中干了哪些隐秘的事,现在是时候揭晓了.抛开乌云见晴天,接下来就 ...
- ASP.NET运行时详解 集成模式和经典模式
遗留问题 在<ASP.NET运行时详解 生命周期入口分析>中遗留两个问题,包括Application的InitInternal方法执行细节.IIS6和II7经典模式请求管道管理类Appli ...
- ASP.NET运行时详解 生命周期入口分析
说起ASP.NET的生命周期,网上有很多的介绍.之前也看了些这方面的博客,但我感觉很多程序猿像我一样,看的时候似乎明白,一段时间过后又忘了.所以,最近Heavi花了一段时间研究ASP.NET的源代码, ...
随机推荐
- SQL Server 2016 CTP2.2 的关键特性
SQL Server 2016 CTP2.2 的关键特性 正如微软CEO 说的,SQL Server2016 是一个Breakthrough Flagship Database(突破性的旗舰级数据库 ...
- 安装jdk
检查已安装jdk,如果有,先删除 rpm -qa|grep java rpm -e --nodeps filename 从oracle官方网站下载jdk安装包:jdk-8u111-linux-x64. ...
- Raft 为什么是更易理解的分布式一致性算法
一致性问题可以算是分布式领域的一个圣殿级问题了,关于它的研究可以回溯到几十年前. 拜占庭将军问题 Leslie Lamport 在三十多年前发表的论文<拜占庭将军问题>(参考[1]). 拜 ...
- .NET Fringe 定义未来
在dotnetconf 2015会宣布了4.12-14 在波特兰召开 .NET Fringe http://dotnetfringe.org/ ,中文社区很少有相关的介绍,本文向大家介绍下这个.NET ...
- 基础知识漫谈(2):从设计UI框架开始
说UI能延展出一丢丢的东西来,光java就有swing,swt/jface乃至javafx等等UI toolkit,在桌面上它们甚至都不是主流,在web端又有canvas.svg等等. 基于这些UI工 ...
- Hadoop学习笔记—4.初识MapReduce
一.神马是高大上的MapReduce MapReduce是Google的一项重要技术,它首先是一个编程模型,用以进行大数据量的计算.对于大数据量的计算,通常采用的处理手法就是并行计算.但对许多开发者来 ...
- .NET中提升UAC权限的方法总结
[题外话] 从Vista开始,由于增加了UAC(用户账户控制,User Account Control)功能,使得管理员用户平时不再拥有能控制所有功能的管理员权限了,所以在调用很多比较重要的功能时需要 ...
- 跟vczh看实例学编译原理——一:Tinymoe的设计哲学
自从<序>胡扯了快一个月之后,终于迎来了正片.之所以系列文章叫<看实例学编译原理>,是因为整个系列会通过带大家一步一步实现Tinymoe的过程,来介绍编译原理的一些知识点. 但 ...
- 我所理解的RESTful Web API [Web标准篇]
REST不是一个标准,而是一种软件应用架构风格.基于SOAP的Web服务采用RPC架构,如果说RPC是一种面向操作的架构风格,而REST则是一种面向资源的架构风格.REST是目前业界更为推崇的构建新一 ...
- SQL之case when then用法
case具有两种格式.简单case函数和case搜索函数. 按 Ctrl+C 复制代码 这两种方式,可以实现相同的功能.简单case函数的写法相对比较简洁,但是和case搜索函数相比,功能方面会有些限 ...