Update documentation to replace int with long

Author: niteshsinghal-siemens

docs/usage/errors.md

@@ -34,9 +34,9 @@ This handler is also the place to choose the log level and message, based on the
 ```c#
 public class ProductOutOfStockException : Exception
 {
-    public int ProductId { get; }
+    public long ProductId { get; }
 
-    public ProductOutOfStockException(int productId)
+    public ProductOutOfStockException(long productId)
     {
         ProductId = productId;
     }

docs/usage/extensibility/controllers.md

@@ -126,10 +126,10 @@ You can even make your own mix of allowed routes by calling the alternate constr
 In some cases, resources may be an aggregation of entities or a view on top of the underlying entities. In these cases, there may not be a writable `IResourceService` implementation, so simply inject the implementation that is available.
 
 ```c#
-public class ReportsController : JsonApiController<Report, int>
+public class ReportsController : JsonApiController<Report, long>
 {
     public ReportsController(IJsonApiOptions options, IResourceGraph resourceGraph,
-        ILoggerFactory loggerFactory, IGetAllService<Report, int> getAllService)
+        ILoggerFactory loggerFactory, IGetAllService<Report, long> getAllService)
         : base(options, resourceGraph, loggerFactory, getAll: getAllService)
     {
     }

docs/usage/extensibility/repositories.md

@@ -5,9 +5,9 @@ If you only need minor changes you can override the methods defined in `EntityFr
 
 ```c#
 // Program.cs
-builder.Services.AddScoped<IResourceRepository<Article, int>, ArticleRepository>();
-builder.Services.AddScoped<IResourceReadRepository<Article, int>, ArticleRepository>();
-builder.Services.AddScoped<IResourceWriteRepository<Article, int>, ArticleRepository>();
+builder.Services.AddScoped<IResourceRepository<Article, long>, ArticleRepository>();
+builder.Services.AddScoped<IResourceReadRepository<Article, long>, ArticleRepository>();
+builder.Services.AddScoped<IResourceWriteRepository<Article, long>, ArticleRepository>();
 ```
 
 In v4.0 we introduced an extension method that you can use to register a resource repository on all of its JsonApiDotNetCore interfaces.
@@ -26,7 +26,7 @@ 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.
 
 ```c#
-public class ArticleRepository : EntityFrameworkCoreRepository<Article, int>
+public class ArticleRepository : EntityFrameworkCoreRepository<Article, long>
 {
     private readonly IAuthenticationService _authenticationService;
 

docs/usage/extensibility/resource-definitions.md

@@ -18,7 +18,7 @@ builder.Services.AddResourceDefinition<ArticleDefinition>();
 > [!NOTE]
 > Prior to the introduction of auto-discovery (in v3), you needed to register the resource definition on the container yourself:
 > ```c#
-> builder.Services.AddScoped<ResourceDefinition<Article, int>, ArticleDefinition>();
+> builder.Services.AddScoped<ResourceDefinition<Article, long>, ArticleDefinition>();
 > ```
 
 ## Customizing queries
@@ -41,7 +41,7 @@ For example, you may accept some sensitive data that should only be exposed to a
 > To exclude fields unconditionally, [attribute capabilities](~/usage/resources/attributes.md#capabilities) and [relationship capabilities](~/usage/resources/relationships.md#capabilities) can be used instead.
 
 ```c#
-public class UserDefinition : JsonApiResourceDefinition<User, int>
+public class UserDefinition : JsonApiResourceDefinition<User, long>
 {
     public UserDefinition(IResourceGraph resourceGraph)
         : base(resourceGraph)
@@ -100,7 +100,7 @@ Content-Type: application/vnd.api+json
 You can define the default sort order if no `sort` query string parameter is provided.
 
 ```c#
-public class AccountDefinition : JsonApiResourceDefinition<Account, int>
+public class AccountDefinition : JsonApiResourceDefinition<Account, long>
 {
     public AccountDefinition(IResourceGraph resourceGraph)
         : base(resourceGraph)
@@ -128,7 +128,7 @@ public class AccountDefinition : JsonApiResourceDefinition<Account, int>
 You may want to enforce pagination on large database tables.
 
 ```c#
-public class AccessLogDefinition : JsonApiResourceDefinition<AccessLog, int>
+public class AccessLogDefinition : JsonApiResourceDefinition<AccessLog, long>
 {
     public AccessLogDefinition(IResourceGraph resourceGraph)
         : base(resourceGraph)
@@ -159,7 +159,7 @@ public class AccessLogDefinition : JsonApiResourceDefinition<AccessLog, int>
 The next example filters out `Account` resources that are suspended.
 
 ```c#
-public class AccountDefinition : JsonApiResourceDefinition<Account, int>
+public class AccountDefinition : JsonApiResourceDefinition<Account, long>
 {
     public AccountDefinition(IResourceGraph resourceGraph)
         : base(resourceGraph)
@@ -188,7 +188,7 @@ public class AccountDefinition : JsonApiResourceDefinition<Account, int>
 In the example below, an error is returned when a user tries to include the manager of an employee.
 
 ```c#
-public class EmployeeDefinition : JsonApiResourceDefinition<Employee, int>
+public class EmployeeDefinition : JsonApiResourceDefinition<Employee, long>
 {
     public EmployeeDefinition(IResourceGraph resourceGraph)
         : base(resourceGraph)
@@ -224,7 +224,7 @@ If the key is present in a query string, the supplied LINQ expression will be ad
 But it only works on primary resource endpoints (for example: /articles, but not on /blogs/1/articles or /blogs?include=articles).
 
 ```c#
-public class ItemDefinition : JsonApiResourceDefinition<Item, int>
+public class ItemDefinition : JsonApiResourceDefinition<Item, long>
 {
     public ItemDefinition(IResourceGraph resourceGraph)
         : base(resourceGraph)

docs/usage/extensibility/services.md

@@ -12,7 +12,7 @@ In simple cases, you can also just wrap the base implementation with your custom
 A simple example would be to send notifications when a resource gets created.
 
 ```c#
-public class TodoItemService : JsonApiResourceService<TodoItem, int>
+public class TodoItemService : JsonApiResourceService<TodoItem, long>
 {
     private readonly INotificationService _notificationService;
 
@@ -51,14 +51,14 @@ If you'd like to use another ORM that does not provide what JsonApiResourceServi
 // Program.cs
 
 // Add the service override for Product.
-builder.Services.AddScoped<IResourceService<Product, int>, ProductService>();
+builder.Services.AddScoped<IResourceService<Product, long>, ProductService>();
 
 // Add your own Data Access Object.
 builder.Services.AddScoped<IProductDao, ProductDao>();
 
 // ProductService.cs
 
-public class ProductService : IResourceService<Product, int>
+public class ProductService : IResourceService<Product, long>
 {
     private readonly IProductDao _dao;
 
@@ -114,14 +114,14 @@ IResourceCommandService <|-- IRemoveFromRelationshipService
 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, int>, IDeleteService<Article, int>
+public class ArticleService : ICreateService<Article, long>, IDeleteService<Article, long>
 {
     // ...
 }
 
 // Program.cs
-builder.Services.AddScoped<ICreateService<Article, int>, ArticleService>();
-builder.Services.AddScoped<IDeleteService<Article, int>, ArticleService>();
+builder.Services.AddScoped<ICreateService<Article, long>, ArticleService>();
+builder.Services.AddScoped<IDeleteService<Article, long>, ArticleService>();
 ```
 
 In v3.0 we introduced an extension method that you can use to register a resource service on all of its JsonApiDotNetCore interfaces.
@@ -149,11 +149,11 @@ public class Article : identifiable<long>
 Alternatively, when using a hand-written controller, you should inherit from the JSON:API controller and pass the services into the named, optional base parameters:
 
 ```c#
-public class ArticlesController : JsonApiController<Article, int>
+public class ArticlesController : JsonApiController<Article, long>
 {
     public ArticlesController(IJsonApiOptions options, IResourceGraph resourceGraph,
-        ILoggerFactory loggerFactory, ICreateService<Article, int> create,
-        IDeleteService<Article, int> delete)
+        ILoggerFactory loggerFactory, ICreateService<Article, long> create,
+        IDeleteService<Article, long> delete)
         : base(options, resourceGraph, loggerFactory, create: create, delete: delete)
     {
     }

docs/usage/meta.md

@@ -47,7 +47,7 @@ Resource-specific metadata can be added by implementing `IResourceDefinition<TRe
 ```c#
 #nullable enable
 
-public class PersonDefinition : JsonApiResourceDefinition<Person, int>
+public class PersonDefinition : JsonApiResourceDefinition<Person, long>
 {
     public PersonDefinition(IResourceGraph resourceGraph)
         : base(resourceGraph)

docs/usage/resource-graph.md

@@ -54,7 +54,7 @@ You can manually construct the graph.
 ```c#
 // Program.cs
 builder.Services.AddJsonApi(resources: resourceGraphBuilder =>
-    resourceGraphBuilder.Add<Person, int>());
+    resourceGraphBuilder.Add<Person, long>());
 ```
 
 ## Resource Name
@@ -66,7 +66,7 @@ The public resource name is exposed through the `type` member in the JSON:API pa
 // Program.cs
 builder.Services.AddJsonApi(resources: resourceGraphBuilder =>
 {
-    resourceGraphBuilder.Add<Person, int>(publicName: "individuals");
+    resourceGraphBuilder.Add<Person, long>(publicName: "individuals");
 });
 ```
 

docs/usage/resources/index.md

@@ -18,7 +18,7 @@ public class Person : identifiable<long>
 {
     [Key]
     [Column("PersonID")]
-    public override int Id { get; set; }
+    public override long Id { get; set; }
 }
 ```
 

docs/usage/routing.md

@@ -28,10 +28,10 @@ public class OrderSummary : identifiable<long>
 }
 
 // Hand-written
-public class OrderLineController : JsonApiController<OrderLine, int>
+public class OrderLineController : JsonApiController<OrderLine, long>
 {
     public OrderLineController(IJsonApiOptions options, IResourceGraph resourceGraph,
-        ILoggerFactory loggerFactory, IResourceService<OrderLine, int> resourceService)
+        ILoggerFactory loggerFactory, IResourceService<OrderLine, long> resourceService)
         : base(options, resourceGraph, loggerFactory, resourceService)
     {
     }
@@ -74,10 +74,10 @@ partial class OrderSummariesController
 // Hand-written
 [DisableRoutingConvention]
 [Route("custom/route/lines-in-order")]
-public class OrderLineController : JsonApiController<OrderLine, int>
+public class OrderLineController : JsonApiController<OrderLine, long>
 {
     public OrderLineController(IJsonApiOptions options, IResourceGraph resourceGraph,
-        ILoggerFactory loggerFactory, IResourceService<OrderLine, int> resourceService)
+        ILoggerFactory loggerFactory, IResourceService<OrderLine, long> resourceService)
         : base(options, resourceGraph, loggerFactory, resourceService)
     {
     }