[转载]ASP.NET MVC的全球化方案 – P_Chou Go deep and Keep learning – 博客园.
由于项目需要最近在学习ASP.NET MVC。在实践中,网站要支持多语言,需要全球化。在MVC下我实现了一个全球化框架,在这里与各位分享一下,不足之处也请各位看官指教。
让URL支持全球化
经常上微软网站的朋友可能很熟悉类似包含..\zh-cn\..、..\en-us\..的url形式,这就是本文要使用的全球化方案。当然还有使用QueryString传递参数的方案,基本思路我想是类似的。
由于MVC天生的URL路由原理,使得这个方案很容易被接受。
基本思路
这个方案的基本思路是:
1.当用户访问的url含有合法的culture参数时,能够直接路由到对应的controller,在controller初始化时设置线程的Culture;
2.当用户访问的url不包含culture参数时,同样被路由到对应的controller,但controller在执行action前,重定向到包含Culture的url。这里的Culture按照先检测cookie,再检测语言浏览器设置,最后使用默认值的优先级顺序实施。
先看下效果演示,注意url,点击下载例子
Resource.resx
在接下去之前先回顾一下资源文件。在ASP.NET web应用程序(winform同样)中定义的资源文件.resx实际上是一个xml配置文件,通常我们只关心其中的key\value配置;我们可以建 立一个或多个.resx,这些.resx会对应生成一个cs文件,这个cs文件会定义一个类(可能是Resource类,取决于你的资源文件的命名),通 过访问这个类的静态属性即可访问这些key,而选择哪个.resx读取的关键就是CultureInfo,只要我们设置当前线程的 CultureInfo,Resource便会自动识别对应的.resx配置文件。而在.resx的命名上,需要按照这样的规则:
Resource.zh-cn.resx(对应简体中文资源文件)
Resource.en-us.resx(对应美国英语资源文件)
中间的Culture名字很重要。
通常在开发时,只要一个默认的Resource.resx,当开发完成之后,拷贝一个相同的Resource.resx,并改名字成上面的样子,然后手动或自动将其中的所有value都翻译成对应的语言。
解决路由问题
在这个方案中,首先要考虑的是url路由配置。首先,理想情况下,我们所有的url都是domain/culture/controller /action/param1/..这种形式,那么只要一份以culture开头的路由就可以了。但是事实上并非这么简单,如果用户不知道这个规则,他手 动输入了domain/controller/action/param1..那么这种url将不能被正确路由。这种情况在初次访问网站的时候最为常见 (通常我们都会键入www.microsoft.com而不会在后面加 上任何的culture参数)。那么难道我们要为了这种场景写两份路由吗?显然不是,或者说不用手动做这件事。这里要解决的第一个问题出现了。我的方案 是:只为domain/controller/action/param1..这种路由手动写代码配置,这也比较符合习惯;然后通过一个方法,遍历 route表中的所有路由,并在每个url规则前面加上一个参数ci表示culture,生成一份新的路由加到路由表中即可。这样做尽管没有减少路由规 则,但是至少不用手动一个个写了,要不然没人会同意这个方案的。下面是代码和解释:
1 |
protected void Application_Start() |
3 |
AreaRegistration.RegisterAllAreas(); |
4 |
RegisterRoutes(RouteTable.Routes); |
5 |
RegisterGlobalizationRoutes(); |
01 |
private void RegisterGlobalizationRoutes() |
04 |
if (RouteTable.Routes == null ) |
07 |
RouteCollection rc = new RouteCollection(); |
12 |
var routes = RouteTable.Routes.SkipWhile(p => (p.GetType().Name == "IgnoreRouteInternal" )); |
14 |
int insertpoint = RouteTable.Routes.Count() - routes.Count(); |
17 |
foreach (var r in routes) |
19 |
Route item = (r as Route); |
21 |
Route newitem = new Route( |
24 |
new MvcRouteHandler()); |
25 |
newitem.Defaults = new RouteValueDictionary(item.Defaults); |
26 |
newitem.Constraints = new RouteValueDictionary(item.Constraints); |
28 |
newitem.Constraints.Add( "ci" , new CulturePrefixRule()); |
29 |
newitem.DataTokens = new RouteValueDictionary(); |
30 |
newitem.DataTokens[ "Namespaces" ] = item.DataTokens[ "Namespaces" ]; |
36 |
RouteTable.Routes.Insert(insertpoint++, c); |
02 |
private class CulturePrefixRule : IRouteConstraint |
04 |
IEnumerable< string > cultureConllection = CultureInfo.GetCultures(CultureTypes.SpecificCultures).Select(p => p.Name.ToLower()); |
05 |
public bool Match(HttpContextBase httpContext, Route route, string parameterName, RouteValueDictionary values, RouteDirection routeDirection) |
07 |
if (values[parameterName] != null ) |
08 |
return cultureConllection.Contains(values[parameterName].ToString().ToLower()); |
这里要注意几点:
1.routes.IgnoreRoute(“{resource}.axd/{*pathInfo}”);会在路由表中添加一条IgnoreRouteInternal类型的路由,只不过这条是需要被跳过的而已。三个类的关系是:
RouteBase->Route->IgnoreRouteInternal
而不巧的是IgnoreRouteInternal是个私有类,因此,只能借助反射了。
2.为路由设置Constraints属性时,实际上是为其指 定一个IRouteConstraint。MVC内部有一个实现了IRouteConstraint的接受正则表达式的类,我们在MapRoute方法中 用一个string初始化Constraints,实际上就是实例化了这个类。而这里我们的需求显然要复杂点:需要判断ci参数是否是支持的,所以也就有 了CulturePrefixRule实现IRouteConstraint。
3.带有ci参数的路由更“特殊”,所以最好还是放在路由表前面。原因我就不再累述了。
在Controller的Action执行前跳转
所有的Controller都应该具有一个相同的行为:能够针对没有ci参数的url实施跳转。因此自然想到实现一个基类Controller,这里我命名为BaseController,代码如下:
01 |
public class BaseController : Controller |
03 |
protected string redirectUrl; |
05 |
protected override void Initialize(System.Web.Routing.RequestContext requestContext) |
07 |
base .Initialize(requestContext); |
10 |
if (requestContext.RouteData.Values.TryGetValue( "ci" , out cultureValue)) |
15 |
Thread.CurrentThread.CurrentUICulture = CultureProvider.GetCultureInfo(cultureValue.ToString()); |
16 |
Thread.CurrentThread.CurrentCulture = CultureProvider.GetCultureInfo(cultureValue.ToString()); |
01 |
Response.Cookies.Add( new HttpCookie(CultureProvider.culturecookiekey,cultureValue.ToString())); |
03 |
catch { throw new Exception( "Culture Error!" ); } |
08 |
HttpCookie cLang = requestContext.HttpContext.Request.Cookies[CultureProvider.culturecookiekey]; |
11 |
cultureValue = cLang.Value; |
15 |
string [] langs = requestContext.HttpContext.Request.UserLanguages; |
16 |
if (langs != null && langs.Length > 0) |
18 |
cultureValue = langs[0].Split( ';' ).First(); |
22 |
if (cultureValue == null ) |
24 |
cultureValue = CultureProvider.culturedefault; |
27 |
redirectUrl = string .Format( @"/{0}{1}" , |
28 |
cultureValue.ToString(), |
29 |
requestContext.HttpContext.Request.RawUrl); |
34 |
protected override IActionInvoker CreateActionInvoker() |
36 |
return new CustomControllerActionInvoker(redirectUrl); |
42 |
internal class CustomControllerActionInvoker : ControllerActionInvoker |
45 |
public CustomControllerActionInvoker( string url) |
50 |
protected override ActionResult InvokeActionMethod(ControllerContext controllerContext, ActionDescriptor actionDescriptor, IDictionary< string , object > parameters) |
54 |
if (! string .IsNullOrEmpty(redirectUrl) && !controllerContext.IsChildAction) |
55 |
returnValue = new RedirectResult(redirectUrl); |
57 |
returnValue = actionDescriptor.Execute(controllerContext, parameters); |
58 |
ActionResult result = CreateActionResult(controllerContext, actionDescriptor, returnValue); |
63 |
public static class CultureProvider |
65 |
public const string culturecookiekey = "Lang" ; |
66 |
public const string culturedefault = "en-US" ; |
68 |
public static CultureInfo GetCultureInfo( string ci) |
72 |
return new CultureInfo(ci); |
只要所有的Controller继承这个BaseController即可。
这里需要重点指出的是 CustomControllerActionInvoker类,事实上发现从这个类入手解决重定向问题花了我不少时间,为此我不得不调试MVC的源码。 当然最初的想法是在每个action执行时手动判断redirectUrl,从而指导重定向,但显然,没人愿意将自己已经写好的action都拿出来一个 个改,所以也就有了这个小小的探索。
页面中的链接、跳转
最后令我感到即高兴又担心的问题是:当我使用这个框架后,页面 中的所有链接和跳转因素几乎都能自动在url前面加上ci参数!虽然我知道类似Html.ActionLink之类的helper有从路由表中产生url 的能力,但是能够自动添加上ci,还是让我感到有点始料未及。不过,链接的url是否正确,还是要注意,有一些特殊情况。
页面中使用资源
在页面中引用资源可以直接在C#脚本中引用Resource类。这里提供一个helper。这个Html的扩展方法。
01 |
public static class ResourceExtensions |
03 |
public static string Resource( this Controller controller, string expression, params object [] args) |
05 |
ResourceExpressionFields fields = GetResourceFields(expression, "~/" ); |
06 |
return GetGlobalResource(fields, args); |
09 |
public static string Resource( this HtmlHelper htmlHelper, string expression, params object [] args) |
12 |
ResourceExpressionFields fields = GetResourceFields( string .Format( "Resource,{0}" , expression), path); |
13 |
return GetGlobalResource(fields, args); |
16 |
static string GetGlobalResource(ResourceExpressionFields fields, object [] args) |
18 |
return string .Format(( string )HttpContext.GetGlobalResourceObject(fields.ClassKey, fields.ResourceKey, CultureInfo.CurrentUICulture), args); |
21 |
static ResourceExpressionFields GetResourceFields( string expression, string virtualPath) |
23 |
var context = new ExpressionBuilderContext(virtualPath); |
24 |
var builder = new ResourceExpressionBuilder(); |
25 |
return (ResourceExpressionFields)builder.ParseExpression(expression, typeof ( string ), context); |
需要注意的是这个方法默认认为Resource是资源的类名,所以必要的话需要修改
ResourceExpressionFields fields = GetResourceFields(string.Format(“Resource,{0}”, expression), path); 中的”Resource,{0}”
结语
初学MVC,甚至可以说是初学web开发。以上是我个人提出的一种方案,不知道有没有什么不足之处,还请各位看官提出见解,探讨一下。
点击下载例子
其他相关资源:
http://blog.miniasp.com/post/2010/01/ASPNET-MVC-Developer-Note-Part-15-Globalization-and-Localization.aspx