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();
    }
}