BaseRuntime 1.0.0

WishingPool.AOP BaseRuntime

這個專案提供 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 需要在 MSBuild pipeline 中掛載並指定 AssemblyPath， 才能對輸出組件進行 patch。此專案目前只提供 Task 本體， 若要使用請在你的專案檔中自訂 Target 進行呼叫。

範例：在專案檔掛載 Task

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

  
  <ItemGroup>
    <ProjectReference Include="..\BaseRuntime\BaseRuntime.csproj" />
  </ItemGroup>

  
  <UsingTask
    TaskName="Aop.Runtime.BuildTask.AopCachePatchTask"
    AssemblyFile="$(OutputPath)BaseRuntime.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="WishingPool.AOP.BaseRuntime" Version="1.0.0" />
  </ItemGroup>

  <UsingTask
    TaskName="Aop.Runtime.BuildTask.AopCachePatchTask"
    AssemblyFile="$(PkgWishingPool_AOP_BaseRuntime)\lib\net8.0\BaseRuntime.dll" />

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

提醒：$(PkgWishingPool_AOP_BaseRuntime) 會依 NuGet 套件 ID 轉為 Pkg + 底線化名稱（. 變 _）。版本號與 TFMs 請依實際套件調整。