implement character controller methods

server/Controllers/v1/CharactersController.cs

@@ -1,4 +1,7 @@
 using Microsoft.AspNetCore.Mvc;
+using MongoDB.Bson;
+using server.Models;
+using server.Persistence.Repositories;
 
 namespace server.Controllers.v1
 {
@@ -8,5 +11,77 @@ namespace server.Controllers.v1
     [Produces("application/json")]
     public class CharactersController : ControllerBase
     {
+        private readonly ICharacterRepository _characterRepository;
+
+        public CharactersController(ICharacterRepository characterRepository)
+        {
+            _characterRepository = characterRepository;
+        }
+
+        /// <summary>
+        /// Gets a collection of characters.
+        /// </summary>
+        /// <param name="filter">Filter parameters passed from query string.</param>
+        /// <response code="200">Returns the collection of characters requested.</response>
+        /// <response code="400">Not a valid request.</response>
+        /// <response code="500">Failed to get characters.</response>
+        /// <returns>Returns a collection of characters.</returns>
+        [MapToApiVersion("1.0")]
+        [HttpGet]
+        [ProducesResponseType(typeof(List<Character>), StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(ValidationProblemDetails), StatusCodes.Status400BadRequest)]
+        [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status500InternalServerError)]
+        public async Task<ActionResult<List<Character>>> GetCharactersAsync([FromQuery] CharacterFilter? filter)
+        {
+            try
+            {
+                var character = await _characterRepository.GetCharactersAsync(filter);
+                return Ok(character);
+            }
+            catch (Exception e)
+            {
+                Console.WriteLine(e);
+                return Problem(detail: "Failed to get characters", statusCode: 500);
+            }
+        }
+
+        /// <summary>
+        /// Gets a character by its id.
+        /// </summary>
+        /// <param name="id">The id of the character being requested.</param>
+        /// <response code="200">Returns the character requested.</response>
+        /// <response code="400">Not a valid request.</response>
+        /// <response code="404">Character with the given id not found.</response>
+        /// <response code="500">Failed to get character.</response>
+        /// <returns>Returns a character.</returns>
+        [MapToApiVersion("1.0")]
+        [HttpGet("{id}")]
+        [ProducesResponseType(typeof(Character), StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(ValidationProblemDetails), StatusCodes.Status400BadRequest)]
+        [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
+        [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status500InternalServerError)]
+        public async Task<ActionResult<Character>> GetCharacterByIdAsync(string id)
+        {
+
+            if (!ObjectId.TryParse(id, out _))
+            {
+                ModelState.AddModelError(nameof(id), $"{id} is not a valid id");
+                return ValidationProblem();
+            }
+
+            try
+            {
+                var quote = await _characterRepository.GetCharacterByIdAsync(id);
+
+                return quote == null ?
+                    Problem(detail: $"Could not find character {id}", statusCode: 404) :
+                    Ok(quote);
+            }
+            catch (Exception e)
+            {
+                Console.WriteLine(e);
+                return Problem(detail: "Failed to get character", statusCode: 500);
+            }
+        }
     }
 }