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

ASF subversion and git services commented on SYNCOPE-1262:
----------------------------------------------------------

Commit b0b0e3294dd893d44845295f6a0f570d33fcc607 in syncope's branch 
refs/heads/master from [~ilgrosso]
[ https://git-wip-us.apache.org/repos/asf?p=syncope.git;h=b0b0e32 ]

[SYNCOPE-1262] Adapting test to OpenAPI


> Upgrade to Swagger UI 3.0
> -------------------------
>
>                 Key: SYNCOPE-1262
>                 URL: https://issues.apache.org/jira/browse/SYNCOPE-1262
>             Project: Syncope
>          Issue Type: Task
>          Components: extensions
>            Reporter: Francesco Chicchiriccò
>            Assignee: Francesco Chicchiriccò
>            Priority: Major
>             Fix For: 2.0.8, 2.1.0
>
>
> Since we introduced the support for Swagger (as an extension), I believe many 
> have found it very useful.
> We are currently shipping a patched version of Swagger UI 2.0 (backed by 
> Swagger Core 1.5), with JS support manually enabled for Matrix parameters - 
> as such parameters are not officially supported by Swagger UI 2.0.
> Luckily, after [long 
> discussions|https://github.com/OAI/OpenAPI-Specification/issues/69], it seems 
> that Matrix parameters eventually found their way through the OpenAPI 
> specification, and Swagger UI 3.0.
> In order to profit from this, we need to generate an OpenAPI 3.0- compliant 
> descriptor, as the current /rest/swagger.json is at 2.0 but, due to the 
> presence of matrix parameters, doesn't load with Swagger UI 3.0.
> There is an [ongoing effort in 
> CXF|https://issues.apache.org/jira/browse/CXF-7525] to provide full support 
> for OpenAPI 3.0, but the work has just started; moreover, this will only land 
> in CXF 3.2 - hence our branch {{2_0_X}} will not use it anyway.
> Another approach, again provided by CXF, is the 
> [SwaggerToOpenApiConversionFilter|https://cwiki.apache.org/confluence/display/CXF20DOC/Swagger2Feature#Swagger2Feature-ConvertingtoOpenAPIJSON],
>  which is essentially an in-line transformer from the {{swagger.json}} we 
> already generate, to the new {{openapi.json}} in OpenAPI 3.0 format.



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)

Reply via email to