基于 abp vNext 和 .NET Core 开发博客项目 - 完善与美化，Swagger登场

时间  2020-05-19
标签 基于 abp vnext core 开发 博客 项目 完善 美化 swagger 登场 繁體版
原文   原文链接

上一篇文章(http://www.javashuo.com/article/p-veljlwtl-bk.html)已经成功将博客项目跑起来了，那么本篇主要是将以前遗留的问题解决，如今的代码看起来可能仍是比较混乱，有大量与之无关的代码存在里面，对于强迫症患者来讲真的是零容忍。html

在程序员界，总有一批强迫症患者，他们但愿本身写的代码看起来尽可能的完美无瑕疵。git

完善与美化

直奔主题，首先将各项目层的项目文件(.csproj)打开，格式化一下，没有引用<Import Project="..\..\common.props" />这句代码的也加一下，这里其实就是将公共属性拿出来，没什么特殊的。程序员

common.props中的代码也很是简单，主要是禁用当开启输出XML的时候没有给代码进行summary注释产生的警告，其实这些大可没必要为之折腾，不影响项目的成功运行。若是您以为没啥必要，彻底能够跳过此小节看最后。github

.Application

.Application层如今只引用Volo.Abp.Identity.Application包，和依赖.Application.Caching、.Application.Contracts、.Domain.Shared三个项目。数据库

//Meowv.Blog.Application.csproj
<Project Sdk="Microsoft.NET.Sdk">

  <Import Project="..\..\common.props" />

  <PropertyGroup>
    <TargetFramework>netcoreapp3.1</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Volo.Abp.Identity.Application" Version="2.7.0" />
    
    <ProjectReference Include="..\Meowv.Blog.Application.Caching\Meowv.Blog.Application.Caching.csproj" />
    <ProjectReference Include="..\Meowv.Blog.Application.Contracts\Meowv.Blog.Application.Contracts.csproj" />
    <ProjectReference Include="..\Meowv.Blog.Domain.Shared\Meowv.Blog.Domain.Shared.csproj" />
  </ItemGroup>

</Project>

.Application.Caching

.Application.Caching层看名字就知道，我准备用它来处理缓存，这里会用到两个包，Volo.Abp.Caching、Microsoft.Extensions.Caching.Redis。json

无论三七二十一，新建一个模块类MeowvBlogApplicationCachingModule.cs，依赖于AbpCachingModule和咱们的MeowvBlogDomainModule模块(此时还没添加)缓存

using Volo.Abp.Caching;
using Volo.Abp.Modularity;

namespace Meowv.Blog.Application.Caching
{
    [DependsOn(
        typeof(AbpCachingModule)
        // ...
    )]
    public class MeowvBlogApplicationCachingModule : AbpModule
    {
        public override void ConfigureServices(ServiceConfigurationContext context)
        {
            base.ConfigureServices(context);
        }
    }
}
//Meowv.Blog.Application.Caching.csproj
<Project Sdk="Microsoft.NET.Sdk">

  <Import Project="..\..\common.props" />

  <PropertyGroup>
    <TargetFramework>netcoreapp3.1</TargetFramework>
  </PropertyGroup>
  
  <ItemGroup>
    <PackageReference Include="Microsoft.Extensions.Caching.Redis" Version="2.2.0" />
    <PackageReference Include="Volo.Abp.Caching" Version="2.7.0" />
    
    <ProjectReference Include="..\Meowv.Blog.Application.Contracts\Meowv.Blog.Application.Contracts.csproj" />
    <ProjectReference Include="..\Meowv.Blog.Domain.Shared\Meowv.Blog.Domain.Shared.csproj" />
    <ProjectReference Include="..\Meowv.Blog.ToolKits\Meowv.Blog.ToolKits.csproj" />
  </ItemGroup>

</Project>

.Application.Contracts

删掉里面全部文件，.Application.Contracts层我不许备按照abp那样来作，此层我只想用来放咱们的传输对象(DTO)，添加项目引用Domain.Shared，同时开启输出XML文件到咱们.HttpApi.Hostingapp

输出XML很简单，在 Visual Studio 中对着项目 右键=>属性=>生成=>输出，而后选择XML文档文件，默认为一个物理路径，咱们将其改成相对路径..\Meowv.Blog.HttpApi.Hosting\Meowv.Blog.Application.Contracts.xml，XML输出到.HttpApi.Hosting层。dom

也能够直接修改项目文件实现，以下ide

//Meowv.Blog.Application.Contracts.csproj
<Project Sdk="Microsoft.NET.Sdk">

  <Import Project="..\..\common.props" />

  <PropertyGroup>
    <TargetFramework>netcoreapp3.1</TargetFramework>
  </PropertyGroup>

  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|AnyCPU'">
    <DocumentationFile>..\Meowv.Blog.HttpApi.Hosting\Meowv.Blog.Application.Contracts.xml</DocumentationFile>
  </PropertyGroup>

  <ItemGroup>
    <ProjectReference Include="..\Meowv.Blog.Domain.Shared\Meowv.Blog.Domain.Shared.csproj" />
  </ItemGroup>

</Project>

.Domain

.Domain层为咱们的实体领域模型，不须要引用其它层，只添加包Volo.Abp.Identity.Domain，同时也输出一下XML文件，XML文件的做用后续Swagger会用的。

//Meowv.Blog.Domain.csproj
<Project Sdk="Microsoft.NET.Sdk">

  <Import Project="..\..\common.props" />

  <PropertyGroup>
    <TargetFramework>netcoreapp3.1</TargetFramework>
  </PropertyGroup>

  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|AnyCPU'">
    <DocumentationFile>..\Meowv.Blog.HttpApi.Hosting\Meowv.Blog.Domain.xml</DocumentationFile>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Volo.Abp.Identity.Domain" Version="2.7.0" />

    <ProjectReference Include="..\Meowv.Blog.Domain.Shared\Meowv.Blog.Domain.Shared.csproj" />
  </ItemGroup>

</Project>

删掉此层全部文件，不要忘了添加模块类，MeowvBlogDomainModule.cs，它依赖AbpIdentityDomainModule模块

using Volo.Abp.Identity;
using Volo.Abp.Modularity;

namespace Meowv.Blog.Domain
{
    [DependsOn(typeof(AbpIdentityDomainModule))]
    public class MeowvBlogDomainModule : AbpModule
    {

    }
}

此时上面.Application.Caching中能够将MeowvBlogDomainModule加上了。

//MeowvBlogApplicationCachingModule.cs
...
    [DependsOn(
        typeof(AbpCachingModule),
        typeof(MeowvBlogDomainModule)
    )]
    public class MeowvBlogApplicationCachingModule : AbpModule
    {
        ...
    }
...

.Domain.Shared

.Domain.Shared层至关于.Domain的一个扩展同样，这里放一下项目用到的枚举、公共常量等内容，须要引用咱们的.Domain项目

<Project Sdk="Microsoft.NET.Sdk">

  <Import Project="..\..\common.props" />

  <PropertyGroup>
    <TargetFramework>netcoreapp3.1</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <ProjectReference Include="..\Meowv.Blog.Domain\Meowv.Blog.Domain.csproj" />
  </ItemGroup>

</Project>

仍是要新增一个模块类MeowvBlogDomainSharedModule.cs，它依赖AbpIdentityDomainSharedModule模块

//MeowvBlogDomainSharedModule.cs
using Volo.Abp.Identity;
using Volo.Abp.Modularity;

namespace Meowv.Blog.Domain
{
    [DependsOn(typeof(AbpIdentityDomainModule))]
    public class MeowvBlogDomainModule : AbpModule
    {
    }
}

.EntityFrameworkCore

.EntityFrameworkCore层一样的，先删掉默认生成的文件。它主要是集成了EF Core，自定义仓储。详细能够看看abp文档：https://docs.abp.io/zh-Hans/abp/latest/Repositories

它支持多种数据库 MySQL、SqlServer、PostgreSql、Sqlite等，若是你有用到MongoDB，则须要新建一个项目，单独实现。能够看官方文档，有时间能够分享具体方法，本项目用不到。https://docs.abp.io/zh-Hans/abp/latest/MongoDB

为了方便你们，我把以上4种主流数据库都集成到项目中，添加包Volo.Abp.EntityFrameworkCore.MySQL，.PostgreSql、.Sqlite、.SqlServer，同时引用.Domain.Shared项目

//Meowv.Blog.EntityFrameworkCore.csproj
<Project Sdk="Microsoft.NET.Sdk">

  <Import Project="..\..\common.props" />

  <PropertyGroup>
    <TargetFramework>netcoreapp3.1</TargetFramework>
  </PropertyGroup>
  
  <ItemGroup>
    <PackageReference Include="Volo.Abp.EntityFrameworkCore.MySQL" Version="2.7.0" />
    <PackageReference Include="Volo.Abp.EntityFrameworkCore.PostgreSql" Version="2.7.0" />
    <PackageReference Include="Volo.Abp.EntityFrameworkCore.Sqlite" Version="2.7.0" />
    <PackageReference Include="Volo.Abp.EntityFrameworkCore.SqlServer" Version="2.7.0" />

    <ProjectReference Include="..\Meowv.Blog.Domain.Shared\Meowv.Blog.Domain.Shared.csproj" />
  </ItemGroup>

</Project>

新建一个模块类MeowvBlogFrameworkCoreModule.cs，依赖MeowvBlogDomainModule和数据库模块

//MeowvBlogFrameworkCoreModule.cs
using Meowv.Blog.Domain;
using Volo.Abp.EntityFrameworkCore;
using Volo.Abp.EntityFrameworkCore.MySQL;
using Volo.Abp.EntityFrameworkCore.PostgreSql;
using Volo.Abp.EntityFrameworkCore.Sqlite;
using Volo.Abp.EntityFrameworkCore.SqlServer;
using Volo.Abp.Modularity;

namespace Meowv.Blog.EntityFrameworkCore
{
    [DependsOn(
        typeof(MeowvBlogDomainModule),
        typeof(AbpEntityFrameworkCoreModule),
        typeof(AbpEntityFrameworkCoreMySQLModule),
        typeof(AbpEntityFrameworkCoreSqlServerModule),
        typeof(AbpEntityFrameworkCorePostgreSqlModule),
        typeof(AbpEntityFrameworkCoreSqliteModule)
    )]
    public class MeowvBlogFrameworkCoreModule : AbpModule
    {
        public override void ConfigureServices(ServiceConfigurationContext context)
        {

        }
    }
}

.EntityFrameworkCore.DbMigrations

.EntityFrameworkCore.DbMigrations层主要作数据库迁移，用code-first方式建立数据库表，先删掉默认生成的文件，目前还用不上，后面讲。

.ToolKits

.ToolKits层是咱们手动建立的项目，我主要用它来包装一些扩展方法，公共的工具类。

Swagger登场

作.net core开发的，相信Swagger的使用你们应该都很熟悉了，不作过多的介绍，今天只先将其用上看看效果。

我单独为Swagger新建了一个项目Meowv.Blog.Swagger，其实大可没必要，直接写在.HttpApi.Hosting中也是同样的。

添加Volo.Abp.AspNetCore和Swashbuckle.AspNetCore包，引用实体层.Domain。

//Meowv.Blog.Swagger.csproj
<Project Sdk="Microsoft.NET.Sdk">

  <Import Project="..\..\common.props" />

  <PropertyGroup>
    <TargetFramework>netcoreapp3.1</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Volo.Abp.AspNetCore" Version="2.7.0" />
    <PackageReference Include="Swashbuckle.AspNetCore" Version="5.4.1" />

    <ProjectReference Include="..\Meowv.Blog.Domain\Meowv.Blog.Domain.csproj" />
  </ItemGroup>

</Project>

添加模块类MeowvBlogSwaggerModule.cs，依赖MeowvBlogDomainModule模块，而且重写ConfigureServices和OnApplicationInitialization方法，不知道这是什么的，能够看文档：https://docs.abp.io/zh-Hans/abp/latest/Module-Development-Basics

而后新建一个扩展类MeowvBlogSwaggerExtensions.cs，编写两个扩展方法AddSwagger和UseSwaggerUI。

在AddSwagger方法中引用咱们的XML文件，配置接口的名称版本以及描述信息，在UseSwaggerUI方法中使用SwaggerUI，代码以下：

//MeowvBlogSwaggerExtensions.cs
using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.OpenApi.Models;
using System;
using System.IO;

namespace Meowv.Blog.Swagger
{
    public static class MeowvBlogSwaggerExtensions
    {
        public static IServiceCollection AddSwagger(this IServiceCollection services)
        {
            return services.AddSwaggerGen(options =>
            {
                options.SwaggerDoc("v1", new OpenApiInfo
                {
                    Version = "1.0.0",
                    Title = "个人接口啊",
                    Description = "接口描述"
                });

                options.IncludeXmlComments(Path.Combine(AppContext.BaseDirectory, "Meowv.Blog.HttpApi.xml"));
                options.IncludeXmlComments(Path.Combine(AppContext.BaseDirectory, "Meowv.Blog.Domain.xml"));
                options.IncludeXmlComments(Path.Combine(AppContext.BaseDirectory, "Meowv.Blog.Application.Contracts.xml"));
            });
        }

        public static void UseSwaggerUI(this IApplicationBuilder app)
        {
            app.UseSwaggerUI(options =>
            {
                options.SwaggerEndpoint($"/swagger/v1/swagger.json", "默认接口");
            });
        }
    }
}

随后即可以在模块MeowvBlogDomainModule中引用了

//MeowvBlogSwaggerModule.cs
using Meowv.Blog.Domain;
using Microsoft.AspNetCore.Builder;
using Volo.Abp;
using Volo.Abp.Modularity;

namespace Meowv.Blog.Swagger
{
    [DependsOn(typeof(MeowvBlogDomainModule))]
    public class MeowvBlogSwaggerModule : AbpModule
    {
        public override void ConfigureServices(ServiceConfigurationContext context)
        {
            context.Services.AddSwagger();
        }

        public override void OnApplicationInitialization(ApplicationInitializationContext context)
        {
            context.GetApplicationBuilder().UseSwagger().UseSwaggerUI();
        }
    }
}

最后在.HttpApi.Hosting层的的启动模块中引用一下。

//MeowvBlogHttpApiHostingModule.cs
...
    [DependsOn(
       typeof(AbpAspNetCoreMvcModule),
       typeof(AbpAutofacModule),
       typeof(MeowvBlogHttpApiModule),
       typeof(MeowvBlogSwaggerModule),
       typeof(MeowvBlogFrameworkCoreModule)
    )]
    public class MeowvBlogHttpApiHostingModule : AbpModule
    {
        ...
    }
...

Ctrl + Shift + B生成解决方案，Ctrl+F5打开 .../swagger/index.html 看看效果，上面有一个坑没有填，不知道你们发现了没有，Meowv.Blog.HttpApi.xml没有生成，启动是是会报错的，你们按照以前的方法自行生成XML便可。

1

棒！预期已经达到了。Swagger之因此想单首创建一个项目是由于还涉及到不少内容，如接口分组、JWT受权、还有Swagger文档描述信息的Filter等。

项目中还剩下.BackgroundJobs层没有处理，此层准备集成Hangfire作一个定时任务处理的，后面会慢慢用起来的。

如今再回头看看，项目是否是很清爽? 没有乱七八糟的东西，有的只是咱们须要的。

此时的层级目录，以供参考。

2

项目中可能有许多不是很合理的地方，请酌情参考。由于大佬们都不肯意出来分享，因此咱们渣渣只能作到这种程度，若是有错误欢迎指正，谢谢。

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

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程