You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@camel.apache.org by "Johnathan Ingram (Jira)" <ji...@apache.org> on 2022/05/06 05:47:00 UTC
[jira] [Updated] (CAMEL-18065) OpenApi Specification Generator - Support multiple tags for an operation
[ https://issues.apache.org/jira/browse/CAMEL-18065?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Johnathan Ingram updated CAMEL-18065:
-------------------------------------
Description:
Hi
The OpenAPI specification supports multiple tags per operation allowing applications to use the tags for custom purposes. Camel only supports 1 tag per operation.
[https://swagger.io/docs/specification/grouping-operations-with-tags/]
Will need to add new attribute list "additionalTags" to the camel model so as to not break backwards compatibility for the XML DSL.
Then add new method for additionalTags(List<String>), setAdditionalTags(List<String>) and List<String>getAdditionalTags.
The generator can then utilise this metadata to set multiple tags on the Oas object to represent mutiple tags in the schema generated.
The internal sort within the camel-opeanapi-java can use the tag for camel grouping (defaults to first tag if additional tags are present and default tag not set), but then still render multiple tags in the OpenAPI spec generated.
was:
Hi
The OpenAPI specification supports multiple tags per operation allowing applications to use the tags for custom purposes. Camel only supports 1 tag per operation.
[https://swagger.io/docs/specification/grouping-operations-with-tags/]
Recommended adding new method to camel-core-model called setTags(array of tags)
The internal sort within the camel-opeanapi-java can use the first tag for camel grouping, but then still render multiple tags in the OpenAPI spec generated.
> OpenApi Specification Generator - Support multiple tags for an operation
> ------------------------------------------------------------------------
>
> Key: CAMEL-18065
> URL: https://issues.apache.org/jira/browse/CAMEL-18065
> Project: Camel
> Issue Type: Improvement
> Components: camel-core, camel-openapi-java
> Affects Versions: 3.14.2
> Reporter: Johnathan Ingram
> Priority: Minor
>
> Hi
>
> The OpenAPI specification supports multiple tags per operation allowing applications to use the tags for custom purposes. Camel only supports 1 tag per operation.
> [https://swagger.io/docs/specification/grouping-operations-with-tags/]
>
> Will need to add new attribute list "additionalTags" to the camel model so as to not break backwards compatibility for the XML DSL.
> Then add new method for additionalTags(List<String>), setAdditionalTags(List<String>) and List<String>getAdditionalTags.
>
> The generator can then utilise this metadata to set multiple tags on the Oas object to represent mutiple tags in the schema generated.
> The internal sort within the camel-opeanapi-java can use the tag for camel grouping (defaults to first tag if additional tags are present and default tag not set), but then still render multiple tags in the OpenAPI spec generated.
>
--
This message was sent by Atlassian Jira
(v8.20.7#820007)