ProWebAPI

이 문서에서는 ProWebAPI를 사용하여 강력하고 표준화된 ASP.NET Core API의 구현을 자세히 설명합니다. Swagger 통합, 종속성 주입, 표준화된 응답, 버전 관리, 요청 유효성 검사, OData v4 지원, 전역 예외 처리 및 UnitOfWork가 포함된 EF Core와 같은 주요 측면을 다룹니다. 이 가이드에서는 각 구성 요소에 대한 단계별 지침을 제공합니다.

ProWebAPI

모든 적절한 표준을 갖춘 ASP.NET Core API

구현된 표준

멋진

스웨거 설치

DI 설정

API에 대한 표준 응답

표준 응답

버전 관리

Nuget 라이브러리 설치

종속성 컨테이너에 추가

필요에 따라 컨트롤러 기반을 장식하십시오.

요청 유효성 검사기

Nuget 라이브러리 설치

DI에 검증인 등록

'RequestDto' 네임스페이스에 dto와 함께 유효성 검사기를 추가합니다.

ValidationFilter 구축

필터를 등록하고 [ApiController] 자동 400 잘못된 요청 차단을 끄세요.

앱설정.json

데이터베이스에 대한 앱 설정 구성

2개의 ENVIRONMENT 구성 생성

OData v4

OData를 지원하려면 NuGetpackages를 설치하십시오.

OData용 서비스 DI에 추가

OData 구성

[EnableOData]로 [EnableQuery] 특성을 재정의하여 오류를 포착하고 표준 응답을 반환합니다.

액션 메소드 꾸미기

URL로 쿼리

전역 예외 처리기

미들웨어 생성

앱 빌더를 위한 확장 메소드 생성

미들웨어 등록

응답 케이싱

OData 쿼리 결과가 대소문자와 충돌하지 않도록 멤버 대소문자 구분(props의 경우 파스칼 대소문자 사용)을 허용합니다.

EF 코어 + UnitOfWork

지원 클래스 라이브러리 추가

ProWeb.Data에 필수 패키지를 설치합니다.

마이그레이션을 실행하려면

ProWeb.Data를 [시작 프로젝트]로 설정하고 마이그레이션을 실행합니다.