SnailAspNetCoreFramework

Pengenalan proyek

• Proyek ini diposisikan sebagai kerangka pengembangan cepat untuk usaha kecil dan menengah berdasarkan inti asp.net, termasuk kode back-end dan front-end yang lengkap.
• Versi v2.0 sedang dalam pengembangan. Versi v1.0 dapat langsung dijalankan setelah berpindah di cabang.
• Tumpukan teknologi back-end: asp.net core 3.1, cap, swag, kode inti ef terlebih dahulu, autofac, automapper, nlog, aop
• Tumpukan teknologi front-end: vue-element-admin, komponen modul pengembangan cepat yang kasar, tiruan
• Fungsi yang diterapkan: kontrol izin berbasis peran, perjanjian hierarki proyek, pembuatan kode otomatis, logging, pemantauan kinerja, aop, dll.

Cara menjalankan proyek

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

Demonstrasi proyek

Berikut ini adalah diagram demonstrasi berdasarkan versi v1.0

• 1. Unduh dan jalankan proyek
• 2. Secara otomatis menghasilkan proyek berdasarkan file konfigurasi
• 3. Jalankan proyeknya

Pengenalan direktori proyek

--ApplicationCore // Lapisan abstraksi inti mengadopsi mode arsitektur yang jelas dan tidak bergantung pada lapisan lain semuanya bergantung pada jenis perpustakaan ini dan bertanggung jawab atas definisi publik seperti antarmuka, konstanta, enumerasi, dto, entitas, dll.
----Const // Definisi konstanta, seperti konstanta konfigurasi, konstanta nama event
----Dtos // semua dtos
----Entitas // Semua entitas
----Enum // enumerasi
----IServices //Definisi abstrak dari lapisan Layanan
----Utilitas // Kelas bantuan

--Infrastruktur //Lapisan infrastruktur menyediakan layanan data untuk lapisan atas (seperti lapisan layanan dan lapisan aplikasi).
----Data/config // Konfigurasi api lancar kerangka entitas basis data
----EFValueConverter // Konversi antara tipe database entitasframework dan tipe clr, seperti konversi enumerasi
----Migrasi //Buat direktori untuk migrasi kode kerangka entitas terlebih dahulu

--Service // Lapisan layanan, digunakan untuk mengimplementasikan antarmuka layanan di ApplicationCore, lapisan utama untuk implementasi logika aplikasi
----Cache // Implementasi cache, yang nantinya akan dihapus dan diekstraksi ke proyek Snail.
----Interceptor //Interceptor diimplementasikan secara default
----BaseService.cs //Kelas dasar setiap layanan berisi metode umum setiap layanan, seperti CRUD
---- InitDatabaseService.cs // Bertanggung jawab untuk inisialisasi data database
----InterceptorService.cs //Kelas dasar interceptor

--Web // Bertanggung jawab atas semua pemrosesan terkait input dan output parameter antarmuka (seperti verifikasi parameter, reservasi format output, dll.)
----AutoFacModule // konfigurasi injeksi autofac
----AutoMapperProfiles // konfigurasi automapper
----ClientApp // Proyek ujung depan
------build // Direktori keluaran dihasilkan oleh kompilasi front-end
------mock // Tiruan bagian depan
------src // Kode inti front-end
----CodeGenerater //Modul T4 dan logika terkait untuk pembuatan kode
----ConfigureServicesExtensions // Ekstensi injeksi ServiceProvider untuk menghindari penulisannya di file startup
----Pengontrol //Pengontrol
----dokumen // Kumpulan dokumen
----Dto // Kelas dto hanya akan digunakan di lapisan web
---- Filter // menyaring
----Hub // pemberi sinyal
----Izin //Penerapan izin default
----staticFile // Digunakan untuk menyimpan file yang diunggah

Desain struktur keseluruhan proyek

DDD digunakan, tetapi teknologi DDD yang berbeda harus diterapkan sesuai dengan ukuran proyek. Secara umum, ini dibagi menjadi beberapa proyek berikut

• Layanan: Lapisan layanan, digunakan untuk mengimplementasikan antarmuka layanan di ApplicationCore, lapisan utama untuk implementasi logika aplikasi
• Lapisan infrastruktur: Lapisan dasar. Lapisan ini digunakan kembali dalam proyek yang berbeda. Lapisan ini bergantung pada konvensi antarmuka lapisan ApplicationCore untuk menyediakan layanan data untuk lapisan atas (seperti lapisan layanan dan lapisan aplikasi). Pada saat yang sama, antarmuka akses data universal IDAL diterapkan.
• Lapisan ApplicationCore: lapisan logika aplikasi, mode DDD, berisi semua logika bisnis dan tidak bergantung pada lapisan lain
• Lapisan web: Bertanggung jawab atas semua pemrosesan terkait masukan dan keluaran parameter antarmuka (seperti verifikasi parameter, reservasi format keluaran, dll.), dan panggilan ke lapisan Aplikasi/DAL.

Izin dan verifikasi data universal

lapisan WEB

• Bertanggung jawab untuk pemrosesan parameter input dan output, intersepsi pengecualian, dan caching web
• Untuk operasi data tipe statistik kueri, lapisan DAL bisa langsung dipanggil.
• Konfigurasi lingkungan pengembangan dan pengujian dapat dipisahkan

Verifikasi parameter --diimplementasikan

• Menggunakan antarmuka Microsoft --diimplementasikan

Konvensi keluaran --diimplementasikan

• Kode Status HTTP mengikuti konvensi kode status, 20x berhasil (antarmuka berhasil dipanggil), 40x adalah kesalahan permintaan (pengecualian bisnis, tidak sah, dll.), 50x adalah kesalahan server (pengecualian server) -- diimplementasikan
• Konten hasil yang dikembalikan sebagian besar dalam format data aktual yang diperlukan oleh front end, yaitu objek json; jika itu adalah pesan kesalahan, konten kesalahan dikembalikan. --Tercapai

Penanganan pengecualian --diimplementasikan

• Penanganan pengecualian menggunakan teknologi Microsoft, lihat https://docs.microsoft.com/zh-cn/aspnet/core/fundamentals/error-handling?view=aspnetcore-2.2
• Semua pengecualian tidak akan ditangkap
• Pengecualian bisnis diminta ke luar. Pengecualian server disadap dan diminta ke luar. Format output prompt mengikuti konvensi output.

kesombongan -- dilaksanakan

• Gunakan NSwagger

Lapisan Inti Aplikasi

• Proyek ini tidak bergantung pada proyek lain, gunakan arsitektur yang bersih, lihat: https://docs.microsoft.com/zh-cn/dotnet/standard/modern-web-apps-azure-architecture/common-web- aplikasi- arsitektur

cache

• Antarmuka ICache mengimplementasikan redis, memcached, memoryCache, dll. Anda dapat mempertimbangkan untuk menggunakan easycaching.
• Gunakan AOP untuk caching untuk menghindari penulisan logika caching di setiap metode. easycaching+autofac
• Pembaruan cache didorong oleh peristiwa dan komponen pihak ketiga diperkenalkan. easycaching+batas

Didorong oleh domain

Didorong oleh domain, jika bergantung pada lapisan lain, itu bergantung pada antarmuka lapisan yang bersangkutan, bukan pada implementasinya.

AOP -- diimplementasikan

• Untuk memasukkan AOP ke log dan cache, pertimbangkan untuk menggunakan autofac

IOC -- dilaksanakan

• Gunakan faks otomatis

Tabel memori --diimplementasikan

• Simpan tabel yang jarang berubah dan memiliki jumlah data yang relatif kecil di memori (bukan cache, tapi objek), dan gunakan pemikiran berbasis peristiwa untuk menyinkronkan data terbaru.

peristiwa

• mempublikasikan dan berlangganan
• Gunakan cap untuk beralih antara aplikasi terdistribusi dan aplikasi tunggal

Pemrosesan log --diimplementasikan

• Gunakan nlog

bus perintah --diimplementasikan

• Gunakan Mediatr

lapisan DAL

• Bertanggung jawab atas semua operasi terkait data
• Rangkum antarmuka dan implementasi akses data umum, seperti menggunakan EF untuk mengimplementasikan fungsi berikut
• Gunakan ide pemrograman berorientasi antarmuka untuk memperluas lapisan DAL menggunakan teknologi selain EF di masa depan.
• Menggunakan mode Repositori, sebenarnya EF sendiri adalah mode Repositori, tetapi untuk menyatukan intersepsi dan penerapan logikanya sendiri pada tingkat operasi akses database, ia kemudian menggunakan Repositorinya sendiri untuk merangkum EF
• Kueri tabel tunggal, paging
• Kueri relasional sederhana dari beberapa tabel, paging
• KRUD sederhana

pembuat peta otomatis

• Referensi automapper untuk penetapan dan konversi objek
• Menerapkan kelas objectmapper berbasis ekspresi untuk penetapan objek sederhana, menutupi kekurangan konfigurasi automapper yang kompleks dan kinerja rendah menggunakan refleksi.

Penggunaan EF

• Log bahasa sql eksekusi EF**--diimplementasikan**
• Untuk tipe enumerasi, gunakan teknologi ValueConverter EF untuk mengonversi secara otomatis, dan disepakati bahwa tipe yang disimpan dalam database adalah tipe string, bukan tipe Int, yang memudahkan pemahaman**--Diimplementasikan**

perpesanan waktu nyata

• Gunakan pemberi sinyal

Pemilihan teknologi

pemrosesan transaksi

Gunakan mode repositori dan unit kerja, tetapi gunakan mode repositori yang disertakan dengan EF.

Metode pemrosesan basis data

• Gunakan EF untuk pemrosesan data dan jangan pertimbangkan metode lain.

Antarmuka ujung depan

• Masukkan ke dalam proyek web dan gunakan metode spa

perlu dilakukan

• Injeksi uji unit
• Lapisan layanan tidak boleh berada di lapisan web, tetapi inti aplikasi

multibahasa

Berbagai detail teknis

TOPI

• Implementasi asli CAP tidak mendukung autofac dengan baik. Dalam proyek ini, SnailCapConsumerServiceSelector ditulis untuk menanganinya.
• CAP secara alami memperlakukan Pengontrol dan non-Pengontrol secara berbeda. Pengontrol hanya perlu menambahkan atribut CapSubscribe ke metode, sedangkan Pengontrol perlu mengimplementasikan antarmuka ICapSubscribe di kelas dan menambahkan atribut CapSubscribe ke metode.

Cara menggunakan

1. git clone proyek ini 2. Konfigurasikan codeGenerate.json 3. Jalankan proyek ini, dan setelah masuk dengan swagger, jalankan antarmuka codeGenerate 4. Jalankan add-migration 5. Mulai proyek

Postingan blog tutorial

Blog Seri Kerangka Kerja SnailAspNetCoreFramework
1. Pengenalan dan ide desain umum dari setiap proyek dan direktori dalam kerangka kerja - kerangka pengembangan cepat SnailAspNetCoreFramework
2. Verifikasi masukan antarmuka, format keluaran, dan penanganan pengecualian—desain back-end kerangka pengembangan cepat SnailAspNetCoreFramework
3. Desain izin universal - desain back-end kerangka pengembangan cepat SnailAspNetCoreFramework
4. Bagaimana menyediakan dokumen antarmuka yang baik (Swagger) ke front-end - desain back-end kerangka pengembangan cepat SnailAspNetCoreFramework
5. Penggunaan cache dalam berbagai skenario—desain backend framework pengembangan cepat SnailAspNetCoreFramework
6. Desain AOP berbasis kastil dan cache umum, kinerja, implementasi pencegat log - desain back-end kerangka pengembangan cepat SnailAspNetCoreFramework
7. Pengantar injeksi ketergantungan - autofac - desain back-end kerangka pengembangan cepat SnailAspNetCoreFramework
8. Mengapa menggunakan Eventbus dan bagaimana menggunakannya - desain back-end kerangka pengembangan cepat SnailAspNetCoreFramework
9. Pengenalan Nlog, komponen log - desain back-end kerangka pengembangan cepat SnailAspNetCoreFramework
10. Pengenalan mediar - desain back-end kerangka pengembangan cepat SnailAspNetCoreFramework
11. Desain CRUD universal untuk lapisan pengontrol, layanan, dan dal—desain backend kerangka kerja pengembangan cepat SnailAspNetCoreFramework
12. Alat pemetaan objek automapper - desain back-end kerangka pengembangan cepat SnailAspNetCoreFramework
13. Cara memantau pernyataan sql yang dihasilkan oleh EF - desain back-end kerangka pengembangan cepat SnailAspNetCoreFramework
14. Pengenalan beberapa metode penerapan .net core - desain back-end kerangka pengembangan cepat SnailAspNetCoreFramework
15. pemberi sinyal komunikasi real-time - desain back-end kerangka pengembangan cepat SnailAspNetCoreFramework
16. Cara menggunakan kode ef terlebih dahulu untuk terus mengulangi versi database proyek - desain back-end kerangka pengembangan cepat SnailAspNetCoreFramework
17. Pengenalan fungsi pembuatan kode otomatis—desain back-end kerangka pengembangan cepat SnailAspNetCoreFramework
18. Cara memantau apakah setiap fungsi proyek normal (HealthCheck) - Desain back-end kerangka pengembangan cepat SnailAspNetCoreFramework
19. Pengenalan hangfire untuk tugas terjadwal—Desain backend kerangka kerja pengembangan cepat SnailAspNetCoreFramework
20. Pengenalan menyeluruh terhadap front-end—desain front-end kerangka pengembangan cepat SnailAspNetCoreFramework
21. Tidak perlu lagi meminta antarmuka back-end (penggunaan MOCK) - SnailAspNetCoreFramework desain front-end kerangka pengembangan cepat
22. Kontrol izin front-end - desain front-end kerangka pengembangan cepat SnailAspNetCoreFramework
23. Bagaimana menghindari penulisan berulang kali kode CRUD front-end (pengenalan dan penggunaan berbagai komponen SnailXXX di front-end) - SnailAspNetCoreFramework desain front-end kerangka pengembangan cepat
24. Pengantar proxy permintaan - desain front-end kerangka pengembangan cepat SnailAspNetCoreFramework