wjones
af1152b001
Refactored all C# test files to use explicit namespace declarations and moved all using directives inside the namespace block for consistency. Updated assembly info and cache files to reflect the new build. Adjusted MvcTestingAppManifest.json to use fully qualified assembly names. No functional changes; all updates are related to code style, organization, and project metadata.
58 lines
1.9 KiB
C#
58 lines
1.9 KiB
C#
// <copyright file="FlagsEnumSchemaFilter.cs" company="PlaceholderCompany">
|
|
// Copyright (c) PlaceholderCompany. All rights reserved.
|
|
// </copyright>
|
|
|
|
namespace Jellyfin.Server.Filters;
|
|
|
|
using System;
|
|
using Microsoft.OpenApi.Models;
|
|
using Swashbuckle.AspNetCore.SwaggerGen;
|
|
|
|
/// <summary>
|
|
/// Schema filter to ensure flags enums are represented correctly in OpenAPI.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// For flags enums:
|
|
/// - The enum schema definition is set to type "string" (not integer).
|
|
/// - Properties using flags enums are transformed to arrays referencing the enum schema.
|
|
/// </remarks>
|
|
public class FlagsEnumSchemaFilter : ISchemaFilter
|
|
{
|
|
/// <inheritdoc />
|
|
public void Apply(OpenApiSchema schema, SchemaFilterContext context)
|
|
{
|
|
var type = context.Type.IsEnum ? context.Type : Nullable.GetUnderlyingType(context.Type);
|
|
if (type is null || !type.IsEnum)
|
|
{
|
|
return;
|
|
}
|
|
|
|
// Check if enum has [Flags] attribute
|
|
if (!type.IsDefined(typeof(FlagsAttribute), false))
|
|
{
|
|
return;
|
|
}
|
|
|
|
if (context.MemberInfo is null)
|
|
{
|
|
// Processing the enum definition itself - ensure it's type "string" not "integer"
|
|
schema.Type = "string";
|
|
schema.Format = null;
|
|
}
|
|
else
|
|
{
|
|
// Processing a property that uses the flags enum - transform to array
|
|
// Generate the enum schema to ensure it exists in the repository
|
|
var enumSchema = context.SchemaGenerator.GenerateSchema(type, context.SchemaRepository);
|
|
|
|
// Flags enums should be represented as arrays referencing the enum schema
|
|
// since multiple values can be combined
|
|
schema.Type = "array";
|
|
schema.Format = null;
|
|
schema.Enum = null;
|
|
schema.AllOf = null;
|
|
schema.Items = enumSchema;
|
|
}
|
|
}
|
|
}
|