利用 redirect 跳轉到 預設頁 或 預設查詢

在網站開發有一些技巧可以增加後續的維護性，利用重導向來做預設內容的處裡，這樣可以統一集中的進行控制。

預設頁面最常會因為業務的策略因素進行調整，這時候散落在各地的連結都要調整，費工又容易漏。

預設查詢這個麻煩點在於參數會變動，散落在各地的連結一樣是個麻煩。


但重導向這種方式也是有損失的，將會多一個 HTTP 請求，這對 UI 反應速度很要求的狀況來說，並不是一個好方法，可能就要改用統一網址管理來處理。


利用 MVC 的 Index() 來控制預設頁面，Index 將不會有實體頁面，而是用來進行重導向。

原始碼

1. public class UserController : Controller 
2. { 
3.    public ActionResult Index() 
4.    { 
5.        return RedirectToAction(nameof(List)); 
6.    } 
7.  
8.    public ActionResult List(DateTime? date) 
9.    { 
10.        //... 
11.        return View(); 
12.    } 
13.  
14. } 

public class UserController : Controller
{
    public ActionResult Index()
    {
        return RedirectToAction(nameof(List));
    }

    public ActionResult List(DateTime? date)
    {
        //...
        return View();
    }

}

判斷 QueryString 為空時，進行預設查詢的重導向，以 QueryString 為判斷點的好處是有時候就是要查詢全部資料，這樣就不會被預設查詢卡到。

原始碼

1. public class UserController : Controller 
2. { 
3.    public ActionResult List(DateTime? date) 
4.    { 
5.        if (Request.QueryString.Count == 0) 
6.        { 
7.            RedirectToAction(nameof(List), new  
8.            {  
9.                date = DateTime.Today.ToString("yyyy-MM-dd")  
10.            }); 
11.        } 
12.  
13.        //... 
14.        return View(); 
15.    } 
16.  
17.  
18. } 

public class UserController : Controller
{
    public ActionResult List(DateTime? date)
    {
        if (Request.QueryString.Count == 0)
        {
            RedirectToAction(nameof(List), new 
            { 
                date = DateTime.Today.ToString("yyyy-MM-dd") 
            });
        }

        //...
        return View();
    }


}

資料庫設計原則

以前跟同事一起訂下的資料庫設計原則，來減少一開始設計不好造成事後要進行大改的風險。

實體關聯的設計是最需要謹慎的，這裡一旦與規格差太多，程式可能就要重寫。

欄位名稱建議在系統中是唯一的，這樣可以減少 JOIN 時還需要換名稱，FK 使用跟 PK 一樣的名稱也可以增加維護性。

---

資料庫設計流程

(Instance 層級)

• 依照 Instance 建立 ER 圖，須清楚描述關聯與實體
• 審視並釐清實體對於規格的含蓋範圍

(Table 層級)

• 依照釐清後的含蓋範圍，修正 ER 圖
• 審視並確認完整 ER圖

(Column 層級)

• 定義各資料表欄位，建立 OrgTableSchema.sql
• 審視並確認完整 Schema
• 有問題重複上述步驟

(Develop 層級)

• 維護 OrgTableSchema.sql
• 使用 DbSchemaTool 工具產生 Schema.sql
• 建立資料庫
• 修正 Dbml
• 更新 DB 專案

資料表與欄位定義

• Id 是 identity 去尾的縮寫，所以 d 要小寫
• No 改成 Num 會比較好，因為會跟 Yes, No 混淆
• Id 是流水號，其他的建議用 Num 或 Code 表示
• 避免用單單字做欄位名，盡量用多單字 ( Ex. IssueType, CompanyCode, SettingId, CompanyName )
• 盡量用 流水號 或 Guid 這類無意義的 id 做 PK
• 除了多對多的中間表，PK 都必須是單一欄位
• 資料來源為 OptionSetting, 值為 OptionId 者，欄位名稱命名須加尾贅詞 Id，型態為 INT
• 資料來源為 Enum, 欄位型態則為 Nvarchar(N)
• 盡量避免資料來源為 bool 對應 bit，因為擴充性太低，資料來源改用 Enum 對應 Nvarchar(N)
• 歷史檔與主檔的差異
• 主檔的 ModifiedBy ModifierdDate 為歷史檔的 CreatedBy CreatedDate，歷史檔無 ModifiedBy ModifierdDate
• 新增歷史檔的 PK , 主檔的 PK 設定為 FK
• 其餘欄位應該與主檔相同
• 每一個 FK 需預設建立 IX，其餘調整於開發完成後，依照使用者回報進行調整
• 多對多的中間表如果超過 3 個附加欄位，必須用一般的方式設計

PK 必須使用 Guid 的情況

• 如果只保留短期資料，但會有大量新增或刪除(每天一萬筆新增)
• 如果有多系統都可以新增資料，最後要合流的狀況

設計 Table 的欄位順序

1. PK
2. FK [主檔]
3. FK [選項]
4. AK
5. 其餘不重要的資料欄位
6. CreatedBy
7. CreatedDate
8. ModifiedBy
9. ModifierdDate

資料型態

• 文字 : NVARCHAR 長度為預定輸入的兩倍
• 日期 : DATETIMEOFFSET 具有時區紀錄(MSDN 建議)
• 時間 : TIME
• 整數 : INT
• Enum : NVARCHAR (32)
• Guid : UNIQUEIDENTIFIER
• 金錢 : MONEY
• 精確浮點數 : DECIMAL (18, 4)

鍵值規則

• Table 規則 {ProjectName}_{TableName}
   Ex: WMS_Carrier
• Foreign Key 規則 FK_{ProjectName}_{TableName}_{Columns}
   Ex: FK_WMS_CarrierMaterial_CarrierId
• Unique 規則 AK_{ProjectName}_{TableName}_{Columns}
   Ex: FK_WMS_CarrierMaterial_CarrierId
• Index 規則 IX_{ProjectName}_{TableName}_{Columns}
   Ex: IX_WMS_CarrierMaterial_CarrierId

縮寫解釋

• PK: Primary Key
• FK: Foreign Key
• AK: Alternate Key
• IX: IndeX
• CK: ChecK
• DF: DeFault

MSSQL 定序設定

定序 Chinese_Taiwan_Stroke_CS_AI

_CS 區分大小寫
_CI 不區分大小寫

_AS 區分腔調 a != á
_AI 不區分腔調

_KS 區分日文假名字元
_WS 區分全形與半形字元

定序會影響查詢與唯一值的判定，例如不區分大小的定序在 WHERE 'abc' = 'ABC' 會是 true。

定序選擇並沒有標準答案，我個人是採用區分大小的定序，如果規格是不區分的時候，再用程式轉大寫或小寫，這部分可以在 DAO 統一完成，雖然也會有遺漏的情況，但至少是可以由程式掌控，如果出現只有某些不區分，而大部分還是區分的時候，還是由程式掌控會比較好。

IIS 網站目錄規劃

1. \{專案名稱} 
2.    \App_Data 
3.    \Attach 
4.    \WebRoot 
5.    \{專案名稱}-說明.txt 

\{專案名稱}
    \App_Data
    \Attach
    \WebRoot
    \{專案名稱}-說明.txt

以一個專案的方式將相關連的東西放在一個目錄下，在目錄下放一個日後維護要注意的說明文件，可以寫一些客戶名稱或者目錄用途等等。

將 IIS 網站的起始目錄指向到 WebRoot，這是網站的主目錄，將會變動的檔案從 WebRoot 移出，用虛擬目錄的方式進行連接，例如檔案上傳的目錄 以及 Log 目錄，如果有人因為發佈時沒做好，把使用者的上傳資料都砍光就不好玩了，再者 WebRoot/bin/ 如果有檔案異動會造成 IIS Pool 重啟，使用者就要重新登入系統了。

NLog Config 的尋找順序

當一個目錄下有兩個以上的執行程序要用不同的 NLog Config 時，可以利用 NLog 的 Config 尋找順序來簡單的區分。

Application *.exe

1. {AppName}.exe.config
2. {AppName}.exe.nlog
3. NLog.config

ASP.NET

1. Web.config
2. Web.nlog
3. NLog.config

LINQ 方法解釋一覽

轉載自: WIDEC

這張圖很好的解釋了 LINQ 常用的方法會產生的結果:

C# MVC 生命週期圖

轉仔自: Detailed ASP.NET MVC Pipeline

C# MVC Cassette 隔離區快取找不到的錯誤

有使用 Cassette 的專案，在發布站台之後網頁開起來卻發生了 JS 跟 CSS 全部掉光，查看錯誤訊息時發現 Cassette 抓不到在隔離區的快取。

原因是當 JS 跟 CSS 有更新時，Cassette 會重新產生快取的 key，卻沒有產生隔離區的快取檔案，造成抓不到快取的問題，IIS pool 重啟也無效，Cassette 的管理畫面也進不去。

解決辦法就是呼叫 Bundles.RebuildCache()，最好方式就是在 Global.asax.cs 增加自動處裡。

原始碼

1. protected void Application_Error(object sender, EventArgs e) 
2. { 
3.    /* 重建 Cassette 綑綁 */ 
4.    var ex = Server.GetLastError() as System.IO.FileNotFoundException; 
5.    if (ex != null && ex.StackTrace.Contains("Cassette.")) 
6.    { Bundles.RebuildCache(); } 
7. } 

protected void Application_Error(object sender, EventArgs e)
{
    /* 重建 Cassette 綑綁 */
    var ex = Server.GetLastError() as System.IO.FileNotFoundException;
    if (ex != null && ex.StackTrace.Contains("Cassette."))
    { Bundles.RebuildCache(); }
}

EF Core 3.1 取得 IQueryable 的 SQL

原始碼

1. private static T getPrivate<T>(this object obj, string privateField) 
2. { 
3.    return (T)obj?.GetType() 
4.        .GetField(privateField, BindingFlags.Instance | BindingFlags.NonPublic) 
5.        ?.GetValue(obj); 
6. } 
7.  
8. public static string ToSql<TEntity>(this IQueryable<TEntity> query) where TEntity : class 
9. { 
10.    var enumerator = query.Provider.Execute<IEnumerable<TEntity>>(query.Expression).GetEnumerator(); 
11.  
12.    var relationalQueryContext = enumerator.getPrivate<RelationalQueryContext>("_relationalQueryContext"); 
13.    var relationalCommandCache = enumerator.getPrivate<RelationalCommandCache>("_relationalCommandCache"); 
14.  
15. #pragma warning disable EF1001 // Internal EF Core API usage. 
16.    IRelationalCommand command = relationalCommandCache.GetRelationalCommand(relationalQueryContext.ParameterValues); 
17. #pragma warning restore EF1001 // Internal EF Core API usage. 
18.  
19.    return command.CommandText; 
20. } 

private static T getPrivate<T>(this object obj, string privateField)
{
    return (T)obj?.GetType()
        .GetField(privateField, BindingFlags.Instance | BindingFlags.NonPublic)
        ?.GetValue(obj);
}

public static string ToSql<TEntity>(this IQueryable<TEntity> query) where TEntity : class
{
    var enumerator = query.Provider.Execute<IEnumerable<TEntity>>(query.Expression).GetEnumerator();

    var relationalQueryContext = enumerator.getPrivate<RelationalQueryContext>("_relationalQueryContext");
    var relationalCommandCache = enumerator.getPrivate<RelationalCommandCache>("_relationalCommandCache");

#pragma warning disable EF1001 // Internal EF Core API usage.
    IRelationalCommand command = relationalCommandCache.GetRelationalCommand(relationalQueryContext.ParameterValues);
#pragma warning restore EF1001 // Internal EF Core API usage.

    return command.CommandText;
}