肉夾饃（Rougamo）是一款編譯時(shí)AOP組件，無需在應(yīng)用啟動(dòng)時(shí)進(jìn)行初始化，也無需繁瑣的配置。它支持所有種類方法（同步和異步、靜態(tài)和實(shí)例、構(gòu)造方法/屬性/普通方法），提供了簡(jiǎn)單易上手的Attribute應(yīng)用方式，同時(shí)還提供了類AspectJ表達(dá)式的批量應(yīng)用規(guī)則。

4.0.1 更新內(nèi)容

在4.0版本發(fā)布的文章評(píng)論中，有朋友反饋了一個(gè)調(diào)試時(shí)無法查看方法內(nèi)部變量值的問題。本次更新就是修復(fù)這個(gè)問題的，4.0.1不包含其他修改，對(duì)調(diào)試時(shí)禁用肉夾饃的朋友沒有任何影響，可以酌情升級(jí)。

肉夾饃IoC/DI擴(kuò)展

4.0.1本來是不準(zhǔn)備發(fā)博客的，內(nèi)容一句話就結(jié)束了，不過又想到前段時(shí)間還發(fā)布了IoC擴(kuò)展，索性就合在一起寫一篇博客吧。

各位在使用肉夾饃時(shí)，最常遇到的問題可能就是如何與IoC交互了�，F(xiàn)在主流的動(dòng)態(tài)代理本身就需要IoC才能完成，所以動(dòng)態(tài)代理在IoC交互方面具有天然的優(yōu)勢(shì)，而肉夾饃編譯時(shí)完成不依賴IoC，所以與IoC的交互也不是很方便。但不方便并不是不能。此前已經(jīng)有朋友在自己的項(xiàng)目中實(shí)現(xiàn)了IoC的訪問，比如Rougamo.OpenTelemetry, FreeSql�？紤]到IoC的使用在現(xiàn)在已經(jīng)非常普遍，所以新增了幾個(gè)常用IoC的擴(kuò)展包。

目前只對(duì)最常用的兩個(gè)IoC組件提供了支持，一個(gè)是微軟官方的 Microsoft.Extensions.DependencyInjection ，另一個(gè)是 Autofac ，主要包含四個(gè)NuGet：

• Rougamo.Extensions.DependencyInjection.AspNetCore
• Rougamo.Extensions.DependencyInjection.GenericHost
• Rougamo.Extensions.DependencyInjection.Autofac.AspNetCore
• Rougamo.Extensions.DependencyInjection.Autofac

其中 AspNetCore 結(jié)尾的兩個(gè)NuGet專用于AspNetCore（廢話了哦），另外兩個(gè)NuGet用于通用主機(jī)（Generic Host）和Framework等場(chǎng)景。

版本號(hào)說明

在引用這些NuGet包時(shí)，你會(huì)發(fā)現(xiàn)他們都包含很多個(gè)版本，這并不是版本迭代更新快或者版本號(hào)設(shè)置錯(cuò)了導(dǎo)致的，版本號(hào)有相應(yīng)的規(guī)則，它們的主版本號(hào)跟隨對(duì)應(yīng)IoC組件的NuGet主版本號(hào)。微軟官方的兩個(gè)擴(kuò)展包的主版本號(hào)跟隨 Microsoft.Extensions.* 的主版本號(hào)（也是.NET SDK的版本）， Autofac 的兩個(gè)擴(kuò)展包的主版本號(hào)跟隨 Autofac 的主版本號(hào)。

快速開始

下面直接用代碼快速展示如何使用對(duì)應(yīng)的擴(kuò)展包。

Rougamo.Extensions.DependencyInjection.AspNetCore

// 注冊(cè)Rougamo（注：如果你不使用IoC/DI功能，Rougamo默認(rèn)是不需要注冊(cè)操作的）
public static void Main(string[] args)
{
    var builder = WebApplication.CreateBuilder(args);
    // ...省略其他步驟
    builder.Services.AddRougamoAspNetCore();
    // ...省略其他步驟
}

// 在切面類型中獲取IServiceProvider實(shí)例并使用
public class TestAttribute : MoAttribute
{
    public override void OnEntry(MethodContext context)
    {
        // 使用擴(kuò)展方法GetServiceProvider獲取IServiceProvider實(shí)例
        var services = context.GetServiceProvider();

        // 使用IServiceProvider
        var xxx = services.GetService();
    }
}

Rougamo.Extensions.DependencyInjection.GenericHost

// 注冊(cè)Rougamo（注：如果你不使用IoC/DI功能，Rougamo默認(rèn)是不需要注冊(cè)操作的）
public static void Main(string[] args)
{
    var builder = Host.CreateDefaultBuilder();
    // ...省略其他步驟
    builder.ConfigureServices(services => services.AddRougamoGenericHost());
    // ...省略其他步驟
}

// 在切面類型中獲取IServiceProvider實(shí)例并使用
public class TestAttribute : MoAttribute
{
    public override void OnEntry(MethodContext context)
    {
        // 使用擴(kuò)展方法GetServiceProvider獲取IServiceProvider實(shí)例
        var services = context.GetServiceProvider();

        // 使用IServiceProvider
        var xxx = services.GetService();
    }
}

Rougamo.Extensions.DependencyInjection.Autofac.AspNetCore

// 注冊(cè)Rougamo（注：如果你不使用IoC/DI功能，Rougamo默認(rèn)是不需要注冊(cè)操作的）
public static void Main(string[] args)
{
    var builder = WebApplication.CreateBuilder(args);
    builder.Host
            .UseServiceProviderFactory(new AutofacServiceProviderFactory())
            .ConfigureContainer(builder =>
            {
                builder.RegisterRougamoAspNetCore();
            });
    
    // 注冊(cè)IHttpContextAccessor也是必須的
    builder.Services.AddHttpContextAccessor();
}

// 在切面類型中獲取ILifetimeScope實(shí)例并使用
public class TestAttribute : MoAttribute
{
    public override void OnEntry(MethodContext context)
    {
        // 使用擴(kuò)展方法GetAutofacCurrentScope獲取ILifetimeScope實(shí)例
        var scope = context.GetAutofacCurrentScope();

        // 使用ILifetimeScope
        var xxx = scope.Resolve();
    }
}

Rougamo.Extensions.DependencyInjection.Autofac

// 注冊(cè)Rougamo（注：如果你不使用IoC/DI功能，Rougamo默認(rèn)是不需要注冊(cè)操作的）
public static void Main(string[] args)
{
    var builder = Host.CreateDefaultBuilder();
    
    builder
        .UseServiceProviderFactory(new AutofacServiceProviderFactory())
        .ConfigureContainer(builder =>
        {
            builder.RegisterRougamo();
        });
}

// 在切面類型中獲取IServiceProvider實(shí)例并使用
public class TestAttribute : MoAttribute
{
    public override void OnEntry(MethodContext context)
    {
        // 使用擴(kuò)展方法GetAutofacCurrentScope獲取ILifetimeScope實(shí)例
        var scope = context.GetAutofacCurrentScope();

        // 使用ILifetimeScope
        var xxx = scope.Resolve();
    }
}

比較早的Framework項(xiàng)目以及WinForm、WPF等項(xiàng)目可能并沒有使用通用主機(jī)（Generic Host），此時(shí)使用 Rougamo.Extensions.DependencyInjection.Autofac 將更加直接，初始化時(shí)創(chuàng)建 ContainerBuilder 后直接調(diào)用 RegisterRougamo 擴(kuò)展方法即可。

var builder = new ContainerBuilder();
builder.RegisterRougamo();

更多

肉夾饃IoC/DI擴(kuò)展更多的信息請(qǐng)?jiān)L問 Rougamo.DI (https://github.com/inversionhourglass/Rougamo.DI)，歡迎反饋建議和提交PR.

• 《暗喻幻想：ReFantazio》尤法社群等級(jí)提升作用介紹
• 【長(zhǎng)城守望】新服開啟！沖榜就送非遺城磚
• 《寶可夢(mèng)大集結(jié)》路卡利歐技能圖鑒
• 《塞爾達(dá)傳說 智慧的再現(xiàn)》螺旋甜味冰沙怎么制作
• 《仙劍世界》黑蜘蛛森林寶箱開啟方法