Mise en place de la pagination

Sources/BowlingApi/BowlingApi.csproj

@@ -9,6 +9,11 @@
 
     <PropertyGroup Condition=" '$(RunConfiguration)' == 'https' " />
     <PropertyGroup Condition=" '$(RunConfiguration)' == 'http' " />
+    <PropertyGroup Condition=" '$(RunConfiguration)' == 'RestFull' " />
+    <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
+      <WarningLevel>4</WarningLevel>
+      <DocumentationFile>bin\Debug\net6.0\BowlingApi.xml</DocumentationFile>
+    </PropertyGroup>
     <ItemGroup>
         <!--<PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="7.0.0" />-->
         <PackageReference Include="Swashbuckle.AspNetCore" Version="6.4.0" />

Sources/BowlingApi/Controllers/JoueurController.cs

@@ -19,6 +19,7 @@ public class JoueurController:Controller
     
     /// <summary>
     /// Get all Players
+    /// GET: api/joueur
     /// </summary>
     /// <returns>la liste des Joueurs </returns>
     /// <response code="200">Retourne la liste des joueurs</response>
@@ -46,13 +47,59 @@ public class JoueurController:Controller
         }
     }
     
+    /// <summary>
+    /// Get player with pagination
+    /// Get : api/Joueur?page=1&pageSize=10
+    /// </summary>
+    /// <returns>la liste des Joueurs </returns>
+    /// <response code="200">Retourne la liste des joueurs</response>
+    /// <response code="404">Si la liste est vide</response>
+    /// <response code="500">Si une erreur est survenue</response>
+    
+    [HttpGet("{page}/{pageSize}")] 
+    [ProducesResponseType(typeof(string), StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(typeof(string), StatusCodes.Status404NotFound)]
+    [ProducesResponseType(typeof(IEnumerable<JoueurDTO>), StatusCodes.Status200OK)]
+    public async Task<IActionResult> Get(int page=1,int pageSize=10)
+    {
+        try
+        {
+            var result = await _joueurService.GetAll();
+            if (result == null)
+            {
+                return NotFound();
+            }
+            var data = result.Skip((page - 1) * pageSize).Take(pageSize);
+            Response.Headers.Add("X-Pagination", Newtonsoft.Json.JsonConvert.SerializeObject(new
+            {
+                totalCount = result.Count(),
+                pageSize = pageSize,
+                currentPage = page,
+                totalPages = (int)Math.Ceiling(result.Count() / (double)pageSize)
+            }));
+            return Ok(data);
+        }
+        catch (Exception e)
+        {
+            return StatusCode(StatusCodes.Status500InternalServerError, e.Message);
+            throw;
+        }
+    }
+    
     /// <summary>
     /// Get a player by name
     /// GET: api/Joueur/Djon
     /// </summary>
     /// <param name="name"></param>
-    /// <returns></returns>
+    /// <response code="200">Retourne le joueur</response>
+    /// <response code="400">Si le nom du joueur est null</response>
+    /// <response code="404">Si le joueur n'existe pas</response>
+    /// <response code="500">Si une erreur est survenue</response>
     [HttpGet("{name}")]
+    [ProducesResponseType(typeof(string), StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(typeof(string), StatusCodes.Status404NotFound)]
+    [ProducesResponseType(typeof(string), StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(typeof(JoueurDTO), StatusCodes.Status200OK)]
     public async Task<IActionResult> Get(string name)
     {
         try
@@ -74,8 +121,18 @@ public class JoueurController:Controller
         }
     }
     
-    // POST: api/Joueur
+    /// <summary>
+    /// Creer un joueur
+    /// POST: api/Joueur
+    /// </summary>
+    /// <param name="joueur"></param>
+    /// <response code="201">Retourne le joueur créé</response>
+    /// <response code="400">Si le joueur est null</response>
+    /// <response code="500">Si une erreur est survenue</response>
     [HttpPost]
+    [ProducesResponseType(typeof(string), StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(typeof(string), StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(typeof(JoueurDTO), StatusCodes.Status201Created)]
     public async Task<ActionResult<JoueurDTO>> Post([FromBody] JoueurDTO joueur)
     {
         try
@@ -95,7 +152,21 @@ public class JoueurController:Controller
         }
     }
     
+    /// <summary>
+    /// Modifier un joueur
+    /// PUT: api/Joueur/5
+    /// </summary>
+    /// <param name="id"></param>
+    /// <param name="joueur"></param>
+    /// <response code="200">Retourne le joueur modifié</response>
+    /// <response code="400">Si le joueur est null</response>
+    /// <response code="404">Si le joueur n'existe pas</response>
+    /// <response code="500">Si une erreur est survenue</response>
     [HttpPut("{id}")]
+    [ProducesResponseType(typeof(string), StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(typeof(string), StatusCodes.Status404NotFound)]
+    [ProducesResponseType(typeof(string), StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(typeof(JoueurDTO), StatusCodes.Status200OK)]
     public async Task<ActionResult<JoueurDTO>> Put(long id,[FromBody] JoueurDTO joueur)
     {
         try

Sources/BowlingApi/Program.cs

@@ -19,6 +19,7 @@ builder.Services.AddEndpointsApiExplorer();
 builder.Services.AddSwaggerGen(c=>
 {
     c.SwaggerDoc("v1", new() { Title = "APi Bowling APP", Version = "v1" });
+    c.IncludeXmlComments(Path.Combine(AppContext.BaseDirectory, "BowlingApi.xml"));
 });
 builder.Services.AddAutoMapper(typeof(JoueurProfile));
 builder.Services.AddScoped<IJoueurService, JoueurService>();

Sources/BowlingApi/Properties/launchSettings.json

@@ -29,8 +29,6 @@
     },
     "RestFull": {
       "commandName": "Project",
-      "dotnetRunMessages": true,
-      "launchBrowser": false,
       "applicationUrl": "https://localhost:5001",
       "environmentVariables": {
         "ASPNETCORE_ENVIRONMENT": "Development"