mirror of
https://github.com/jellyfin/jellyfin.git
synced 2024-09-07 03:48:06 +02:00
177 lines
6.3 KiB
C#
177 lines
6.3 KiB
C#
using System;
|
|
using System.Collections.Generic;
|
|
using System.Linq;
|
|
using System.Net;
|
|
using Jellyfin.Data.Enums;
|
|
using MediaBrowser.Common.Extensions;
|
|
using MediaBrowser.Controller.Net;
|
|
using MediaBrowser.Controller.Session;
|
|
using MediaBrowser.Model.Querying;
|
|
using Microsoft.AspNetCore.Http;
|
|
|
|
namespace Jellyfin.Api.Helpers
|
|
{
|
|
/// <summary>
|
|
/// Request Extensions.
|
|
/// </summary>
|
|
public static class RequestHelpers
|
|
{
|
|
/// <summary>
|
|
/// Get Order By.
|
|
/// </summary>
|
|
/// <param name="sortBy">Sort By. Comma delimited string.</param>
|
|
/// <param name="requestedSortOrder">Sort Order. Comma delimited string.</param>
|
|
/// <returns>Order By.</returns>
|
|
public static ValueTuple<string, SortOrder>[] GetOrderBy(string? sortBy, string? requestedSortOrder)
|
|
{
|
|
var val = sortBy;
|
|
|
|
if (string.IsNullOrEmpty(val))
|
|
{
|
|
return Array.Empty<ValueTuple<string, SortOrder>>();
|
|
}
|
|
|
|
var vals = val.Split(',');
|
|
if (string.IsNullOrWhiteSpace(requestedSortOrder))
|
|
{
|
|
requestedSortOrder = "Ascending";
|
|
}
|
|
|
|
var sortOrders = requestedSortOrder.Split(',');
|
|
|
|
var result = new ValueTuple<string, SortOrder>[vals.Length];
|
|
|
|
for (var i = 0; i < vals.Length; i++)
|
|
{
|
|
var sortOrderIndex = sortOrders.Length > i ? i : 0;
|
|
|
|
var sortOrderValue = sortOrders.Length > sortOrderIndex ? sortOrders[sortOrderIndex] : null;
|
|
var sortOrder = string.Equals(sortOrderValue, "Descending", StringComparison.OrdinalIgnoreCase)
|
|
? SortOrder.Descending
|
|
: SortOrder.Ascending;
|
|
|
|
result[i] = new ValueTuple<string, SortOrder>(vals[i], sortOrder);
|
|
}
|
|
|
|
return result;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Get parsed filters.
|
|
/// </summary>
|
|
/// <param name="filters">The filters.</param>
|
|
/// <returns>Item filters.</returns>
|
|
public static IEnumerable<ItemFilter> GetFilters(string? filters)
|
|
{
|
|
return string.IsNullOrEmpty(filters)
|
|
? Array.Empty<ItemFilter>()
|
|
: filters.Split(',').Select(v => Enum.Parse<ItemFilter>(v, true));
|
|
}
|
|
|
|
/// <summary>
|
|
/// Splits a string at a separating character into an array of substrings.
|
|
/// </summary>
|
|
/// <param name="value">The string to split.</param>
|
|
/// <param name="separator">The char that separates the substrings.</param>
|
|
/// <param name="removeEmpty">Option to remove empty substrings from the array.</param>
|
|
/// <returns>An array of the substrings.</returns>
|
|
internal static string[] Split(string? value, char separator, bool removeEmpty)
|
|
{
|
|
if (string.IsNullOrWhiteSpace(value))
|
|
{
|
|
return Array.Empty<string>();
|
|
}
|
|
|
|
return removeEmpty
|
|
? value.Split(new[] { separator }, StringSplitOptions.RemoveEmptyEntries)
|
|
: value.Split(separator);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Checks if the user can update an entry.
|
|
/// </summary>
|
|
/// <param name="authContext">Instance of the <see cref="IAuthorizationContext"/> interface.</param>
|
|
/// <param name="requestContext">The <see cref="HttpRequest"/>.</param>
|
|
/// <param name="userId">The user id.</param>
|
|
/// <param name="restrictUserPreferences">Whether to restrict the user preferences.</param>
|
|
/// <returns>A <see cref="bool"/> whether the user can update the entry.</returns>
|
|
internal static bool AssertCanUpdateUser(IAuthorizationContext authContext, HttpRequest requestContext, Guid userId, bool restrictUserPreferences)
|
|
{
|
|
var auth = authContext.GetAuthorizationInfo(requestContext);
|
|
|
|
var authenticatedUser = auth.User;
|
|
|
|
// If they're going to update the record of another user, they must be an administrator
|
|
if ((!userId.Equals(auth.UserId) && !authenticatedUser.HasPermission(PermissionKind.IsAdministrator))
|
|
|| (restrictUserPreferences && !authenticatedUser.EnableUserPreferenceAccess))
|
|
{
|
|
return false;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
internal static SessionInfo GetSession(ISessionManager sessionManager, IAuthorizationContext authContext, HttpRequest request)
|
|
{
|
|
var authorization = authContext.GetAuthorizationInfo(request);
|
|
var user = authorization.User;
|
|
var session = sessionManager.LogSessionActivity(
|
|
authorization.Client,
|
|
authorization.Version,
|
|
authorization.DeviceId,
|
|
authorization.Device,
|
|
request.HttpContext.GetNormalizedRemoteIp(),
|
|
user);
|
|
|
|
if (session == null)
|
|
{
|
|
throw new ArgumentException("Session not found.");
|
|
}
|
|
|
|
return session;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Get Guid array from string.
|
|
/// </summary>
|
|
/// <param name="value">String value.</param>
|
|
/// <returns>Guid array.</returns>
|
|
internal static Guid[] GetGuids(string? value)
|
|
{
|
|
if (value == null)
|
|
{
|
|
return Array.Empty<Guid>();
|
|
}
|
|
|
|
return Split(value, ',', true)
|
|
.Select(i => new Guid(i))
|
|
.ToArray();
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the item fields.
|
|
/// </summary>
|
|
/// <param name="fields">The fields string.</param>
|
|
/// <returns>IEnumerable{ItemFields}.</returns>
|
|
internal static ItemFields[] GetItemFields(string? fields)
|
|
{
|
|
if (string.IsNullOrEmpty(fields))
|
|
{
|
|
return Array.Empty<ItemFields>();
|
|
}
|
|
|
|
return Split(fields, ',', true)
|
|
.Select(v =>
|
|
{
|
|
if (Enum.TryParse(v, true, out ItemFields value))
|
|
{
|
|
return (ItemFields?)value;
|
|
}
|
|
|
|
return null;
|
|
}).Where(i => i.HasValue)
|
|
.Select(i => i!.Value)
|
|
.ToArray();
|
|
}
|
|
}
|
|
}
|