in swagger/swagger-generator/generator-core/src/main/java/org/apache/servicecomb/swagger/generator/core/processor/annotation/OperationMethodAnnotationProcessor.java [42:110]
public void process(SwaggerGenerator swaggerGenerator,
OperationGenerator operationGenerator, Operation apiOperationAnnotation) {
io.swagger.v3.oas.models.Operation operation = operationGenerator.getOperation();
if (!StringUtils.isEmpty(apiOperationAnnotation.method())) {
operationGenerator.setHttpMethod(apiOperationAnnotation.method());
}
if (apiOperationAnnotation.responses() != null) {
// This is a bit different from swagger annotation intention.
// Here we assume @Content defines all supported media type and only one implementation class for one status code.
List<String> produces = new ArrayList<>();
for (ApiResponse apiResponse : apiOperationAnnotation.responses()) {
if (StringUtils.isEmpty(apiResponse.responseCode()) || "default".equals(apiResponse.responseCode())) {
throw new IllegalArgumentException("@ApiResponse status code must be defined.");
}
Class<?> type = null;
for (Content content : apiResponse.content()) {
if (StringUtils.isNotEmpty(content.mediaType())) {
produces.add(content.mediaType());
}
if (content.schema() != null && content.schema().implementation() != Void.class) {
type = content.schema().implementation();
}
}
operationGenerator.getOperationGeneratorContext().updateResponse(apiResponse.responseCode(),
type == null ? null : SwaggerUtils.resolveTypeSchemas(swaggerGenerator.getOpenAPI(), type));
if (StringUtils.isNotEmpty(apiResponse.description())) {
operationGenerator.getOperationGeneratorContext().updateResponseDescription(apiResponse.responseCode(),
apiResponse.description());
}
for (Header header : apiResponse.headers()) {
if (header.schema() == null || header.schema().implementation() == Void.class) {
throw new IllegalArgumentException("@ApiResponse header schema implementation must be defined.");
}
if (StringUtils.isEmpty(header.name())) {
throw new IllegalArgumentException("@ApiResponse header name must be defined.");
}
operationGenerator.getOperationGeneratorContext().updateResponseHeader(apiResponse.responseCode(),
header.name(), AnnotationUtils.schemaModel(swaggerGenerator.getOpenAPI(), header.schema()));
}
}
if (!CollectionUtils.isEmpty(produces)) {
operationGenerator.getOperationGeneratorContext().updateProduces(produces);
}
}
io.swagger.v3.oas.models.Operation specificOperation =
AnnotationUtils.operationModel(swaggerGenerator.getOpenAPI(), apiOperationAnnotation);
if (!StringUtils.isEmpty(specificOperation.getSummary())) {
operation.setSummary(specificOperation.getSummary());
}
if (!StringUtils.isEmpty(specificOperation.getDescription())) {
operation.setDescription(specificOperation.getDescription());
}
if (!StringUtils.isEmpty(specificOperation.getOperationId())) {
operation.setOperationId(specificOperation.getOperationId());
}
if (!CollectionUtils.isEmpty(specificOperation.getExtensions())) {
operation.setExtensions(specificOperation.getExtensions());
}
if (!CollectionUtils.isEmpty(specificOperation.getTags())) {
operation.setTags(specificOperation.getTags());
}
}