🔖 Début du versionning, problème au niveau de swagger, voir le code du prof ou tenter un SwaggerOption, qui reste compliquer.

Sources/API_LoL/API_LoL.csproj

@@ -9,6 +9,8 @@
   </PropertyGroup>
 
   <ItemGroup>
+    <PackageReference Include="Microsoft.AspNetCore.Mvc.Versioning" Version="5.0.0" />
+    <PackageReference Include="Microsoft.AspNetCore.Mvc.Versioning.ApiExplorer" Version="5.0.0" />
     <PackageReference Include="Microsoft.VisualStudio.Azure.Containers.Tools.Targets" Version="1.17.0" />
     <PackageReference Include="Swashbuckle.AspNetCore" Version="6.2.3" />
   </ItemGroup>

Sources/API_LoL/Controllers/ChampionsController.cs

@@ -9,7 +9,9 @@ using System.CodeDom.Compiler;
 
 namespace API_LoL.Controllers
 {
-    [Route("api/[controller]")]
+    //[Route("api/[controller]")]
+    [ApiVersion("1.0")]
+    [Route("api/v{version:apiVersion}/[controller]")]
     [ApiController]
     public class ChampionsController : ControllerBase
     {

Sources/API_LoL/Controllers/ChampionsControllerVersioned.cs

@@ -0,0 +1,106 @@
+using Microsoft.AspNetCore.Mvc;
+using Model;
+using StubLib;
+using DTO;
+using DTO.Mapper;
+using System.CodeDom.Compiler;
+
+namespace API_LoL.Controllers
+{
+    [ApiVersion("2.0")]
+    [ApiVersion("2.2")]
+    [Route("api/v{version:apiVersion}/versioned")]
+    [ApiController]
+    public class ChampionsControllerVersioned : ControllerBase
+    {
+        public ChampionsControllerVersioned(IDataManager Manager)
+        {
+            this.ChampionsManager = Manager.ChampionsMgr;
+        }
+
+        private IChampionsManager ChampionsManager;
+
+        // GET api/<ChampionController>/5
+
+        [HttpGet]
+        public async Task<IActionResult> Get(String? name = null, String? skill = null, String? characteristic = null, int index = 0, int size = 10)
+        {
+            if (size - index > 10)
+            {
+                return BadRequest();
+            }
+            if (!string.IsNullOrEmpty(name))
+            {
+                var list = await ChampionsManager.GetItemsByName(name, index, size);
+                if (list.Count() != 0)
+                {
+                    return Ok(list.Select(champion => champion?.ToDTO()));
+                }
+                else { return NoContent(); }
+            }
+            else if (!string.IsNullOrEmpty(skill))
+            {
+                var list = await ChampionsManager.GetItemsBySkill(skill, index, size);
+                if (list.Count() != 0)
+                {
+                    return Ok(list.Select(champion => champion?.ToDTO()));
+                }
+                else { return NoContent(); }
+            }
+            else if (!string.IsNullOrEmpty(characteristic))
+            {
+                var list = await ChampionsManager.GetItems(index, size);
+                if (list.Count() != 0)
+                {
+                    return Ok(list.Select(champion => champion?.ToDTO()));
+                }
+                else { return NoContent(); }
+            }
+            else
+            {
+                var list = await ChampionsManager.GetItems(index, size);
+                if (list.Count() != 0)
+                {
+                    return Ok(list.Select(champion => champion?.ToDTO()));
+                }
+                else { return NoContent(); }
+            }
+        }
+
+        
+        // POST api/<ChampionController>
+        [HttpPost]
+        public async Task<IActionResult> Post(ChampionDTO champion)
+        {
+            if (champion == null)
+            {
+                return UnprocessableEntity();
+            }
+            else
+            {
+                await ChampionsManager.AddItem(champion.ToChampion());
+                return CreatedAtAction("Post", champion);
+            }
+        }
+
+        // PUT api/<ChampionController>/5
+        [HttpPut("{id}")]
+        public void Put(int id, [FromBody] string value)
+        {
+        }
+
+        // DELETE api/<ChampionController>/5
+        [HttpDelete("{id}")]
+        public void Delete(int id)
+        {
+        }
+
+
+        ///---------- Versioning ----------///
+        [HttpGet]
+        public string GetThatOnlySayHello() => "Hello v2.0!";
+
+        [HttpGet, MapToApiVersion("2.2")]
+        public string GetThatOnlySayHelloV2() => "Hello but i'm from v2.2!";
+    }
+}

Sources/API_LoL/Program.cs

@@ -1,24 +1,59 @@
+using Microsoft.AspNetCore.Mvc.ApiExplorer;
+using Microsoft.AspNetCore.Mvc.Versioning;
 using Model;
 using StubLib;
 
 var builder = WebApplication.CreateBuilder(args);
 
-// Add services to the container.
 
-builder.Services.AddControllers();
+//Versioning
+
+///NOT WORKING WHEN CHANGING VERSIONS :
+/// voir sur https://blog.christian-schou.dk/how-to-use-api-versioning-in-net-core-web-api/ rubrique "Configure SwaggerOptions"
+/// (mais requiere l'injection de dépendance).
+/// Sinon, code plus simple disponible par le prof
+
+
+
+// Add ApiExplorer to discover versions
+builder.Services.AddVersionedApiExplorer(setup =>
+{
+    setup.GroupNameFormat = "'v'VVV";
+    setup.SubstituteApiVersionInUrl = true;
+});
+
 // Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
 builder.Services.AddEndpointsApiExplorer();
 builder.Services.AddSwaggerGen();
 
+
+builder.Services.AddApiVersioning(o => o.ApiVersionReader = new UrlSegmentApiVersionReader());
+
+// Add services to the container.
+builder.Services.AddControllers();
+
+
+
 builder.Services.AddScoped<IDataManager,StubData>();
 
 var app = builder.Build();
 
+var apiVersionDescriptionProvider = app.Services.GetRequiredService<IApiVersionDescriptionProvider>();
+
+
 // Configure the HTTP request pipeline.
 if (app.Environment.IsDevelopment())
 {
     app.UseSwagger();
-    app.UseSwaggerUI();
+    app.UseSwaggerUI(options =>
+    {
+        
+        foreach (var description in apiVersionDescriptionProvider.ApiVersionDescriptions)
+        {
+            options.SwaggerEndpoint($"/swagger/{description.GroupName}/swagger.json",
+                description.GroupName.ToUpperInvariant());
+        }
+    });
 }
 
 app.UseHttpsRedirection();