* Add support for operation descriptions and update tests * Update tests for Entityset paths operations descriptions * Code cleanup * Update test OpenAPI output files. Co-authored-by: Irvine Sunday <irochand@microsoft.com>
105 lines
3.7 KiB
C#
105 lines
3.7 KiB
C#
// ------------------------------------------------------------
|
|
// Copyright (c) Microsoft Corporation. All rights reserved.
|
|
// Licensed under the MIT License (MIT). See LICENSE in the repo root for license information.
|
|
// ------------------------------------------------------------
|
|
|
|
using System.Linq;
|
|
using Microsoft.OData.Edm;
|
|
using Microsoft.OpenApi.Models;
|
|
using Microsoft.OpenApi.OData.Common;
|
|
using Microsoft.OpenApi.OData.Edm;
|
|
using Microsoft.OpenApi.OData.Generator;
|
|
using Microsoft.OpenApi.OData.Vocabulary.Capabilities;
|
|
|
|
namespace Microsoft.OpenApi.OData.Operation
|
|
{
|
|
/// <summary>
|
|
/// Delete an Entity
|
|
/// The Path Item Object for the entity set contains the keyword delete with an Operation Object as value
|
|
/// that describes the capabilities for deleting the entity.
|
|
/// </summary>
|
|
internal class EntityDeleteOperationHandler : EntitySetOperationHandler
|
|
{
|
|
/// <inheritdoc/>
|
|
public override OperationType OperationType => OperationType.Delete;
|
|
|
|
/// <inheritdoc/>
|
|
protected override void SetBasicInfo(OpenApiOperation operation)
|
|
{
|
|
// Summary
|
|
operation.Summary = "Delete entity from " + EntitySet.Name;
|
|
|
|
IEdmEntityType entityType = EntitySet.EntityType();
|
|
|
|
// Description
|
|
operation.Description = Context.Model.GetDescriptionAnnotation(entityType);
|
|
|
|
// OperationId
|
|
if (Context.Settings.EnableOperationId)
|
|
{
|
|
string typeName = entityType.Name;
|
|
operation.OperationId = EntitySet.Name + "." + typeName + ".Delete" + Utils.UpperFirstChar(typeName);
|
|
}
|
|
}
|
|
|
|
/// <inheritdoc/>
|
|
protected override void SetParameters(OpenApiOperation operation)
|
|
{
|
|
base.SetParameters(operation);
|
|
|
|
operation.Parameters.Add(new OpenApiParameter
|
|
{
|
|
Name = "If-Match",
|
|
In = ParameterLocation.Header,
|
|
Description = "ETag",
|
|
Schema = new OpenApiSchema
|
|
{
|
|
Type = "string"
|
|
}
|
|
});
|
|
}
|
|
|
|
/// <inheritdoc/>
|
|
protected override void SetResponses(OpenApiOperation operation)
|
|
{
|
|
operation.Responses = new OpenApiResponses
|
|
{
|
|
{ Constants.StatusCode204, Constants.StatusCode204.GetResponse() },
|
|
{ Constants.StatusCodeDefault, Constants.StatusCodeDefault.GetResponse() }
|
|
};
|
|
|
|
base.SetResponses(operation);
|
|
}
|
|
|
|
protected override void SetSecurity(OpenApiOperation operation)
|
|
{
|
|
DeleteRestrictionsType delete = Context.Model.GetRecord<DeleteRestrictionsType>(EntitySet, CapabilitiesConstants.DeleteRestrictions);
|
|
if (delete == null || delete.Permissions == null)
|
|
{
|
|
return;
|
|
}
|
|
|
|
operation.Security = Context.CreateSecurityRequirements(delete.Permissions).ToList();
|
|
}
|
|
|
|
protected override void AppendCustomParameters(OpenApiOperation operation)
|
|
{
|
|
DeleteRestrictionsType delete = Context.Model.GetRecord< DeleteRestrictionsType>(EntitySet, CapabilitiesConstants.DeleteRestrictions);
|
|
if (delete == null)
|
|
{
|
|
return;
|
|
}
|
|
|
|
if (delete.CustomHeaders != null)
|
|
{
|
|
AppendCustomParameters(operation, delete.CustomHeaders, ParameterLocation.Header);
|
|
}
|
|
|
|
if (delete.CustomQueryOptions != null)
|
|
{
|
|
AppendCustomParameters(operation, delete.CustomQueryOptions, ParameterLocation.Query);
|
|
}
|
|
}
|
|
}
|
|
}
|