本节介绍的是Microsoft.AspNet.Localization工程。该工程是运行在Asp.net 5环境中的运行时多语言设置。

ASP.net 5中间件技术

在新的Asp.net 5中,可以将组件组册到asp.net环境中。注册是通过接口IApplicationBuilder的扩展方法实现的。

  1. 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的入口。
  1. public static class IApplicationBuilderExtensions
  2. {
  3. public static IApplicationBuilder UseRequestLocalization([NotNull] this IApplicationBuilder builder)
  4. {
  5. var options = new RequestLocalizationOptions();
  6.  
  7. return UseRequestLocalization(builder, options);
  8. }
  9.  
  10. public static IApplicationBuilder UseRequestLocalization(
  11. [NotNull] this IApplicationBuilder builder,
  12. [NotNull] RequestLocalizationOptions options)
  13. => builder.UseMiddleware<RequestLocalizationMiddleware>(options);
  14. }

IApplicationBuilderExtensions

  1. public class RequestLocalizationMiddleware
  2. {
  3. private readonly RequestDelegate _next;
  4. private readonly RequestLocalizationOptions _options;
  5.  
  6. public RequestLocalizationMiddleware([NotNull] RequestDelegate next, [NotNull] RequestLocalizationOptions options)
  7. {
  8. _next = next;
  9. _options = options;
  10. }
  11.  
  12. public async Task Invoke([NotNull] HttpContext context)
  13. {
  14. var requestCulture = _options.DefaultRequestCulture ??
  15. new RequestCulture(CultureInfo.CurrentCulture, CultureInfo.CurrentUICulture);
  16.  
  17. IRequestCultureProvider winningProvider = null;
  18.  
  19. if (_options.RequestCultureProviders != null)
  20. {
  21. foreach (var provider in _options.RequestCultureProviders)
  22. {
  23. var result = await provider.DetermineRequestCulture(context);
  24. if (result != null)
  25. {
  26. requestCulture = result;
  27. winningProvider = provider;
  28. break;
  29. }
  30. }
  31. }
  32.  
  33. context.SetFeature<IRequestCultureFeature>(new RequestCultureFeature(requestCulture, winningProvider));
  34.  
  35. SetCurrentThreadCulture(requestCulture);
  36.  
  37. await _next(context);
  38. }
  39.  
  40. private static void SetCurrentThreadCulture(RequestCulture requestCulture)
  41. {
  42. #if DNX451
  43. Thread.CurrentThread.CurrentCulture = requestCulture.Culture;
  44. Thread.CurrentThread.CurrentUICulture = requestCulture.UICulture;
  45. #else
  46. CultureInfo.CurrentCulture = requestCulture.Culture;
  47. CultureInfo.CurrentUICulture = requestCulture.UICulture;
  48. #endif
  49. }
  50. }

RequestLocalizationMiddleware

注册前的参数RequestLocalizationOptions

IApplicationBuilderExtensions中,我们对于中间件RequestLocalizationMiddleware注册时,需要传入RequestLocalizationOptions类型的实例,大多数时候传入的都是默认的无参实例。

我们看RequestLocalizationOptions类只有4个属性,代码如下:

  1. public class RequestLocalizationOptions
  2. {
  3. public RequestLocalizationOptions()
  4. {
  5. DefaultRequestCulture = new RequestCulture(CultureInfo.CurrentCulture, CultureInfo.CurrentUICulture);
  6.  
  7. RequestCultureProviders = new List<IRequestCultureProvider>
  8. {
  9. new QueryStringRequestCultureProvider { Options = this },
  10. new CookieRequestCultureProvider { Options = this },
  11. new AcceptLanguageHeaderRequestCultureProvider { Options = this }
  12. };
  13. }
  14. public RequestCulture DefaultRequestCulture { get; set; }
  15. public IList<CultureInfo> SupportedCultures { get; set; }
  16. public IList<CultureInfo> SupportedUICultures { get; set; }
  17. public IList<IRequestCultureProvider> RequestCultureProviders { get; set; }
  18. }

我们看到在无参的构造函数中,系统初始化了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接口的实例。

  1. context.SetFeature<IRequestCultureFeature>(new RequestCultureFeature(requestCulture, winningProvider));

整体结构

整个工程的文件可以用以下结构表示:

[Asp.net 5] Localization-Asp.net运行时多语言的更多相关文章

  1. ASP.NET Core3.0 中的运行时编译

    运行时编译 通过 Razor 文件的运行时编译补充生成时编译. 当 .cshtml 文件的内容发生更改时,ASP.NET Core MVC 将重新编译 Razor 文件 . 通过 Razor 文件的运 ...

  2. [ASP.NET Core MVC] 如何实现运行时动态定义Controller类型?

    昨天有个朋友在微信上问我一个问题:他希望通过动态脚本的形式实现对ASP.NET Core MVC应用的扩展,比如在程序运行过程中上传一段C#脚本将其中定义的Controller类型注册到应用中,问我是 ...

  3. Windows Store App 全球化:运行时响应语言变更

    在应用程序运行过程中,系统的语言.像素.对比度等系统设置可能会发生改变,应用程序应根据系统环境的改变及时做出适当的响应.为了解决这样的问题,可以在应用程序中为系统状态更改事件注册事件处理方法,当语言. ...

  4. cefSharp 设置运行时系统语言

    在使用用CefSharp使用过程中,系统用了很多第三方控件.这些控件很多能够根据浏览器设置的语言来进行控件展示对应语言. 在cefSharp可以设置系统语言,代码如下: CefSharp.Settin ...

  5. Runtime运行时的那点事儿

    注:本文是对 Colin Wheeler 的 Understanding the Objective-C Runtime 的翻译. 初学 Objective-C(以下简称ObjC) 的人很容易忽略一个 ...

  6. ASP.NET 5运行时升级到Beta5

    在Visual Studio 2015 RTM和Windows 10正式发布之前,微软把开源.NET升级到了beta5,带来了一些增强和改变.和Visual Studio 2015 RC一起安装的AS ...

  7. ASP.NET 运行时详解 揭开请求过程神秘面纱

    对于ASP.NET开发,排在前五的话题离不开请求生命周期.像什么Cache.身份认证.Role管理.Routing映射,微软到底在请求过程中干了哪些隐秘的事,现在是时候揭晓了.抛开乌云见晴天,接下来就 ...

  8. ASP.NET运行时详解 集成模式和经典模式

    遗留问题 在<ASP.NET运行时详解 生命周期入口分析>中遗留两个问题,包括Application的InitInternal方法执行细节.IIS6和II7经典模式请求管道管理类Appli ...

  9. ASP.NET运行时详解 生命周期入口分析

    说起ASP.NET的生命周期,网上有很多的介绍.之前也看了些这方面的博客,但我感觉很多程序猿像我一样,看的时候似乎明白,一段时间过后又忘了.所以,最近Heavi花了一段时间研究ASP.NET的源代码, ...

随机推荐

  1. CSDN:你认为一名优秀的技术人应该具备怎样的素质?

    CSDN:你认为一名优秀的技术人应该具备怎样的素质? 王晶昱:我个人认为,符合这个世界要求的就是优秀的.在目前这个时代,我认为一个优秀的技术人员的特质可能是: 兴趣驱动,兴趣是最好的老师,写程序本身就 ...

  2. 安卓动态调试七种武器之离别钩 – Hooking(上)

    安卓动态调试七种武器之离别钩 – Hooking(上) 作者:蒸米@阿里聚安全 0x00 序 随着移动安全越来越火,各种调试工具也都层出不穷,但因为环境和需求的不同,并没有工具是万能的.另外工具是死的 ...

  3. Java NIO5:选择器1---理论篇

    选择器 最后,我们探索一下选择器.由于选择器内容比较多,所以本篇先偏理论地讲一下,后一篇讲代码,文章也没有什么概括.总结的,写到哪儿算哪儿了,只求能将选择器写明白,并且将一些相对重要的内容加粗标红. ...

  4. Lesson 4 An existing trip

    Text I have just received a letter from my brother,Tim. He is in Australia. He has been there for si ...

  5. ASP.Net MVC开发基础学习笔记:四、校验、AJAX与过滤器

    一.校验 — 表单不是你想提想提就能提 1.1 DataAnnotations(数据注解) 位于 System.ComponentModel.DataAnnotations 命名空间中的特性指定对数据 ...

  6. PHP扩展-扩展的生成和编译

    首先说明一下,PHP扩展有两种编译方式:方式一:在编译PHP时直接将扩展编译进去方式二:扩展被编译成.so文件,在php.ini里配置加载路径: 以下开始说明创建PHP扩展并编译的步骤:下载PHP源码 ...

  7. 异步方法不能使用ref和out的解决方法

    异常处理汇总-后端系列:http://www.cnblogs.com/dunitian/p/4523006.html 应用场景==>后端现在都是用异步方法,那么分页是必不可少的,于是就有了这个问 ...

  8. 详解jquery插件中;(function ( $, window, document, undefined )的作用

    在jquery插件中我们经常看到以下这段代码 1 2 3 ;(function ( $, window, document, undefined ){ //函数体内具体代码 })(jQuery, wi ...

  9. 解密jQuery事件核心 - 绑定设计(一)

    说起jQuery的事件,不得不提一下Dean Edwards大神 addEvent库,很多流行的类库的基本思想从他那儿借来的 jQuery的事件处理机制吸取了JavaScript专家Dean Edwa ...

  10. invalidate()和postInvalidate() 的区别及使用

    Android提供了Invalidate方法实现界面刷新,但是Invalidate不能直接在线程中调用,因为他是违背了单线程模型:Android UI操作并不是线程安全的,并且这些操作必须在UI线程中 ...