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، ومكونات وحدة التطوير السريع الأولية، وmock
• الوظائف المنفذة: التحكم في الأذونات المستندة إلى الأدوار، والاتفاقية الهرمية للمشروع، وإنشاء التعليمات البرمجية تلقائيًا، والتسجيل، ومراقبة الأداء، و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 // تتبنى طبقة التجريد الأساسية وضعًا معماريًا واضحًا ولا تعتمد على طبقات أخرى. تعتمد المشاريع الثلاثة الأخرى جميعها على هذا النوع من المكتبات وتكون مسؤولة عن التعريفات العامة للواجهات والثوابت والتعدادات وdtos والكيانات وما إلى ذلك. .
----Const // تعريف ثابت، مثل ثوابت التكوين وثوابت اسم الحدث
----Dtos // جميع dtos
----الكيانات // جميع الكيانات
----التعدادات // التعداد
----IServices // تعريف مجرد لطبقة الخدمة
---- المرافق // فئة المساعدة

--البنية التحتية // توفر طبقة البنية التحتية خدمات البيانات للطبقات العليا (مثل طبقة الخدمة وطبقة التطبيق).
----Data/config // تكوين واجهة برمجة تطبيقات كيان قاعدة البيانات بطلاقة
----EFValueConverter // التحويل بين نوع قاعدة بيانات الكيان ونوع clr، مثل تحويل التعداد
----الترحيل // أنشئ دليلًا لترحيل كود إطار عمل الكيان أولاً

--Service // طبقة الخدمة، المستخدمة لتنفيذ واجهة الخدمة في ApplicationCore، الطبقة الرئيسية لتنفيذ منطق التطبيق
----Cache // تنفيذ ذاكرة التخزين المؤقت، والتي ستتم إزالتها واستخراجها إلى مشروع Snail لاحقًا.
----Interceptor // يتم تنفيذ Interceptor افتراضيًا
----BaseService.cs // تحتوي الفئة الأساسية لكل خدمة على الطرق الشائعة لكل خدمة، مثل CRUD
----InitDatabaseService.cs // المسؤول عن تهيئة بيانات قاعدة البيانات
----InterceptorService.cs // الفئة الأساسية للمعترض

--الويب // مسؤول عن جميع عمليات المعالجة ذات الصلة لمدخلات ومخرجات معلمات الواجهة (مثل التحقق من المعلمات وحجز تنسيق الإخراج وما إلى ذلك)
----AutoFacModule // تكوين حقن autofac
----AutoMapperProfiles // تكوين automapper
----ClientApp // مشروع الواجهة الأمامية
------build // دليل الإخراج الذي تم إنشاؤه بواسطة تجميع الواجهة الأمامية
------ وهمية // وهمية للواجهة الأمامية
------src // الكود الأساسي للواجهة الأمامية
----CodeGenerater //وحدة T4 والمنطق ذي الصلة لإنشاء التعليمات البرمجية
----ConfigureServicesExtensions // ملحقات حقن ServiceProvider لتجنب كتابتها في ملف بدء التشغيل
---- وحدات التحكم // وحدات التحكم
----المستندات // مجموعة المستندات
----Dto // سيتم استخدام فئة dto فقط في طبقة الويب
---- مرشح // مرشح
----محاور // إشارة
----إذن // التنفيذ الافتراضي للأذونات
----staticFile // يستخدم لتخزين الملفات التي تم تحميلها

التصميم الهيكلي العام للمشروع

يتم استخدام DDD، ولكن يجب تطبيق تقنيات DDD المختلفة وفقًا لحجم المشروع. بشكل عام، يتم تقسيمها إلى المشاريع التالية

• الخدمة: طبقة الخدمة، المستخدمة لتنفيذ واجهة الخدمة في ApplicationCore، الطبقة الرئيسية لتنفيذ منطق التطبيق
• طبقة البنية التحتية: يتم إعادة استخدام هذه الطبقة في مشاريع مختلفة، وهي تعتمد على اتفاقية الواجهة الخاصة بطبقة ApplicationCore لتوفير خدمات البيانات للطبقات العليا (مثل طبقة الخدمة وطبقة التطبيق). وفي الوقت نفسه، تم تنفيذ واجهة الوصول العالمية للبيانات الخاصة بـ IDAL.
• طبقة ApplicationCore: طبقة منطق التطبيق، وضع DDD، تحتوي على كل منطق الأعمال ولا تعتمد على طبقات أخرى
• طبقة الويب: مسؤولة عن جميع عمليات المعالجة ذات الصلة للإدخال والإخراج لمعلمات الواجهة (مثل التحقق من المعلمة، وحجز تنسيق الإخراج، وما إلى ذلك)، والمكالمات إلى طبقة التطبيق/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 وذاكرة التخزين المؤقت وما إلى ذلك. يمكنك التفكير في استخدام التخزين المؤقت السهل.
• استخدم AOP للتخزين المؤقت لتجنب كتابة منطق التخزين المؤقت في كل طريقة. easycaching+autofac
• تعتمد تحديثات ذاكرة التخزين المؤقت على الأحداث ويتم تقديم مكونات الطرف الثالث. التخزين المؤقت السهل+cap

المجال مدفوعة

يعتمد المجال، إذا كان يعتمد على طبقات أخرى، فإنه يعتمد على واجهة الطبقة المقابلة بدلاً من التنفيذ.

AOP - تم التنفيذ

• لإدخال AOP في السجلات وذاكرة التخزين المؤقت، فكر في استخدام autofac

اللجنة الأولمبية الدولية - تم التنفيذ

• استخدم الضبط التلقائي

جدول الذاكرة - تم التنفيذ

• قم بتخزين الجداول التي تتغير بشكل غير متكرر وتحتوي على كميات صغيرة نسبيًا من البيانات في الذاكرة (وليس ذاكرات التخزين المؤقت، ولكن الكائنات)، واستخدم التفكير المبني على الأحداث لمزامنة أحدث البيانات.

حدث

• النشر والاشتراك
• استخدم الغطاء للتبديل بين التطبيقات الموزعة والفردية

معالجة السجل - تم التنفيذ

• استخدم نلوج

حافلة الأوامر - تم تنفيذها

• استخدم ميدياتر

طبقة دال

• - مسؤول عن جميع العمليات المتعلقة بالبيانات
• قم بتغليف واجهات وتطبيقات الوصول إلى البيانات الشائعة، مثل استخدام EF لتنفيذ الوظائف التالية
• استخدم فكرة البرمجة الموجهة للواجهة لتوسيع طبقة DAL باستخدام تقنيات أخرى غير EF في المستقبل.
• باستخدام وضع المستودع، في الواقع، EF نفسه هو وضع مستودع، ولكن من أجل اعتراض وتطبيق المنطق الخاص به بشكل موحد على مستوى عمليات الوصول إلى قاعدة البيانات، فإنه يستخدم بعد ذلك المستودع الخاص به لتغليف EF
• استعلام جدول واحد، الترحيل
• استعلام علائقي بسيط لجداول متعددة وترحيل الصفحات
• خام بسيط

com.automapper

• مرجع تلقائي لتعيين الكائن وتحويله
• قم بتطبيق فئة objectmapper المستندة إلى التعبير لتعيين كائن بسيط، والتعويض عن أوجه القصور في التكوين المعقد لـ automapper والأداء المنخفض باستخدام الانعكاس.

استخدام إي أف

• سجل لغة SQL لتنفيذ EF**--تم التنفيذ**
• بالنسبة لأنواع التعداد، استخدم تقنية ValueConverter الخاصة بـ EF لتحويلها تلقائيًا. ومن المتفق عليه أن النوع المخزن في قاعدة البيانات هو نوع سلسلة بدلاً من نوع Int، وهو أمر مناسب للفهم**--تم التنفيذ**.

التواصل في الوقت الحقيقي

• استخدم الإشارة

اختيار التكنولوجيا

معالجة المعاملات

استخدم وضعي المستودع ووحدة العمل، ولكن استخدم وضع المستودع الذي يأتي مع EF.

طريقة معالجة قاعدة البيانات

• استخدم EF لمعالجة البيانات ولا تفكر في طرق أخرى.

الواجهة الأمامية

• ضعه في مشروع الويب واستخدم طريقة السبا

بحاجة للقيام به

• حقن اختبار الوحدة
• لا ينبغي أن تكون طبقة الخدمة في طبقة الويب، بل في طبقة التطبيق الأساسية

متعدد اللغات

تفاصيل فنية مختلفة

كاب

• لا يدعم التنفيذ الأصلي لـ 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 القائم على القلعة وذاكرة التخزين المؤقت المشتركة والأداء وتنفيذ اعتراض السجل - تصميم الواجهة الخلفية لإطار التطوير السريع لـ SnailAspNetCoreFramework
7. مقدمة إلى حقن التبعية - autofac - تصميم الواجهة الخلفية لإطار التطوير السريع SnailAspNetCoreFramework
8. لماذا نستخدم Eventbus وكيفية استخدامه - التصميم الخلفي لإطار التطوير السريع SnailAspNetCoreFramework
9. مقدمة إلى Nlog، مكون السجل - تصميم الواجهة الخلفية لإطار التطوير السريع SnailAspNetCoreFramework
10.مقدمة Mediatr - تصميم الواجهة الخلفية لإطار التطوير السريع SnailAspNetCoreFramework
11. تصميم CRUD العالمي لطبقات وحدة التحكم والخدمة وdal — تصميم الواجهة الخلفية لإطار التطوير السريع SnailAspNetCoreFramework
12. أداة رسم خرائط الكائنات automapper - SnailAspNetCoreFramework إطار التطوير السريع للتصميم الخلفي
13. كيفية مراقبة بيانات SQL التي تم إنشاؤها بواسطة EF - التصميم الخلفي لإطار التطوير السريع لإطار عمل SnailAspNetCoreFramework
14. مقدمة إلى العديد من طرق النشر لـ .net core - التصميم الخلفي لإطار التطوير السريع SnailAspNetCoreFramework
15. إشارة الاتصال في الوقت الحقيقي - تصميم الواجهة الخلفية لإطار التطوير السريع SnailAspNetCoreFramework
16. كيفية استخدام كود ef أولاً للتكرار المستمر لإصدار قاعدة بيانات المشروع - تصميم الواجهة الخلفية لإطار التطوير السريع SnailAspNetCoreFramework
17. مقدمة إلى وظيفة إنشاء التعليمات البرمجية التلقائية — تصميم الواجهة الخلفية لإطار التطوير السريع SnailAspNetCoreFramework
18. كيفية مراقبة ما إذا كانت كل وظيفة في المشروع طبيعية (HealthCheck) - التصميم الخلفي لإطار التطوير السريع لإطار عمل SnailAspNetCoreFramework
19. مقدمة إلى Hangfire للمهام المجدولة — تصميم الواجهة الخلفية لإطار التطوير السريع SnailAspNetCoreFramework
20. مقدمة شاملة للواجهة الأمامية - تصميم الواجهة الأمامية لإطار التطوير السريع لـ SnailAspNetCoreFramework
21. لا مزيد من التسول للواجهات الخلفية (استخدام MOCK) - تصميم الواجهة الأمامية لإطار التطوير السريع لـ SnailAspNetCoreFramework
22. التحكم في أذونات الواجهة الأمامية - تصميم الواجهة الأمامية لإطار التطوير السريع SnailAspNetCoreFramework
23. كيفية تجنب كتابة كود CRUD للواجهة الأمامية بشكل متكرر (مقدمة واستخدام مكونات SnailXXX المختلفة في الواجهة الأمامية) - تصميم الواجهة الأمامية لإطار التطوير السريع لـ SnailAspNetCoreFramework
24. مقدمة لطلب الوكيل - تصميم الواجهة الأمامية لإطار التطوير السريع SnailAspNetCoreFramework