[ 
https://issues.apache.org/jira/browse/CXF-7525?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16304585#comment-16304585
 ] 

Francesco Chicchiriccò commented on CXF-7525:
---------------------------------------------

Hi there, thanks for this effort.

On Syncope we are currently using Swagger2Feature both with CXF 3.1.14 (our 
2_0_X branch) and 3.2.1 (our master branch), but would like to migrate both to 
this new OpenApiFeature as soon as it is ready (and backported to CXF 3.1.x I 
hope).

I have briefly tested with Syncope 2.1.0-SNAPSHOT / CXF 3.2.2-SNAPSHOT and it 
works; compared to Swagger2Feature, though, there are several missing features:

# [dynamic base path 
calculation|https://github.com/apache/cxf/blob/master/rt/rs/description-swagger/src/main/java/org/apache/cxf/jaxrs/swagger/Swagger2Feature.java#L102]
 (to avoid hard-coding the server's hostname in the JSON content)
# [tags 
re-assembly|https://github.com/apache/cxf/blob/master/rt/rs/description-swagger/src/main/java/org/apache/cxf/jaxrs/swagger/Swagger2Customizer.java#L50]
 (to avoid everything under a single "default" tag)
# [javadoc-based 
descriptions|https://github.com/apache/cxf/blob/master/rt/rs/description-swagger/src/main/java/org/apache/cxf/jaxrs/swagger/Swagger2Customizer.java#L54]
 (to avoid duplicating the same descriptions both via Javadoc and Swagger 
annotations)
# [Swagger Parameter 
customization|https://github.com/apache/cxf/blob/master/rt/rs/description-swagger/src/main/java/org/apache/cxf/jaxrs/swagger/Swagger2Customizer.java#L190]
 (to allow injecting header parameters to all available endpoints)

Do you see problems in migrating all such features?

> Add support for Swagger 2.0 (OpenApi Spec 3.0)
> ----------------------------------------------
>
>                 Key: CXF-7525
>                 URL: https://issues.apache.org/jira/browse/CXF-7525
>             Project: CXF
>          Issue Type: Improvement
>            Reporter: Andriy Redko
>            Assignee: Andriy Redko
>
> The OpenApi spec 3.0 has been released recently. Swagger 2.0 (currently in 
> rc-2) should released in a few months (Dec/Jan). It would be great to have 
> the integration available in CXF as well. 



--
This message was sent by Atlassian JIRA
(v6.4.14#64029)

Reply via email to