在.net平台中软件的国际化主要依靠工作线程的国际化来完成。在.net框架的的处理线程中我们通过设置Thread.CurrentCulture属性来实现对日期、时间、数字、货币值、文本的排序顺序负载约定和字符串比较的默认值的格式确定默认情况下这个属性来自于“控制面板”的“区域和语言选项”中的用户区域性。当然在软件运行过程中也可以通过手动的方式强制改变Thread.CurrentCulture属性值。CurrentUICulture属性则用来确定需要向用户呈现的资源格式它对软件的操作界面来说最有用因为它标识了在显示UI元素时应使用的语言。在.net中通常给软件设置不同的UI资源文件使得软件运行时通过CurrentUICulture属性值来选择不同语言的资源文件渲染软件界面。线程的CurrentUICulture 和 CurrentCulture 属性一般设置为同一个CultureInfo对象也就是就他它使用相同的语言、国家信息然而也可将它们设为不同的对象。例如一个美国人在北京借用了一台操作系统是简体中文版的计算机进行工作时就可以通过这种方式让软件满足美国用户的使用需求。下面的例子解释了对于不同的Thread.CurrentCulture属性值同一个日期字符串转换为日期类型时会生成不同结果1 static void Main(string[] args) 2 { 3 string birthdate 02/06/2013; 4 DateTime dateTime; 5 dateTime DateTime.Parse(birthdate); 6 Console.WriteLine(dateTime.ToString(yyyy年MM月dd日)); 7 Thread.CurrentThread.CurrentCulture new System.Globalization.CultureInfo(en-GB); 8 dateTime DateTime.Parse(birthdate); 9 Console.WriteLine(dateTime.ToString(yyyy年MM月dd日)); 10 Console.Read(); 11 }下面的例子解释了对于不同的Thread.CurrentUICulture属性值框架会选择不同的资源文件读取其中的值以便向使用不同语言的用户呈现不同的信息。运行前需要在项目中建立如下的资源文件。每个资源文件的内容如下其中文件名中的语言代码代表不同的国家及使用的语言如en-US美国英语、en-GB英国英语等等。文件名不带语言代码的为默认资源文件框架会根据当前计算机所在的区域来调用这个资源文件。由于我在中国并且使用简体中文的操作系统所以会将默认资源文件中的中文字符读出。1 static void Main(string[] args) 2 { 3 string hello; 4 hello International.Hello; 5 Console.WriteLine(hello); 6 Thread.CurrentThread.CurrentUICulture new System.Globalization.CultureInfo(ja-JP); 7 hello International.Hello; 8 Console.WriteLine(hello); 9 Thread.CurrentThread.CurrentUICulture new System.Globalization.CultureInfo(en-US); 10 hello International.Hello; 11 Console.WriteLine(hello); 12 Thread.CurrentThread.CurrentUICulture new System.Globalization.CultureInfo(en-GB); 13 hello International.Hello; 14 Console.WriteLine(hello); 15 Console.Read(); 16 }那么在Web API中如何确定用户来自哪个国家以及使用哪种语言、文化呢由于Web API无法主动读取用户所有区域的信息那么就只能被动地从用户那里获取此类信息。而这部分信息则会被包含在用户提交的HTTP请求头信息中。比如Accept-Language: en-us, en-gb;q0.8, en;q0.7在这段HTTP请求头信息中所传达的信息就是用户可接受的语言和地区文化。每种国家及语言后面的参数q称为相对质量的因素(relative quality factor)代表用户对于该种语言可接受的优先度取值0.0~1.0默认值为1.0。总之通俗一来就讲上面这段头信息的意思就是用户首选是美式英语如果不支持的话没关系那就英式英语吧再不行的话其它类型的英语也可以。上面的这段请求头信息提交到服务器时会被封装在HttpRequestMessage类(System.Net.Http命名空间)的Headers属性中我们可以很轻易地在Web API的控制器中读取到。参考以下例子1 public void Post(Object obj) 2 { 3 HttpHeaderValueCollectionStringWithQualityHeaderValue acceptedLanguages Request.Headers.AcceptLanguage; 4 foreach (StringWithQualityHeaderValue language in acceptedLanguages) 5 { 6 Debug.WriteLine(language.Value); 7 Debug.WriteLine(language.Quality); 8 } 9 }当然在实际的开发中上面的方法不是推荐的方法。更加科学的方法是我们新建一个自定义的DelegatingHandler简单一点来讲DelegatingHandler是HTTP请求通道中的过滤器。我们可以在这个DelegatingHandler中读取Accept-Language信息并且设置处理线程的Thread.CurrentCulture属性和CurrentUICulture属性。源码如下1 namespace HelloWebAPI.Infrastructure 2 { 3 public class CultureHandler : DelegatingHandler 4 { 5 6 private Liststring supportedCulture new Liststring() 7 { 8 zh-cn, en-us, ja-jp 9 }; 10 11 protected override System.Threading.Tasks.TaskHttpResponseMessage SendAsync(HttpRequestMessage request, System.Threading.CancellationToken cancellationToken) 12 { 13 HttpHeaderValueCollectionStringWithQualityHeaderValue acceptedLanguage request.Headers.AcceptLanguage; 14 if (acceptedLanguage ! null acceptedLanguage.Count 0) 15 { 16 StringWithQualityHeaderValue preferredLanguage 17 acceptedLanguage.OrderByDescending(e e.Quality ?? 1.0D) 18 .Where(e !e.Quality.HasValue || e.Quality.Value 0.0D) 19 .FirstOrDefault( 20 e supportedCulture.Contains(e.Value, StringComparer.OrdinalIgnoreCase)); 21 if (preferredLanguage ! null) 22 { 23 // 如需要此处也可同时设置CurrentCulture属性 24 Thread.CurrentThread.CurrentUICulture CultureInfo.GetCultureInfo(preferredLanguage.Value); 25 } 26 27 if (acceptedLanguage.Any(e e.Value * (!e.Quality.HasValue || e.Quality.Value 0.0D))) 28 { 29 string selectedCulture 30 supportedCulture.FirstOrDefault(e !acceptedLanguage.Any( 31 ee 32 ee.Value.Equals(e, StringComparison.OrdinalIgnoreCase) ee.Quality.HasValue 33 ee.Quality.Value 0.0D)); 34 if (!string.IsNullOrWhiteSpace(selectedCulture)) 35 { 36 // 如需要此处也可同时设置CurrentCulture属性 37 Thread.CurrentThread.CurrentUICulture CultureInfo.GetCultureInfo(selectedCulture); 38 } 39 } 40 } 41 return base.SendAsync(request, cancellationToken); 42 } 43 } 44 }上面的这段代码中假设系统支持的语言有美式英语、简体中文、日文。并且如果用户支持多种语言该DelegatingHandler也会根据头信息中的相对质量的因素q进行排序以确定首选语言。打开WebApiConfig.cs文件注册自定义的DelegatingHandler在Register静态方法中添加如下的语句。1 public static void Register(HttpConfiguration config) 2 { 3 config.Routes.MapHttpRoute( 4 name: DefaultApi, 5 routeTemplate: api/{controller}/{id}, 6 defaults: new { id RouteParameter.Optional } 7 ); 8 config.MessageHandlers.Add(new CultureHandler()); 9 }应用场景一根据用户所在的国家和使用的语言向用户提供不同语言的响应在项目中新建一个App_GlobalResources文件夹该文件为ASP.net的专属文件夹专门用于存放资源文件。分别建立几个对应语言的资源文件。文件中均有一个同键不同值的字符串“NotFound”该字符串用于提示用户找不到指定的文件或资源。在控制器中建立一个示例动作方法如下1 public class EmployeesController : ApiController 2 { 3 public HttpResponseMessage Get(int id) 4 { 5 // 业务逻辑此处省略 6 return Request.CreateErrorResponse(HttpStatusCode.NotFound, Resources.Message.NotFound); 7 } 8 }为了调试我们使用Fiddler来进行运行项目之后我们通过设置HTTP请求头信息中的Accept-Lanuage可以得到不同语言的响应。
