ProWebAPI

Dokumen ini merinci implementasi ASP.NET Core API yang kuat dan terstandarisasi menggunakan ProWebAPI. Ini mencakup aspek-aspek utama seperti integrasi Swagger, injeksi ketergantungan, respons terstandarisasi, pembuatan versi, validasi permintaan, dukungan OData v4, penanganan pengecualian global, dan EF Core dengan UnitOfWork. Panduan ini memberikan petunjuk langkah demi langkah untuk setiap komponen.

ProWebAPI

ASP.NET Core API dengan semua standar yang tepat

Standar Diimplementasikan

Menyombongkan

Instal Kesombongan

Pengaturan DI

Respon Standar untuk API

Respon standar

Pembuatan versi

Instal perpustakaan Nuget

Tambahkan ke wadah ketergantungan

Hiasi pengontrol berdasarkan kebutuhan

Permintaan Validator

Instal perpustakaan Nuget

Daftarkan validator di DI

Pada Namespace 'RequestDto', Tambahkan validator bersama dengan dto

Bangun Filter Validasi

Daftarkan filter dan matikan [ApiController] intersep 400 Permintaan Buruk otomatis

Pengaturan Aplikasi.json

Konfigurasikan pengaturan aplikasi untuk database

Buat 2 konfigurasi LINGKUNGAN

OData v4

Untuk mendukung OData Instal NuGetpackages

Tambahkan ke layanan DI untuk OData

Konfigurasikan OData

Ganti atribut [EnableQuery] dengan [EnableOData] untuk menangkap kesalahan dan mengembalikan respons standar

Hiasi Metode Aksi

Kueri berdasarkan URL

Penangan Pengecualian Global

Buat Middlewarenya

Buat metode ekstensi untuk pembuat aplikasi

Daftarkan middlewarenya

Casing Respon

Izinkan casing anggota (yang akan menggunakan huruf pascal untuk props) sehingga hasil kueri OData tidak bertentangan dengan casing

EF Core + Unit Kerja

Tambahkan perpustakaan kelas pendukung

Instal paket yang diperlukan di ProWeb.Data

Untuk menjalankan migrasi

SET ProWeb.Data sebagai [Proyek Startup] dan jalankan migrasi