v5.0.0-pre1

New features and enhancements

First of all, this release is a refresher to embrace the latest technologies. We've updated to ASP.NET 6 with EF Core 6 and adopted nullable reference types. We've switched to System.Text.Json. And we're now leveraging EF Core's built-in many-to-many relationships. Lastly, ASP.NET controllers can be auto-generated using source generators. Aside from these changes, pagination links at secondary endpoints got better. We've added various performance optimizations. And improved error responses on invalid input. And quite some bug fixes too!

Note: See our updated documentation, as well as updated examples in our codebase.
Upgrading from v4 instead? Be sure to check out our migration guide.

Breaking changes

• When using [Resource], this now automatically generates a controller class. Replace with [Resource(GenerateControllerEndpoints = JsonApiEndpoints.None)] to turn that off.
• The experimental Resource Hooks feature has finally been removed.
• The switch to System.Text.Json introduced breaks as well, see here and here.
• Short-hand interfaces were removed too.
• Remaining breaks are listed here, here and here.

Merged PRs

• Removed Resource Hooks by @bart-degreed in #1036
• Updated dependencies to .NET 5 with EF Core 5 by @bart-degreed in #1022
• Updated roadmap for v5.x by @bart-degreed in #1034
• Native many to many by @bart-degreed in #1037
• Refactorings by @bart-degreed in #1038
• Instrumented code to measure execution time of the various layers by @bart-degreed in #1023
• Optimized RemoveFromToManyRelationship endpoint by @bart-degreed in #1039
• Feature/allow leading space by @sgryphon in #1041
• Rename JsonApiDotNetCoreExampleTests -> JsonApiDotNetCoreTests by @maurei in #1069
• Removing dependency on JsonApiDotNetCoreExample project in test projects by @maurei in #1068
• Updated PostgreSQL to v13.4 by @bart-degreed in #1072
• Removed temporary workaround to start postgres service in cibuild by @bart-degreed in #1083
• Restored docs for HasManyThrough, which was removed in #1037 by @bart-degreed in #1084
• Use System.Text.Json by @bart-degreed in #1075
• Corrected example in docs by @bart-degreed in #1087
• Redesign conversion between JSON objects and ASP.NET models by @bart-degreed in #1091
• Remove short-hand interfaces for TId is int by @bart-degreed in #1093
• Nullable reference types by @bart-degreed in #1095
• Secondary paging by @bart-degreed in #1100
• Resource Graph validations by @bart-degreed in #1101
• Fix code cleanup by @bart-degreed in #1107
• Various fixes and improvements by @bart-degreed in #1114
• Auto-generated JSON:API controllers using source generators by @bart-degreed in #1117
• Update to .NET 6 with EF Core 6 by @bart-degreed in #1122
• Added tests for blobs by @bart-degreed in #1125
• Move resource annotations into separate package by @bart-degreed in #1127

New Contributors

• @sgryphon made their first contribution in #1041

Full Changelog: v4.2.0...v5.0.0-pre1