jellyfin/Jellyfin.Api/Controllers/ItemRefreshController.cs

using System;
using System.ComponentModel;
using System.ComponentModel.DataAnnotations;
using Jellyfin.Api.Constants;
using MediaBrowser.Controller.Library;
using MediaBrowser.Controller.Providers;
using MediaBrowser.Model.IO;
using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;

namespace Jellyfin.Api.Controllers
{
    /// <summary>
    /// Item Refresh Controller.
    /// </summary>
    [Route("Items")]
    [Authorize(Policy = Policies.RequiresElevation)]
    public class ItemRefreshController : BaseJellyfinApiController
    {
        private readonly ILibraryManager _libraryManager;
        private readonly IProviderManager _providerManager;
        private readonly IFileSystem _fileSystem;

        /// <summary>
        /// Initializes a new instance of the <see cref="ItemRefreshController"/> class.
        /// </summary>
        /// <param name="libraryManager">Instance of <see cref="ILibraryManager"/> interface.</param>
        /// <param name="providerManager">Instance of <see cref="IProviderManager"/> interface.</param>
        /// <param name="fileSystem">Instance of <see cref="IFileSystem"/> interface.</param>
        public ItemRefreshController(
            ILibraryManager libraryManager,
            IProviderManager providerManager,
            IFileSystem fileSystem)
        {
            _libraryManager = libraryManager;
            _providerManager = providerManager;
            _fileSystem = fileSystem;
        }

        /// <summary>
        /// Refreshes metadata for an item.
        /// </summary>
        /// <param name="itemId">Item id.</param>
        /// <param name="metadataRefreshMode">(Optional) Specifies the metadata refresh mode.</param>
        /// <param name="imageRefreshMode">(Optional) Specifies the image refresh mode.</param>
        /// <param name="replaceAllMetadata">(Optional) Determines if metadata should be replaced. Only applicable if mode is FullRefresh.</param>
        /// <param name="replaceAllImages">(Optional) Determines if images should be replaced. Only applicable if mode is FullRefresh.</param>
        /// <response code="204">Item metadata refresh queued.</response>
        /// <response code="404">Item to refresh not found.</response>
        /// <returns>An <see cref="NoContentResult"/> on success, or a <see cref="NotFoundResult"/> if the item could not be found.</returns>
        [HttpPost("{itemId}/Refresh")]
        [Description("Refreshes metadata for an item.")]
        [ProducesResponseType(StatusCodes.Status204NoContent)]
        [ProducesResponseType(StatusCodes.Status404NotFound)]
        public ActionResult RefreshItem(
            [FromRoute, Required] Guid itemId,
            [FromQuery] MetadataRefreshMode metadataRefreshMode = MetadataRefreshMode.None,
            [FromQuery] MetadataRefreshMode imageRefreshMode = MetadataRefreshMode.None,
            [FromQuery] bool replaceAllMetadata = false,
            [FromQuery] bool replaceAllImages = false)
        {
            var item = _libraryManager.GetItemById(itemId);
            if (item == null)
            {
                return NotFound();
            }

            var refreshOptions = new MetadataRefreshOptions(new DirectoryService(_fileSystem))
            {
                MetadataRefreshMode = metadataRefreshMode,
                ImageRefreshMode = imageRefreshMode,
                ReplaceAllImages = replaceAllImages,
                ReplaceAllMetadata = replaceAllMetadata,
                ForceSave = metadataRefreshMode == MetadataRefreshMode.FullRefresh
                    || imageRefreshMode == MetadataRefreshMode.FullRefresh
                    || replaceAllImages
                    || replaceAllMetadata,
                IsAutomated = false
            };

            _providerManager.QueueRefresh(item.Id, refreshOptions, RefreshPriority.High);
            return NoContent();
        }
    }
}