[NETCONF-490] Update to the latest version (3.4) of Swagger-UI Created: 06/Dec/17  Updated: 13/Aug/19

Status: Open
Project: netconf
Component/s: None
Affects Version/s: None
Fix Version/s: None

Type: Story Priority: Medium
Reporter: Allan Clarke Assignee: Unassigned
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: 1 week
Time Spent: Not Specified
Original Estimate: 1 week

Attachments: File swagger-modified-1.2.json     File swagger-modified-2.0.json     File swagger-modified-3.0.json     File swagger-original-1.2.json    

 Description   

Netconf is using...

... version 1.2 of OpenAPI which has 3.0 as the latest version
https://github.com/OAI/OpenAPI-Specification/tree/master/versions

... version 1.2 of Swagger which has 3.8 as the latest version
https://github.com/swagger-api/swagger-ui

Port NETCONF from swagger-ui 1.2 to use swagger-ui 3.8

 Comments   
Comment by Allan Clarke [ 06/Dec/17 ]

Vasu Srinivasan and I will be starting this month on this issue.

Comment by Allan Clarke [ 06/Dec/17 ]

Initiated by issue reported in https://jira.opendaylight.org/browse/NETCONF-200

Comment by Allan Clarke [ 28/Dec/17 ]

As part of this upgrade, I attached the 1.2 version of our API. I also included an automatically converted 2.0 and 3.0 version, but I had to edit the 1.2 due to errors with dangling types.

Comment by Allan Clarke [ 24/Jan/18 ]

There is a swagger-core that contains serializable POJOs that can be used to construct the API definition. The current code uses a half dozen home grown classes for this. But the Open API 3.0 has about 30 classes for this.

I'm still having trouble getting the bundle to load into Karaf because Open API 3.0 has transitive dependencies that are BOTH older and newer than the versions in NETCONF.

Comment by Robert Varga [ 28/Aug/18 ]

allanclarke any progress on this?

Comment by Allan Clarke [ 29/Aug/18 ]

No longer working on this due to 

  • lack of interest from the community in helping
  • unable to resolve conflicting bundles in OSGi

I will remove my name as assignee.

Comment by Robert Varga [ 17/Sep/18 ]

https://github.com/UltimateDogg/netconf seems to hold a swagger-2.0 update, which may be worth considering.

Generated at Wed Feb 07 20:15:10 UTC 2024 using Jira 8.20.10#820010-sha1:ace47f9899e9ee25d7157d59aa17ab06aee30d3d.