docs: update simple sample for repositoryAccessor (#898)

* docs: update simple sample for repositoryAccessor

* Updated additional places in docs for CancellationToken usage

Co-authored-by: Bart Koelman <[email protected]>

Author: fdlane

docs/usage/extensibility/controllers.md

@@ -51,15 +51,15 @@ public class ArticlesController : BaseJsonApiController<Article>
     { }
 
     [HttpGet]
-    public override async Task<IActionResult> GetAsync()
+    public override async Task<IActionResult> GetAsync(CancellationToken cancellationToken)
     {
-        return await base.GetAsync();
+        return await base.GetAsync(cancellationToken);
     }
 
     [HttpGet("{id}")]
-    public override async Task<IActionResult> GetAsync(int id)
+    public override async Task<IActionResult> GetAsync(int id, CancellationToken cancellationToken)
     {
-        return await base.GetAsync(id);
+        return await base.GetAsync(id, cancellationToken);
     }
 }
 ```
@@ -108,9 +108,9 @@ public class ReportsController : BaseJsonApiController<Report>
     { }
 
     [HttpGet]
-    public override async Task<IActionResult> GetAsync()
+    public override async Task<IActionResult> GetAsync(CancellationToken cancellationToken)
     {
-        return await base.GetAsync();
+        return await base.GetAsync(cancellationToken);
     }
 }
 ```

docs/usage/extensibility/repositories.md

@@ -51,9 +51,10 @@ public class ArticleRepository : EntityFrameworkCoreRepository<Article>
         _authenticationService = authenticationService;
     }
 
-    public override IQueryable<Article> GetAll()
+    public override IQueryable<Article> GetAll(CancellationToken cancellationToken)
     {
-        return base.Get().Where(article => article.UserId == _authenticationService.UserId);
+        return base.GetAll(cancellationToken)
+            .Where(article => article.UserId == _authenticationService.UserId);
     }
 }
 ```

docs/usage/extensibility/services.md

@@ -16,28 +16,28 @@ public class TodoItemService : JsonApiResourceService<TodoItem>
     private readonly INotificationService _notificationService;
 
     public TodoItemService(
-        IResourceRepository<TodoItem> repository,
+        IResourceRepositoryAccessor repositoryAccessor,
         IQueryLayerComposer queryLayerComposer,
         IPaginationContext paginationContext,
         IJsonApiOptions options,
         ILoggerFactory loggerFactory,
         IJsonApiRequest request,
         IResourceChangeTracker<TodoItem> resourceChangeTracker,
         IResourceFactory resourceFactory,
-        IResourceHookExecutor hookExecutor = null)
-        : base(repository, queryLayerComposer, paginationContext, options, loggerFactory,
+        IResourceHookExecutorFacade hookExecutor)
+        : base(repositoryAccessor, queryLayerComposer, paginationContext, options, loggerFactory,
             request, resourceChangeTracker, resourceFactory, hookExecutor)
     {
         _notificationService = notificationService;
     }
 
-    public override async Task<TodoItem> CreateAsync(TodoItem resource)
+    public override async Task<TodoItem> CreateAsync(TodoItem resource, CancellationToken cancellationToken)
     {
         // Call the base implementation
-        var newResource = await base.CreateAsync(resource);
+        var newResource = await base.CreateAsync(resource, cancellationToken);
 
         // Custom code
-        _notificationService.Notify($"Resource created: {newResource.StringId}");
+        await _notificationService.NotifyAsync($"Resource created: {newResource.StringId}");
 
         return newResource;
     }
@@ -70,9 +70,9 @@ public class ProductService : IResourceService<Product>
         _dao = dao;
     }
 
-    public Task<IEnumerable<Product>> GetAsync()
+    public async Task<IReadOnlyCollection<Product>> GetAsync(CancellationToken cancellationToken)
     {
-        return await _dao.GetProductsAsync();
+        return await _dao.GetProductsAsync(cancellationToken);
     }
 }
 ```
@@ -162,15 +162,15 @@ public class ArticlesController : BaseJsonApiController<Article>
     { }
 
     [HttpPost]
-    public override async Task<IActionResult> PostAsync([FromBody] Article resource)
+    public override async Task<IActionResult> PostAsync([FromBody] Article resource, CancellationToken cancellationToken)
     {
-        return await base.PostAsync(resource);
+        return await base.PostAsync(resource, cancellationToken);
     }
 
     [HttpDelete("{id}")]
-    public override async Task<IActionResult>DeleteAsync(int id)
+    public override async Task<IActionResult>DeleteAsync(int id, CancellationToken cancellationToken)
     {
-        return await base.DeleteAsync(id);
+        return await base.DeleteAsync(id, cancellationToken);
     }
 }
 ```