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 /// [ApiVersion("8.0")] [Route("api/v{version:apiVersion}/[controller]")] [Produces("application/json")] [Authorize] public class LocaleController : Controller { 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 /// /// Required roles: Any /// /// /// 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)); var o = await biz.GetAsync(id); if (o == null) { return NotFound(new ApiErrorResponse(ApiErrorCode.NOT_FOUND)); } return Ok(new ApiOkResponse(o)); } /// /// Get Locale pick list /// Required roles: Any /// /// /// 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)); var l = await biz.GetPickListAsync(); return Ok(new ApiOkResponse(l)); } /// /// Get subset of locale values /// Required roles: Any /// /// /// LocaleSubsetParam object defining the locale Id and a list of keys required /// A key value array of localized text values [HttpPost("SubSet")] public async Task SubSet([FromBody] LocaleSubsetParam 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)); var l = await biz.GetSubset(inObj); return Ok(new ApiOkResponse(l)); } /// /// Duplicates an existing locale with a new name /// /// Required roles: OpsAdminFull | BizAdminFull /// /// /// NameIdItem object containing source locale Id and new name /// Error response or newly created locale [HttpPost("Duplicate")] public async Task Duplicate([FromBody] NameIdItem 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)); var o = await biz.DuplicateAsync(inObj); if (o == null) { //error return return BadRequest(new ApiErrorResponse(biz.Errors)); } else { //save and success return await ct.SaveChangesAsync(); //Log EventLogProcessor.AddEntry(new Event(biz.userId, o.Id, AyaType.Locale, AyaEvent.Created), ct); return CreatedAtAction("GetLocale", new { id = o.Id }, new ApiCreatedResponse(o)); } } /// /// Put (UpdateLocaleItemDisplayText) /// /// Required roles: OpsAdminFull | BizAdminFull /// /// 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 PutLocalItemDisplyaText([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.IsAuthorizedToModify(HttpContext.Items, AyaType.Locale, oDbParent.OwnerId)) { return StatusCode(401, new ApiNotAuthorizedResponse()); } //Instantiate the business object handler LocaleBiz biz = new LocaleBiz(ct, UserIdFromContext.Id(HttpContext.Items), UserRolesFromContext.Roles(HttpContext.Items)); if (!biz.PutLocaleItemDisplayText(oFromDb, inObj, oDbParent)) { return BadRequest(new ApiErrorResponse(biz.Errors)); } try { await ct.SaveChangesAsync(); } catch (DbUpdateConcurrencyException) { if (!biz.LocaleItemExists(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)); } } //Log EventLogProcessor.AddEntry(new Event(biz.userId, oDbParent.Id, AyaType.Locale, AyaEvent.Modified), ct); return Ok(new ApiOkResponse(new { ConcurrencyToken = oFromDb.ConcurrencyToken })); } /// /// Put (UpdateLocaleName) /// /// Required roles: OpsAdminFull | BizAdminFull /// /// 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.IsAuthorizedToModify(HttpContext.Items, AyaType.Locale, oFromDb.OwnerId)) { return StatusCode(401, new ApiNotAuthorizedResponse()); } //Instantiate the business object handler LocaleBiz biz = new LocaleBiz(ct, UserIdFromContext.Id(HttpContext.Items), UserRolesFromContext.Roles(HttpContext.Items)); if (!biz.PutLocaleName(oFromDb, inObj)) { return BadRequest(new ApiErrorResponse(biz.Errors)); } try { await ct.SaveChangesAsync(); } catch (DbUpdateConcurrencyException) { if (!biz.LocaleExists(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)); } } //Log EventLogProcessor.AddEntry(new Event(biz.userId, oFromDb.Id, AyaType.Locale, AyaEvent.Modified), ct); return Ok(new ApiOkResponse(new { ConcurrencyToken = oFromDb.ConcurrencyToken })); } /// /// Delete Locale /// /// Required roles: /// BizAdminFull, InventoryFull /// /// /// /// 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 = ct.Locale.Include(x => x.LocaleItems).SingleOrDefault(m => m.Id == id); if (dbObj == null) { return NotFound(new ApiErrorResponse(ApiErrorCode.NOT_FOUND)); } if (!Authorized.IsAuthorizedToDelete(HttpContext.Items, AyaType.Locale, dbObj.OwnerId)) { return StatusCode(401, new ApiNotAuthorizedResponse()); } //Instantiate the business object handler LocaleBiz biz = new LocaleBiz(ct, UserIdFromContext.Id(HttpContext.Items), UserRolesFromContext.Roles(HttpContext.Items)); if (!biz.Delete(dbObj)) { return BadRequest(new ApiErrorResponse(biz.Errors)); } await ct.SaveChangesAsync(); //Delete children / attached objects // biz.DeleteChildren(dbObj); //Log EventLogProcessor.DeleteObject(biz.userId, AyaType.Locale, dbObj.Id, dbObj.Name, ct); return NoContent(); } // private bool LocaleExists(long id) // { // return ct.Locale.Any(e => e.Id == id); // } //------------ public class LocaleSubsetParam { [System.ComponentModel.DataAnnotations.Required] public long LocaleId { get; set; } [System.ComponentModel.DataAnnotations.Required] public List Keys { get; set; } } } }