如何构建可读性更高的ASP.NET Core路由

本篇内容介绍了“如何构建可读性更高的ASP.NET Core路由”的有关知识，在实际案例的操作过程中，不少人都会遇到这样的困境，接下来就让小编带领大家学习一下如何处理这些情况吧！希望大家仔细阅读，能够学有所成！

Step by Step

        在构建项目的路由时，不管是采用大写的 URL 路由，还是采用小写的 URL 路由，我们首先需要确保的是，我们需要将整个项目的 URL 格式进行统一。不能说一个项目一部分的 URL 地址用大写的，而另一部分采用的是小写的 URL 地址。同时，同一个页面的大写的路径以及小写的路径，虽然最终服务器可能都会将两个地址指向同一个页面，但是对于搜索引擎的收录来说，这无疑是两个页面。
        试想以下，当别人告诉了我们一个有趣的网站，我们从浏览器的地址栏中输入网址进行访问。当我们输入 URL 地址时，不管是中文输入法还是英文输入法，输出的英文字母都是小写的，此时，如果输入的网址中存在大写字母，嗯，我们还需要使用 CapsLock 键进行大小写切换。
        另外，我们知道，对于 Windows 服务器来说，因为对于路径的大小写不敏感，如果我们弄错了地址的大小写，我们还是可以进行正常的访问的，可是，如果将应用部署到 Linux 服务器上的话。。。。

        至于更好的可读性，这个概念可能会显得有些主观。简单来说，就是当我们面对一个网址时，我们可以很清楚的通过这个网址知道这个网页的主要内容。例如，当我们看见www.youdomain.com/editor/post/new 这个网址时，虽然可能并没有打开这个网页，但我们还是可以大致猜到这个页面可能是新增文章的。可是，如果你收到的网址是 www.youdomain.com/9rg7f2/i?HXI-D+iaj34 这样的，没人能知道这个页面到底是干啥的。

        因此，为了便捷输入，首先我们需要将我们的 URL 地址转换成小写的形式，在 ASP.NET Core 中，微软提供了 RoutingServiceCollectionExtensions.AddRouting 这个扩展方法可以让我们将 URL 地址转换成小写。
        打开项目的 Startup.cs 文件，找到 ConfigureServices 方法，在方法体内添加下面的代码。

1
2
3
4

services.AddRouting(options =>
{
    options.LowercaseUrls = true;
});

        示例项目的顶部链接代码如下所示，运行项目可以看到，通过设置小写路由后，程序根据 Controller 和 Action 自动生成的 URL 地址全部变成了小写。仔细观察可以发现，这里会出现一个问题。在某些特殊的情况下，Area/Controller/Action 可能是由多个英文字母拼接而成的一个混合英文单词，如果把这个混合的单词全部进行小写而不进行拆分的话，整个项目的 URL 可读性更低了。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

<header>
    <nav class="navbar navbar-expand-sm navbar-toggleable-sm navbar-light bg-white border-bottom box-shadow mb-3">
        <div class="container">
            <a class="navbar-brand" asp-area="" asp-controller="Home" asp-action="Index">Sample</a>
            <button class="navbar-toggler" type="button" data-toggle="collapse" data-target=".navbar-collapse" aria-controls="navbarSupportedContent"
                    aria-expanded="false" aria-label="Toggle navigation">
                <span class="navbar-toggler-icon"></span>
            </button>
            <div class="navbar-collapse collapse d-sm-inline-flex flex-sm-row-reverse">
                <ul class="navbar-nav flex-grow-1">
                    <li class="nav-item">
                        <a class="nav-link text-dark" asp-area="" asp-controller="Home" asp-action="Index">Home</a>
                    </li>
                    <li class="nav-item">
                        <a class="nav-link text-dark" asp-area="" asp-controller="Home" asp-action="Privacy">Privacy</a>
                    </li>
                    <li class="nav-item">
                        <a class="nav-link text-dark" asp-area="" asp-controller="Post" asp-action="DraftSetting">Draft Setting</a>
                    </li>
                </ul>
            </div>
        </div>
    </nav>
</header>

        在 Startup 类中的 Configure 方法里，我们定义了针对包含 Area 和不包含 Area 的两个路由模板，整个项目的 URL 都是根据这两个模板进行生成的。那么这里我们是不是可以通过对单个 Controller 或是 Action 指定特殊的 URL 格式呢？

1
2
3
4
5
6
7
8
9
10

app.UseMvc(routes =>
{
    routes.MapRoute(
        name: "default",
        template: "{controller=Home}/{action=Index}/{id?}");

    routes.MapRoute(
        name: "areas",
        template: "{area:exists}/{controller=Home}/{action=Index}/{id?}");
});

        答案当然是可以的。在 ASP.NET Core 中，我们可以通过在 Controller 或是 Action 方法上添加 RouteAttribute 的方式将用户自定义路由信息添加到项目的路由表中。例如这里我在 DraftSetting 这个 Action 上使用特性路由的方式手动指定当前 Action 生成特殊的 URL 格式。

1
2
3
4
5
6
7
8

public class PostController : Controller
{
    [Route("post/draft-setting")]
    public IActionResult DraftSetting()
    {
        return View();
    }
}

        虽然这样可以解决我们的问题，可以一旦项目有新增页面时，就要手动的指定特性路由地址，这样似乎有些麻烦。那么，如何自动的让程序帮我们实现这一功能呢？
        在 ASP.NET Core 2.2 版本中，微软为我们提供了参数转换器这一概念，我们可以通过实现 IOutboundParameterTransformer 这个接口，从而将 URL 中路由的值或者是 URL 中路由参数的值按照我们的需求进行转换。就像下面的代码中，我通过实现这个接口，从而实现将多个英文单词生成的混合单词以 hyphen(-) 的形式进行分隔。

1
2
3
4
5
6
7
8
9

public class SlugifyParameterTransformer : IOutboundParameterTransformer
{
    public string TransformOutbound(object value)
    {
        return value == null
            ? null
            : Regex.Replace(value.ToString(), "([a-z])([A-Z])", "$1-$2").ToLower();
    }
}

        这里我使用 hyphen(-) 作为 URL 中各个单词间的连字符，是因为对于搜索引擎来说，它会将 - 视为单词间分隔符，采用这种风格的 URL 更有利于搜索引擎收录。
        当接口功能实现之后，我们就需要对我们的默认全局路由进行修改。首先，我们需要在路由模板上指定需要替换的路由参数，这里我们指定 Area、Controller、Action 是需要进行路由参数转换的变量。

1
2
3
4
5
6
7
8
9
10
11

app.UseMvc(routes =>
{
    routes.MapRoute(
        name: "default",
        template: "{controller:slugify=Home}/{action:slugify=Index}/{id?}");

    routes.MapRoute(
       name: "areas",
       template: "{area:exists:slugify}/{controller:slugify=Home}/{action:slugify=Index}/{id?}"
    );
});

        当定义好参数转换器以及需要转换的 URL 路由参数后，我们就可以在 AddRouting 方法中通过 ConstraintMap 进行配置需要转换的参数路由值。至此就可以完成我们进行路由参数转换的结果。

1
2
3
4

services.AddRouting(options => {
    options.ConstraintMap["slugify"] = typeof(SlugifyParameterTransformer);
    options.LowercaseUrls = true;
});

“如何构建可读性更高的ASP.NET Core路由”的内容就介绍到这里了，感谢大家的阅读。如果想了解更多行业相关的知识可以关注亿速云网站，小编将为大家输出更多高质量的实用文章！