[C#] 讓event handler method不因event多次觸發而重複執行

 前言：

最近遇到一個情境，物件的某個event trigger會多次，

但訂閱的event handler method只需要處理該event trigger的第一次，

該怎麼做呢?

作法：

如下圖的Document類別，有一個Loaded事件，當呼叫Open方法時會觸發Loaded事件。

client端訂閱該Loaded事件，但只需要針對第一次觸發做處理，也就是讓event handler method只執行一次。因為event是把delegate清單wrap起來，

因此再加入第2個delegate將上一個event handler移除事件訂閱。

可以看到雖然Loaded事件觸發2次，但訂閱的event handler method只執行1次。

[SQL Server] 如何使用執行計畫(execution plan)判斷statement效能

 前言：

提到資料庫存取，大多會擔心撰寫的statement是否有效能問題，

雖然公司可能會有DBA來review開發人員的statement，

但開發人員仍需初步判斷所寫的statement執行的狀況。

以SQL Server來說，會使用SSMS(SQL Server Management Studio)裡的執行計畫(Execution plan)來判斷。

作法：

可以準備幾個要比較statement來跑執行計畫，一般會先看是否有吃到index，

效能通常是：index seek > index scan

但如果SELECT的資料筆數接近整張table的筆數，SQL Server就可能採table scan將資料回傳。

基本上使用PK來當條件，就會套用cluster index seek。cluster index預設是從table的PK建出來的，每張table只會有一組，如下圖OrderID是[Orders]的唯一PK。

還有一種是nonclustered index seek，nonclustered index在一張table可以有多組，可以視SELECT資料的需求來建立。如下圖CustomerID是[Orders]的其一nonclustered index。

至於index scan，可分為cluster index scan，如下圖。

另一種則是noncluster index scan。

to be continued...

參考資料：

https://docs.microsoft.com/zh-tw/sql/relational-databases/sql-server-index-design-guide?view=sql-server-ver15

https://docs.microsoft.com/zh-tw/sql/relational-databases/indexes/clustered-and-nonclustered-indexes-described?view=sql-server-ver15

https://github.com/Microsoft/sql-server-samples/tree/master/samples/databases/northwind-pubs

[Design Pattern] 狀態模式(State Pattern)

前陣子開發電子化表單相關的程式，剛好使用到狀態模式(State Pattern)。

需求是每張表單有其狀態，每個狀態有對應的處理動作，

因此直覺上可以使用狀態模式的概念來處理。

先上個類別圖：

這邊使用抽象類別StateBase，下方的類別就是實際的狀態，

以請假表單來說，會有初始狀態與主管審核後狀態，

Execute方法代表執行狀態對應的動作，可能是狀態移轉或通知對應的人。

而StateContext是管理狀態的類別，其Request方法呼叫state物件的Execute方法，

並注入執行的state instance，以提供狀態執行所需的環境資訊。

剛好這需求，一開始同事是使用switch case來處理各狀態行為，

我改成狀態模式，避免全部的狀態行為都擠在同一個方法，

後續擴充維護也會容易許多，這也是Open–closed principle的精神。

[Web] OAuth Authorization code flow筆記與取得google userinfo範例

 

Authorization Code是OAuth的其中一種授權方式，

可以讓client程式取得使用者(resource owner)外部的資源，需要使用者輸入帳密，

流程如下：

● 觸發驗證流程後，client程式將使用者的瀏覽器導向authorization server的驗證端點(authorize endpoint)。

● 此時網頁會顯示client程式想存取使用者在外部的哪些資源，等待使用者授權。

● authorization server依使用者回應與帳密決定是否授權。

• 若使用者允許，則authorization server會依client程式註冊OAuth服務時填寫的redirection URI，將authorization code導回給client程式。
• 若使用者不允許或無法成功授權，則將錯誤訊息導回client程式。

● client程式再帶authorization code、redirection URI等參數POST到authorization server的權杖端點(token endpoint)。

● authorization server確認參數無誤後，即回傳access token相關資訊，即可以此token跟resource server要資料。

以Flow chart描述流程如下：

來個實際操作吧，這邊使用Google OAuth來取得userinfo：

• 先到google developer console的Credentials頁面，新增OAuth client ID，至少要給redirect URIs，儲存後就會拿到ClientID與Secret。
• 組合取得Authorization code的url，紅色部份依實際狀況填入：

https://accounts.google.com/o/oauth2/v2/auth?

client_id=client id from google oauth setting&

redirect_uri=redirect_uri from google oauth setting&

response_type=code&

scope=profile&

access_type=offline&

state=up to you

• GET呼叫取得Authorization code的url，google server會callback Authorization code，code通常是4%2F開頭，要注意有url encode，所以要轉為4/。
• 接著POST呼叫要token，code就帶Authorization code，通常超過10分鐘會失效，如下圖，即可取得欲存取資源的token。
  
  
  
  
  
  
• 最後拿token即可存取授權的資源：

參考資料：

https://tools.ietf.org/html/rfc6749

https://developers.google.com/identity/protocols/oauth2/web-server

[MVC/Pattern] Unit of Work與Repository模式紀錄

前言：
上一次用到Unif Of Work，已經快3年了，有機會就來記錄一下吧。

先上個圖：

Repository部分讓商業邏輯跟資料存取可以拆開，也是一種pattern，
IRepository定義了常用的CRUD操作，使用泛型處理不同的資料實體，
建立Repository instance時，注入搭配的UnitOfWork instance。

而Unit Of Work負責處理資料交易的部分，確保資料與db是一致的。
當然，多了這些抽象，寫測試也就水到渠成了。

實際程式碼如下：

public interface IUnitOfWork : IDisposable
{ 

	DbContext DbContext { get; set; }
    
	void Commit();

}

public class UnitOfWork : IUnitOfWork
{

        public DbContext DbContext { get; set; }

        public UnitOfWork()
        {
            DbContext = new ApplicationDbContext();
        }

        public void Commit()
        {
            DbContext.SaveChanges();
        }

        public void Dispose()
        {
            DbContext.Dispose();
        }
        
}

public interface IRepository<T> where T : class
{

        IUnitOfWork UnitOfWork { get; set; }

        void Create(T entity);

        IQueryable<T> ReadAll();

        IQueryable<T> Read(Expression<Func<T, bool>> filter);

        void Delete(T entity);

        void Save();

}

public class Repository<T> : IRepository<T> where T : class
{

	private DbSet _entity;
    
	public Repository(IUnitOfWork unitOfWork)
	{
	    UnitOfWork = unitOfWork;
	}

	public IUnitOfWork UnitOfWork { get; set; }

	public void Create(T entity)
        {
            Entity.Add(entity);
        }

        public IQueryable ReadAll()
        {
            return Entity;
        }

        public IQueryable Read(Expression> filter)
        {
            return Entity.Where(filter);
        }

        public void Delete(T entity);
        {
            Entity.Remove(entity);
        }

        public void Save()
        {
            UnitOfWork.Commit();
        }

}

參考資料：
https://docs.microsoft.com/zh-tw/aspnet/mvc/overview/older-versions/getting-started-with-ef-5-using-mvc-4/implementing-the-repository-and-unit-of-work-patterns-in-an-asp-net-mvc-application
https://web.csulb.edu/~pnguyen/cecs475/pdf/repository%20pattern.pdf

[.Net/C#] C#中List與Array的關係(relationship between List and Array)

前言：
有一次聽到同事A跟同事B說，這裡不要用List，
用Array效能比較好，因為是直接存取記憶體。

當下覺得有點怪怪的，因為就我所知，
該程式是宣告固定長度的List，那跟宣告為Array不是一樣嗎?


從list.cs的Source code可以看到：
宣告固定長度的List，內部的確是用Array宣告。

正確的說，使用List其實就是在操作Array，
所以資料都是在記憶體上。

照這樣看來，宣告固定長度的List跟宣告Array，
在搜尋效能上，應該是一樣的？
簡單來測試一下：

結果跟我想的不一樣...

使用Array「大量」存取時，執行時間少了一半，
推測是因為List在存取Count跟使用indexer取得元素時，有做了一些檢查，
即使時間複雜度一樣，但step count多了一些，
這樣看來，如果是固定長度還是直接用Array，
會變動元素，當然就是List的強項了。


參考資料：

[Web] 初探Http Cache策略(cache-control)

前言：
瀏覽器會將從server下載回來的靜態檔案做快取，
好處是節省頻寬與資源，加快瀏覽速度。
壞處是需要針對存取資源做適當的快取配置，
讓client在瀏覽網頁的速度與資源的更新取得平衡。


作法：
除了更新資源檔案的檔名外，
一般都是從HTTP/1.1 header中的cache-control指令下手，
設定max-age(單位為秒數)，讓browser定期跟server擷取資源，
不過各browser作法略有不同。
FireFox從第2次開始，會自行帶max-age=0給server，

Chrome不會自行帶max-age的指令，還是需server設定，
且需再增加no-cache指令，讓browser發request來重新驗證資源是否更新，
否則Chrome仍然使用local cache。


max-age雖然可讓browser定期擷取資源，但若資源內容沒有變動，
也沒有下載的必要，因此會搭配ETag指令：
server會依快取的檔案內容產出一字串，回應給browser，
之後browser送出request會夾帶If-None-Match指令，如果字串比對一致，
則回傳status code 304(表Not Modified)，如下圖：

反之，若字串沒有match了，代表資源內容變更了，此時browser再重新擷取該資源即可。

建議font可善用CDN cache，分散又可降低server loading。


參考資料：
https://tools.ietf.org/html/rfc2616
https://tools.ietf.org/html/rfc7234
https://developers.google.com/web/fundamentals/performance/optimizing-content-efficiency/http-caching
https://developer.mozilla.org/zh-TW/docs/Web/HTTP/Caching
https://medium.com/@codebyamir/a-web-developers-guide-to-browser-caching-cc41f3b73e7c