.NET6_MVC開發三層式架構開發part1_搭配Autofac來實作IOC_專案功能模組架構前期準備

-
 






這邊我要來透過三層式架構創建專案
那基本上會拆分成

(1).UI顯示層

(2).業務邏輯層(BLL)

(3).資料庫訪問層(DAL)



這裡會透過將三層都進行interface設計
透過IOC容器來去將interface與具體的實踐做串接








新建好空方案
並新建四個folder各自分別命名






準備好資料庫與相應表


 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
use master;
create database SchoolDb;

use SchoolDb;
create table Student
(
  [Id] [uniqueidentifier] primary key not null,
  [Name] [nvarchar](20) not null,
  [Age] [int] not null,
  [Sex] [bit] not null,	--1:男生,0:女生
  [Address] [nvarchar](500) not null,
  [CardId] [varchar](12) not null	--身分證字號
)

use SchoolDb;
create table Course
(
  [Id] [uniqueidentifier] primary key not null,
  [Name] [nvarchar](200) not null,	--課程名稱
  [Summary] [nvarchar] (500) null	--課程描述
)


--成績屬於哪位學生修的哪門課

use SchoolDb;
create table Score
(
  [Id] [uniqueidentifier] primary key not null,
  [Mark] [numeric](5,2) not null,	--成績(分數)
  [CourseId] [uniqueidentifier] foreign key references [Course](Id) not null,	--課程ID 成績對應哪門課
  [Student] [uniqueidentifier] foreign key references [Student](Id) not null,	--學生ID 成績對應哪位學生
  [Semester] [nvarchar](200) not null
)

針對這些表去產生相應的Model Class於DataModel目錄下



學生

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
using System;

public class Student
{
    public Guid Id { get; set; }

    public string Name { get; set; }

    public int Age { get; set; }

    public bool Sex { get; set; }

    public string Address { get; set; }

    public string CardId { get; set; }

}

成績

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
using System;

public class Score
{
    public Guid Id { get; set; }

    public decimal Mark { get; set; }

    public Guid CourseId { get; set; }

    public Guid Student { get; set; }

    public string Semester { get; set; }

}

課程

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
using System;

public class Course
{
    public Guid Id { get; set; }

    public string Name { get; set; }

    public string Summary { get; set; }

}


針對UI顯示層

新增一個asp.net core mvc專案


配置連線字串

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "SchoolDbConn": "Server=.\\SQLEXPRESS;Database=SchoolDb;uid=sa;pwd=rootroot"
  }
}










針對資料庫訪問層(DAL)

新增一個Class Library Project



把預設的Class刪除






Nuget補安裝Microsoft.Data.SqlClient
ado.net最新微軟釋出的存取套件








建立ISysDataAccess的類別庫
用於DB訪問的介面，負責定義對DB訪問操作與資料存取相應規範。

可以定義 IBaseSysDataAccess 抽象的CRUD操作。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
using Microsoft.Data.SqlClient;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace My3TierAdoApp.ISysDataAccess
{
    public interface IBaseSysDataAccess
    {
        int Create(string sql);

        SqlDataReader Query(string sql);

        int Update(string sql);

        int Remove(string sql);
    }
}


建立SysDataAccess的類別庫
並新增SysDataAccess的Class
之後負責實踐ISysDataAccess，具體相應操作實踐。


配置nuget套件
Microsoft.Extensions.Configuration.Json

添加過Microsoft.Data.SqlClient套件
添加ISysDataAccess的類別庫參考
由於SysDataAccess類別庫專案要去繼承ISysDataAccess類別庫專案當中的IBaseSysDataAccess





在此類別庫專案定義一個SqlDbHelper的類別

 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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
using Microsoft.Data.SqlClient;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Configuration.Json;
using System;
using System.Collections;
using System.Collections.Generic;
using System.Data;
using System.Linq;
using System.Text;
using System.Threading.Tasks;


namespace My3TierAdoApp.SysDataAccess
{
    public static class SqlDbHelper
    {
        private static string connStr;
        static SqlDbHelper()
        {
            //創建組態Builder物件並相應獲取appsetting.json檔案
            var configuration = new ConfigurationBuilder().Add(
                new JsonConfigurationSource { Path="appsetting.json",ReloadOnChange=true}
            ).Build();
            connStr = configuration.GetConnectionString("SchoolDbConn");
        }

        /// <summary>
        /// 可傳入sql字串並參數化方式進行Insert,Delete,Update並回傳影響筆數
        /// </summary>
        /// <param name="strSQL"></param>
        /// <param name="htParams"></param>
        /// <returns></returns>
        public static int ExecuteNonQuery(string strSQL, Hashtable htParams = null)
        {
            using (SqlConnection conn = new SqlConnection(connStr))
            {
                conn.Open();
                SqlCommand sqlCommand = conn.CreateCommand();
                sqlCommand.CommandText = strSQL;
                sqlCommand.CommandType = CommandType.Text;
                PrepareParams(htParams, sqlCommand);
                return sqlCommand.ExecuteNonQuery();
            }
        }

        /// <summary>
        /// 透過SQL語法回傳資料表中資料採用ReadOnly Data Reader方式獲取
        /// </summary>
        /// <param name="strSQL"></param>
        /// <param name="htParams"></param>
        /// <returns></returns>
        public static SqlDataReader GetSqlDataReader(string strSQL, Hashtable htParams = null)
        {
            SqlConnection conn = new SqlConnection(connStr);
            conn.Open();
            SqlCommand sqlCommand = conn.CreateCommand();
            sqlCommand.CommandText = strSQL;
            sqlCommand.CommandType = CommandType.Text;
            PrepareParams(htParams, sqlCommand);
            //設置CommandBehavior.CloseConnection代表當關閉Data Read後也同時將連線關閉
            return sqlCommand.ExecuteReader(CommandBehavior.CloseConnection);
        }

        /// <summary>
        /// 回傳首橫列首直行的值(first row and first column value)
        /// ex: select top 1 , select sum() , select count(*)
        /// </summary>
        /// <param name="strSQL"></param>
        /// <param name="htParams"></param>
        /// <returns></returns>
        public static object ExecuteScalar(string strSQL, Hashtable htParams = null)
        {
            using (SqlConnection conn = new SqlConnection(connStr))
            {
                conn.Open();
                SqlCommand sqlCommand = conn.CreateCommand();
                sqlCommand.CommandText = strSQL;
                sqlCommand.CommandType = CommandType.Text;
                PrepareParams(htParams, sqlCommand);
                return sqlCommand.ExecuteScalar();
            }
        }

        private static void PrepareParams(Hashtable htParams, SqlCommand sqlCommand)
        {
            if (htParams != null)
            {
                foreach (DictionaryEntry entry in htParams)
                {
                    sqlCommand.Parameters.AddWithValue(entry.Key.ToString(), entry.Value);
                }
            }
        }

    }
}


新定義一個BaseSysDataAccess的類別(用於具體實作IBaseSysDataAccess)

 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
using Microsoft.Data.SqlClient;
using My3TierAdoApp.ISysDataAccess;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;


namespace My3TierAdoApp.SysDataAccess
{
    public class BaseSysDataAccess : IBaseSysDataAccess
    {
        public int Create(string sql)
        {
            return SqlDbHelper.ExecuteNonQuery(sql);
        }

        public SqlDataReader Query(string sql)
        {
            return SqlDbHelper.GetSqlDataReader(sql);
        }

        public int Remove(string sql)
        {
            return SqlDbHelper.ExecuteNonQuery(sql);
        }

        public int Update(string sql)
        {
            return SqlDbHelper.ExecuteNonQuery(sql);
        }
    }
}





建立SysDataAccessContainer的IOC容器類別庫


建立SysDataAccessContainer
用於作為倉儲容器，透過Autofac來做依賴注入容器
實踐ISysDataAccess 和 SysDataAccess 的相應串聯，負責SysDataAccess物件的實體化
針對SysDataAccessContainer類別庫專案新增nuget套件 "Autofac"


針對SysDataAccessContainer類別庫專案
新增IOCContainer.cs的class

由於在IOC容器中需要去建立ISysDataAccess 和 SysDataAccess之間的關聯。
因此需要額外補添加
上面兩個類別庫專案參考




撰寫IOC容器 類別 IOCContainer

 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
using Autofac;
using Autofac.Core.Activators;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace My3TierAdoApp.SysDataAccessContainer
{

    /// <summary>
    /// 後續BLL要呼叫資料存取訪問層可以不用透過new來實體化SysDataAccess相關物件，而是
    /// 透過IOC容器中來間接獲取物件實體並映射至對應interface
    /// 換言之，有點類似統一入口，避免過多入口存取呼叫導致混亂，較難管理。
    /// </summary>
    public class IOCContainer
    {
        public static IContainer Container = null;

        public static T Resolve<T>()
        {
            try
            {
                if (Container == null)
                {
                    Instance();
                }
            }
            catch (Exception ex)
            {
                throw new Exception("IOC Initial instance fail," + ex.Message);
            }
            //Resolve方法可確保Instance()只生成一次並根據傳過來的泛型T(任一種類型)於容器中提取相應實體。
            return Container.Resolve<T>();
        }

        public static void Instance()
        {
            var builder = new ContainerBuilder();
            //使用RegisterType來註冊組件
            //組件部分統一關係皆為 具體的Class 
            //與相應繼承(要實作)的抽象Interace 
            //builder.RegisterType<具體的Class>().As<相應實作的抽象Interace>().InstancePerLifetimeScope();
            Container = builder.Build();
        }
    }
}


針對業務邏輯層(BLL)

新建一個IService類別庫專案



新建一個IBaseService
主要用來規範一些業務邏輯的共用方法
在泛型interface這邊約束T必須為引用類型(reference type)
並定義4個業務邏輯操作

 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
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace My3TierAdoApp.IService
{
    public interface IBaseService<T> where T : class
    {
        /// <summary>
        /// 添加
        /// </summary>
        /// <param name="t"></param>
        /// <returns></returns>
        bool Add(T t);
        /// <summary>
        /// 刪除
        /// </summary>
        /// <param name="id"></param>
        /// <returns></returns>
        bool Delete(string id);
        /// <summary>
        /// 獲取單一筆資料
        /// </summary>
        /// <param name="id"></param>
        /// <returns></returns>
        T GetSingle(string id);
        /// <summary>
        /// 資料更新
        /// </summary>
        /// <param name="t"></param>
        /// <returns></returns>
        bool Update(T t);
        /// <summary>
        /// 資料查詢
        /// </summary>
        /// <param name="keyword"></param>
        /// <returns></returns>
        List<T> GetList(string keyword);
    }
}

那這裡藉由泛型好處就在於
你可以傳遞int,double,string之類任一種類型

若以多個(column)屬性的資料要一起提交給資料庫
就可以使用model作為參數

如果只是單一個值提交給資料庫則使用單個參數
IBaseService這個介面服務目的在於
去實踐以物件實體來傳遞資料

在和DAL對接時則需要將Data Model 轉為T-SQL

新建Service類別庫專案

有了抽象的IService介面也要有相應具體的實踐

那這個專案由於涉及到諸多專案參考
需要添加
My3TierAdoApp.IService
My3TierAdoApp.ISysDataAccess
My3TierAdoApp.SysDataAccessContainer


那並不包含具體實作的這個類別
My3TierAdoApp.SysDataAccess
在這邊會藉由My3TierAdoApp.SysDataAccessContainer定義的容器
來建立具體的SysDataAccess 在賦予給ISysDataAccess

藉由IOC來取得相應實體，改善傳統三層式架構於業務邏輯層會去實體化DAL物件
導致有強依賴的缺點。

那在這專案中並不需要再去建立IBaseService的介面沒必要了
只要所有功能模組有相應繼承(實作)IBaseService去實作參數實體化
於Service專案中就可讓功能模組的class繼承對應功能模組的介面
即可實踐專用的業務邏輯處理。



新建ServiceContainer類別庫專案

於BLL中也需要有一個IOC容器的專案
用於針對UI層要去存取BLL中方法時候，不會去依賴Service 物件實體
而是透過IOC容器來獲取有實作 IService 的Service物件實體

這裡於專案中需要補添加
IService與Service兩項專案參考


一樣需要nuget補安裝Autofac套件



撰寫IOC容器 類別 IOCContainer
可以將功能模組中的業務邏輯操作的class與interface建立關係
並供 UI層去呼叫

 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
using Autofac;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace My3TierAdoApp.ServiceContainer
{
    public class IOCContainer
    {
        public static IContainer Container = null;

        public static T Resolve<T>()
        {
            try
            {
                if (Container == null)
                {
                    Instance();
                }
            }
            catch (Exception ex)
            {
                throw new Exception("IOC Initial instance fail," + ex.Message);
            }
            return Container.Resolve<T>();
        }

        public static void Instance()
        {
            var builder = new ContainerBuilder();
            //builder.RegisterType<具體的Class>().As<相應實作的抽象Interace>().InstancePerLifetimeScope();
            Container = builder.Build();
        }
    }
}














留言

張貼留言

這個網誌中的熱門文章

經得起原始碼資安弱點掃描的程式設計習慣培養(五)_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協定。 在第一次發出前往特定網站的請求時，攻擊者可以執行中間人攻擊並將用戶轉址到
閱讀完整內容

經得起原始碼資安弱點掃描的程式設計習慣培養(三)_7.Cross Site Scripting(XSS)_Stored XSS_Reflected XSS All Clients

-
圖片
  近期新加入的功能code剛好也被CheckMarx掃出高風險部分的程式碼漏洞 我也踏到這個Issue啦 Cross Site Scripting(XSS)  第一種.Stored XSS 高風險 CheckMarx掃碼報告給的說明[Stored XSS] ============================================================ 風險: 攻擊者可以利用合法存取應用程式提交資料到資料庫。 當另一個使用者隨後存取該資料，網頁可能會被改寫且惡意腳本可能會被啟動。 發生原因: 從資料庫中的資料建立網頁。資料直接嵌入至HTML的頁面，利用瀏覽器顯示。 資料可能源自於其他使用者的輸入。 如果資料包含HTML片段或Javascript，使用者無法分辨是否為預期的頁面。 該漏洞主因為未先對嵌入資料庫中的資料進行編碼(Encode) 來預防瀏覽器將其當為HTML的格式而非純文字。 如何避免: 1.驗證所有資料，無論其來源為何。驗證應基於白名單：僅接受預定結構的資訊，而不是拒絕不良的樣式(Patterns)。  應確認：  ● 資料型態  ● 大小  ● 範圍  ● 格式  ● 期望值  2. 驗證無法取代編碼. 輸出嵌入之前，不論其來源， 將所有動態資料進行編碼. 編碼方式應該是上下文相關的. 例如: ● HTML內容使用HTML的編碼方式  ● HTML編碼特性是將資料輸出到特性的值 ● JavaScript的編碼方式為伺服器產生的Javascript  3.考慮使用ESAPI的編碼庫，或它的內置功能。對於舊版的ASP.NET，請考慮使用AntiXSS.  4.在HTTP類型對應的表頭， 明確定義整個頁面的字元編碼.  5. 設置 httpOnly 標誌於會期資訊，以防止利用XSS來竊取資訊. ============================================================ 這裡報告描述是指我對傳進來字串參數直接拋給DAL處裡的類別執行查詢 這裡缺乏對輸入進來的字串參數做一些查檢判斷 也建議在帶入時對參數也做一些html encode處理 這裡用AntiXSS來Encode 第二種.Reflected XSS All Clients 高風險 CheckMarx掃碼報告給的說明[Reflecte
閱讀完整內容

(2021年度)駕訓學科筆試準備題庫歸納分析_法規是非題

-
圖片
  若是出現 「必須」、「必需」、「...必...」、「應由」、「應先」、「應...」 則很高機率是圈 是非通常只要是如下字眼 「不必」+動詞 、「不需」「不須」、「可不」、「可以不」、「可立即」 有出現或符合的都選叉 (X)1.違規記點又不登記在駕照上，所以可以 不必理會 而任意違反交通規則。 (X)2.發生重大交通事故，為迅速恢復交通，清除現場，可 不必等待 肇事處理機關之指示，即可進行。 (X)3.道路駕駛練習，行車前 不必實施 車輛安全檢查，因為那是駕駛教練的工作。 (X)4.開車前， 不必檢查 機件安全，但在行駛中要隨時注意儀錶功能顯示，確保行車安全。 (X)5.煞車油若經常低於"MIN"線，只要添加即可， 不必到修理廠檢修 。 (X)6.冷卻系統只要副水箱在滿水位，主水箱 不必檢查 也不會有問題。 (X)7.引擎冷卻水內含有防凍液或防銹劑，可 不必更換 。 (X)8.儀錶板上的「燃油油量錶」之指針高度，已經降低至「E」點，橘色的「低油料警示燈」點亮時， 不必急著加油 ，到達目的地後再行補充燃油即可。 (X)9.有安全氣囊裝備的汽車， 不必繫 安全帶。 (X)10.煞車時有異音，是正常的情況， 不必檢修 。 (X)11.汽車定期檢驗 不必檢驗 車輛故障標誌，所以隨車不一定要帶車輛故障標誌。 (X)12.開車時 不必理會 義交之指揮，一切以號誌為主。 (X)13.汽車經過隧道，因隧道內燈光明亮視線良好，為省電可 不必開亮 頭燈。 (X)14.駕駛人只求技術優良，對遵守交通規則 不必太重視 。 (X)15.在開車前， 不必檢查 機件，以免耽誤行車時間。 (X)16.遇幼童專用車、校車、身心障礙者用特製車或教練車， 不必禮讓 。 (X)17.行車 不必攜帶 隨車工具。 (X)18.行車起駛前進， 不必顯示 方向燈。 (X)19.汽車通過鐵路平交道，前後兩車間， 不必保持 距離。 (X)20.夜間將車輛停放在無燈光設備及照明不清之道路時，亦 不必顯示 停車燈光或反光標識。 (X)21.在夜間或有霧靄、雨雪、風沙及晝晦時，把車輛停在路旁， 不必顯示 停車燈光或反光標識。 (X)22.汽車駕駛人，僅需具有優良駕駛技術， 不需 具備急救的常識和技能。 (X)23.汽車車身、引擎、底盤、電系等重要設備變更或調換時， 不需 向公路主管機關申請臨時檢驗。
閱讀完整內容