| | 1 | | using Microsoft.OpenApi.Any; |
| | 2 | | using Microsoft.OpenApi.Interfaces; |
| | 3 | | using Microsoft.OpenApi.Models; |
| | 4 | | using Plainquire.Filter.Abstractions; |
| | 5 | | using Plainquire.Sort.Swashbuckle.Models; |
| | 6 | | using System; |
| | 7 | | using System.Collections.Generic; |
| | 8 | | using System.Linq; |
| | 9 | | using System.Reflection; |
| | 10 | | using System.Text.RegularExpressions; |
| | 11 | |
|
| | 12 | | namespace Plainquire.Sort.Swashbuckle; |
| | 13 | |
|
| | 14 | | /// <summary> |
| | 15 | | /// Extension methods for <see cref="OpenApiOperation"/>. |
| | 16 | | /// </summary> |
| | 17 | | public static class OpenApiOperationExtensions |
| | 18 | | { |
| | 19 | | private const string ENTITY_SORT_EXTENSION = "x-entity-sort"; |
| | 20 | | private const string ENTITY_DELETE_EXTENSION = "x-entity-sort-delete"; |
| | 21 | |
|
| | 22 | | /// <summary> |
| | 23 | | /// Replaces <see cref="EntitySort{TEntity}"/> and with the sort parameters. |
| | 24 | | /// </summary> |
| | 25 | | /// <param name="operation">The <see cref="OpenApiOperation"/> to operate on.</param> |
| | 26 | | /// <param name="parametersToReplace">The parameters to replace.</param> |
| | 27 | | public static void ReplaceSortParameters(this OpenApiOperation operation, IList<SortParameterReplacement> parameters |
| | 28 | | { |
| 58 | 29 | | MarkExistingParametersForDeletion(parametersToReplace); |
| | 30 | |
|
| 58 | 31 | | var httpQueryParameterGroup = GroupByHttpQueryParameterName(parametersToReplace); |
| 198 | 32 | | foreach (var (queryParameter, parameters) in httpQueryParameterGroup) |
| | 33 | | { |
| 41 | 34 | | var (prefixes, postfixes, primaryAscendingPostfix, primaryDescendingPostfix) = GetSortPrefixes(parameters); |
| 41 | 35 | | var allowedPropertyNamePattern = CreatePropertyNamePattern(parameters, prefixes, postfixes); |
| | 36 | |
|
| 41 | 37 | | var openApiParameter = new OpenApiParameter |
| 41 | 38 | | { |
| 41 | 39 | | Name = queryParameter, |
| 41 | 40 | | Description = $"Sorts the result by the given property in ascending ({primaryAscendingPostfix}) or desce |
| 41 | 41 | | Schema = new OpenApiSchema |
| 41 | 42 | | { |
| 41 | 43 | | Type = "array", |
| 41 | 44 | | Items = new OpenApiSchema |
| 41 | 45 | | { |
| 41 | 46 | | Type = "string", |
| 41 | 47 | | Example = new OpenApiString(string.Empty), |
| 41 | 48 | | Pattern = allowedPropertyNamePattern |
| 41 | 49 | | }, |
| 41 | 50 | | }, |
| 41 | 51 | | In = ParameterLocation.Query, |
| 41 | 52 | | Extensions = new Dictionary<string, IOpenApiExtension>(StringComparer.Ordinal) |
| 41 | 53 | | { |
| 41 | 54 | | [ENTITY_SORT_EXTENSION] = new OpenApiBoolean(true) |
| 41 | 55 | | } |
| 41 | 56 | | }; |
| | 57 | |
|
| 41 | 58 | | var insertionIndex = operation.Parameters.IndexOf(parameters[0].OpenApiParameter); |
| 41 | 59 | | operation.Parameters.Insert(insertionIndex, openApiParameter); |
| | 60 | | } |
| | 61 | |
|
| 58 | 62 | | RemoveParametersMarkedForDeletion(operation); |
| 58 | 63 | | } |
| | 64 | |
|
| | 65 | | private static Dictionary<string, List<SortParameterReplacement>> GroupByHttpQueryParameterName(IList<SortParameterR |
| 58 | 66 | | => parametersToReplace |
| 58 | 67 | | .GroupBy(parameter => |
| 58 | 68 | | { |
| 58 | 69 | | var bindingParameterName = parameter.OpenApiDescription.ParameterDescriptor.BindingInfo?.BinderModelName |
| 58 | 70 | | var actionParameterName = parameter.OpenApiDescription.ParameterDescriptor.Name; |
| 58 | 71 | | return bindingParameterName ?? actionParameterName; |
| 58 | 72 | | }, StringComparer.Ordinal) |
| 58 | 73 | | .ToDictionary( |
| 58 | 74 | | group => group.Key, |
| 58 | 75 | | group => group.ToList(), |
| 58 | 76 | | StringComparer.Ordinal |
| 58 | 77 | | ); |
| | 78 | |
|
| | 79 | | private static void MarkExistingParametersForDeletion(IList<SortParameterReplacement> parameters) |
| | 80 | | { |
| 266 | 81 | | foreach (var parameter in parameters) |
| 75 | 82 | | parameter.OpenApiParameter.Extensions.TryAdd(ENTITY_DELETE_EXTENSION, new OpenApiBoolean(true)); |
| 58 | 83 | | } |
| | 84 | |
|
| | 85 | | private static void RemoveParametersMarkedForDeletion(OpenApiOperation operation) |
| | 86 | | { |
| 58 | 87 | | var parametersToRemove = operation.Parameters |
| 58 | 88 | | .Where(parameter => parameter.Extensions.ContainsKey(ENTITY_DELETE_EXTENSION)) |
| 58 | 89 | | .ToList(); |
| | 90 | |
|
| 246 | 91 | | foreach (var parameter in parametersToRemove) |
| 65 | 92 | | operation.Parameters.Remove(parameter); |
| 58 | 93 | | } |
| | 94 | |
|
| | 95 | | private static (List<string>, List<string>, string, string) GetSortPrefixes(IReadOnlyCollection<SortParameterReplace |
| | 96 | | { |
| 41 | 97 | | var ascendingPrefixes = parameters.Select(parameter => parameter.Configuration.AscendingPrefixes).SelectMany(x = |
| 41 | 98 | | var descendingPrefixes = parameters.Select(parameter => parameter.Configuration.DescendingPrefixes).SelectMany(x |
| 41 | 99 | | var ascendingPostfixes = parameters.Select(parameter => parameter.Configuration.AscendingPostfixes).SelectMany(x |
| 41 | 100 | | var descendingPostfixes = parameters.Select(parameter => parameter.Configuration.DescendingPostfixes).SelectMany |
| | 101 | |
|
| 41 | 102 | | var prefixes = ascendingPrefixes.Concat(descendingPrefixes).Distinct(StringComparer.OrdinalIgnoreCase).Select(Re |
| 41 | 103 | | var postfixes = ascendingPostfixes.Concat(descendingPostfixes).Distinct(StringComparer.OrdinalIgnoreCase).Select |
| | 104 | |
|
| 41 | 105 | | var primaryAscendingPostfix = ascendingPostfixes[0]; |
| 41 | 106 | | var primaryDescendingPostfix = descendingPostfixes[0]; |
| | 107 | |
|
| 41 | 108 | | return (prefixes, postfixes, primaryAscendingPostfix, primaryDescendingPostfix); |
| | 109 | | } |
| | 110 | |
|
| | 111 | | private static string CreatePropertyNamePattern(IEnumerable<SortParameterReplacement> parameters, IEnumerable<string |
| | 112 | | { |
| 41 | 113 | | var sortablePropertyNames = GetSortablePropertyNames(parameters); |
| | 114 | |
|
| 41 | 115 | | var allowedPropertyNamePattern = $"^({string.Join("|", prefixes)})?({string.Join("|", sortablePropertyNames)})(\ |
| 41 | 116 | | return allowedPropertyNamePattern; |
| | 117 | | } |
| | 118 | |
|
| | 119 | | private static List<string> GetSortablePropertyNames(IEnumerable<SortParameterReplacement> parameters) |
| 41 | 120 | | => parameters |
| 41 | 121 | | .Select(parameter => parameter.SortedType) |
| 41 | 122 | | .SelectMany(sortedType => sortedType.GetSortPropertyNames()) |
| 41 | 123 | | .Distinct(StringComparer.Ordinal) |
| 41 | 124 | | .Select(Regex.Escape) |
| 41 | 125 | | .ToList(); |
| | 126 | |
|
| | 127 | | private static List<string> GetSortPropertyNames(this Type sortedType) |
| | 128 | | { |
| 75 | 129 | | var entityFilterAttribute = sortedType.GetCustomAttribute<EntityFilterAttribute>(); |
| | 130 | |
|
| 75 | 131 | | var sortableProperties = sortedType |
| 75 | 132 | | .GetSortableProperties() |
| 75 | 133 | | .Select(property => property.GetSortParameterName(entityFilterAttribute?.Prefix)) |
| 75 | 134 | | .ToList(); |
| | 135 | |
|
| 75 | 136 | | return sortableProperties; |
| | 137 | | } |
| | 138 | | } |