asp.net core api路由及多语言切换的实现

预期目标：https://myweb.com/zh-CN/api/post、https://myweb.com/en-US/api/post

即通过地址实现多语言切换。

 

在startup.cs中配置：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }

            app.UseHttpsRedirection();

            app.UseRouting();

            app.UseAuthorization();

            app.UseStaticFiles();

            CultureInfo[] supportedCultures = new[]
            {
                new CultureInfo("en"),
                new CultureInfo("zh-CN")
            };

            var options = new RequestLocalizationOptions();
            options.DefaultRequestCulture = new RequestCulture("en");
            options.SupportedCultures = supportedCultures;
            options.SupportedUICultures = supportedCultures;

            options.RequestCultureProviders.Insert(0, new RouteDataRequestCultureProvider { Options = options });

            app.UseRequestLocalization(options);//一定要放在这个位置

            app.UseEndpoints(endpoints =>
            {
                //endpoints.MapControllers();
                endpoints.MapControllerRoute(name: "default", pattern: "~/{culture}/{controller}/{action}");
            });
        }

 

采用MapControllerRoute配置路由则无需再为controler及其action配置属性路由，controler及其action会自动根据MapControllerRoute配置的共享路由配置自己的路由。如果仍然给controler及其action配置了属性路由，则系统则以ontroler及其action的属性路由为准。换句话说，MapControllerRoute配置的路由是共享路由，controler及其action配置的路由是针对单个controler及其action的个性化路由。个性化路由优先于共享路由。

 

RouteDataRequestCultureProvider是实现地址栏多语言切换的重要类，配合endpoints.MapControllerRoute的{culture}参数设置即可实现目标，它会根据路由规则自动读取地址栏对应的culture值设置为当前的cultureInfo。

 

上面的代码通过下面的方式修改，可以达到相同效果。

把16行到27行的代码定义到ConfigureServices(IServiceCollection services)方法中：

public void ConfigureServices(IServiceCollection services)
        {
            CultureInfo[] supportedCultures = new[]
           {
             new CultureInfo("en"),
             new CultureInfo("zh-CN")
            };

            services.Configure<RequestLocalizationOptions>(options =>
            {
                options.DefaultRequestCulture = new RequestCulture("en");
                options.SupportedCultures = supportedCultures;
                options.SupportedUICultures = supportedCultures;

                options.RequestCultureProviders.Insert(0, new RouteDataRequestCultureProvider { Options = options });
            });

            
            services.AddControllers();
        }

然后把第一段代码的16到29行改为：

app.UseRequestLocalization();

即可。效果是一样的！