(精华)2020年8月22日 ABP vNext WebAPI应用ABP

上一节我们创建了基于Razor Page的简单应用，如果我们希望创建单页面应用或者移动应用，就需要通过Web Api调用应用层。Abp提供了从应用层到Web Api的自动映射，我们只需要增加少量的代码就可以，不需要编写重复的Api接口代码。

首先我们增加Swagger支持，使我们的应用支持Web Api浏览和测试，在程序包管理器中增加Swashbuckle.AspNetCore引用。
然后PoemWebModule中增加动态Web Api代码和对Swagger的支持：

using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.OpenApi.Models;
using Volo.Abp;
using Volo.Abp.AspNetCore.Mvc;
using Volo.Abp.Autofac;
using Volo.Abp.Modularity;
using ZL.AbpNext.Poem.Application;
using ZL.AbpNext.Poem.Core;
using ZL.AbpNext.Poem.EF;

namespace ZL.AbpNext.Poem.Web
{
     
    [DependsOn(typeof(AbpAspNetCoreMvcModule),
        typeof(AbpAutofacModule),
    typeof(PoemCoreModule),
    typeof(PoemApplicationModule),
    typeof(PoemDataModule))]
    public class PoemWebModule : AbpModule
    {
     
        public override void OnApplicationInitialization(
            ApplicationInitializationContext context)
        {
     
            var app = context.GetApplicationBuilder();
            var env = context.GetEnvironment();

            if (env.IsDevelopment())
            {
     
                app.UseDeveloperExceptionPage();
            }
            else
            {
     
                app.UseExceptionHandler("/Error");
            }

            app.UseStaticFiles();
            app.UseRouting();
            app.UseSwagger();
            app.UseSwaggerUI(options =>
            {
     
                options.SwaggerEndpoint("/swagger/v1/swagger.json", "BookStore API");
            });
            app.UseConfiguredEndpoints();
        }

        public override void ConfigureServices(ServiceConfigurationContext context)
        {
     
            Configure<AbpAspNetCoreMvcOptions>(options =>
            {
     
                options
                    .ConventionalControllers
                    .Create(typeof(PoemApplicationModule).Assembly);
            });
            var configuration = context.Services.GetConfiguration();
            ConfigureSwaggerServices(context.Services);
        }

        private void ConfigureSwaggerServices(IServiceCollection services)
        {
     
            services.AddSwaggerGen(
                options =>
                {
     
                    options.SwaggerDoc("v1", new OpenApiInfo {
      Title = "PoemApp API", Version = "v1" });
                    options.DocInclusionPredicate((docName, description) => true);
                    options.CustomSchemaIds(type => type.FullName);
                }
            );
        }
    }
}

运行应用，进入Swagger界面：

我们可以看到api的列表，我们可以测试一下，以api/app/poem/categories为例：

可以看到，正确返回了结果。