跳到主要內容

菜渣開源一個基於 EMIT 的 AOP 庫(.NET Core)

目錄

  • 1,快速入門

    • 1.1 繼承 ActionAttribute 特性

    • 1.2 標記代理類型



    • 2，如何創建代理類型

      • 2.1 通過API直接創建



  • 2,創建代理類型

    • 通過API

    • 通過 Microsoft.Extensions.DependencyInjection

      • 通過 Autofac



  • 3,深入使用

    • 代理類型

    • 方法、屬性代理

    • 上下文

      • 攔截方法或屬性的參數


    • 非侵入式代理




Nuget 庫地址：https://www.nuget.org/packages/CZGL.AOP/


Github 庫地址：https://github.com/whuanle/CZGL.AOP


CZGL.AOP 是 基於 EMIT 編寫的 一個簡單輕量的AOP框架，支持非侵入式代理，支持.NET Core/ASP.NET Core，以及支持多種依賴注入框架。


1,快速入門


CZGL.AOP 使用比較簡單，你只需要使用 [Interceptor] 特性標記需要代理的類型，然後使用繼承 ActionAttribute 的特性標記要被代理的方法或屬性。


1.1 繼承 ActionAttribute 特性


ActionAttribute 是用於代理方法或屬性的特性標記，不能直接使用，需要繼承后重寫方法。


示例如下：


    public class LogAttribute : ActionAttribute
     {
         public override void Before(AspectContext context)
         {
             Console.WriteLine("執行前");
         }
 
         public override object After(AspectContext context)
         {
             Console.WriteLine("執行后");
             if (context.IsMethod)
                 return context.MethodResult;
             else if (context.IsProperty)
                 return context.PropertyValue;
             return null;
         }
     }

Before 會在被代理的方法執行前或被代理的屬性調用時生效，你可以通過 AspectContext 上下文，獲取、修改傳遞的參數。


After 在方法執行后或屬性調用時生效，你可以通過上下文獲取、修改返回值。


1.2 標記代理類型


在被代理的類型中，使用 [Interceptor] 特性來標記，在需要代理的方法中，使用 繼承了 ActionAttribute 的特性來標記。


此方法是侵入式的，需要在編譯前完成。


[Interceptor]
 public class Test : ITest
 {
     [Log] public virtual string A { get; set; }
     [Log]
     public virtual void MyMethod()
     {
         Console.WriteLine("運行中");
     }
 }

注意的是，一個方法或屬性只能設置一個攔截器。


2，如何創建代理類型


CZGL.AOP 有多種生成代理類型的方式，下面介紹簡單的方式。


請預先創建如下代碼：


    public class LogAttribute : ActionAttribute
     {
         public override void Before(AspectContext context)
         {
             Console.WriteLine("執行前");
         }
 
         public override object After(AspectContext context)
         {
             Console.WriteLine("執行后");
             if (context.IsMethod)
                 return context.MethodResult;
             else if (context.IsProperty)
                 return context.PropertyValue;
             return null;
         }
     }
 
     public interface ITest
     {
         void MyMethod();
     }
 
     [Interceptor]
     public class Test : ITest
     {
         [Log] public virtual string A { get; set; }
         public Test()
         {
             Console.WriteLine("構造函數沒問題");
         }
         [Log]
         public virtual void MyMethod()
         {
             Console.WriteLine("運行中");
         }
     }

2.1 通過API直接創建


通過 CZGL.AOP 中的 AopInterceptor 類，你可以生成代理類型。


示例如下：


            ITest test1 = AopInterceptor.CreateProxyOfInterface<ITest, Test>();
             Test test2 = AopInterceptor.CreateProxyOfClass<Test>();
             test1.MyMethod();
             test2.MyMethod();

CreateProxyOfInterface 通過接口創建代理類型；CreateProxyOfClass 通過類創建代理類型；


默認調用的是無參構造函數。


2,創建代理類型


通過API


你可以參考源碼解決方案


中的 ExampleConsole 項目。


如果要直接使用 AopInterceptor.CreateProxyOfInterface 和 AopInterceptor.CreateProxyOfClass 方法，通過接口或類來創建代理類型。


        ITest test1 = AopInterceptor.CreateProxyOfInterface<ITest, Test>();
         Test test2 = AopInterceptor.CreateProxyOfClass<Test>();

如果要指定實例化的構造函數，可以這樣：


            // 指定構造函數
             test2 = AopInterceptor.CreateProxyOfClass<Test>("aaa", "bbb");
             test2.MyMethod();

通過 Microsoft.Extensions.DependencyInjection


Microsoft.Extensions.DependencyInjection 是 .NET Core/ASP.NET Core 默認的依賴注入容器。


如果需要支持 ASP.NET Core 中使用 AOP，你可以在 Nuget 包中安裝 CZGL.AOP.MEDI。


如果你在控制台下使用 Microsoft.Extensions.DependencyInjection，你可以使用名為 BuildAopProxy 的 IServiceCollection 拓展方法來為容器中的類型，生成代理類型。


示例如下：


            IServiceCollection _services = new ServiceCollection();
             _services.AddTransient<ITest, Test>();
             var serviceProvider = _services.BuildAopProxy().BuildServiceProvider();
             serviceProvider.GetService<ITest>();
             return serviceProvider;

你可以參考源碼解決方案中的 ExampleMEDI 項目。


如果你要在 ASP.NET Core 中使用，你可以在 Startup 中，ConfigureServices 方法的最後一行代碼使用 services.BuildAopProxy(); 。


        public void ConfigureServices(IServiceCollection services)
         {
             services.AddControllers();
             services.BuildAopProxy();
         }

還可以在 Program 的 IHostBuilder 中使用 .UseServiceProviderFactory(new AOPServiceProxviderFactory()) 來配置使用 CZGL.AOP。


示例：


        public static IHostBuilder CreateHostBuilder(string[] args) =>
             Host.CreateDefaultBuilder(args)
             .UseServiceProviderFactory(new AOPServiceProxviderFactory())
                 .ConfigureWebHostDefaults(webBuilder =>
                 {
                     webBuilder.UseStartup<Startup>();
                 });

可以參考解決方案中的 ExampleConsole 和 ExampleWebMEDI 兩個項目。


你不必擔心引入 CZGL.AOP 后，使用依賴注入會使程序變慢或者破壞容器中的原有屬性。CZGL.AOP 只會在創建容器時處理需要被代理的類型，不會影響容器中的服務，也不會幹擾到依賴注入的執行。


通過 Autofac


如果需要在 Autofac 中使用 AOP，則需要引用 CZGL.AOP.Autofac 包。


如果你在控制台程序中使用 Autofac，則可以在 Build() 後面使用 BuildAopProxy()。


            ContainerBuilder builder = new ContainerBuilder();
             builder.RegisterType<Test>().As<ITest>();
             var container = builder.Build().BuildAopProxy();
 
             using (ILifetimeScope scope = container.BeginLifetimeScope())
             {
                 // 獲取實例
                 ITest myService = scope.Resolve<ITest>();
                 myService.MyMethod();
             }
 
             Console.ReadKey();
         }

要注意的是，在已經完成的組件註冊創建一個新的容器后，才能調用 BuildAopProxy() 方法，


這樣針對一個新的容器你可以考慮是否需要對容器中的組件進行代理。


如果在 ASP.NET Core 中使用 Autofac，你需要在 Program 類的 IHostBuilder 中使用：


.UseServiceProviderFactory(new AutofacServiceProviderFactory())

如果需要代理已經註冊的組件，則將其替換為：


 .UseServiceProviderFactory(new CZGL.AOP.Autofac.AOPServiceProxviderFactory())

請參考 源碼解決方案中的 ExampleAutofac 和 ExampleWebAutofac 兩個項目。


3,深入使用


代理類型


要被代理的類型，需要使用 [Interceptor]來標記，例如：


    [Interceptor]
     public class Test : ITest
     {
     }

支持泛型類型。


被代理的類型必須是可被繼承的。


類型的構造函數沒有限制，你可以隨意編寫。


在使用 API 創建代理類型並且實例化時，你可以指定使用哪個構造函數。


例如：


			string a="",b="",c="";
 			ITest test1 = AopInterceptor.CreateProxyOfInterface<ITest, Test>(a,b,c);

API 會根據參數的多少以及參數的類型自動尋找合適的構造函數。


方法、屬性代理


為了代理方法或屬性，你需要繼承 ActionAttribute 特性，然後為方法或屬性標記此特性，並且將方法或屬性設置為 virtual


一個類型中的不同方法，可以使用不同的攔截器。


        [Log1]
         public virtual void MyMethod1(){}
         
         [Log2]
         public virtual void MyMethod2(){}

對於屬性，可以在屬性上直接使用特性，或者只在 get 或 set 構造器使用。


        [Log] public virtual string A { get; set; }
         
         // 或
         public virtual string A { [Log] get; set; }
         
         // 或
         public virtual string A { get; [Log] set; }

如果在屬性上使用特性，相當於 [Log] get; [Log] set;。


上下文


一個簡單的方法或屬性攔截標記是這樣的：


    public class LogAttribute : ActionAttribute
     {
         public override void Before(AspectContext context)
         {
             Console.WriteLine("執行前");
         }
 
         public override object After(AspectContext context)
         {
             Console.WriteLine("執行后");
             if (context.IsMethod)
                 return context.MethodResult;
             else if (context.IsProperty)
                 return context.PropertyValue;
             return null;
         }
     }

AspectContext 的屬性說明如下：















































字段 說明
Type 當前被代理類型生成的代理類型
ConstructorParamters 類型被實例化時使用的構造函數的參數，如果構造函數沒有參數，則 MethodValues.Length = 0，而不是 MethodValues 為 null。
IsProperty 當前攔截的是屬性
PropertyInfo 當前被執行的屬性的信息，可為 null。
PropertyValue 但調用的是屬性時，返回 get 的結果或 set 的 value 值。
IsMethod 當前攔截的是方法
MethodInfo 當前方法的信息
MethodValues 方法被調用時傳遞的參數，如果此方法沒有參數，則 MethodValues.Length = 0，而不是 MethodValues 為 null
MethodResult 方法執行返回的結果(如果有)

攔截方法或屬性的參數


通過上下文，你可以修改方法或屬性的參數以及攔截返回結果：


    public class LogAttribute : ActionAttribute
     {
         public override void Before(AspectContext context)
         {
             // 攔截並修改方法的參數
             for (int i = 0; i < context.MethodValues.Length; i++)
             {
                 context.MethodValues[i] = (int)context.MethodValues[i] + 1;
             }
             Console.WriteLine("執行前");
         }
 
         public override object After(AspectContext context)
         {
             Console.WriteLine("執行后");
 
             // 攔截方法的執行結果
             context.MethodResult = (int)context.MethodResult + 664;
 
             if (context.IsMethod)
                 return context.MethodResult;
             else if (context.IsProperty)
                 return context.PropertyValue;
             return null;
         }
     }
 
     [Interceptor]
     public class Test
     {
         [Log]
         public virtual int Sum(int a, int b)
         {
             Console.WriteLine("運行中");
             return a + b;
         }
     }
 

            Test test = AopInterceptor.CreateProxyOfClass<Test>();
 
             Console.WriteLine(test.Sum(1, 1));

方法的參數支持 in、ref、out；支持泛型方法泛型屬性；支持異步方法；


非侵入式代理


此種方式不需要改動被代理的類型，你也可以代理程序集中的類型。


    public class LogAttribute : ActionAttribute
     {
         public override void Before(AspectContext context)
         {
             Console.WriteLine("執行前");
         }
 
         public override object After(AspectContext context)
         {
             Console.WriteLine("執行后");
             if (context.IsMethod)
                 return context.MethodResult;
             else if (context.IsProperty)
                 return context.PropertyValue;
             return null;
         }
     }
 

    public class TestNo
     {
         public virtual string A { get; set; }
         public virtual void MyMethod()
         {
             Console.WriteLine("運行中");
         }
     }
 

            TestNo test3 = AopInterceptor.CreateProxyOfType<TestNo>(new ProxyTypeBuilder()
                 .AddProxyMethod(typeof(LogAttribute), typeof(TestNo).GetMethod(nameof(TestNo.MyMethod)))
                 .AddProxyMethod(typeof(LogAttribute), typeof(TestNo).GetProperty(nameof(TestNo.A)).GetSetMethod()));

通過 ProxyTypeBuilder 來構建代理類型。


代理方法或屬性都是使用 AddProxyMethod，第一個參數是要使用的攔截器，第二個參數是要攔截的方法。


如果要攔截屬性，請分開設置屬性的 get、set 構造。


如果多個方法或屬性使用同一個攔截器，則可以這樣：


            TestNo test3 = AopInterceptor.CreateProxyOfType<TestNo>(
                 new ProxyTypeBuilder(new Type[] { typeof(LogAttribute) })
                 .AddProxyMethod("LogAttribute", typeof(TestNo).GetMethod(nameof(TestNo.MyMethod)))
                 .AddProxyMethod("LogAttribute", typeof(TestNo).GetProperty(nameof(TestNo.A)).GetSetMethod()));
 

            TestNo test3 = AopInterceptor.CreateProxyOfType<TestNo>(
                 new ProxyTypeBuilder(new Type[] { typeof(LogAttribute) })
                 .AddProxyMethod("LogAttribute", typeof(TestNo).GetMethod(nameof(TestNo.MyMethod)))
                 .AddProxyMethod(typeof(LogAttribute2), typeof(TestNo).GetProperty(nameof(TestNo.A)).GetSetMethod()));

在構造函數中傳遞過去所需要的攔截器，然後在攔截時使用。

本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理

【其他文章推薦】



※為什麼 USB CONNECTOR 是電子產業重要的元件?



※網頁設計一頭霧水該從何著手呢? 台北網頁設計公司幫您輕鬆架站!



※台北網頁設計公司全省服務真心推薦



※想知道最厲害的網頁設計公司"嚨底家"!



※推薦評價好的iphone維修中心


Orignal From: 菜渣開源一個基於 EMIT 的 AOP 庫(.NET Core)

留言

張貼留言

這個網誌中的熱門文章

Python 併發總結，多線程，多進程，異步IO

1 測量函數運行時間 import time def profile(func): def wrapper(*args, ** kwargs): import time start = time.time() func( *args, ** kwargs) end = time.time() print ' COST: {} ' .format(end - start) return wrapper @profile def fib(n): if n<= 2 : return 1 return fib(n-1) + fib(n-2 ) fib( 35 )   2 啟動多個線程，並等待完成   2.1 使用threading.enumerate() import threading for i in range(2 ): t = threading.Thread(target=fib, args=(35 ,)) t.start() main_thread = threading.currentThread() for t in threading.enumerate(): if t is main_thread: continue t.join()   2.2 先保存啟動的線程 threads = [] for i in range(5 ): t = Thread(target=foo, args= (i,)) threads.append(t) t.start() for t in threads: t.join()   3 使用信號量，限制同時能有幾個線程訪問臨界區 from threading import Semaphore import time sema = Semaphor...
張貼留言
閱讀完整內容

高雄十大包子名店出爐

, 圖文：吳恩文 高雄包子大賽落幕了，我只能就我個人意見， 介紹一下前十名這些包子，但是不能代表其他四位評審的意見，雖然身為評審長，我通常不會第一個表示意見，以免影響其他評審， 我主要工作是負責發問。   這次參賽的素包子很少，而且都不夠細致，又偏油，我不愛， 但是第一名的甜芝麻包－熔岩黑金包，竟然是素食得名－ 漢來蔬食巨蛋店。   這包子賣相太好，竹炭粉的黑色外皮刷上金粉，一上桌，眾人驚呼， 搶拍照，內餡是芝麻餡，混一點花生醬增稠，加入白糖芝麻油， 熔岩爆漿的程度剛剛好，我一直以為芝麻要配豬油才行、 但是選到好的黑芝麻油一樣不減香醇， 當下有二位評審就想宅配回家。   尤其特別的是，黑芝麻餡室溫易化，師傅必須要輪班躲在冷藏室內， 穿著大外套才能包，一天包不了多少，我笑說，漢來美食，集團餐廳那麼多，實力雄厚，根本是「 奧運選手報名參加村裡運動會」嘛，其他都是小包子店啊， 但是沒辦法，顯然大家都覺得它好看又好吃， 目前限定漢來蔬食高雄巨蛋店，二顆88元，可以冷凍宅配， 但是要排一陣子，因為供不應求，聽說，四月份， 台北sogo店開始會賣。   第二名的包子，左營寬來順早餐店，顯然平易近人的多，一顆肉包， 十塊錢，是所有參賽者中最便宜的，當然，個頭也小， 它的包子皮明顯和其他不同，灰灰的老麵，薄但紮實有嚼勁， 肉餡新鮮帶汁，因為打了些水，味道極其簡單，就是蔥薑，塩， 香油，薑味尤其明顯，是老眷村的味道， 而特別的是老闆娘是台灣本省人， 當年完全是依據眷村老兵的口味一步一步調整而來，沒有加什麼糖、 五香粉，胡椒粉，油蔥酥。就是蔥薑豬肉和老麵香，能得名， 應該是它的平實無華，鮮美簡單，打動人心。   這是標準的心靈美食，可以撫慰人心，得名之前，寛來順已經天天排隊，現在，恐怕要排更久了， 建議大家六七點早點上門。   第三名，「專十一」很神奇，我記得比賽最後， 大家連吃了幾家不能引起共鳴的包子，有些累，到了專十一， 就坐著等包子，其他評審一吃，就催我趕快試，我一吃， 也醒了大半。   它的包子皮厚薄適中，但是高筋麵粉高些，老麵加一點點酵母， 我心中，它的皮屬一屬二，至於餡又多又好吃，蛋黃還是切丁拌入， 不是整顆放，吃起來「美味、均衡、飽滿」。一顆二十元。   老闆是陸軍專科十一期畢業取名專十一，...
張貼留言
閱讀完整內容

韋伯連續劇終於更新 期待第一季順利完結

　　地球天文學界的跳票大王詹姆斯·韋伯空間望遠鏡 (James Webb Space Telescope，縮寫為 JWST)自 1996 年以來斷斷續續不按劇本演出的連續劇終於讓焦慮的觀眾們又等到了一次更新：五層遮陽罩測試順利完成。 裝配完成的韋伯望遠鏡與好夥伴遮陽罩同框啦。Credit: NASA 　　嚴格的測試是任何空間任務順利成功的重中之重。遮陽罩，這個韋伯望遠鏡異常重要的親密夥伴，要是無法正常運轉的話，韋伯的這一季天文界連續劇說不準就要一直拖更了。 　　詹姆斯·韋伯空間望遠鏡是歷史上造出的最先進的空間望遠鏡。它不僅是一架紅外望遠鏡，還具有特別高的靈敏度。但想要達到辣么高的靈敏度來研究系外行星和遙遠的宇宙童年，韋伯童鞋必須非常"冷靜"，體溫升高的話，靈敏度會大大折損。這個時候，遮陽罩就要大顯身手啦。 　　遮陽罩在韋伯的設計中至關重要。韋伯望遠鏡會被發射到拉格朗日 L2 點，運行軌道很高，遠離太陽、地球與月球。太陽是韋伯的主要熱量干擾的來源，其次是地球與月球。遮陽罩會有效阻斷來自這三大熱源的能量並保護韋伯維持在工作溫度正常運轉。這個工作溫度指的是零下 220 攝氏度(-370 華氏度；50 開爾文)。 上圖中我們可以看出，韋伯望遠鏡的配置大致可分為兩部分：紅色較熱的一面溫度為 85 攝氏度，藍色較冷的一面溫度達到零下 233 攝氏度。紅色的這部分中，儀器包括太陽能板、通信設備、計算機、以及轉向裝置。藍色部分的主要裝置包括鏡面、探測器、濾光片等。Credit: STSci. 　　遮陽罩的那一部分和望遠鏡的鏡面這部分可以產生非常極端的溫差。遮陽的這面溫度可以達到 110 攝氏度，足以煮熟雞蛋，而背陰處的部分溫度極低，足以凍結氧氣。 　　工程師們剛剛完成了五層遮陽罩的測試，按照韋伯在 L2 時的運行狀態安裝了遮陽罩。L2 距離地球約 160 萬公里。NASA 表示這些測試使用了航天器的自帶系統來展開遮陽罩，測試目前都已成功完成。韋伯望遠鏡遮陽罩負責人 James Cooper 介紹說這是遮陽罩"第一次在望遠鏡系統的电子設備的控制下展開。儘管這個任務非常艱巨，難度高，但測試順利完成，遮陽罩展開時的狀態非常驚艷"。 　　遮陽罩由五層 Kapton 製成。Kapton 是一種聚酰亞胺薄膜材料， 耐高溫絕...
張貼留言
閱讀完整內容