.NET Core使用APB vNext框架入門教程
快速入門案例
.NET Core 控制臺應用
1. 安裝 ABP 框架核心依賴
Install-Package Volo.Abp.Core -Version 3.3.2
2. 新建 ABP 應用的啟動模塊
HelloAbpModule.cs
using Volo.Abp.Modularity; namespace HelloAbp { /// <summary> /// 啟動模塊 /// </summary> public class HelloAbpModule : AbpModule { } }
3. 新建服務,並註冊到啟動模塊中
HelloWorldService.cs
using System; using Volo.Abp.DependencyInjection; namespace HelloAbp { /// <summary> /// TODO: ABP 註冊服務方式一: 繼承接口 /// ISingletonDependency、IScopedDependency、ITransientDependency /// </summary> public class HelloWorldService : ITransientDependency { public void Run() { Console.WriteLine($"{nameof(HelloAbpModule)}-{nameof(HelloWorldService)}: Hello World!"); } } }
4. 根據啟動模塊創建 ABP應用,調用應用中註冊的服務方法
Program.cs
using System; using Microsoft.Extensions.DependencyInjection; using Volo.Abp; namespace HelloAbp { class Program { static void Main(string[] args) { // 根據啟動模塊創建 abp 應用 var application = AbpApplicationFactory.Create<HelloAbpModule>(); // 初始化 abp 應用 application.Initialize(); // 獲取應用中註冊的服務 var service = application.ServiceProvider.GetService<HelloWorldService>(); // 調用應用中的服務方法 service.Run(); Console.ReadKey(); } } }
ASP.NET Core Web 應用程序
1. 安裝 ABP 框架核心依賴
Install-Package Volo.Abp.Core -Version 3.3.2 Install-Package Volo.Abp.AspNetCore.Mvc -Version 3.3.2
2.新建 ABP 應用的啟動模塊
AppModule.cs
using System; using System.Collections.Generic; using System.Linq; using System.Threading.Tasks; using Microsoft.AspNetCore.Builder; using Microsoft.AspNetCore.Http; using Microsoft.Extensions.Hosting; using Volo.Abp; using Volo.Abp.AspNetCore.Mvc; using Volo.Abp.Modularity; namespace HelloWebAbp { /// <summary> /// 啟動模塊 /// TODO: 1.在啟動模塊中配置 ASP.NET Core Web 程序的管道,就需要定義對 ASP.NET Core Mvc模塊的依賴 /// </summary> [DependsOn(typeof(AbpAspNetCoreMvcModule))] public class AppModule : AbpModule { /// <summary> /// 應用初始化方法 /// TODO: 2.重寫 ABP 應用的初始化方法,用來構建 ASP.NET Core 應用程序的中間件管道 /// </summary> /// <param name="context"></param> public override void OnApplicationInitialization(ApplicationInitializationContext context) { // base.OnApplicationInitialization(context); var app = context.GetApplicationBuilder(); var env = context.GetEnvironment(); if (env.IsDevelopment()) { app.UseDeveloperExceptionPage(); } app.UseRouting(); // TODO: 5.將 程序應用的端點配置 修改為 ABP 應用的端點配置 app.UseConfiguredEndpoints(); } } }
3. 註冊 ABP 啟動模塊,並初始化 ABP 應用
Startup.cs
using Microsoft.AspNetCore.Builder; using Microsoft.AspNetCore.Hosting; using Microsoft.AspNetCore.Http; using Microsoft.Extensions.DependencyInjection; using Microsoft.Extensions.Hosting; using System; using System.Collections.Generic; using System.Linq; using System.Threading.Tasks; namespace HelloWebAbp { /// <summary> /// 程序啟動類 /// TODO: 3. 在 Startup 類中,完成對 ABP 應用的初始化 /// </summary> public class Startup { // This method gets called by the runtime. Use this method to add services to the container. // For more information on how to configure your application, visit https://go.microsoft.com/fwlink/?LinkID=398940 public void ConfigureServices(IServiceCollection services) { services.AddApplication<AppModule>(); } // This method gets called by the runtime. Use this method to configure the HTTP request pipeline. public void Configure(IApplicationBuilder app, IWebHostEnvironment env) { app.InitializeApplication(); } } }
4. 新建控制器,測試 ABP 應用運行狀態
HomeController.cs
using Microsoft.AspNetCore.Mvc; using System; using System.Collections.Generic; using System.Linq; using System.Threading.Tasks; using Volo.Abp.AspNetCore.Mvc; namespace HelloWebAbp.Controllers { /// <summary> /// 控制器 /// TODO: 4. 繼承 Abp 框架中的基類控制器(提供瞭一些便捷的服務和方法) /// </summary> public class HomeController : AbpController { public IActionResult Index() { return Content("Hello world!"); } } }
各個擊破案例
ABP應用中的模塊可以有很多個,但是啟動模塊隻能有一個;
ABP應用中的每個模塊之間沒有必然的聯系;
ABP應用中每個模塊註冊的服務,都註冊到瞭ABP應用的全局容器中;
ABP應用中的模塊也分為兩種類型:應用程序模塊(業務實現)和框架模塊(技術實現);
ABP應用中最頂層的模塊是啟動模塊,最後被加載的也是啟動模塊。
在模塊中註冊自定義服務
HelloAbpModule.cs
using System; using System.Collections.Generic; using System.Text; using Microsoft.Extensions.DependencyInjection; using Volo.Abp; using Volo.Abp.Modularity; namespace HelloAbp { /// <summary> /// 啟動模塊 /// </summary> public class HelloAbpModule : AbpModule { // TODO: 重寫 ABP 模塊的服務配置方法,向模塊中註冊自定義的服務 public override void ConfigureServices(ServiceConfigurationContext context) { base.ConfigureServices(context); // TODO: ABP 註冊服務方式二: 模塊註冊 context.Services.AddTransient<HelloWorldService>(); } } }
小結
初始化ABP模塊
- 1.註冊ABP基礎設施與核心服務(模塊系統相關)
- 2.加載整個應用的所有模塊,按照依賴性排序
- 3.按順序遍歷所有模塊,執行每一個模塊的配置方法
- 4.按順序遍歷所有模塊,執行每一個模塊的初始化方法
使用標簽屬性註冊自定義服務
HelloWorldService.cs
using System; using System.Collections.Generic; using System.Text; using Microsoft.Extensions.DependencyInjection; using Volo.Abp.DependencyInjection; namespace HelloAbp { /// <summary> /// TODO: ABP 註冊服務方式三: 特性標簽 /// ServiceLifetime.Singleton、ServiceLifetime.Scoped、ServiceLifetime.Transient /// </summary> [Dependency(ServiceLifetime.Transient)] public class HelloWorldService { public void Run() { Console.WriteLine($"{nameof(HelloAbpModule)}-{nameof(HelloWorldService)}: Hello World!"); } } }
ABP 項目中使用 Autofac
1. 安裝 Autofac 模塊
Install-Package Volo.Abp.Autofac -Version 3.3.2
2. 在模塊中創建對 Autofac 模塊的依賴
HelloAbpModule.cs
using System; using System.Collections.Generic; using System.Text; using Microsoft.Extensions.DependencyInjection; using Volo.Abp; using Volo.Abp.Autofac; using Volo.Abp.Modularity; namespace HelloAbp { /// <summary> /// 啟動模塊 /// </summary> // TODO: 使用 Autofac 第三方依賴註入框架(提供瞭更多的高級特性) [DependsOn(typeof(AbpAutofacModule))] public class HelloAbpModule : AbpModule { public override void ConfigureServices(ServiceConfigurationContext context) { base.ConfigureServices(context); context.Services.AddTransient<HelloWorldService>(); } } }
3. 在ABP應用創建時集成 Autofac
Program.cs
using System; using Microsoft.Extensions.DependencyInjection; using Volo.Abp; namespace HelloAbp { class Program { static void Main(string[] args) { { // 根據啟動模塊創建 abp 應用 var application = AbpApplicationFactory.Create<HelloAbpModule>(options => { // 集成 Autofac options.UseAutofac(); }); // 初始化 abp 應用 application.Initialize(); // 獲取應用中註冊的服務 var service = application.ServiceProvider.GetService<HelloWorldService>(); // 調用應用中的服務方法 service.Run(); } Console.WriteLine("Hello World!"); Console.ReadKey(); } } }
完整案例代碼
AbpSample
到此這篇關於.NET Core使用APB vNext框架入門教程的文章就介紹到這瞭。希望對大傢的學習有所幫助,也希望大傢多多支持WalkonNet。
推薦閱讀:
- ASP.NET Core實現中間件的幾種方式
- Asp.net core程序中使用微軟的依賴註入框架
- .NET中IoC框架Autofac用法講解
- .NetCore Web Api 利用ActionFilterAttribute統一接口返回值格式及問題解析
- ASP.Net Core MVC基礎系列之環境設置