.NET Core第4天_middleware是捨麼?

-
中介軟體為組成應用程式管線的軟體，用以處理要求與回應，
.net core中定義的中介則可以說是用來取代以前HTTP Handler(HTTP 處理常式)新技術。
ASP.NET Core 採用Request Pipeline的模型設計，
要求管線由要求委派序列組成，並會一個接著一個呼叫。 
下圖說明此概念。 執行緒遵循黑色箭號執行。


也可以白話說就是用來重應用程式管線來處理請求、回應的元件，用Pipeline 來
比喻Middleware的模型就是強調各項Middleware串聯在一起。
每次的Request跟Response都會像大隊接力一樣，傳送至下一棒。
也像跑電子公文單審核經費超過特定門檻是否往上加簽的概念
(類似設計模式中的Chain of Responsibility Pattern責任鍊模式)
管線內每一元件都可去抉擇是否將request交給下一元件，並且在管線中呼叫下一元件之前
和之後執行某些業務邏輯功能。


和Http Module差異在於
HttpModules 是透過Web.config或global.asax來做配置，無法讓人透過程式來控制，且執行順序是基於Application life cycle events，每次Request、Response都為固定的。
開發者只能在特定Event去寫程式，不可更改違背其本身設計原則。

至於Middleware 則完全是透過Startup.cs code 而非config檔案來配置
開發人員有更大彈性去自行設計想要做的啟動配置流程。



請求委派被創建來建立請求管線，請求委派負責處裡每個HTTP Request，
主要透過IApplicationBuilder 型別的Run , Map , 和Use擴充method進行設定。

通常Register這些Middleware方式都是於Startup.cs 的 Configure 
對 IApplicationBuilder 型別的app使用 Use方法

public static Microsoft.AspNetCore.Builder.IApplicationBuilder Use (this Microsoft.AspNetCore.Builder.IApplicationBuilder app, Func<Microsoft.AspNetCore.Http.HttpContext,Func<System.Threading.Tasks.Task>,System.Threading.Tasks.Task> middleware);

每個單獨的請求委派可以透過匿名方法內嵌方式或者定義一個可以ReUse的Class中
至於這些可被ReUse的Class就是Middleware了

每個位於Request Pipeline中的Middleware負責接力(呼叫下一個元件)或者適時短路(不往下呼叫)。

內建擴充的普遍以 Use 開頭的方法註冊
預設用MVC  template建立的.net core 專案
就有用到
app.UseStaticFiles(); //啟用靜態檔案存取
app.UseRouting();  //啟用路由
app.UseAuthorization(); //身分授權
app.UseEndpoints();//啟用路由端點
這麼多內建擴充的Middleware
其他還有像是
app.UseAuthentication();//身分驗證
app.UseSession();//啟用Session
app.UseHttpsRedirect();//http轉向https
都是屬於內建的middleware


這裡自行寫一段用Use方法的測試
在初始腳本

Test Code:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

namespace MyCore0
{
    public class Startup
    {
        // This method gets called by the runtime. Use this method to add services to the container.
        public void ConfigureServices(IServiceCollection services)
        {

        }

        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            //註冊 Middleware 的方法
            app.Use(async (context, next) =>
            {
                await context.Response.WriteAsync("1st Middleware in. \r\n");
                await next.Invoke();//跳至下一個Middleware的方法
                await context.Response.WriteAsync("1st Middleware out. \r\n");
            });

            app.Use(async (context, next) =>
            {
                await context.Response.WriteAsync("2nd Middleware in. \r\n");
                await next.Invoke();//跳至下一個Middleware的方法
                await context.Response.WriteAsync("2nd Middleware out. \r\n");
            });

            //註冊 Middleware 的方法，和Use差別在於不會依序執行下一個 Middleware。
            app.Run(async (context) =>
            {
                await context.Response.WriteAsync("Test 1 \r\n");
            });

            app.Use(async (context, next) =>
            {
                await context.Response.WriteAsync("3rd Middleware in. \r\n");
                await next.Invoke();//跳至下一個Middleware的方法
                await context.Response.WriteAsync("3rd Middleware out. \r\n");
            });

            //註冊 Middleware 的方法，和Use差別在於不會依序執行下一個 Middleware。
            //app.Run(async (context) =>
            //{
            //    await context.Response.WriteAsync("Test 1 \r\n");
            //});

            //if (env.IsDevelopment())
            //{
            //    app.UseDeveloperExceptionPage();
            //}

            //app.UseRouting();

            //app.UseEndpoints(endpoints =>
            //{
            //    endpoints.MapGet("/", async context =>
            //    {
            //        await context.Response.WriteAsync("Hello World!");
            //    });
            //});
        }
    }
}

執行結果





這裡可以看到第三個Middleware沒有執行到主要原因是前面呼叫到
IApplicationBuilder.Run()會造成管線短路。
此外也可觀察到註冊順序的重要性，資料傳遞順序是先進後出。

IApplicationBuilder.Run():
Adds a terminal middleware delegate to the application's request pipeline.

1
public static void Run(this IApplicationBuilder app, RequestDelegate handler)



RequestDelegate Delegate
A function that can process an HTTP request.

1
public delegate Task RequestDelegate(HttpContext context);



IApplicationBuilder.Run() 跟IApplicationBuilder.Use()最大差異就在於
Run方法會造成管線短路(因為並未需要傳入next的請求委派)
所以通常Run只在管線最底部被調用。

但是Use方法中即便會傳入next但只要在方法裏頭根本沒使用到next也等同於Run!!!




在這裡練習自己寫自訂的Middleware
(PS:我們在Startup.cs 中Configure 註冊的 Middleware 
屬於Global範圍註冊可套用到所有的 Request。)

MyCustomMiddleware.cs:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.Logging;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace MyCore0
{
    public class MyCustomMiddleware
    {
        private readonly RequestDelegate _next;
        private readonly ILogger _logger;

        public MyCustomMiddleware(RequestDelegate next, ILoggerFactory logFactory)
        {
            _next = next;
            _logger = logFactory.CreateLogger("MyCustomMiddleware");
        }

        public async Task Invoke(HttpContext httpContext)
        {
            _logger.LogInformation("MyCustomMiddleware executing...");
            await _next(httpContext);
        }
    }    
}

MyCustomMiddlewareExtensions.cs:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
using Microsoft.AspNetCore.Builder;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace MyCore0
{
    public static class MyCustomMiddlewareExtensions
    {
        public static IApplicationBuilder UseMyCustomMiddleware(this IApplicationBuilder builder)
        {
            return builder.UseMiddleware<MyCustomMiddleware>();
        }
    }
}

Startup.cs:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

namespace MyCore0
{
    public class Startup
    {
        // This method gets called by the runtime. Use this method to add services to the container.
        public void ConfigureServices(IServiceCollection services)
        {

        }

        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            //app.UseMiddleware<MyCustomMiddleware>();//寫法1.不用Extension method直接用內建的

            app.UseMyCustomMiddleware();//寫法2.用Extension method

            app.Run(async (context) => {
                await context.Response.WriteAsync("Hello World!");
            });
        }
    }
}


會看到在終端輸出也有跑我們自訂的內容



在此我想看IP跟port資訊是捨麼


也可以輸出~~自行客製化


在此還要特別注意
中介軟體順序


寫成是順序要特別留意
比方Authentication一定要在Authorization之上。



Ref:
ASP.NET Core 中介軟體

ASP.NET Core - Middleware
https://www.tutorialsteacher.com/core/aspnet-core-middleware

ASP.NET Core 中介軟體
https://docs.microsoft.com/zh-tw/aspnet/core/fundamentals/middleware/?view=aspnetcore-3.1

ASP.NET Core 基礎 - Middleware
https://blog.darkthread.net/blog/aspnetcore-middleware-lab/

[Day03] ASP.NET Core 2 系列 - Middleware
https://ithelp.ithome.com.tw/articles/10192682

ASP.NET - 使用自訂中介軟體偵測與修正 ASP.NET Core 應用程式中的 404
https://docs.microsoft.com/zh-tw/archive/msdn-magazine/2016/june/asp-net-use-custom-middleware-to-detect-and-fix-404s-in-asp-net-core-apps

[鐵人賽Day04] - 淺談Middleware
https://ithelp.ithome.com.tw/articles/10203041

What is the difference between IApplicationBuilder.Use() and IApplicationBuilder.Run() C# Asp.net Core?
https://www.tutorialspoint.com/what-is-the-difference-between-iapplicationbuilder-use-and-iapplicationbuilder-run-chash-asp-net-core


How C# ASP.NET Core Middleware is different from HttpModule?
https://www.tutorialspoint.com/how-chash-asp-net-core-middleware-is-different-from-httpmodule

Asp.net HttpHandler vs HttpModule 詳細解說
https://isdaniel.github.io/HttpHandler-HttpModule/
https://isdaniel.github.io/Ithelp-day2/

留言

張貼留言

這個網誌中的熱門文章

何謂淨重(Net Weight)、皮重(Tare Weight)與毛重(Gross Weight)

-
圖片
當談到貨物的重量時，往往會分成所謂的淨重(Net Weight)與毛重(Gross Weight)。 會有以下公式關係存在 淨重=毛重-皮重(包裝物的重量) 毛重=淨重+皮重 淨重( Net Weight 縮寫為N.W.) 指物品本身的重量，不包括容器或包裝材料的重量。 凈重是國際貿易中最常見的計重辦法。 例如，如果運輸原材料，原材料的重量就是所運輸貨物的淨重。包裝原材料的容器或包裝不計入淨重。同樣地，當我們考慮一罐豆子時，罐子內所含物品的重量就算作淨重。因此，淨重將包括豆子、罐頭里的任何液體，以及保存豆子所含的物品。 大多數 以重量為計價的貨物買賣 ，採用此計價方法。 若合同中並未明確規範以何種方式計量和計價時，按慣例以凈重計價。 毛重( Gross Weight 縮寫G.W.) 貨物連同它的包裝的重量，是你托運的所有物品的總重量。 皮重(Tare Weight) 指商品外包裝材料的重量(即運輸包裝的重量)，不包括內包裝材料和襯墊物的重量。 比方一個空的貨櫃、容器、或任何包裝材料的重量。 Net Net Weight純淨重 (指從Net Weight中扣除內包裝後的重量) 進出口商品為了因應運輸及消費需求, 一般都有內包裝與外包裝。 一般在買賣合同與信用狀中,通常只要求於裝箱單上註明Gross Weight和Net Weight即可, 但有些L/C 要求 Net Net Weight,大多是海關徵收從量稅時的依據 運輸重量對於航運業或者航空運輸等各自都通用這些術語 為何特別在意重量? 主要就在於會影響像是傳輸安全乘載限制。 就運輸層面(不同方式的運輸) 航空運輸：對機長而言，毛重包括皮重、產品淨重以及飛機、燃料、乘客和機組人員的重量。 公路/鐵路運輸:對於火車車長而言，毛重包括產品淨重、皮重和運輸車輛的重量。 水路航運運輸：對船長而言，毛重就是淨重和皮重之和。 就公司ERP成本角度 成本一般都會採用 "淨重" 主要是因為若用毛重，可能會有輔材不可控因素存在 比方一個 5cm 固定塑膠件，今天用一個 10cm 紙箱測重，明天用一個 100cm 紙箱測重，那可能就容易導致ERP資料比較會失真。 就物流層面來探討 通常還會有一名詞即所謂「實際重量」(Actual Weight) 根據稱重(過磅)所得到的重量，實際重量分為實際毛重(Gross Weig...
閱讀完整內容

Architecture(架構) 和 Framework(框架) 有何不同?_軟體設計前的事前規劃的藍圖概念

-
圖片
一個應用程式(軟體) 不管是  互動拍照 也好、 投影也好、車牌偵測... 舞台演唱會後方電視牆的互動應用程序、 粒子特效、3D或2D遊戲  等等 開發者通常都需要在一開始做規劃 ㄟ  假設我今天要寫 跟影像有關 可能需要偵測、可能需要提取前景、可能需要偵測圓形 之類的 我有  emgucv 、AForge.Net、 opencv 等等可以用 但是 假設我今天要做的應用程序是需要有視窗介面的~~ emgucv 跟 C# windows form 媒合性 就很高 而且直接在 visual studio 做開發 opencv 我可能還需要依賴 Qt 之類等等  framework 假設我今天是要寫一個 演唱會電視牆互動粒子特效 可能就會挑   openframeworks  、 processing 、kinect 來寫互動 Achitecture  --->全稱 :  Software Architecture   軟體架構 Achitecture   由好多 framework 組成 軟體架構（Software Architecture）是一種軟體在開發前的設計藍圖， 用來告訴軟體的結構，功能，介面，用法，與其他系統的構連以及資料交換等等規範， 但它並沒有叫你要用什麼方式實作， 因此軟體架構通常會產生文件，圖樣，原型以及規格等， 就是沒有可用的程式碼，因為那不是軟體架構應該有的東西， 就像蓋房子時是給你藍圖，而不是一幢蓋好的房子。 軟體框架（Framework):是一個已經成形的方法，而且有程式碼實體 （例如鋼構工法也是要有鋼材才能做），並且會告訴你要如何使用它 （即 Framework Documentation，MSDN Library 即為一最佳例子）
閱讀完整內容

經得起原始碼資安弱點掃描的程式設計習慣培養(五)_Missing HSTS Header

-
圖片
  接續前幾篇系列 經得起原始碼資安弱點掃描的程式設計習慣培養(一)_OWASP Top 10(十大網站安全風險)_學習寫更安全程式碼的網站推薦 經得起原始碼資安弱點掃描的程式設計習慣培養(二)_8.Insecure Deserialization ：不安全的反序列化漏洞ASP.NET處理方式 經得起原始碼資安弱點掃描的程式設計習慣培養(三)_7.Cross Site Scripting(XSS)_Stored XSS_Reflected XSS All Clients 經得起原始碼資安弱點掃描的程式設計習慣培養(四)_1.Injection注入攻擊_SQL Injection)_order by 語句正確參數化套入 最近又遇到被若安掃描到高風險要修正的程式碼啦.... 一看這還真是搞不懂該怎麼修呢 HSTS(HTTP Strict Transport Security)  主要是一份國際標準規格 (RFC 6797) 的網際網路瀏覽安全機制， 用於宣告瀏覽器與伺服器之間通訊方式必須強制採用 TLS/SSL 加密通道。 只要從伺服器端送出一個 Strict-Transport-Security 標頭 (Header) 給瀏覽器，即可告知瀏覽器於未來的某段時間內一律使用 SSL 來和該網站連接 (設定可涵蓋所有子域名網站)， 一旦發生憑證失效情況，使用者將無法再瀏覽該網站，如此一來便可大幅減少中間人攻擊的問題發生。 再更白話一點 HSTS Header 就是負責將 http 強制轉為 https CheckMarx掃碼報告給的說明 ============================================================ 風險: 如果web config沒有設置HSTS表頭、"max-age"(有效期)不足一年， 或沒有設定"includeSubDomains"(包含所有子網域)，可能會使用戶容易遭受中間人攻擊。 發生原因: 許多使用者只要在瀏覽器的網址列輸入網域名稱(Domain Name)即可瀏覽網站， 並沒有輸入協定(Protocol)的名稱。 瀏覽器會自動假設使用者使用的是HTTP協定而不是有加密機制的HTTPS協定。 在第一次發出前往特定網站的請求時，攻擊者可以執行中間人攻擊並將用戶轉址到...
閱讀完整內容