基于 abp vNext 和 .NET Core 开发博客项目 - 给项目瘦身,让它跑起来
转载于:https://github.com/Meowv/Blog.git
本篇文章将给项目进行瘦身,删掉对我们来说暂时用不到的组件。讲解各个模块之间的关系,写一个Hello World,让其成功运行起来。
给项目瘦身
.HttpApi.Hosting
Meowv.Blog.HttpApi.Hosting相当于一个web项目,但这里主要依赖于Meowv.Blog.HttpApi模块,用来暴露我们的API的。
删掉Meowv.Blog.HttpApi.Hosting项目中abp自己生成的文件和文件夹,只留下Program.cs和Startup.cs两个类。
在abp中,每个模块都应该定义一个模块类,派生自AbpModule,那么就添加一个模块类MeowvBlogHttpApiHostingModule.cs
AbpModule类中可以做 配置服务前和后的操作,应用程序初始化,应用程序初始化前和后,应用程序关闭和模块依赖等一系列操作,详看,https://docs.abp.io/en/abp/latest/Module-Development-Basics
为了方便,在这里直接集成Autofac,来替换官方依赖注入,详看,https://docs.abp.io/zh-Hans/abp/latest/Autofac-Integration
于是我们的模块类就变成下面这个样子。
using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.Hosting;
using Volo.Abp;
using Volo.Abp.AspNetCore.Mvc;
using Volo.Abp.Autofac;
using Volo.Abp.Modularity;
namespace Meowv.Blog.HttpApi.Hosting
{
[DependsOn(
typeof(AbpAspNetCoreMvcModule),
typeof(AbpAutofacModule)
)]
public class MeowvBlogHttpApiHostingModule : AbpModule
{
public override void ConfigureServices(ServiceConfigurationContext context)
{
base.ConfigureServices(context);
}
public override void OnApplicationInitialization(ApplicationInitializationContext context)
{
var app = context.GetApplicationBuilder();
var env = context.GetEnvironment();
// 环境变量,开发环境
if (env.IsDevelopment())
{
// 生成异常页面
app.UseDeveloperExceptionPage();
}
// 路由
app.UseRouting();
// 路由映射
app.UseEndpoints(endpoints =>
{
endpoints.MapControllers();
});
}
}
}
然后在Startup.cs使用,services.AddApplication();
继续修改Program.cs代码,如下:
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Hosting;
using System.Threading.Tasks;
namespace Meowv.Blog.HttpApi.Hosting
{
public class Program
{
public static async Task Main(string[] args)
{
await Host.CreateDefaultBuilder(args)
.ConfigureWebHostDefaults(builder =>
{
builder.UseIISIntegration()
.UseStartup();
}).UseAutofac().Build().RunAsync();
}
}
}
然后编辑一下项目文件,Meowv.Blog.HttpApi.Hosting.csproj,删掉无用的配置文件信息和abp默认引用的组件。
netcoreapp3.1<ProjectReference Include="..\Meowv.Blog.HttpApi\Meowv.Blog.HttpApi.csproj" />
.HttpApi
Meowv.Blog.HttpApi职责主要是编写Controller,所有的API都写在这里,同时它要依赖于Meowv.Blog.Application模块
先删掉Models文件夹和默认的Controller,修改默认模块类名称为:MeowvBlogHttpApiModule,并删掉无用的依赖项
using Volo.Abp.Identity;
using Volo.Abp.Modularity;
namespace Meowv.Blog.HttpApi
{
[DependsOn(
typeof(AbpIdentityHttpApiModule)
)]
public class MeowvBlogHttpApiModule : AbpModule
{
}
}
编辑项目文件Meowv.Blog.HttpApi.csproj
netcoreapp3.1.Application
Meowv.Blog.Application为我们的应用服务层,在这里编写服务的接口以及对应的实现
首先还是模块类,MeowvBlogApplicationModule,在这里我们应该集成缓存和AutoMapper,这个先留着,先把项目瘦身跑起来后面在说吧。
using Volo.Abp.Identity;
using Volo.Abp.Modularity;
namespace Meowv.Blog.Application
{
[DependsOn(
typeof(AbpIdentityApplicationModule)
)]
public class MeowvBlogApplicationModule : AbpModule
{
public override void ConfigureServices(ServiceConfigurationContext context)
{
}
}
}
新建一个MeowvBlogApplicationServiceBase.cs继承自ApplicationService,然后就可以先写一个Hello World的应用服务接口和实现。
//IHelloWorldService.cs
namespace Meowv.Blog.Application.HelloWorld
{
public interface IHelloWorldService
{
string HelloWorld();
}
}
//HelloWorldService.cs
namespace Meowv.Blog.Application.HelloWorld.Impl
{
public class HelloWorldService : ServiceBase, IHelloWorldService
{
public string HelloWorld()
{
return “Hello World”;
}
}
}
这里有两点需要注意,我们的服务都以Service结尾,每个服务都应该继承我们编写的的基类ServiceBase
然后在Meowv.Blog.HttpApi层中添引用:Meowv.Blog.Application,同时添加依赖模块类,MeowvBlogApplicationModule
//MeowvBlogHttpApiModule.cs
using Meowv.Blog.Application;
using Volo.Abp.Identity;
using Volo.Abp.Modularity;
namespace Meowv.Blog.HttpApi
{
[DependsOn(
typeof(AbpIdentityHttpApiModule),
typeof(MeowvBlogApplicationModule)
)]
public class MeowvBlogHttpApiModule : AbpModule
{
}
}
让它跑起来
好了,完成以上步骤,基本上差不多了,在Meowv.Blog.HttpApi中新增一个 Controller,HelloWorldController.cs
using Meowv.Blog.Application.HelloWorld;
using Microsoft.AspNetCore.Mvc;
using Volo.Abp.AspNetCore.Mvc;
namespace Meowv.Blog.HttpApi.Controllers
{
[ApiController]
[Route("[controller]")]
public class HelloWorldController : AbpController
{
private readonly IHelloWorldService _helloWorldService;
public HelloWorldController(IHelloWorldService helloWorldService)
{
_helloWorldService = helloWorldService;
}
[HttpGet]
public string HelloWorld()
{
return _helloWorldService.HelloWorld();
}
}
}
ok,运行一下Meowv.Blog.HttpApi.Hosting试试看,不出意料应该会报错的,因为我们在启动层Meowv.Blog.HttpApi.Hosting没有依赖MeowvBlogHttpApiModule模块,添加上试试
…
[DependsOn(
typeof(AbpAspNetCoreMvcModule),
typeof(AbpAutofacModule),
typeof(MeowvBlogHttpApiModule)
)]
public class MeowvBlogHttpApiHostingModule : AbpModule
{
…
}
…
搞定,成功出现Hello World,目标圆满完成。
图片
放一张此时项目的层级目录,以供参考
图片
以上就是本章全部内容,暂时只用到了其中三个项目层便成功运行,由于时间问题,其中还有许多需要完善的地方没有操作,但后续用到的时候会逐步优化掉。
开源地址:https://github.com/Meowv/Blog/tree/blog_tutorial