上一节我们创建了基于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为例:
可以看到,正确返回了结果。
在此基础上,我们可以开发单页面应用了。