JSON 빌드 프레임 워크 : .NET 코어 및 엔티티 프레임 워크 코어를 사용하여 API 준수 REST API. 원자 운영에 대한 지원이 포함됩니다.

이 라이브러리의 궁극적 인 목표는 정렬, 필터링 및 페이지 매김과 같은 상자 외 기능을 제공하여 가능한 한 많은 보일러 플레이트를 제거하는 것입니다. 리소스를 정의하고 맞춤형 비즈니스 로직을 구현하는 데 집중하면됩니다. 이 라이브러리는 의존성 주입을 중심으로 설계되었으므로 확장 성이 매우 쉽습니다.
이 프로젝트 가이 프로젝트가 무엇인지 이해하고 사용할 수있는 방법을 이해하는 데 도움이되는 몇 가지 단계입니다.
최신 샘플 응용 프로그램은 예제 디렉토리를 참조하십시오. JSONAPIDOTNETCORE API 및 EMBERJS 클라이언트가 포함 된 TODO 목록 앱도 있습니다.
자세한 사용에 대해서는 문서를 참조하십시오.
#nullable enable
[ Resource ]
public class Article : Identifiable < int >
{
[ Attr ]
public string Name { get ; set ; } = null ! ;
} // Program.cs
builder . Services . AddJsonApi < AppDbContext > ( ) ;
// ...
app . UseRouting ( ) ;
app . UseJsonApi ( ) ;
app . MapControllers ( ) ; 다음 차트는 환경에 따라 최고의 버전을 선택하는 데 도움이됩니다. 버전 관리 정책도 참조하십시오.
| JSONAPIDOTNETCORE | 상태 | .그물 | 엔티티 프레임 워크 핵심 |
|---|---|---|---|
| 3.x | 안정적인 | 핵심 2.X | 2.X |
| 4.X | 안정적인 | 핵심 3.1 | 3.1, 5 |
| 5 | 5 | ||
| 6 | 5 | ||
| 5.0.0-5.0.2 | 안정적인 | 6 | 6 |
| 5.0.3-5.4.0 | 안정적인 | 6 | 6, 7 |
| 7 | 7 | ||
| 5.5+ | 안정적인 | 6 | 6, 7 |
| 7 | 7 | ||
| 8 | 8, 9 | ||
| 9 | 9 | ||
| 주인 | 시사 | 8 | 8, 9 |
| 9 | 9 | ||
| Openapi | 실험 | 8 | 8, 9 |
| 9 | 9 |
질문이 있거나 버그를 찾거나 코드 변경 사항을 제출하고 싶습니까? 기고 가이드 라인을 참조하십시오.
마스터 브랜치에 각각 커밋 한 후 새로운 프리 릴리스 Nuget 패키지가 GitHub 패키지에 자동으로 게시됩니다. 시도해 보려면 아래 단계를 따르십시오.
최소한 read:packages 스코프로 개인 액세스 토큰 (클래식)을 만듭니다.
실행하여 로컬 사용자 별 nuget.config 파일에 패키지 소스를 추가하십시오.
dotnet nuget add source https://nuget.pkg.github.com/json-api-dotnet/index.json --name github-json-api --username YOUR-GITHUB-USERNAME --password YOUR-PAT-CLASSIC위의 명령에서 :
dotnet nuget remove source github-json-api --store-password-in-clear-text 스위치로 재 시도했습니다.
IDE를 다시 시작하고 프로젝트를 열고 GitHub-JSON-API 피드에서 패키지 목록을 찾아보십시오 (사전 릴리스 패키지가 포함되어 있는지 확인하십시오).
이 저장소에서 로컬로 코드를 작성하려면 다음을 실행하십시오.
dotnet build로컬로 테스트를 실행하려면 PostgreSQL 데이터베이스에 대한 액세스가 필요합니다. Docker를 설치 한 경우 다음을 통해 다음을 수행 할 수 있습니다.
pwsh run-docker-postgres.ps1그런 다음 테스트를 실행합니다.
dotnet test또는 모든 테스트를 구축하고 실행하고 코드 커버리지 및 NUGET 패키지를 생성합니다.
pwsh Build.ps1