jellyfin/Jellyfin.Api/Controllers/DlnaController.cs

using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using Jellyfin.Api.Constants;
using MediaBrowser.Controller.Dlna;
using MediaBrowser.Model.Dlna;
using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;

namespace Jellyfin.Api.Controllers
{
    /// <summary>
    /// Dlna Controller.
    /// </summary>
    [Authorize(Policy = Policies.RequiresElevation)]
    public class DlnaController : BaseJellyfinApiController
    {
        private readonly IDlnaManager _dlnaManager;

        /// <summary>
        /// Initializes a new instance of the <see cref="DlnaController"/> class.
        /// </summary>
        /// <param name="dlnaManager">Instance of the <see cref="IDlnaManager"/> interface.</param>
        public DlnaController(IDlnaManager dlnaManager)
        {
            _dlnaManager = dlnaManager;
        }

        /// <summary>
        /// Get profile infos.
        /// </summary>
        /// <response code="200">Device profile infos returned.</response>
        /// <returns>An <see cref="OkResult"/> containing the device profile infos.</returns>
        [HttpGet("ProfileInfos")]
        [ProducesResponseType(StatusCodes.Status200OK)]
        public ActionResult<IEnumerable<DeviceProfileInfo>> GetProfileInfos()
        {
            return Ok(_dlnaManager.GetProfileInfos());
        }

        /// <summary>
        /// Gets the default profile.
        /// </summary>
        /// <response code="200">Default device profile returned.</response>
        /// <returns>An <see cref="OkResult"/> containing the default profile.</returns>
        [HttpGet("Profiles/Default")]
        [ProducesResponseType(StatusCodes.Status200OK)]
        public ActionResult<DeviceProfile> GetDefaultProfile()
        {
            return _dlnaManager.GetDefaultProfile();
        }

        /// <summary>
        /// Gets a single profile.
        /// </summary>
        /// <param name="profileId">Profile Id.</param>
        /// <response code="200">Device profile returned.</response>
        /// <response code="404">Device profile not found.</response>
        /// <returns>An <see cref="OkResult"/> containing the profile on success, or a <see cref="NotFoundResult"/> if device profile not found.</returns>
        [HttpGet("Profiles/{profileId}")]
        [ProducesResponseType(StatusCodes.Status200OK)]
        [ProducesResponseType(StatusCodes.Status404NotFound)]
        public ActionResult<DeviceProfile> GetProfile([FromRoute, Required] string profileId)
        {
            var profile = _dlnaManager.GetProfile(profileId);
            if (profile is null)
            {
                return NotFound();
            }

            return profile;
        }

        /// <summary>
        /// Deletes a profile.
        /// </summary>
        /// <param name="profileId">Profile id.</param>
        /// <response code="204">Device profile deleted.</response>
        /// <response code="404">Device profile not found.</response>
        /// <returns>A <see cref="NoContentResult"/> on success, or a <see cref="NotFoundResult"/> if profile not found.</returns>
        [HttpDelete("Profiles/{profileId}")]
        [ProducesResponseType(StatusCodes.Status204NoContent)]
        [ProducesResponseType(StatusCodes.Status404NotFound)]
        public ActionResult DeleteProfile([FromRoute, Required] string profileId)
        {
            var existingDeviceProfile = _dlnaManager.GetProfile(profileId);
            if (existingDeviceProfile is null)
            {
                return NotFound();
            }

            _dlnaManager.DeleteProfile(profileId);
            return NoContent();
        }

        /// <summary>
        /// Creates a profile.
        /// </summary>
        /// <param name="deviceProfile">Device profile.</param>
        /// <response code="204">Device profile created.</response>
        /// <returns>A <see cref="NoContentResult"/>.</returns>
        [HttpPost("Profiles")]
        [ProducesResponseType(StatusCodes.Status204NoContent)]
        public ActionResult CreateProfile([FromBody] DeviceProfile deviceProfile)
        {
            _dlnaManager.CreateProfile(deviceProfile);
            return NoContent();
        }

        /// <summary>
        /// Updates a profile.
        /// </summary>
        /// <param name="profileId">Profile id.</param>
        /// <param name="deviceProfile">Device profile.</param>
        /// <response code="204">Device profile updated.</response>
        /// <response code="404">Device profile not found.</response>
        /// <returns>A <see cref="NoContentResult"/> on success, or a <see cref="NotFoundResult"/> if profile not found.</returns>
        [HttpPost("Profiles/{profileId}")]
        [ProducesResponseType(StatusCodes.Status204NoContent)]
        [ProducesResponseType(StatusCodes.Status404NotFound)]
        public ActionResult UpdateProfile([FromRoute, Required] string profileId, [FromBody] DeviceProfile deviceProfile)
        {
            var existingDeviceProfile = _dlnaManager.GetProfile(profileId);
            if (existingDeviceProfile is null)
            {
                return NotFound();
            }

            _dlnaManager.UpdateProfile(profileId, deviceProfile);
            return NoContent();
        }
    }
}