UserGroupController.cs

Go to the documentation of this file.

using System;
using System.Linq;
using System.Threading;
using System.Threading.Tasks;
 
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Logging;
 
using Tgstation.Server.Api;
using Tgstation.Server.Api.Models;
using Tgstation.Server.Api.Models.Request;
using Tgstation.Server.Api.Models.Response;
using Tgstation.Server.Api.Rights;
using Tgstation.Server.Host.Authority;
using Tgstation.Server.Host.Controllers.Results;
using Tgstation.Server.Host.Database;
using Tgstation.Server.Host.Models;
using Tgstation.Server.Host.Security;
using Tgstation.Server.Host.Utils;
 
namespace Tgstation.Server.Host.Controllers
{
    [Route(Routes.UserGroup)]
    public class UserGroupController : ApiController
    {
        readonly IRestAuthorityInvoker<IUserGroupAuthority> userGroupAuthority;
 
        public UserGroupController(
            IDatabaseContext databaseContext,
            IAuthenticationContext authenticationContext,
            IApiHeadersProvider apiHeaders,
            ILogger<UserGroupController> logger,
            IRestAuthorityInvoker<IUserGroupAuthority> userGroupAuthority)
            : base(
                databaseContext,
                authenticationContext,
                apiHeaders,
                logger,
                true)
        {
            this.userGroupAuthority = userGroupAuthority ?? throw new ArgumentNullException(nameof(userGroupAuthority));
        }
 
        static Models.PermissionSet? TransformApiPermissionSet(Api.Models.PermissionSet? permissionSet)
            => permissionSet != null
                ? new Models.PermissionSet
                {
                    InstanceManagerRights = permissionSet?.InstanceManagerRights,
                    AdministrationRights = permissionSet?.AdministrationRights,
                }
                : null;
 
        [HttpPut]
        [TgsAuthorize(AdministrationRights.WriteUsers)]
        [ProducesResponseType(typeof(UserGroupResponse), 201)]
        public async ValueTask<IActionResult> Create([FromBody] UserGroupCreateRequest model, CancellationToken cancellationToken)
        {
            ArgumentNullException.ThrowIfNull(model);
 
            if (model.Name == null)
                return BadRequest(new ErrorMessageResponse(ErrorCode.ModelValidationFailure));
 
            return await userGroupAuthority.InvokeTransformable<UserGroup, UserGroupResponse>(
                this,
                authority => authority.Create(
                    model.Name,
                    TransformApiPermissionSet(model.PermissionSet),
                    cancellationToken));
        }
 
        [HttpPost]
        [TgsAuthorize(AdministrationRights.WriteUsers)]
        [ProducesResponseType(typeof(UserGroupResponse), 200)]
        public ValueTask<IActionResult> Update([FromBody] UserGroupUpdateRequest model, CancellationToken cancellationToken)
        {
            ArgumentNullException.ThrowIfNull(model);
 
            return userGroupAuthority.InvokeTransformable<UserGroup, UserGroupResponse>(
                this,
                authority => authority.Update(
                    model.Require(x => x.Id),
                    model.Name,
                    TransformApiPermissionSet(model.PermissionSet),
                    cancellationToken));
        }
 
        [HttpGet("{id}")]
        [TgsRestAuthorize<IUserGroupAuthority>(nameof(IUserGroupAuthority.GetId))]
        [ProducesResponseType(typeof(UserGroupResponse), 200)]
        [ProducesResponseType(typeof(ErrorMessageResponse), 410)]
        public ValueTask<IActionResult> GetId(long id, CancellationToken cancellationToken)
            => userGroupAuthority.InvokeTransformable<UserGroup, UserGroupResponse>(this, authority => authority.GetId(id, true, cancellationToken));
 
        [HttpGet(Routes.List)]
        [TgsRestAuthorize<IUserGroupAuthority>(nameof(IUserGroupAuthority.Queryable))]
        [ProducesResponseType(typeof(PaginatedResponse<UserGroupResponse>), 200)]
        public ValueTask<IActionResult> List([FromQuery] int? page, [FromQuery] int? pageSize, CancellationToken cancellationToken)
            => Paginated<UserGroup, UserGroupResponse>(
                () => ValueTask.FromResult(
                    new PaginatableResult<UserGroup>(
                        userGroupAuthority
                            .InvokeQueryable(authority => authority.Queryable(true))
                            .OrderBy(x => x.Id))),
                null,
                page,
                pageSize,
                cancellationToken);
 
        [HttpDelete("{id}")]
        [TgsAuthorize(AdministrationRights.WriteUsers)]
        [ProducesResponseType(204)]
        [ProducesResponseType(typeof(ErrorMessageResponse), 409)]
        [ProducesResponseType(typeof(ErrorMessageResponse), 410)]
        public ValueTask<IActionResult> Delete(long id, CancellationToken cancellationToken)
#pragma warning disable API1001 // The response type is RIGHT THERE ^^^
            => userGroupAuthority.Invoke(this, authority => authority.DeleteEmpty(id, cancellationToken));
#pragma warning restore API1001
    }
}