AspectCore Project 是適用於Asp.Net Core 平台的輕量級Aop(Aspect-oriented programming) 解決方案,它更好的遵循Asp.Net Core的模組化開發理念,使用AspectCore可以更容易建立低耦合、易擴展的Web應用程式。 AspectCore使用Emit實現高效率的動態代理程式從而不依賴任何第三方Aop函式庫。
啟動 Visual Studio。從 File 選單, 選擇 New > Project。選擇 ASP.NET Core Web Application 專案模版,建立新的 ASP.NET Core Web Application 專案。
從Nuget 安裝AspectCore.Extensions.DependencyInjection
package:
PM> Install-Package AspectCore.Extensions.DependencyInjection
#在一般情況下可以使用抽象的InterceptorAttribute
自訂特性類,它實作IInterceptor
介面。 AspectCore預設實作了基於Attribute
的攔截器配置。我們的自訂攔截器看起來像下面這樣:
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
介面和它的實作類別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(); } }
註冊ICustomService
,接著,在ConfigureServices
中配置建立代理類型的容器:
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
AddAspectCore(Action的重載方法,其中
AspectCoreOptions提供
InterceptorFactories註冊全域攔截器:
services.AddAspectCore(config => { config.InterceptorFactories.AddTyped<CustomInterceptorAttribute>(); });
CustomInterceptorAttribute中加入參數的建構器:
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"); } } }
services.AddAspectCore(config => { config.InterceptorFactories.AddTyped<CustomInterceptorAttribute>(args: new object[] { "custom" }); });
ConfigureServices中新增:
services.AddTransient<CustomInterceptorAttribute>(provider => new CustomInterceptorAttribute("service"));
services.AddAspectCore(config => { config.InterceptorFactories.AddServiced<CustomInterceptorAttribute>(); });
Service或
Method的全域攔截器,下面的程式碼示範了作用於帶有
Service後綴的類別的全域攔截器:
services.AddAspectCore(config => { config.InterceptorFactories.AddTyped<CustomInterceptorAttribute>(method => method.DeclaringType.Name.EndsWith("Service")); });
services.AddAspectCore(config => { config.InterceptorFactories.AddTyped<CustomInterceptorAttribute>(PredicateFactory.ForService("*Service")); });
NonAspectAttribute來使得
Service或
Method不被代理程式:
[NonAspect] public interface ICustomService { void Call(); }
services.AddAspectCore(config => { //App1命名空间下的Service不会被代理 config.NonAspectOptions.AddNamespace("App1"); //最后一级为App1的命名空间下的Service不会被代理 config.NonAspectOptions.AddNamespace("*.App1"); //ICustomService接口不会被代理 config.NonAspectOptions.AddService("ICustomService"); //后缀为Service的接口和类不会被代理 config.NonAspectOptions.AddService("*Service"); //命名为Query的方法不会被代理 config.NonAspectOptions.AddMethod("Query"); //后缀为Query的方法不会被代理 config.NonAspectOptions.AddMethod("*Query"); });
屬性注入,在攔截器中擁有
public get and set權限的屬性標記
[AspectCore.Abstractions.FromServices](區別於
Microsoft.AspNetCore.Mvc. FromServices)特性,即可自動注入該屬性,如:
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); } }
Service,除全域攔截器外,仍可使用
ServiceInterceptor使攔截器從DI中啟動:
public interface ICustomService { [ServiceInterceptor(typeof(CustomInterceptorAttribute))] void Call(); }
AspectContext可以取得目前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); } }
和AspectCore
。 AspectCore原生支援整合Autofac,我們需要安裝下面兩個nuget packages:<div class="code" style="position:relative; padding:0px; margin:0px;"><pre class="brush:php;toolbar:false">PM> Install-Package Autofac.Extensions.DependencyInjection
PM> Install-Package AspectCore.Extensions.Autofac</pre><div class="contentsignin">登入後複製</div></div>
AspectCore提供
擴充方法在Autofac的Container
中註冊動態代理程式所需的服務,並提供AsInterfacesProxy
和AsClassProxy
擴充方法啟用interface和class的代理程式。修改ConfigureServices
方法為:<div class="code" style="position:relative; padding:0px; margin:0px;"><pre class="brush:php;toolbar:false">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());
}</pre><div class="contentsignin">登入後複製</div></div>
最後。 。 。
以上是什麼是AspectCore Project ?的詳細內容。更多資訊請關注PHP中文網其他相關文章!