基于 abp vNext 和 .NET Core 开发博客项目 - Blazor 实战系列（五）

时间 2020-06-14

标签基于 abp vnext core 开发博客项目 blazor 实战系列繁體版

原文原文链接

系列文章

上一篇完成了分类标签友链的列表查询页面数据绑定，还剩下一个文章详情页的数据没有绑，如今简单的解决掉。javascript

文章详情

以前已经添加了四个参数：year、month、day、name，用来组成咱们最终的URL，继续添加一个参数用来接收API返回的数据。html

[Parameter]
public int year { get; set; }

[Parameter]
public int month { get; set; }

[Parameter]
public int day { get; set; }

[Parameter]
public string name { get; set; }

/// <summary>
/// URL
/// </summary>
private string url => $"/{year}/{(month >= 10 ? month.ToString() : $"0{month}")}/{(day >= 10 ? day.ToString() : $"0{day}")}/{name}/";

/// <summary>
/// 文章详情数据
/// </summary>
private ServiceResult<PostDetailDto> post;

而后在初始化方法OnInitializedAsync()中请求数据。前端

/// <summary>
/// 初始化
/// </summary>
protected override async Task OnInitializedAsync()
{
    // 获取数据
    post = await Http.GetFromJsonAsync<ServiceResult<PostDetailDto>>($"/blog/post?url={url}");
}

如今拿到了post数据，而后在HTML中绑定便可。java

@if (post == null)
{
    <Loading />
}
else
{
    @if (post.Success)
    {
        var _post = post.Result;

        <article class="post-wrap">
            <header class="post-header">
                <h1 class="post-title">@_post.Title</h1>
                <div class="post-meta">
                    Author: <a itemprop="author" rel="author" href="javascript:;">@_post.Author</a>
                    <span class="post-time">
                        Date: <a href="javascript:;">@_post.CreationTime</a>
                    </span>
                    <span class="post-category">
                        Category:<a href="/category/@_post.Category.DisplayName/">@_post.Category.CategoryName</a>
                    </span>
                </div>
            </header>
            <div class="post-content" id="content">
                @((MarkupString)_post.Html)
            </div>
            <section class="post-copyright">
                <p class="copyright-item">
                    <span>Author:</span>
                    <span>@_post.Author</span>
                </p>
                <p class="copyright-item">
                    <span>Permalink:</span>
                    <span><a href="/post@_post.Url">https://meowv.com/post@_post.Url</a></span>
                </p>
                <p class="copyright-item">
                    <span>License:</span>
                    <span>本文采用<a target="_blank" href="http://creativecommons.org/licenses/by-nc-nd/4.0/"> 知识共享 署名-非商业性使用-禁止演绎(CC BY-NC-ND)国际许可协议 </a>进行许可</span>
                </p>
            </section>
            <section class="post-tags">
                <div>
                    <span>Tag(s):</span>
                    <span class="tag">
                        @if (_post.Tags.Any())
                        {
                            @foreach (var tag in _post.Tags)
                            {
                                <a href="/tag/@tag.DisplayName/"># @tag.TagName</a>
                            }
                        }
                    </span>
                </div>
                <div>
                    <a @onclick="async () => await Common.BaskAsync()">back</a>
                    <span>· </span>
                    <a href="/">home</a>
                </div>
            </section>
            <section class="post-nav">
                @if (_post.Previous != null)
                {
                    <a class="prev"
                       rel="prev"
                       @onclick="@(async () => await Common.NavigateTo($"/post{_post.Previous.Url}, true))"
                       href="/post@_post.Previous.Url">@_post.Previous.Title</a>
                }
                @if (_post.Next != null)
                {
                    <a class="next"
                       rel="next"
                       @onclick="@(async () => await Common.NavigateTo($"/post{_post.Next.Url}", true))"
                       href="/post@_post.Next.Url">
                        @_post.Next.Title
                    </a>
                }
            </section>
        </article>
    }
    else
    {
        <ErrorTip />
    }
}

其中有几个地方须要注意一下：git

咱们从post对象中取到的文章内容HTML，直接显示是不行了，须要将其解析为HTML标签，须要用到MarkupString。github

而后页面上有一个后退按钮，这里我在Common.cs中写了一个方法来实现。浏览器

/// <summary>
/// 后退
/// </summary>
/// <returns></returns>
public async Task BaskAsync()
{
    await InvokeAsync("window.history.back");
}

还有就是上一篇和下一篇的问题，将具体的URL传递给NavigateTo()方法，而后跳转过去便可。缓存

在Common.cs中将以前文章建立RenderPage()方法修改为NavigateTo()。这个命名更好一点。cookie

/// <summary>
/// 跳转指定URL
/// </summary>
/// <param name="uri"></param>
/// <param name="forceLoad">true，绕过路由刷新页面</param>
/// <returns></returns>
public async Task NavigateTo(string url, bool forceLoad = false)
{
    _navigationManager.NavigateTo(url, forceLoad);

    await Task.CompletedTask;
}

如今数据算是绑定完了，可是遇到了一个大问题，就是详情页面的样式问题，由于用到了Markdown，因此以前是加载了许多JS文件来处理的。那么如今确定行不通了，因此关于详情页的样式问题暂时搁浅，让我寻找一下好多解决方式。网络

如今显示是没有问题了，就是不太好看，还有关于添加文章的功能，不知道有什么好的 Markdown 编辑器能够推荐我使用。

到这里Blazor的前端展现页面已经所有弄完了，接下来开始写后台相关的页面。

后台首页

关于后台管理的全部页面都放在Admin文件夹下，在Pages文件夹下新建Admin文件夹，而后先添加两个组件页面：Admin.razor、Auth.razor。

Admin.razor为后台管理的首页入口，咱们在里面直接添加几个预知的连接并设置其路由。

@page "/admin"

<div class="post-wrap">
    <h2 class="post-title">-&nbsp;博客内容管理&nbsp;-</h2>
    <ul>
        <li>
            <a href="/admin/post"><h3>📝~~~ 新增文章 ~~~📝</h3></a>
        </li>
        <li>
            <a href="/admin/posts"><h3>📗~~~ 文章管理 ~~~📗</h3></a>
        </li>
        <li>
            <a href="/admin/categories"><h3>📕~~~ 分类管理 ~~~📕</h3></a>
        </li>
        <li>
            <a href="/admin/tags"><h3>📘~~~ 标签管理 ~~~📘</h3></a>
        </li>
        <li>
            <a href="/admin/friendlinks"><h3>📒~~~ 友链管理 ~~~📒</h3></a>
        </li>
    </ul>
</div>

里面的a标签所对应的页面尚未添加，等作到的时候再加，先手动访问这个页面看看，当成功受权后就跳到这个页面来。

认证受权

关于受权，由于以前在API中已经完成了基于Github的JWT模式的认证受权模式，因此这里我想作一个无感的受权功能，为何说无感呢，由于在我使用GitHub登陆的过程当中，若是以前已经登陆过且没有清除浏览器cookie数据，下次再登陆的时候会默认直接登陆成功，从而达到无感的。

实现逻辑其实也很简单，我这里用到了Common.cs中以前添加的公共方法设置和获取localStorage的方法，我会将token等信息放入localStorage中。

我设置的路由是：/auth。这个路由须要和 GitHub OAuth App 的回调地址一致，当登陆成功，会回调跳到配置的页面并携带code参数。

在获取请求参数这块须要引用一个包：Microsoft.AspNetCore.WebUtilities，添加好后在_Imports.razor添加引用：@using Meowv.Blog.BlazorApp.Shared。

默认仍是显示加载中的组件：<Loading />。

而后在@code{}中编写代码，添加页面初始化函数。

/// <summary>
/// 初始化
/// </summary>
/// <returns></returns>
protected override async Task OnInitializedAsync()
{
    // localStorage中access_token值
    var access_token = await Common.GetStorageAsync("access_token");

    // access_token有值
    if (!string.IsNullOrEmpty(access_token))
    {
        // 获取token
        var _token = await Http.GetFromJsonAsync<ServiceResult<string>>($"/auth/token?access_token={access_token}");
        if (_token.Success)
        {
            // 将token存入localStorage
            await Common.SetStorageAsync("token", _token.Result);

            // 跳转至后台首页
            await Common.NavigateTo("/admin");
        }
        else
        {
            // access_token失效，或者请求失败的状况下，从新执行一次验证流程
            await AuthProcessAsync();
        }
    }
    else //access_token为空
    {
        await AuthProcessAsync();
    }
}

先去获取localStorage中的access_token值，确定会有两种状况，有或者没有，而后分别去走不一样的逻辑。

当access_token有值，就能够直接拿access_token去取token的值，理想状况请求成功拿到了token，这时候能够将token存到浏览器中，而后正常跳转至后台管理首页，还有就是取token失败了，失败了就有多是access_token过时了或者出现异常状况，这时候咱们不去提示错误，直接抛弃全部，从新来一遍认证受权的流程，放在一个单独的方法中AuthProcessAsync()。

而当access_token没值那就好办了，也去来一遍认证受权的流程便可。

验证流程AuthProcessAsync()的代码。

/// <summary>
/// 验证流程
/// </summary>
/// <returns></returns>
private async Task AuthProcessAsync()
{
    // 当前URI对象
    var uri = await Common.CurrentUri();

    // 是否回调携带了code参数
    bool hasCode = QueryHelpers.ParseQuery(uri.Query).TryGetValue("code", out Microsoft.Extensions.Primitives.StringValues code);

    if (hasCode)
    {
        var access_token = await Http.GetFromJsonAsync<ServiceResult<string>>($"/auth/access_token?code={code}");
        if (access_token.Success)
        {
            // 将access_token存入localStorage
            await Common.SetStorageAsync("access_token", access_token.Result);

            var token = await Http.GetFromJsonAsync<ServiceResult<string>>($"/auth/token?access_token={access_token.Result}");
            if (token.Success)
            {
                // 将token存入localStorage
                await Common.SetStorageAsync("token", token.Result);

                // 成功认证受权，跳转至后台管理首页
                await Common.NavigateTo("/admin");
            }
            else
            {
                // 没有权限的人，回到首页去吧
                await Common.NavigateTo("/");

                // 输出提示信息
                Console.WriteLine(token.Message);
            }
        }
        else
        {
            // 出错了，回到首页去吧
            await Common.NavigateTo("/");

            // 输出提示信息
            Console.WriteLine(access_token.Message);
        }
    }
    else
    {
        // 获取第三方登陆地址
        var loginAddress = await Http.GetFromJsonAsync<ServiceResult<string>>("/auth/url");

        // 跳转到登陆页面
        await Common.NavigateTo(loginAddress.Result);
    }
}

验证流程的逻辑先获取当前URI对象，判断URI中是否携带了code参数，从而能够知道当前页面是回调的过来的仍是直接请求的，获取当前URI对象放在Common.cs中。

/// <summary>
/// 获取当前URI对象
/// </summary>
/// <returns></returns>
public async Task<Uri> CurrentUri()
{
    var uri = _navigationManager.ToAbsoluteUri(_navigationManager.Uri);

    return await Task.FromResult(uri);
}

在刚才添加的包Microsoft.AspNetCore.WebUtilities中为咱们封装好了解析URI参数的方法。

使用QueryHelpers.ParseQuery(...)获取code参数的值。

当没有值的时候，直接取请求登陆地址，而后若是登陆成功就会跳转到携带code参数的回调页面。这样流程就又回到了验证流程开始的地方了。

登陆成功，此时code确定就有值了，那么直接根据code获取access_token，存入localStorage，正常状况拿到access_token就去生成token，而后也存入localStorage，成功受权能够跳到后台管理首页了。

其中若是有任何一个环节出现问题，直接跳转到网站首页去。若是受权不成功确定是你在瞎搞(不接受任何反驳🤣🤣)，赶忙回到首页去吧。

如今流程走完，去看看效果。

GitHub在国内的状况你们知道，有时候慢甚至打不开，有时候仍是挺快的，还好今天没掉链子，我遇到过好几回压根打不开的状况，获取能够针对网络很差的时候咱们换成其它的验证方式，这个之后有机会再优化吧。

验证组件

这个时候会发现，其实咱们压根不须要打开/auth走验证流程，直接访问/admin就能够进来管理首页，这是极其不合理的。那岂不是谁知道地址谁都能进来瞎搞了。因此咱们能够在 Shared 文件夹下添加一个权限验证的组件：AdminLayout.razor。用来判断是否真的登陆了。

新建一个bool类型的变量 isLogin。默认确定是false，此时可让页面转圈圈，使用<Loading />组件。当isLogin = true的时候咱们才展现具体的HTML内容。

那么就须要用到服务端组件RenderFragment，他有一个固定的参数名称ChildContent。

判断是否登陆的方法能够写在初始化方法中，这里还少了一个API，就是判断当前token的值是否合法，合法就表示已经成功执行了验证流程了。token不存在或者不合法，直接拒绝请求返回到首页去吧。

整个代码以下：

@if (!isLogin)
{
    <Loading />
}
else
{
    @ChildContent
}

@code {
    /// <summary>
    /// 展现内容
    /// </summary>
    [Parameter]
    public RenderFragment ChildContent { get; set; }

    /// <summary>
    /// 是否登陆
    /// </summary>
    private bool isLogin { get; set; }

    /// <summary>
    /// 初始化
    /// </summary>
    /// <returns></returns>
    protected override async Task OnInitializedAsync()
    {
        var token = await Common.GetStorageAsync("token");

        if (string.IsNullOrEmpty(token))
        {
            isLogin = false;

            await Common.NavigateTo("/");
        }
        else
        {
            // TODO:判断token是否合法，先默认都是正确的
            isLogin = true;
        }
    }
}

使用这个组件也很方便了，咱们后台全部页面都引用AdminLayout，将展现内容传递给就好了，成功验证后就会展现HTM内容。

在Admin.razor中使用。

@page "/admin"

<AdminLayout>
    <div class="post-wrap">
        <h2 class="post-title">-&nbsp;博客内容管理&nbsp;-</h2>
        <ul>
            <li>
                <a href="/admin/post"><h3>📝~~~ 新增文章 ~~~📝</h3></a>
            </li>
            <li>
                <a href="/admin/posts"><h3>📗~~~ 文章管理 ~~~📗</h3></a>
            </li>
            <li>
                <a href="/admin/categories"><h3>📕~~~ 分类管理 ~~~📕</h3></a>
            </li>
            <li>
                <a href="/admin/tags"><h3>📘~~~ 标签管理 ~~~📘</h3></a>
            </li>
            <li>
                <a href="/admin/friendlinks"><h3>📒~~~ 友链管理 ~~~📒</h3></a>
            </li>
        </ul>
    </div>
</AdminLayout>

如今清除掉浏览器缓存，去请求/admin试试。

完美，比较简单的实现了验证是否登陆的组件。其中还有许多地方能够优化，就交给你们去自行完成了😎。

开源地址：https://github.com/Meowv/Blog/tree/blog_tutorial