SnailAspNetCoreFramework

การแนะนำโครงการ

• โครงการนี้อยู่ในตำแหน่งที่เป็นกรอบการพัฒนาที่รวดเร็วสำหรับองค์กรขนาดเล็กและขนาดกลางที่ใช้แกน asp.net รวมถึงโค้ดแบ็กเอนด์และฟรอนต์เอนด์ที่สมบูรณ์
• ขณะนี้เวอร์ชัน v2.0 อยู่ระหว่างการพัฒนา สามารถเรียกใช้เวอร์ชัน v1.0 ได้โดยตรงหลังจากเปลี่ยนสาขา สำหรับบทช่วยสอน โปรดดูที่ชุดบล็อกของฉันหรือเอกสารในโปรเจ็กต์
• เทคโนโลยีแบ็คเอนด์: asp.net core 3.1, cap, swag, ef core code first, autofac, automapper, nlog, aop
• สแต็คเทคโนโลยีส่วนหน้า: vue-element-admin, ส่วนประกอบโมดูลการพัฒนาอย่างรวดเร็ว crud, จำลอง
• ฟังก์ชันที่นำไปใช้: การควบคุมสิทธิ์ตามบทบาท, ข้อตกลงลำดับชั้นของโครงการ, การสร้างโค้ดอัตโนมัติ, การบันทึก, การตรวจสอบประสิทธิภาพ, aop ฯลฯ

วิธีการดำเนินโครงการ

 git clone [email protected]:shengyu-kmust/SnailAspNetCoreFramework.git
git clone [email protected]:shengyu-kmust/Snail.git
cd SnailAspNetCoreFramework
dotnet build

การสาธิตโครงการ

ต่อไปนี้เป็นแผนภาพสาธิตตามเวอร์ชัน v1.0

• 1. ดาวน์โหลดและรันโครงการ
• 2. สร้างโครงการโดยอัตโนมัติตามไฟล์การกำหนดค่า
• 3. รันโครงการ

การแนะนำไดเรกทอรีโครงการ

--ApplicationCore // เลเยอร์นามธรรมหลักใช้โหมดสถาปัตยกรรมที่ชัดเจนและไม่ขึ้นอยู่กับเลเยอร์อื่น ๆ อีกสามโปรเจ็กต์ทั้งหมดอาศัยไลบรารีประเภทนี้และรับผิดชอบคำจำกัดความสาธารณะ เช่น อินเทอร์เฟซ ค่าคงที่ การแจงนับ dto เอนทิตี ฯลฯ
----Const // คำจำกัดความคงที่ เช่น ค่าคงที่การกำหนดค่า ค่าคงที่ชื่อเหตุการณ์
----Dtos // dtos ทั้งหมด
----เอนทิตี // เอนทิตีทั้งหมด
----แจกแจง // แจงนับ
----IServices // คำจำกัดความเชิงนามธรรมของชั้นบริการ
----ยูทิลิตี้ // คลาสช่วยเหลือ

--โครงสร้างพื้นฐาน //ชั้นโครงสร้างพื้นฐานให้บริการข้อมูลสำหรับชั้นบน (เช่นชั้นบริการและชั้นแอปพลิเคชัน)
---- ข้อมูล / config // ฐานข้อมูลเอนทิตีเฟรมการกำหนดค่า API ได้อย่างคล่องแคล่ว
----EFValueConverter // การแปลงระหว่างประเภทฐานข้อมูลเอนทิตีเฟรมเวิร์กและประเภท clr เช่นการแปลงการแจงนับ
----การโยกย้าย //สร้างไดเร็กทอรีสำหรับการย้ายโค้ดเอนทิตีเฟรมเวิร์กก่อน

--Service // Service layer ใช้เพื่อใช้อินเทอร์เฟซบริการใน ApplicationCore ซึ่งเป็นเลเยอร์หลักสำหรับการนำตรรกะของแอปพลิเคชันไปใช้
----Cache // การใช้งานแคชซึ่งจะถูกลบและแยกไปยังโปรเจ็กต์ Snail ในภายหลัง
----Interceptor //Interceptor ถูกใช้งานโดยค่าเริ่มต้น
----BaseService.cs //คลาสฐานของแต่ละบริการประกอบด้วยวิธีการทั่วไปของแต่ละบริการ เช่น CRUD
----InitDatabaseService.cs // รับผิดชอบในการเริ่มต้นข้อมูลฐานข้อมูล
----InterceptorService.cs //คลาสฐาน Interceptor

--Web // รับผิดชอบการประมวลผลอินพุตและเอาท์พุตของพารามิเตอร์อินเทอร์เฟซที่เกี่ยวข้องทั้งหมด (เช่น การตรวจสอบพารามิเตอร์ การจองรูปแบบเอาต์พุต ฯลฯ)
----AutoFacModule // การกำหนดค่าการฉีด autofac
----AutoMapperProfiles // การกำหนดค่า automapper
----ClientApp // โครงการส่วนหน้า
------ build // ไดเร็กทอรีเอาต์พุตที่สร้างโดยการคอมไพล์ส่วนหน้า
------เยาะเย้ย // เยาะเย้ยส่วนหน้า
------src // รหัสหลักส่วนหน้า
----CodeGenerater //โมดูล T4 และตรรกะที่เกี่ยวข้องสำหรับการสร้างโค้ด
----ConfigureServicesExtensions // ส่วนขยายการฉีด ServiceProvider เพื่อหลีกเลี่ยงการเขียนลงในไฟล์เริ่มต้น
----คอนโทรลเลอร์ //คอนโทรลเลอร์
----docs // ชุดเอกสาร
----Dto // คลาส dto จะถูกใช้ในเว็บเลเยอร์เท่านั้น
----ตัวกรอง // ตัวกรอง
----ฮับ // ผู้ส่งสัญญาณ
---- การอนุญาต // การใช้งานการอนุญาตเริ่มต้น
----staticFile // ใช้สำหรับจัดเก็บไฟล์ที่อัพโหลด

การออกแบบโครงสร้างโดยรวมของโครงการ

มีการใช้ DDD แต่ต้องใช้เทคโนโลยีที่แตกต่างกันของ DDD ตามขนาดของโครงการ โดยทั่วไปจะแบ่งออกเป็นโครงการดังต่อไปนี้

• บริการ: เลเยอร์บริการ ใช้เพื่อใช้อินเทอร์เฟซบริการใน ApplicationCore ซึ่งเป็นเลเยอร์หลักสำหรับการนำตรรกะของแอปพลิเคชันไปใช้
• เลเยอร์โครงสร้างพื้นฐาน: เลเยอร์พื้นฐาน เลเยอร์นี้ถูกนำมาใช้ซ้ำในโครงการต่างๆ โดยอาศัยรูปแบบอินเทอร์เฟซของเลเยอร์ ApplicationCore เพื่อให้บริการข้อมูลสำหรับเลเยอร์ด้านบน (เช่น เลเยอร์บริการและเลเยอร์แอปพลิเคชัน) ในขณะเดียวกัน อินเทอร์เฟซการเข้าถึงข้อมูลสากลของ IDAL ก็ถูกนำมาใช้
• ApplicationCore layer: เลเยอร์ตรรกะของแอปพลิเคชัน โหมด DDD มีตรรกะทางธุรกิจทั้งหมดและไม่ขึ้นอยู่กับเลเยอร์อื่น
• เลเยอร์เว็บ: รับผิดชอบการประมวลผลอินพุตและเอาท์พุตของพารามิเตอร์อินเทอร์เฟซที่เกี่ยวข้องทั้งหมด (เช่น การตรวจสอบพารามิเตอร์ การสำรองรูปแบบเอาต์พุต ฯลฯ) และการเรียกไปยังเลเยอร์ Application/DAL

การอนุญาตข้อมูลสากลและการตรวจสอบ

เลเยอร์เว็บ

• รับผิดชอบการประมวลผลพารามิเตอร์อินพุตและเอาต์พุต การสกัดกั้นข้อยกเว้น และการแคชเว็บ
• สำหรับการดำเนินการข้อมูลประเภทสถิติการสืบค้น สามารถเรียกเลเยอร์ DAL ได้โดยตรง
• การกำหนดค่าของสภาพแวดล้อมการพัฒนาและการทดสอบสามารถแยกออกได้

การตรวจสอบพารามิเตอร์ --ดำเนินการแล้ว

• การใช้อินเทอร์เฟซของ Microsoft -- นำไปใช้งาน

แบบแผนการส่งออก -- ดำเนินการแล้ว

• รหัสสถานะ HTTP เป็นไปตามแบบแผนรหัสสถานะ 20x คือความสำเร็จ (เรียกใช้อินเทอร์เฟซสำเร็จแล้ว) 40x คือข้อผิดพลาดคำขอ (ข้อยกเว้นทางธุรกิจ ไม่ได้รับอนุญาต ฯลฯ) 50x คือข้อผิดพลาดของเซิร์ฟเวอร์ (ข้อยกเว้นเซิร์ฟเวอร์) - นำไปใช้
• เนื้อหาผลลัพธ์ที่ส่งคืนส่วนใหญ่อยู่ในรูปแบบข้อมูลจริงที่ส่วนหน้าต้องการ ซึ่งเป็นออบเจ็กต์ json หากเป็นข้อความแสดงข้อผิดพลาด เนื้อหาข้อผิดพลาดจะถูกส่งกลับ --บรรลุผลแล้ว

การจัดการข้อยกเว้น -- นำไปใช้แล้ว

• การจัดการข้อยกเว้นใช้เทคโนโลยีของ Microsoft โปรดดู https://docs.microsoft.com/zh-cn/aspnet/core/fundamentals/error-handling?view=aspnetcore-2.2
• ข้อยกเว้นทั้งหมดจะไม่ถูกจับ
• ข้อยกเว้นทางธุรกิจได้รับแจ้งไปยังภายนอก ข้อยกเว้นของเซิร์ฟเวอร์จะถูกดักและแจ้งให้ภายนอกทราบ

กร่าง - นำไปใช้

• ใช้ NSwagger

แอปพลิเคชันคอร์เลเยอร์

• โครงการนี้ไม่ขึ้นอยู่กับโครงการอื่นใด ใช้สถาปัตยกรรมใหม่ทั้งหมด อ้างอิงถึง: https://docs.microsoft.com/zh-cn/dotnet/standard/modern-web-apps-azure-architecture/common-web- แอปพลิเคชัน-สถาปัตยกรรม

แคช

• อินเทอร์เฟซ ICache ใช้งาน redis, memcached, memoryCache ฯลฯ คุณสามารถลองใช้ easycaching ได้
• ใช้ AOP สำหรับการแคชเพื่อหลีกเลี่ยงการเขียนตรรกะการแคชในแต่ละวิธี easycaching+ออโต้แฟค
• การอัปเดตแคชเป็นไปตามเหตุการณ์และมีการแนะนำส่วนประกอบของบุคคลที่สาม แคชง่าย + หมวก

ขับเคลื่อนด้วยโดเมน

ขับเคลื่อนโดยโดเมน หากขึ้นอยู่กับเลเยอร์อื่นๆ ก็ขึ้นอยู่กับอินเทอร์เฟซของเลเยอร์ที่เกี่ยวข้องมากกว่าการใช้งาน

AOP -- นำไปใช้แล้ว

• สำหรับการเข้าสู่ AOP ในบันทึกและแคช ให้พิจารณาใช้ autofac

IOC-- ดำเนินการแล้ว

• ใช้ออโต้แฟค

ตารางหน่วยความจำ -- นำไปใช้แล้ว

• จัดเก็บตารางที่เปลี่ยนแปลงไม่บ่อยนักและมีข้อมูลในหน่วยความจำค่อนข้างน้อย (ไม่ใช่แคช แต่เป็นอ็อบเจ็กต์) และใช้การคิดที่ขับเคลื่อนด้วยเหตุการณ์เพื่อซิงโครไนซ์ข้อมูลล่าสุด

เหตุการณ์

• เผยแพร่และสมัครสมาชิก
• ใช้ cap เพื่อสลับระหว่างแอปพลิเคชันแบบกระจายและแอปพลิเคชันเดี่ยว

การประมวลผลบันทึก -- นำไปใช้แล้ว

• ใช้ nlog

บัสคำสั่ง - นำไปใช้แล้ว

• ใช้สื่อกลาง

ชั้น DAL

• รับผิดชอบการดำเนินงานที่เกี่ยวข้องกับข้อมูลทั้งหมด
• สรุปอินเทอร์เฟซการเข้าถึงข้อมูลทั่วไปและการใช้งาน เช่น การใช้ EF เพื่อใช้งานฟังก์ชันต่อไปนี้
• ใช้แนวคิดการเขียนโปรแกรมเชิงอินเทอร์เฟซเพื่อขยายเลเยอร์ DAL โดยใช้เทคโนโลยีอื่นที่ไม่ใช่ EF ในอนาคต
• ที่จริงแล้ว การใช้โหมด Repository นั้น EF เองก็เป็นโหมด Repository แต่เพื่อที่จะรวมการสกัดกั้นและการประยุกต์ใช้ตรรกะของตัวเองในระดับการดำเนินการเข้าถึงฐานข้อมูล EF จะใช้ Repository ของตัวเองเพื่อห่อหุ้ม EF
• แบบสอบถามตารางเดียวเพจ
• การสืบค้นเชิงสัมพันธ์อย่างง่ายของหลายตาราง การเพจ
• CRUD ง่าย ๆ

ผู้ทำแผนที่อัตโนมัติ

• อ้างอิง automapper สำหรับการกำหนดวัตถุและการแปลง
• ใช้คลาส objectmapper แบบอิงนิพจน์สำหรับการกำหนดอ็อบเจ็กต์อย่างง่าย ชดเชยข้อบกพร่องของการกำหนดค่าที่ซับซ้อนของ automapper และประสิทธิภาพต่ำโดยใช้การสะท้อน

การใช้งานอีเอฟ

• บันทึกภาษา SQL การดำเนินการ EF**--นำไปใช้แล้ว**
• สำหรับประเภทการแจงนับ ให้ใช้เทคโนโลยี ValueConverter ของ EF เพื่อแปลงโดยอัตโนมัติ และมีการตกลงกันว่าประเภทที่เก็บไว้ในฐานข้อมูลจะเป็นประเภทสตริงแทนที่จะเป็นประเภท Int ซึ่งสะดวกต่อการทำความเข้าใจ**--นำไปใช้**

การส่งข้อความแบบเรียลไทม์

• ใช้เครื่องส่งสัญญาณ

การเลือกใช้เทคโนโลยี

การประมวลผลธุรกรรม

ใช้พื้นที่เก็บข้อมูลและหน่วยของโหมดการทำงาน แต่ใช้โหมดพื้นที่เก็บข้อมูลที่มาพร้อมกับ EF

วิธีการประมวลผลฐานข้อมูล

• ใช้ EF ในการประมวลผลข้อมูลและไม่คำนึงถึงวิธีอื่น

อินเทอร์เฟซส่วนหน้า

• นำไปลงในโครงการเว็บและใช้วิธีการสปา

จำเป็นต้องทำ

• การฉีดทดสอบหน่วย
• Service Layer ไม่ควรอยู่ใน Web Layer แต่เป็น ApplicationCore

พูดได้หลายภาษา

รายละเอียดทางเทคนิคต่างๆ

หมวกแก๊ป

• การใช้งาน CAP ดั้งเดิมไม่รองรับ autofac เป็นอย่างดี ในโปรเจ็กต์นี้ SnailCapConsumerServiceSelector ถูกเขียนขึ้นเพื่อจัดการ
• CAP ปฏิบัติต่อคอนโทรลเลอร์และผู้ที่ไม่ใช่คอนโทรลเลอร์ต่างกันโดยกำเนิด เพียงเพิ่มแอตทริบิวต์ CapSubscribe ให้กับเมธอด ในขณะที่คอนโทรลเลอร์จำเป็นต้องใช้อินเทอร์เฟซ ICapSubscribe บนคลาส และเพิ่มแอตทริบิวต์ CapSubscribe ให้กับเมธอด

วิธีใช้

1. git clone โปรเจ็กต์นี้ 2. กำหนดค่า codeGenerate.json 3. รันโปรเจ็กต์นี้ และหลังจากเข้าสู่ระบบแบบผยองแล้ว ให้รันอินเทอร์เฟซ codeGenerate 4. รัน add-migration 5. เริ่มโปรเจ็กต์

โพสต์บล็อกการสอน

บล็อกซีรีส์ SnailAspNetCoreFramework Framework
1. บทนำและแนวคิดการออกแบบทั่วไปของแต่ละโครงการและไดเร็กทอรีภายในกรอบงาน - SnailAspNetCoreFramework กรอบการพัฒนาอย่างรวดเร็ว
2. การตรวจสอบอินพุตอินเทอร์เฟซ รูปแบบเอาต์พุต และการจัดการข้อยกเว้น—การออกแบบแบ็คเอนด์เฟรมเวิร์กการพัฒนาอย่างรวดเร็วของ SnailAspNetCoreFramework
3. การออกแบบการอนุญาตสากล - การออกแบบแบ็คเอนด์ของเฟรมเวิร์กการพัฒนาอย่างรวดเร็วของ SnailAspNetCoreFramework
4. วิธีการจัดเตรียมเอกสารอินเทอร์เฟซที่ดี (Swagger) ให้กับส่วนหน้า - SnailAspNetCoreFramework การออกแบบแบ็คเอนด์เฟรมเวิร์กการพัฒนาอย่างรวดเร็ว
5. การใช้แคชในสถานการณ์ต่างๆ—การออกแบบแบ็กเอนด์เฟรมเวิร์กการพัฒนาอย่างรวดเร็วของ SnailAspNetCoreFramework
6. การออกแบบ AOP ที่ใช้ Castle และแคชทั่วไป ประสิทธิภาพ การใช้งานตัวสกัดกั้นบันทึก - SnailAspNetCoreFramework การออกแบบแบ็คเอนด์เฟรมเวิร์กการพัฒนาอย่างรวดเร็ว
7. รู้เบื้องต้นเกี่ยวกับการฉีดพึ่งพา - autofac - SnailAspNetCoreFramework การออกแบบแบ็คเอนด์กรอบการพัฒนาอย่างรวดเร็ว
8. เหตุใดจึงต้องใช้ Eventbus และวิธีใช้งาน - SnailAspNetCoreFramework การออกแบบแบ็คเอนด์เฟรมเวิร์กการพัฒนาอย่างรวดเร็ว
9. รู้เบื้องต้นเกี่ยวกับ Nlog ส่วนประกอบบันทึก - SnailAspNetCoreFramework การออกแบบแบ็คเอนด์เฟรมเวิร์กการพัฒนาอย่างรวดเร็ว
10.การแนะนำ Mediatr - SnailAspNetCoreFramework การออกแบบแบ็คเอนด์กรอบการพัฒนาอย่างรวดเร็ว
11. การออกแบบ CRUD ที่เป็นสากลสำหรับตัวควบคุม บริการ และเลเยอร์ Dal—การออกแบบแบ็กเอนด์เฟรมเวิร์กการพัฒนาอย่างรวดเร็วของ SnailAspNetCoreFramework
12. เครื่องมือทำแผนที่วัตถุอัตโนมัติ - SnailAspNetCoreFramework การออกแบบแบ็คเอนด์กรอบการพัฒนาอย่างรวดเร็ว
13. วิธีตรวจสอบคำสั่ง sql ที่สร้างโดย EF - SnailAspNetCoreFramework การออกแบบแบ็คเอนด์เฟรมเวิร์กการพัฒนาอย่างรวดเร็ว
14. รู้เบื้องต้นเกี่ยวกับวิธีการปรับใช้ต่างๆ ของ .net core - SnailAspNetCoreFramework การออกแบบแบ็คเอนด์ของเฟรมเวิร์กการพัฒนาอย่างรวดเร็ว
15. ตัวส่งสัญญาณการสื่อสารแบบเรียลไทม์ - SnailAspNetCoreFramework การออกแบบแบ็คเอนด์กรอบการพัฒนาอย่างรวดเร็ว
16. วิธีใช้โค้ด ef ก่อนเพื่อวนซ้ำเวอร์ชันฐานข้อมูลของโปรเจ็กต์อย่างต่อเนื่อง - SnailAspNetCoreFramework การออกแบบแบ็คเอนด์เฟรมเวิร์กการพัฒนาอย่างรวดเร็ว
17. ข้อมูลเบื้องต้นเกี่ยวกับฟังก์ชันการสร้างโค้ดอัตโนมัติ—SnailAspNetCoreFramework การออกแบบส่วนหลังของเฟรมเวิร์กการพัฒนาอย่างรวดเร็ว
18. จะติดตามได้อย่างไรว่าแต่ละฟังก์ชั่นของโปรเจ็กต์เป็นปกติ (HealthCheck) - SnailAspNetCoreFramework การออกแบบแบ็คเอนด์เฟรมเวิร์กการพัฒนาอย่างรวดเร็ว
19. ข้อมูลเบื้องต้นเกี่ยวกับแฮงก์ไฟร์สำหรับงานตามกำหนดเวลา—การออกแบบแบ็กเอนด์เฟรมเวิร์กการพัฒนาอย่างรวดเร็วของ SnailAspNetCoreFramework
20. การแนะนำโดยรวมเกี่ยวกับฟรอนต์เอนด์—SnailAspNetCoreFramework การออกแบบฟรอนต์เอนด์ของเฟรมเวิร์กการพัฒนาอย่างรวดเร็ว
21. ไม่มีการร้องขออินเทอร์เฟซแบ็คเอนด์อีกต่อไป (ใช้ MOCK) - SnailAspNetCoreFramework การออกแบบส่วนหน้าของเฟรมเวิร์กการพัฒนาอย่างรวดเร็ว
22. การควบคุมการอนุญาตส่วนหน้า - SnailAspNetCoreFramework การออกแบบส่วนหน้าของเฟรมเวิร์กการพัฒนาอย่างรวดเร็ว
23. วิธีหลีกเลี่ยงการเขียนโค้ด CRUD ส่วนหน้าซ้ำๆ (การแนะนำและการใช้งานส่วนประกอบ SnailXXX ต่างๆ ในส่วนหน้า) - การออกแบบส่วนหน้าของเฟรมเวิร์กการพัฒนาอย่างรวดเร็วของ SnailAspNetCoreFramework
24. ข้อมูลเบื้องต้นเกี่ยวกับการขอพรอกซี - SnailAspNetCoreFramework การออกแบบส่วนหน้าของเฟรมเวิร์กการพัฒนาอย่างรวดเร็ว