Closed scrhartley closed 3 weeks ago
Hello, The same apply for multiple response content type.
Here is a customizer that can circumvent the issue until resolved but then, be careful, it removes any deduplication capabilities:
@Component
public class PreserveOperationIdOpenApiCustomizer implements GlobalOperationCustomizer {
@Override
public Operation customize(Operation operation, HandlerMethod handlerMethod) {
operation.setOperationId(
Optional
.ofNullable(handlerMethod.getMethodAnnotation(io.swagger.v3.oas.annotations.Operation.class))
.map(io.swagger.v3.oas.annotations.Operation::operationId)
.orElseGet(handlerMethod.getMethod()::getName)
);
return operation;
}
}
I ended up with a less aggressive customizer:
@Override
public Operation customize(Operation operation, HandlerMethod handlerMethod) {
Optional
.ofNullable(handlerMethod.getMethodAnnotation(io.swagger.v3.oas.annotations.Operation.class))
.map(io.swagger.v3.oas.annotations.Operation::operationId)
.ifPresent(operation::setOperationId);
return operation;
}
Thank you, I'll look forward to the next release.
Describe the bug
In a Spring Boot RestController that wants to support POST request bodies of both form data or JSON, to use the built-in functionality, multiple endpoint methods must be used to support both content types. The JSON accepting method expects the Spring MVC
@RequestBody
annotation to be used, while the form data version expects Spring MVC@RequestBody
to not be used, so the Swagger annotation must be used instead.Although the output OpenAPI JSON correctly puts the two as the same request body with different supported content, the operationId is incorrectly deduplicated, changing its value. n.b. This does require the operationId to be set explicitly on both methods, because otherwise the last automatically generated operationId will be picked to represent both methods.
To Reproduce
What version of spring-boot you are using? 3.3.1
What modules and versions of springdoc-openapi are you using? springdoc-openapi-starter-webmvc-api version 2.6.0, creating OpenAPI version 3.0.1 JSON.
What is the actual and the expected result using OpenAPI Description (yml or json)? Actual (snippet):
Expected the same except:
Provide with a sample code (HelloController) or Test that reproduces the problem
}