using System.Collections.Generic; using System.Linq; using System.Threading.Tasks; using Microsoft.AspNetCore.Http; using Microsoft.AspNetCore.Mvc; using Microsoft.AspNetCore.Routing; using Microsoft.AspNetCore.Authorization; using Microsoft.AspNetCore.JsonPatch; using Microsoft.EntityFrameworkCore; using Microsoft.Extensions.Logging; using AyaNova.Models; using AyaNova.Api.ControllerHelpers; using AyaNova.Biz; namespace AyaNova.Api.Controllers { //DOCUMENTATING THE API //https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/xmldoc/recommended-tags-for-documentation-comments //https://github.com/domaindrivendev/Swashbuckle.AspNetCore#include-descriptions-from-xml-comments /// /// Localized text controller /// [ApiController] [ApiVersion("8.0")] [Route("api/v{version:apiVersion}/[controller]")] [Produces("application/json")] [Authorize] public class LocaleController : ControllerBase { private readonly AyContext ct; private readonly ILogger log; private readonly ApiServerState serverState; /// /// ctor /// /// /// /// public LocaleController(AyContext dbcontext, ILogger logger, ApiServerState apiServerState) { ct = dbcontext; log = logger; serverState = apiServerState; } /// /// Get Locale all values /// /// /// A single Locale and it's values [HttpGet("{id}")] public async Task GetLocale([FromRoute] long id) { if (serverState.IsClosed) { return StatusCode(503, new ApiErrorResponse(ApiErrorCode.API_CLOSED, null, serverState.Reason)); } if (!ModelState.IsValid) { return BadRequest(new ApiErrorResponse(ModelState)); } //Instantiate the business object handler // LocaleBiz biz = new LocaleBiz(ct, UserIdFromContext.Id(HttpContext.Items), UserRolesFromContext.Roles(HttpContext.Items)); LocaleBiz biz = LocaleBiz.GetBiz(ct, HttpContext); var o = await biz.GetAsync(id); if (o == null) { return NotFound(new ApiErrorResponse(ApiErrorCode.NOT_FOUND)); } return Ok(ApiOkResponse.Response(o, true)); } /// /// Get Locale pick list /// /// Picklist in alphabetical order of all locales [HttpGet("PickList")] public async Task LocalePickList() { if (serverState.IsClosed) { return StatusCode(503, new ApiErrorResponse(ApiErrorCode.API_CLOSED, null, serverState.Reason)); } //Instantiate the business object handler //LocaleBiz biz = new LocaleBiz(ct, UserIdFromContext.Id(HttpContext.Items), UserRolesFromContext.Roles(HttpContext.Items)); LocaleBiz biz = LocaleBiz.GetBiz(ct, HttpContext); var l = await biz.GetPickListAsync(); return Ok(ApiOkResponse.Response(l, true)); } #if (DEBUG) /// /// Get a coverage report of locale keys used versus unused /// /// Report of all unique locale keys requested since last server reboot [HttpGet("LocaleKeyCoverage")] public async Task LocaleKeyCoverage() { if (serverState.IsClosed) { return StatusCode(503, new ApiErrorResponse(ApiErrorCode.API_CLOSED, null, serverState.Reason)); } //Instantiate the business object handler LocaleBiz biz = LocaleBiz.GetBiz(ct, HttpContext); //LocaleBiz biz = new LocaleBiz(ct, UserIdFromContext.Id(HttpContext.Items), UserRolesFromContext.Roles(HttpContext.Items)); var l = await biz.LocaleKeyCoverageAsync(); return Ok(ApiOkResponse.Response(l, true)); } #endif /// /// Get subset of locale values /// /// List of locale key strings /// A key value array of localized text values [HttpPost("SubSet")] public async Task SubSet([FromBody] List inObj) { if (serverState.IsClosed) { return StatusCode(503, new ApiErrorResponse(ApiErrorCode.API_CLOSED, null, serverState.Reason)); } //Instantiate the business object handler //LocaleBiz biz = new LocaleBiz(ct, UserIdFromContext.Id(HttpContext.Items), UserRolesFromContext.Roles(HttpContext.Items)); //Instantiate the business object handler LocaleBiz biz = LocaleBiz.GetBiz(ct, HttpContext); var l = await biz.GetSubsetAsync(inObj); return Ok(ApiOkResponse.Response(l, true)); } /// /// Duplicates an existing locale with a new name /// /// NameIdItem object containing source locale Id and new name /// Automatically filled from route path, no need to specify in body /// Error response or newly created locale [HttpPost("Duplicate")] public async Task Duplicate([FromBody] NameIdItem inObj, ApiVersion apiVersion) { if (serverState.IsClosed) { return StatusCode(503, new ApiErrorResponse(ApiErrorCode.API_CLOSED, null, serverState.Reason)); } //Instantiate the business object handler // LocaleBiz biz = new LocaleBiz(ct, UserIdFromContext.Id(HttpContext.Items), UserRolesFromContext.Roles(HttpContext.Items)); LocaleBiz biz = LocaleBiz.GetBiz(ct, HttpContext); var o = await biz.DuplicateAsync(inObj); if (o == null) { //error return return BadRequest(new ApiErrorResponse(biz.Errors)); } else { return CreatedAtAction(nameof(LocaleController.GetLocale), new { id = o.Id, version = apiVersion.ToString() }, new ApiCreatedResponse(o)); } } /// /// Put (UpdateLocaleItemDisplayText) /// Update a single key with new display text /// /// NewText/Id/Concurrency token object. NewText is new display text, Id is LocaleItem Id, concurrency token is required /// [HttpPut("UpdateLocaleItemDisplayText")] public async Task PutLocalItemDisplayText([FromBody] NewTextIdConcurrencyTokenItem inObj) { if (!serverState.IsOpen) { return StatusCode(503, new ApiErrorResponse(ApiErrorCode.API_CLOSED, null, serverState.Reason)); } if (!ModelState.IsValid) { return BadRequest(new ApiErrorResponse(ModelState)); } var oFromDb = await ct.LocaleItem.SingleOrDefaultAsync(m => m.Id == inObj.Id); if (oFromDb == null) { return NotFound(new ApiErrorResponse(ApiErrorCode.NOT_FOUND)); } //Now fetch locale for rights and to ensure not stock var oDbParent = await ct.Locale.SingleOrDefaultAsync(x => x.Id == oFromDb.LocaleId); if (oDbParent == null) { return NotFound(new ApiErrorResponse(ApiErrorCode.NOT_FOUND)); } if (!Authorized.HasModifyRole(HttpContext.Items, AyaType.Locale)) { return StatusCode(403, new ApiNotAuthorizedResponse()); } //Instantiate the business object handler // LocaleBiz biz = new LocaleBiz(ct, UserIdFromContext.Id(HttpContext.Items), UserRolesFromContext.Roles(HttpContext.Items)); LocaleBiz biz = LocaleBiz.GetBiz(ct, HttpContext); try { if (!await biz.PutLocaleItemDisplayTextAsync(oFromDb, inObj, oDbParent)) { return BadRequest(new ApiErrorResponse(biz.Errors)); } } catch (DbUpdateConcurrencyException) { if (!await biz.LocaleItemExistsAsync(inObj.Id)) { return NotFound(new ApiErrorResponse(ApiErrorCode.NOT_FOUND)); } else { //exists but was changed by another user //I considered returning new and old record, but where would it end? //Better to let the client decide what to do than to send extra data that is not required return StatusCode(409, new ApiErrorResponse(ApiErrorCode.CONCURRENCY_CONFLICT)); } } return Ok(ApiOkResponse.Response(new { ConcurrencyToken = oFromDb.ConcurrencyToken }, true)); } /// /// Put (UpdateLocaleName) /// Update a locale to change the name (non-stock locales only) /// /// NewText/Id/Concurrency token object. NewText is new locale name, Id is Locale Id, concurrency token is required /// [HttpPut("UpdateLocaleName")] public async Task PutLocaleName([FromBody] NewTextIdConcurrencyTokenItem inObj) { if (!serverState.IsOpen) { return StatusCode(503, new ApiErrorResponse(ApiErrorCode.API_CLOSED, null, serverState.Reason)); } if (!ModelState.IsValid) { return BadRequest(new ApiErrorResponse(ModelState)); } var oFromDb = await ct.Locale.SingleOrDefaultAsync(m => m.Id == inObj.Id); if (oFromDb == null) { return NotFound(new ApiErrorResponse(ApiErrorCode.NOT_FOUND)); } if (!Authorized.HasModifyRole(HttpContext.Items, AyaType.Locale)) { return StatusCode(403, new ApiNotAuthorizedResponse()); } //Instantiate the business object handler //LocaleBiz biz = new LocaleBiz(ct, UserIdFromContext.Id(HttpContext.Items), UserRolesFromContext.Roles(HttpContext.Items)); LocaleBiz biz = LocaleBiz.GetBiz(ct, HttpContext); try { if (!await biz.PutLocaleNameAsync(oFromDb, inObj)) { return BadRequest(new ApiErrorResponse(biz.Errors)); } } catch (DbUpdateConcurrencyException) { if (!await biz.LocaleExistsAsync(inObj.Id)) { return NotFound(new ApiErrorResponse(ApiErrorCode.NOT_FOUND)); } else { //exists but was changed by another user //I considered returning new and old record, but where would it end? //Better to let the client decide what to do than to send extra data that is not required return StatusCode(409, new ApiErrorResponse(ApiErrorCode.CONCURRENCY_CONFLICT)); } } return Ok(ApiOkResponse.Response(new { ConcurrencyToken = oFromDb.ConcurrencyToken }, true)); } /// /// Delete Locale /// /// /// Ok [HttpDelete("{id}")] public async Task DeleteLocale([FromRoute] long id) { if (!serverState.IsOpen) { return StatusCode(503, new ApiErrorResponse(ApiErrorCode.API_CLOSED, null, serverState.Reason)); } if (!ModelState.IsValid) { return BadRequest(new ApiErrorResponse(ModelState)); } //Fetch locale and it's children //(fetch here so can return proper REST responses on failing basic validity) var dbObj = await ct.Locale.Include(x => x.LocaleItems).SingleOrDefaultAsync(m => m.Id == id); if (dbObj == null) { return NotFound(new ApiErrorResponse(ApiErrorCode.NOT_FOUND)); } if (!Authorized.HasDeleteRole(HttpContext.Items, AyaType.Locale)) { return StatusCode(403, new ApiNotAuthorizedResponse()); } //Instantiate the business object handler LocaleBiz biz = LocaleBiz.GetBiz(ct, HttpContext); if (!await biz.DeleteAsync(dbObj)) { return BadRequest(new ApiErrorResponse(biz.Errors)); } return NoContent(); } #if (DEBUG) public class LocaleCoverageInfo { public List RequestedKeys { get; set; } public int RequestedKeyCount { get; set; } public List NotRequestedKeys { get; set; } public int NotRequestedKeyCount { get; set; } public LocaleCoverageInfo() { RequestedKeys = new List(); NotRequestedKeys = new List(); } } #endif } }