Asp.Net Core轻量级Aop解决方案:AspectCore
什么是AspectCore Project ?
AspectCore Project 是適用于Asp.Net Core 平臺(tái)的輕量級(jí) Aop(Aspect-oriented programming) 解決方案,它更好的遵循Asp.Net Core的模塊化開(kāi)發(fā)理念,使用AspectCore可以更容易構(gòu)建低耦合、易擴(kuò)展的Web應(yīng)用程序。AspectCore使用Emit實(shí)現(xiàn)高效的動(dòng)態(tài)代理從而不依賴(lài)任何第三方Aop庫(kù)。
開(kāi)使使用AspectCore
啟動(dòng) Visual Studio。從 File 菜單, 選擇 New > Project。選擇 ASP.NET Core Web Application 項(xiàng)目模版,創(chuàng)建新的 ASP.NET Core Web Application 項(xiàng)目。
從 Nuget 安裝 AspectCore.Extensions.DependencyInjection package:
PM> ? Install-Package AspectCore.Extensions.DependencyInjection在一般情況下可以使用抽象的InterceptorAttribute自定義特性類(lèi),它實(shí)現(xiàn)IInterceptor接口。AspectCore默認(rèn)實(shí)現(xiàn)了基于Attribute的攔截器配置。我們的自定義攔截器看起來(lái)像下面這樣:
public class CustomInterceptorAttribute : InterceptorAttribute{ ?
public async override Task Invoke(IAspectContext context, AspectDelegate next)
? ?{ ? ? ? ?try{Console.WriteLine("Before service call"); ? ? ? ? ?
?await next(context);} ? ? ? ?catch (Exception){Console.WriteLine("Service threw an exception!"); ?
? ? ? ? ? ?throw;} ? ? ? ?finally{Console.WriteLine("After service call");}}}定義ICustomService接口和它的實(shí)現(xiàn)類(lèi)CustomService:
public interface ICustomService{[CustomInterceptor] ? ?void Call(); }public class CustomService : ICustomService{ ? ?public void Call() ? ?{Console.WriteLine("service calling...");} }在HomeController中注入ICustomService:
public class HomeController : Controller{ ?
?private readonly ICustomService _service; ? ?
?public HomeController(ICustomService service) ? ?{_service = service;} ? ?public IActionResult Index() ? ?{_service.Call(); ? ? ? ?return View();} }注冊(cè)ICustomService,接著,在ConfigureServices中配置創(chuàng)建代理類(lèi)型的容器:
public IServiceProvider ConfigureServices(IServiceCollection services){services.AddTransient<ICustomService, CustomService>();services.AddMvc();services.AddAspectCore(); ? ?return services.BuildAspectCoreServiceProvider(); }攔截器配置。首先安裝AspectCore.Extensions.Configuration package:
PM> Install-Package AspectCore.Extensions.Configuration全局?jǐn)r截器。使用AddAspectCore(Action<AspectCoreOptions>)的重載方法,其中AspectCoreOptions提供InterceptorFactories注冊(cè)全局?jǐn)r截器:
services.AddAspectCore(config =>{config.InterceptorFactories.AddTyped<CustomInterceptorAttribute>();});帶構(gòu)造器參數(shù)的全局?jǐn)r截器,在CustomInterceptorAttribute中添加帶參數(shù)的構(gòu)造器:
public class CustomInterceptorAttribute : InterceptorAttribute{ ?
?private readonly string _name; ? ?public CustomInterceptorAttribute(string name) ?
?{_name = name;} ? ?public async override Task Invoke(AspectContext context, AspectDelegate next) ? ?{ ? ? ? ?try{Console.WriteLine("Before service call"); ? ? ?
? ? ?await next(context);} ? ? ? ?catch (Exception)
{Console.WriteLine("Service threw an exception!"); ? ? ? ? ? ?throw;} ? ? ? ?finally{Console.WriteLine("After service call");}} }修改全局?jǐn)r截器注冊(cè):
services.AddAspectCore(config => {config.InterceptorFactories.AddTyped<CustomInterceptorAttribute>(args: new object[] { "custom" }); });作為服務(wù)的全局?jǐn)r截器。在ConfigureServices中添加:
services.AddTransient<CustomInterceptorAttribute>(provider => new CustomInterceptorAttribute("service"));修改全局?jǐn)r截器注冊(cè):
services.AddAspectCore(config => {config.InterceptorFactories.AddServiced<CustomInterceptorAttribute>(); });作用于特定Service或Method的全局?jǐn)r截器,下面的代碼演示了作用于帶有Service后綴的類(lèi)的全局?jǐn)r截器:
services.AddAspectCore(config => {config.InterceptorFactories.AddTyped<CustomInterceptorAttribute>(method => method.DeclaringType.Name.EndsWith("Service")); });使用通配符的特定全局?jǐn)r截器:
services.AddAspectCore(config => {config.InterceptorFactories.AddTyped<CustomInterceptorAttribute>(PredicateFactory.ForService("*Service")); });在AspectCore中提供NonAspectAttribute來(lái)使得Service或Method不被代理:
[NonAspect]public interface ICustomService{ ? ?void Call(); }同時(shí)支持全局忽略配置,亦支持通配符:
services.AddAspectCore(config =>{ ? ? ?//App1命名空間下的Service不會(huì)被代理config.NonAspectOptions.AddNamespace("App1"); ? ? ?//最后一級(jí)為App1的命名空間下的Service不會(huì)被代理config.NonAspectOptions.AddNamespace("*.App1"); ? ? ?//ICustomService接口不會(huì)被代理config.NonAspectOptions.AddService("ICustomService"); ? ? ?//后綴為Service的接口和類(lèi)不會(huì)被代理config.NonAspectOptions.AddService("*Service"); ? ? ?//命名為Query的方法不會(huì)被代理config.NonAspectOptions.AddMethod("*Query"); ? ? ?//后綴為Query的方法不會(huì)被代理config.NonAspectOptions.AddMethod("*Query");});攔截器中的依賴(lài)注入。在攔截器中支持屬性注入,構(gòu)造器注入和服務(wù)定位器模式。
public class CustomInterceptorAttribute : InterceptorAttribute{[AspectCore.Abstractions.FromServices] ? ?public ILogger<CustomInterceptorAttribute> Logger { get; set; } ? ?public override Task Invoke(AspectContext context, AspectDelegate next) ? ?{Logger.LogInformation("call interceptor"); ? ? ? ?return next(context);} }
屬性注入,在攔截器中擁有public get and set權(quán)限的屬性標(biāo)記[AspectCore.Abstractions.FromServices](區(qū)別于Microsoft.AspNetCore.Mvc.FromServices)特性,即可自動(dòng)注入該屬性,如:構(gòu)造器注入需要使攔截器作為Service,除全局?jǐn)r截器外,仍可使用ServiceInterceptor使攔截器從DI中激活:
public interface ICustomService{[ServiceInterceptor(typeof(CustomInterceptorAttribute))] ? ?void Call(); }服務(wù)定位器模式。攔截器上下文AspectContext可以獲取當(dāng)前Scoped的ServiceProvider:
public class CustomInterceptorAttribute : InterceptorAttribute{ ? ?public override Task Invoke(AspectContext context, AspectDelegate next) ? ?{ ? ? ? ?var logger = context.ServiceProvider.GetService<ILogger<CustomInterceptorAttribute>>();logger.LogInformation("call interceptor"); ? ? ? ?return next(context);} }使用Autofac和AspectCore。AspectCore原生支持集成Autofac,我們需要安裝下面兩個(gè)nuget packages:
PM> Install-Package Autofac.Extensions.DependencyInjectionPM> Install-Package AspectCore.Extensions.AutofacAspectCore提供RegisterAspectCore擴(kuò)展方法在Autofac的Container中注冊(cè)動(dòng)態(tài)代理需要的服務(wù),并提供AsInterfacesProxy和AsClassProxy擴(kuò)展方法啟用interface和class的代理。修改ConfigureServices方法為:
public IServiceProvider ConfigureServices(IServiceCollection services){services.AddMvc(); ? ?var container = new ContainerBuilder();container.RegisterAspectCore();container.Populate(services);container.RegisterType<CustomService>().As<ICustomService>().InstancePerDependency().AsInterfacesProxy(); ? ?return new AutofacServiceProvider(container.Build()); }
有問(wèn)題反饋
如果您有任何問(wèn)題,請(qǐng)?zhí)峤?Issue 給我們。
AspectCore Project 項(xiàng)目地址: https://github.com/aspectcore
最后。。。
正在找工作,歡迎推薦.NET/.NET Core后端開(kāi)發(fā)職位,坐標(biāo)上海,可以到他博客找他,或者發(fā)郵件 liuhaoyang1221@hotmail.com
相關(guān)文章:?
?[Asp.Net Core輕量級(jí)Aop解決方案]AspectCore Project 介紹
原文地址:http://www.cnblogs.com/liuhaoyang/p/aspectcore-introduction-1.html
.NET社區(qū)新聞,深度好文,微信中搜索dotNET跨平臺(tái)或掃描二維碼關(guān)注
總結(jié)
以上是生活随笔為你收集整理的Asp.Net Core轻量级Aop解决方案:AspectCore的全部?jī)?nèi)容,希望文章能夠幫你解決所遇到的問(wèn)題。
- 上一篇: DDD领域驱动之干货 (一)
- 下一篇: 编写高性能 .NET 代码 第二章:垃圾