ASP.Net Core的 JSONAPI 框架
库的最终目标是通过提供诸如排序,过滤和分页等开箱即用的功能来尽可能消除样板。 您只需要专注于定义资源和实现自定义业务逻辑。 这个库是围绕依赖注入设计的,使得可扩展性非常容易。
.NET 其它杂项
共419Star
详细介绍
JSON API .Net Core
A framework for building json:api compliant web APIs. The ultimate goal of this library is to eliminate as much boilerplate as possible by offering out-of-the-box features such as sorting, filtering and pagination. You just need to focus on defining the resources and implementing your custom business logic. This library has been designed around dependency injection making extensibility incredibly easy.
Getting Started
These are some steps you can take to help you understand what this project is and how you can use it:
- What is json:api and why should I use it?
- The json:api specification
- Demo [Video]
- Our documentation
- Check out the example projects
- Embercasts: Full Stack Ember with ASP .NET Core
Related Projects
Examples
See the examples directory for up-to-date sample applications. There is also a Todo List App that includes a JADNC API and an EmberJs client.
Installation And Usage
See our documentation for detailed usage.
Models
public class Article : Identifiable
{
[Attr("name")]
public string Name { get; set; }
}
Controllers
public class ArticlesController : JsonApiController<Article>
{
public ArticlesController(
IJsonApiOptions jsonApiOptions,
IResourceService<Article> resourceService,
ILoggerFactory loggerFactory)
: base(jsonApiOptions, resourceService, loggerFactory)
{ }
}
Middleware
public class Startup
{
public IServiceProvider ConfigureServices(IServiceCollection services) {
services.AddJsonApi<AppDbContext>();
// ...
}
public void Configure(IApplicationBuilder app) {
app.UseJsonApi()
// ...
}
}
Development
Restore all NuGet packages with:
dotnet restore
Testing
Running tests locally requires access to a PostgreSQL database. If you have docker installed, this can be propped up via:
docker run --rm --name jsonapi-dotnet-core-testing -e POSTGRES_DB=JsonApiDotNetCoreExample -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=postgres -p 5432:5432 postgres:12.0
And then to run the tests:
dotnet test
Cleaning
Sometimes the compiled files can be dirty / corrupt from other branches / failed builds.
dotnet clean
Compiler warnings
The Release
build configuration is set to fail on warnings. That means when submitting a PR there shouldn't be any compiler warnings because the CI build it set to Release
.
Compatibility
A lot of changes were introduced in v4.0.0, the following chart should help you with compatibility issues between .NET Core versions
.NET Core Version | JADNC Version |
---|---|
2.* | v3.* |
3.* | v4.* |
-
0 Star
-
43 Star
-
19230 Star
-
7845 Star
-
24 Star
-
35 Star
-
106 Star
-
467 Star