android abp接口,从零开始学习ABP vNext开发 （十四）Web API

上一节我们创建了基于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(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界面：

图片.png

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

图片.png

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

在此基础上，我们可以开发单页面应用了。