JCat.AOP.Runtime 1.0.3

JCat.AOP.Runtime

這個專案提供 AOP Runtime 的基礎元件與一個 MSBuild Task， 用來在編譯後以 IL 方式套用攔截邏輯。

內容與用途

• AopExtensions
  • AddAop(IServiceProvider)：初始化 AopServiceProvider 的靜態存取。
• AopServiceProvider
  • 儲存全域 IServiceProvider，提供 GetRequiredService 取用 DI 服務。
• AopInterceptorBase
  • 定義攔截器的基底介面（同步/非同步、泛型/非泛型）。
• Attributes/AroundAttribute
  • 標記方法，指定攔截器型別。
• Attributes/InterceptWithAttribute
  • 標記自訂 Attribute 類別，讓該 Attribute 指向攔截器型別。
• BuildTask/AopCachePatchTask
  • 使用 Mono.Cecil 修改組件 IL：
    • 將被標記的方法複製為 $AopOriginal
    • 生成 $AopWrapper 包裝方法
    • 呼叫攔截器的 Around / AroundAsync
  • 透過 AroundAttribute 或 InterceptWithAttribute 解析攔截器型別。

基本使用方式

// 程式啟動時註冊
services.AddAop();

public class LoggingInterceptor : AopInterceptorBase
{
    public override Task AroundAsync(
        Func<object?[], Task> factory,
        string methodName,
        object?[] args,
        Attribute? attribute)
    {
        Console.WriteLine($"Before: {methodName}");
        return factory(args);
    }
}

public class ExampleService
{
    [Around(typeof(LoggingInterceptor))]
    public async Task DoWorkAsync()
    {
        await Task.Delay(10);
    }
}

Build Task 說明

AopCachePatchTask 會在編譯後以 IL 方式進行 patch。 當你使用 NuGet 套件 時，已透過 buildTransitive 自動掛載， 不需要在專案檔手動加入 UsingTask 或 Target。 只有在 ProjectReference 直接參考原始專案時才需要手動掛載。

範例：在專案檔掛載 Task

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
  </PropertyGroup>

  
  <ItemGroup>
    <ProjectReference Include="..\JCat.AOP.Runtime\JCat.AOP.Runtime.csproj" />
  </ItemGroup>

  
  <UsingTask
    TaskName="Aop.Runtime.BuildTask.AopCachePatchTask"
    AssemblyFile="$(OutputPath)JCat.AOP.Runtime.dll" />

  
  <Target Name="AopPatch" AfterTargets="Build">
    <AopCachePatchTask AssemblyPath="$(TargetPath)" />
  </Target>
</Project>

提醒：AssemblyFile 請指向包含 AopCachePatchTask 的組件輸出位置， 如果是 NuGet 套件，請改成對應的 $(Pkg... ) 路徑。

範例：使用 NuGet 套件時的寫法

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="JCat.AOP.Runtime" Version="1.0.3" />
  </ItemGroup>
</Project>

提醒：透過 NuGet 安裝會自動掛載 buildTransitive， 只要引用套件即可生效。