Umbraco-CMS/src/Umbraco.Web.BackOffice/Controllers/TrackedReferencesController.cs

using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Mvc;
using Umbraco.Cms.Core;
using Umbraco.Cms.Core.Models;
using Umbraco.Cms.Core.Services;
using Umbraco.Cms.Web.BackOffice.ModelBinders;
using Umbraco.Cms.Web.Common.Attributes;
using Umbraco.Cms.Web.Common.Authorization;

namespace Umbraco.Cms.Web.BackOffice.Controllers
{
    [PluginController(Constants.Web.Mvc.BackOfficeApiArea)]
    [Authorize(Policy = AuthorizationPolicies.SectionAccessContentOrMedia)]
    public class TrackedReferencesController : BackOfficeNotificationsController
    {
        private readonly ITrackedReferencesService _relationService;

        public TrackedReferencesController(ITrackedReferencesService relationService)
        {
            _relationService = relationService;
        }

        /// <summary>
        /// Gets a page list of tracked references for the current item, so you can see where an item is being used.
        /// </summary>
        /// <remarks>
        /// Used by info tabs on content, media etc. and for the delete and unpublish of single items.
        /// This is basically finding parents of relations.
        /// </remarks>
        public ActionResult<PagedResult<RelationItem>> GetPagedReferences(int id, int pageNumber = 1, int pageSize = 100, bool filterMustBeIsDependency = false)
        {
            if (pageNumber <= 0 || pageSize <= 0)
            {
                return BadRequest("Both pageNumber and pageSize must be greater than zero");
            }

            return _relationService.GetPagedRelationsForItem(id, pageNumber - 1, pageSize, filterMustBeIsDependency);
        }

        /// <summary>
        /// Gets a page list of the child nodes of the current item used in any kind of relation.
        /// </summary>
        /// <remarks>
        /// Used when deleting and unpublishing a single item to check if this item has any descending items that are in any kind of relation.
        /// This is basically finding the descending items which are children in relations.
        /// </remarks>
        public ActionResult<PagedResult<RelationItem>> GetPagedDescendantsInReferences(int parentId, int pageNumber = 1, int pageSize = 100, bool filterMustBeIsDependency = true)
        {
            if (pageNumber <= 0 || pageSize <= 0)
            {
                return BadRequest("Both pageNumber and pageSize must be greater than zero");
            }

            return _relationService.GetPagedDescendantsInReferences(parentId, pageNumber - 1, pageSize, filterMustBeIsDependency);
        }

        /// <summary>
        /// Gets a page list of the items used in any kind of relation from selected integer ids.
        /// </summary>
        /// <remarks>
        /// Used when bulk deleting content/media and bulk unpublishing content (delete and unpublish on List view).
        /// This is basically finding children of relations.
        /// </remarks>
        [HttpGet]
        [HttpPost]
        public ActionResult<PagedResult<RelationItem>> GetPagedReferencedItems([FromJsonPath] int[] ids, int pageNumber = 1, int pageSize = 100, bool filterMustBeIsDependency = true)
        {
            if (pageNumber <= 0 || pageSize <= 0)
            {
                return BadRequest("Both pageNumber and pageSize must be greater than zero");
            }

            return _relationService.GetPagedItemsWithRelations(ids, pageNumber - 1, pageSize, filterMustBeIsDependency);
        }
    }
}