Write enhancements (continued) (#875)

* Enhancements in create/update/delete

Continuation of #851.

* Various cleanups based on diff with master.

* refactor: reduced ResourceService dependencies

* refactor: move logic from GetResourcesByIds to composer

* Refactor: remove IGetResourcesByIds

* Replace repo.GetPrimaryResourceForCompleteReplacement with overridable coordination from service.

* Removed IDataStoreUpdateFailureInspector dependency from repository

* Simplified code

* More refactorings

* Added services.AddResourceRepository()

* removed TODO

* Reorder methods in calling order, renames, expose FlushFromCache/SaveChangesAsync

* Removed ThroughEntitiesFilter

* Renames

* Extract responsibilities

* Added tracking TODOs

* formatting

* TODO

* Added tests for obfuscated IDs

* Added marker to our TODOs

* Added documentation

* Tests for cyclic relationships

* Folder rename

* Migrated left-over tests

* Change casing of .sln (1/2)

* Change casing of .sln (2/2)

* chore: restore toplevel related links in relationship endpoint

* Merged IntegrationTests project

* Added tests for 0 or empty string as primary key value

* Removed TODO

* tests: pagination on relationship endpoint

* Fixes and more tests for handling zero/empty primary key

* added check for related link

* Fixes for proper error on relationship kind mismatch (HasOne vs HasMany)

* Removed empty folder

* tests: added required relationship tests, changed existing tests to display better assertion failures if they would have covered required relationships

* Improved purging of change tracker

* Replaced dependency on IResourceRepository with IResourceRepositoryAccessor

* Move logic around to reduce dependencies in SecondaryResourceResolver.

* Inlined ISecondaryResourceResolver into JsonApiResourceService

* Refactorings to remove joinTableFilter parameter from ResourceRepository.AddToToManyRelationshipAsync()

* Do not fetch resource for hooks on delete (because we didn't do that for GetSecondary either).

* tests: required relationships

* feat: throw CannotClearRequiredRelationshipException

* chore: self review

* refactor: EF Core null assignment change tracker trick no longer required

* refactorings

* refactorings

* Added ID to error message

* chore: review todos

* Remove unused usings

* fix: minor refactor repository

* review

* removed query for jointable

* fix name

* Use generic type parameter in IResourceRepositoryAccessor

* Expose EntityFrameworkCoreRepository methods as protected to enable copy/paste Update method in derived classes

* Readme updates

* Small tweaks based on diff with master

* Fixed casing

Co-authored-by: maurei <maurits.moeys@gmail.com>

Author: Bart Koelman

JsonApiDotnetCore.sln renamed to JsonApiDotNetCore.sln

@@ -2,7 +2,7 @@
 <img src ="https://raw.githubusercontent.com/json-api-dotnet/JsonApiDotnetCore/master/logo.png" />
 </p>
 
-# JSON API .Net Core
+# JSON:API .NET Core
 
 [![Build status](https://ci.appveyor.com/api/projects/status/5go47hrm0iik0ls3/branch/master?svg=true)](https://ci.appveyor.com/project/jaredcnance/jsonapidotnetcore/branch/master)
 [![Travis](https://travis-ci.org/json-api-dotnet/JsonApiDotNetCore.svg?branch=master)](https://travis-ci.org/json-api-dotnet/JsonApiDotNetCore)
@@ -21,7 +21,7 @@ These are some steps you can take to help you understand what this project is an
 - [Demo [Video]](https://youtu.be/KAMuo6K7VcE)
 - [Our documentation](https://json-api-dotnet.github.io/JsonApiDotNetCore/)
 - [Check out the example projects](https://github.com/json-api-dotnet/JsonApiDotNetCore/tree/master/src/Examples)
-- [Embercasts: Full Stack Ember with ASP .NET Core](https://www.embercasts.com/course/full-stack-ember-with-dotnet/watch/whats-in-this-course-cs)
+- [Embercasts: Full Stack Ember with ASP.NET Core](https://www.embercasts.com/course/full-stack-ember-with-dotnet/watch/whats-in-this-course-cs)
 
 ## Related Projects
 
@@ -43,7 +43,7 @@ See [our documentation](https://json-api-dotnet.github.io/JsonApiDotNetCore/) fo
 ```csharp
 public class Article : Identifiable
 {
-    [Attr("name")]
+    [Attr]
     public string Name { get; set; }
 }
 ```
@@ -53,12 +53,11 @@ public class Article : Identifiable
 ```csharp
 public class ArticlesController : JsonApiController<Article>
 {
-        public ArticlesController(
-            IJsonApiOptions options,
-            IResourceService<Article> resourceService,
-            ILoggerFactory loggerFactory)
-            : base(options, resourceService, loggerFactory)
-        { }
+    public ArticlesController(IJsonApiOptions options, IResourceService<Article> resourceService,
+        ILoggerFactory loggerFactory)
+        : base(options, resourceService, loggerFactory)
+    {
+    }
 }
 ```
 
@@ -67,14 +66,16 @@ public class ArticlesController : JsonApiController<Article>
 ```csharp
 public class Startup
 {
-    public IServiceProvider ConfigureServices(IServiceCollection services) {
+    public IServiceProvider ConfigureServices(IServiceCollection services)
+    {
         services.AddJsonApi<AppDbContext>();
-        // ...
     }
 
-    public void Configure(IApplicationBuilder app)  {
-        app.UseJsonApi()
-        // ...
+    public void Configure(IApplicationBuilder app)
+    {
+        app.UseRouting();
+        app.UseJsonApi();
+        app.UseEndpoints(endpoints => endpoints.MapControllers());
     }
 }
 ```
@@ -101,26 +102,19 @@ And then to run the tests:
 dotnet test
 ```
 
-#### Cleaning
-
-Sometimes the compiled files can be dirty / corrupt from other branches / failed builds.
-
-```bash
-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
+A lot of changes were introduced in v4, the following chart should help you with compatibility issues between .NET Core versions.
 
-| .NET Core Version | JADNC Version |
-| ----------------- | ------------- |
-| 2.*               | v3.*          |
-| 3.*               | v4.*          |
+| .NET Core Version | EF Core Version | JADNC Version |
+| ----------------- | --------------- | ------------- |
+| 2.x               | 2.x             | v3.x          |
+| 3.x               | 3.x, 5.x        | v4.x          |
+| 5.x               | 5.x             | v4.x          |
 
 ## Trying out the latest build
 

README.md

@@ -3,6 +3,7 @@
 using System.ComponentModel.Design;
 using BenchmarkDotNet.Attributes;
 using JsonApiDotNetCore.Configuration;
+using JsonApiDotNetCore.Middleware;
 using JsonApiDotNetCore.Resources;
 using JsonApiDotNetCore.Serialization;
 using JsonApiDotNetCore.Serialization.Objects;
@@ -37,7 +38,8 @@ public JsonApiDeserializerBenchmarks()
             var options = new JsonApiOptions();
             IResourceGraph resourceGraph = DependencyFactory.CreateResourceGraph(options);
             var targetedFields = new TargetedFields();
-            _jsonApiDeserializer = new RequestDeserializer(resourceGraph, new ResourceFactory(new ServiceContainer()), targetedFields, new HttpContextAccessor());
+            var request = new JsonApiRequest();
+            _jsonApiDeserializer = new RequestDeserializer(resourceGraph, new ResourceFactory(new ServiceContainer()), targetedFields, new HttpContextAccessor(), request);
         }
 
         [Benchmark]

benchmarks/Serialization/JsonApiDeserializerBenchmarks.cs

@@ -49,7 +49,7 @@ private static FieldsToSerialize CreateFieldsToSerialize(IResourceGraph resource
 
             var accessor = new Mock<IResourceDefinitionAccessor>().Object;
 
-            return new FieldsToSerialize(resourceGraph, constraintProviders, accessor);
+            return new FieldsToSerialize(resourceGraph, constraintProviders, accessor, request);
         }
 
         [Benchmark]

benchmarks/Serialization/JsonApiSerializerBenchmarks.cs

@@ -16,6 +16,6 @@ Install-Package JsonApiDotnetCore
 ```xml
 <ItemGroup>
   <!-- Be sure to check NuGet for the latest version # -->
-  <PackageReference Include="JsonApiDotNetCore" Version="3.0.0" />
+  <PackageReference Include="JsonApiDotNetCore" Version="4.0.0" />
 </ItemGroup>
 ```

docs/getting-started/install.md

@@ -1,3 +1,3 @@
 # Internals
 
-The section contains overviews for the inner workings of the JsonApiDotNetCore library.
+This section contains overviews for the inner workings of the JsonApiDotNetCore library.

docs/internals/index.md

@@ -45,22 +45,22 @@ _Note that cURL requires "[" and "]" in URLs to be escaped._
 
 # Writing data
 
-### Create
+### Create resource
 
 [!code-ps[REQUEST](010_CREATE_Person.ps1)]
 [!code-json[RESPONSE](010_CREATE_Person_Response.json)]
 
-### Create with relationship
+### Create resource with relationship
 
 [!code-ps[REQUEST](011_CREATE_Book-with-Author.ps1)]
 [!code-json[RESPONSE](011_CREATE_Book-with-Author_Response.json)]
 
-### Update
+### Update resource
 
 [!code-ps[REQUEST](012_PATCH_Book.ps1)]
 [!code-json[RESPONSE](012_PATCH_Book_Response.json)]
 
-### Delete
+### Delete resource
 
 [!code-ps[REQUEST](013_DELETE_Book.ps1)]
 [!code-json[RESPONSE](013_DELETE_Book_Response.json)]

docs/request-examples/index.md

@@ -3,7 +3,7 @@
 If you want to use a data access technology other than Entity Framework Core, you can create an implementation of `IResourceRepository<TResource, TId>`.
 If you only need minor changes you can override the methods defined in `EntityFrameworkCoreRepository<TResource, TId>`.
 
-The repository should then be added to the service collection in Startup.cs.
+The repository should then be registered in Startup.cs.
 
 ```c#
 public void ConfigureServices(IServiceCollection services)
@@ -12,6 +12,21 @@ public void ConfigureServices(IServiceCollection services)
 }
 ```
 
+In v4.0 we introduced an extension method that you can use to register a resource repository on all of its JsonApiDotNetCore interfaces.
+This is helpful when you implement a subset of the resource interfaces and want to register them all in one go.
+
+Note: If you're using service discovery, this happens automatically.
+
+```c#
+public class Startup
+{
+    public void ConfigureServices(IServiceCollection services)
+    {
+        services.AddResourceRepository<ArticleRepository>();
+    }
+}
+```
+
 A sample implementation that performs authorization might look like this.
 
 All of the methods in EntityFrameworkCoreRepository will use the `GetAll()` method to get the `DbSet<TResource>`, so this is a good method to apply filters such as user or tenant authorization.

docs/usage/extensibility/repositories.md

@@ -115,7 +115,7 @@ IResourceService
         PATCH /{id}/relationships/{relationship}
 ```
 
-In order to take advantage of these interfaces you first need to inject the service for each implemented interface.
+In order to take advantage of these interfaces you first need to register the service for each implemented interface.
 
 ```c#
 public class ArticleService : ICreateService<Article>, IDeleteService<Article>
@@ -136,6 +136,8 @@ public class Startup
 In v3.0 we introduced an extension method that you can use to register a resource service on all of its JsonApiDotNetCore interfaces.
 This is helpful when you implement a subset of the resource interfaces and want to register them all in one go.
 
+Note: If you're using service discovery, this happens automatically.
+
 ```c#
 public class Startup
 {