aboutsummaryrefslogtreecommitdiff
path: root/Jellyfin.Api/BaseJellyfinApiController.cs
blob: 0c63d24b70c5665e391f730df4c7d5012542e54c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
using System.Collections.Generic;
using System.Net.Mime;
using Jellyfin.Api.Results;
using Jellyfin.Extensions.Json;
using Microsoft.AspNetCore.Mvc;

namespace Jellyfin.Api
{
    /// <summary>
    /// Base api controller for the API setting a default route.
    /// </summary>
    [ApiController]
    [Route("[controller]")]
    [Produces(
        MediaTypeNames.Application.Json,
        JsonDefaults.CamelCaseMediaType,
        JsonDefaults.PascalCaseMediaType)]
    public class BaseJellyfinApiController : ControllerBase
    {
        /// <summary>
        /// Create a new <see cref="OkResult{T}"/>.
        /// </summary>
        /// <param name="value">The value to return.</param>
        /// <typeparam name="T">The type to return.</typeparam>
        /// <returns>The <see cref="ActionResult{T}"/>.</returns>
        protected ActionResult<IEnumerable<T>> Ok<T>(List<T> value)
            => new OkResult<IEnumerable<T>>(value);

        /// <summary>
        /// Create a new <see cref="OkResult{T}"/>.
        /// </summary>
        /// <param name="value">The value to return.</param>
        /// <typeparam name="T">The type to return.</typeparam>
        /// <returns>The <see cref="ActionResult{T}"/>.</returns>
        protected ActionResult<IEnumerable<T>> Ok<T>(IReadOnlyList<T> value)
            => new OkResult<IEnumerable<T>>(value);

        /// <summary>
        /// Create a new <see cref="OkResult{T}"/>.
        /// </summary>
        /// <param name="value">The value to return.</param>
        /// <typeparam name="T">The type to return.</typeparam>
        /// <returns>The <see cref="ActionResult{T}"/>.</returns>
        protected ActionResult<IEnumerable<T>> Ok<T>(IEnumerable<T>? value)
            => new OkResult<IEnumerable<T>?>(value);

        /// <summary>
        /// Create a new <see cref="OkResult{T}"/>.
        /// </summary>
        /// <param name="value">The value to return.</param>
        /// <typeparam name="T">The type to return.</typeparam>
        /// <returns>The <see cref="ActionResult{T}"/>.</returns>
        protected ActionResult<T> Ok<T>(T value)
            => new OkResult<T>(value);
    }
}