mirror of
https://github.com/jellyfin/jellyfin.git
synced 2024-09-07 03:48:06 +02:00
216 lines
11 KiB
C#
216 lines
11 KiB
C#
using MediaBrowser.Model.Entities;
|
|
using MediaBrowser.Model.Querying;
|
|
using ServiceStack;
|
|
using System;
|
|
using System.Collections.Generic;
|
|
using System.Linq;
|
|
|
|
namespace MediaBrowser.Api.UserLibrary
|
|
{
|
|
public abstract class BaseItemsRequest : IHasDtoOptions
|
|
{
|
|
protected BaseItemsRequest()
|
|
{
|
|
EnableImages = true;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Skips over a given number of items within the results. Use for paging.
|
|
/// </summary>
|
|
/// <value>The start index.</value>
|
|
[ApiMember(Name = "StartIndex", Description = "Optional. The record index to start at. All items with a lower index will be dropped from the results.", IsRequired = false, DataType = "int", ParameterType = "query", Verb = "GET")]
|
|
public int? StartIndex { get; set; }
|
|
|
|
/// <summary>
|
|
/// The maximum number of items to return
|
|
/// </summary>
|
|
/// <value>The limit.</value>
|
|
[ApiMember(Name = "Limit", Description = "Optional. The maximum number of records to return", IsRequired = false, DataType = "int", ParameterType = "query", Verb = "GET")]
|
|
public int? Limit { get; set; }
|
|
|
|
/// <summary>
|
|
/// Whether or not to perform the query recursively
|
|
/// </summary>
|
|
/// <value><c>true</c> if recursive; otherwise, <c>false</c>.</value>
|
|
[ApiMember(Name = "Recursive", Description = "When searching within folders, this determines whether or not the search will be recursive. true/false", IsRequired = false, DataType = "boolean", ParameterType = "query", Verb = "GET")]
|
|
public bool Recursive { get; set; }
|
|
|
|
/// <summary>
|
|
/// Gets or sets the sort order.
|
|
/// </summary>
|
|
/// <value>The sort order.</value>
|
|
[ApiMember(Name = "SortOrder", Description = "Sort Order - Ascending,Descending", IsRequired = false, DataType = "string", ParameterType = "query", Verb = "GET")]
|
|
public SortOrder? SortOrder { get; set; }
|
|
|
|
/// <summary>
|
|
/// Specify this to localize the search to a specific item or folder. Omit to use the root.
|
|
/// </summary>
|
|
/// <value>The parent id.</value>
|
|
[ApiMember(Name = "ParentId", Description = "Specify this to localize the search to a specific item or folder. Omit to use the root", IsRequired = false, DataType = "string", ParameterType = "query", Verb = "GET")]
|
|
public string ParentId { get; set; }
|
|
|
|
/// <summary>
|
|
/// Fields to return within the items, in addition to basic information
|
|
/// </summary>
|
|
/// <value>The fields.</value>
|
|
[ApiMember(Name = "Fields", Description = "Optional. Specify additional fields of information to return in the output. This allows multiple, comma delimeted. Options: Budget, Chapters, CriticRatingSummary, DateCreated, Genres, HomePageUrl, IndexOptions, MediaStreams, Overview, ParentId, Path, People, ProviderIds, PrimaryImageAspectRatio, Revenue, SortName, Studios, Taglines", IsRequired = false, DataType = "string", ParameterType = "query", Verb = "GET", AllowMultiple = true)]
|
|
public string Fields { get; set; }
|
|
|
|
/// <summary>
|
|
/// Gets or sets the exclude item types.
|
|
/// </summary>
|
|
/// <value>The exclude item types.</value>
|
|
[ApiMember(Name = "ExcludeItemTypes", Description = "Optional. If specified, results will be filtered based on item type. This allows multiple, comma delimeted.", IsRequired = false, DataType = "string", ParameterType = "query", Verb = "GET", AllowMultiple = true)]
|
|
public string ExcludeItemTypes { get; set; }
|
|
|
|
/// <summary>
|
|
/// Gets or sets the include item types.
|
|
/// </summary>
|
|
/// <value>The include item types.</value>
|
|
[ApiMember(Name = "IncludeItemTypes", Description = "Optional. If specified, results will be filtered based on item type. This allows multiple, comma delimeted.", IsRequired = false, DataType = "string", ParameterType = "query", Verb = "GET", AllowMultiple = true)]
|
|
public string IncludeItemTypes { get; set; }
|
|
|
|
/// <summary>
|
|
/// Filters to apply to the results
|
|
/// </summary>
|
|
/// <value>The filters.</value>
|
|
[ApiMember(Name = "Filters", Description = "Optional. Specify additional filters to apply. This allows multiple, comma delimeted. Options: IsFolder, IsNotFolder, IsUnplayed, IsPlayed, IsFavorite, IsResumable, Likes, Dislikes", IsRequired = false, DataType = "string", ParameterType = "query", Verb = "GET", AllowMultiple = true)]
|
|
public string Filters { get; set; }
|
|
|
|
/// <summary>
|
|
/// Gets or sets the media types.
|
|
/// </summary>
|
|
/// <value>The media types.</value>
|
|
[ApiMember(Name = "MediaTypes", Description = "Optional filter by MediaType. Allows multiple, comma delimited.", IsRequired = false, DataType = "string", ParameterType = "query", Verb = "GET", AllowMultiple = true)]
|
|
public string MediaTypes { get; set; }
|
|
|
|
/// <summary>
|
|
/// Gets or sets the image types.
|
|
/// </summary>
|
|
/// <value>The image types.</value>
|
|
[ApiMember(Name = "ImageTypes", Description = "Optional. If specified, results will be filtered based on those containing image types. This allows multiple, comma delimited.", IsRequired = false, DataType = "string", ParameterType = "query", Verb = "GET", AllowMultiple = true)]
|
|
public string ImageTypes { get; set; }
|
|
|
|
/// <summary>
|
|
/// What to sort the results by
|
|
/// </summary>
|
|
/// <value>The sort by.</value>
|
|
[ApiMember(Name = "SortBy", Description = "Optional. Specify one or more sort orders, comma delimeted. Options: Album, AlbumArtist, Artist, Budget, CommunityRating, CriticRating, DateCreated, DatePlayed, PlayCount, PremiereDate, ProductionYear, SortName, Random, Revenue, Runtime", IsRequired = false, DataType = "string", ParameterType = "query", Verb = "GET", AllowMultiple = true)]
|
|
public string SortBy { get; set; }
|
|
|
|
[ApiMember(Name = "IsPlayed", Description = "Optional filter by items that are played, or not.", IsRequired = false, DataType = "bool", ParameterType = "query", Verb = "GET")]
|
|
public bool? IsPlayed { get; set; }
|
|
|
|
/// <summary>
|
|
/// Limit results to items containing specific genres
|
|
/// </summary>
|
|
/// <value>The genres.</value>
|
|
[ApiMember(Name = "Genres", Description = "Optional. If specified, results will be filtered based on genre. This allows multiple, pipe delimeted.", IsRequired = false, DataType = "string", ParameterType = "query", Verb = "GET", AllowMultiple = true)]
|
|
public string Genres { get; set; }
|
|
|
|
[ApiMember(Name = "OfficialRatings", Description = "Optional. If specified, results will be filtered based on OfficialRating. This allows multiple, pipe delimeted.", IsRequired = false, DataType = "string", ParameterType = "query", Verb = "GET", AllowMultiple = true)]
|
|
public string OfficialRatings { get; set; }
|
|
|
|
[ApiMember(Name = "Tags", Description = "Optional. If specified, results will be filtered based on tag. This allows multiple, pipe delimeted.", IsRequired = false, DataType = "string", ParameterType = "query", Verb = "GET", AllowMultiple = true)]
|
|
public string Tags { get; set; }
|
|
|
|
/// <summary>
|
|
/// Limit results to items containing specific years
|
|
/// </summary>
|
|
/// <value>The years.</value>
|
|
[ApiMember(Name = "Years", Description = "Optional. If specified, results will be filtered based on production year. This allows multiple, comma delimeted.", IsRequired = false, DataType = "string", ParameterType = "query", Verb = "GET", AllowMultiple = true)]
|
|
public string Years { get; set; }
|
|
|
|
[ApiMember(Name = "EnableImages", Description = "Optional, include image information in output", IsRequired = false, DataType = "boolean", ParameterType = "query", Verb = "GET")]
|
|
public bool? EnableImages { get; set; }
|
|
|
|
[ApiMember(Name = "ImageTypeLimit", Description = "Optional, the max number of images to return, per image type", IsRequired = false, DataType = "int", ParameterType = "query", Verb = "GET")]
|
|
public int? ImageTypeLimit { get; set; }
|
|
|
|
[ApiMember(Name = "EnableImageTypes", Description = "Optional. The image types to include in the output.", IsRequired = false, DataType = "string", ParameterType = "query", Verb = "GET")]
|
|
public string EnableImageTypes { get; set; }
|
|
|
|
public string[] GetGenres()
|
|
{
|
|
return (Genres ?? string.Empty).Split(new[] { '|' }, StringSplitOptions.RemoveEmptyEntries);
|
|
}
|
|
|
|
public string[] GetTags()
|
|
{
|
|
return (Tags ?? string.Empty).Split(new[] { '|' }, StringSplitOptions.RemoveEmptyEntries);
|
|
}
|
|
|
|
public string[] GetOfficialRatings()
|
|
{
|
|
return (OfficialRatings ?? string.Empty).Split(new[] { '|' }, StringSplitOptions.RemoveEmptyEntries);
|
|
}
|
|
|
|
public string[] GetMediaTypes()
|
|
{
|
|
return (MediaTypes ?? string.Empty).Split(new[] { ',' }, StringSplitOptions.RemoveEmptyEntries);
|
|
}
|
|
|
|
public string[] GetIncludeItemTypes()
|
|
{
|
|
return (IncludeItemTypes ?? string.Empty).Split(new[] { ',' }, StringSplitOptions.RemoveEmptyEntries);
|
|
}
|
|
|
|
public string[] GetExcludeItemTypes()
|
|
{
|
|
return (ExcludeItemTypes ?? string.Empty).Split(new[] { ',' }, StringSplitOptions.RemoveEmptyEntries);
|
|
}
|
|
|
|
public int[] GetYears()
|
|
{
|
|
return (Years ?? string.Empty).Split(new[] { ',' }, StringSplitOptions.RemoveEmptyEntries).Select(int.Parse).ToArray();
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the filters.
|
|
/// </summary>
|
|
/// <returns>IEnumerable{ItemFilter}.</returns>
|
|
public IEnumerable<ItemFilter> GetFilters()
|
|
{
|
|
var val = Filters;
|
|
|
|
if (string.IsNullOrEmpty(val))
|
|
{
|
|
return new ItemFilter[] { };
|
|
}
|
|
|
|
return val.Split(',').Select(v => (ItemFilter)Enum.Parse(typeof(ItemFilter), v, true));
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the image types.
|
|
/// </summary>
|
|
/// <returns>IEnumerable{ImageType}.</returns>
|
|
public IEnumerable<ImageType> GetImageTypes()
|
|
{
|
|
var val = ImageTypes;
|
|
|
|
if (string.IsNullOrEmpty(val))
|
|
{
|
|
return new ImageType[] { };
|
|
}
|
|
|
|
return val.Split(',').Select(v => (ImageType)Enum.Parse(typeof(ImageType), v, true));
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the order by.
|
|
/// </summary>
|
|
/// <returns>IEnumerable{ItemSortBy}.</returns>
|
|
public string[] GetOrderBy()
|
|
{
|
|
var val = SortBy;
|
|
|
|
if (string.IsNullOrEmpty(val))
|
|
{
|
|
return new string[] { };
|
|
}
|
|
|
|
return val.Split(',');
|
|
}
|
|
}
|
|
}
|