Update swagger generator to OpenAPI 3.0 30/88830/23
authorillia.ihushev <illia.ihushev@pantheon.tech>
Wed, 1 Apr 2020 14:57:37 +0000 (17:57 +0300)
committerillia.ihushev <illia.ihushev@pantheon.tech>
Tue, 19 May 2020 12:04:50 +0000 (15:04 +0300)
commit9dc96d8bcbcb5ed4841362c28d4f8189fbff3e01
treec17f17d649480c6ce85fdecbcf968dece6a6ce41
parent49275c4d9c884f400a3df21644953cd5ce8ac7d3
Update swagger generator to OpenAPI 3.0

This commit update both generation of the API documentation JSON, along
with UI based on the JSON.

Issues:

 - the request bodies generated with all the choice case nodes present
 - invalid request bodies for the POST requests on list/container, when
   Content-Type is application/xml

JIRA: NETCONF-687
Signed-off-by: illia.ihushev <illia.ihushev@pantheon.tech>
Change-Id: I58002878d5d5a46507be021c4c1783004ea0409a
92 files changed:
restconf/sal-rest-docgen-maven/src/main/java/org/opendaylight/netconf/sal/rest/doc/maven/StaticDocGenerator.java
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/api/ApiDocService.java
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/impl/AllModulesDocGenerator.java [new file with mode: 0644]
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/impl/ApiDocServiceImpl.java
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/impl/BaseYangSwaggerGenerator.java
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/impl/BaseYangSwaggerGeneratorDraft02.java
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/impl/BaseYangSwaggerGeneratorRFC8040.java
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/impl/DefinitionGenerator.java [new file with mode: 0644]
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/impl/DefinitionNames.java [new file with mode: 0644]
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/impl/ModelGenerator.java [deleted file]
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/jaxrs/JaxbContextResolver.java
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/jaxrs/WebInitializer.java
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/model/builder/OperationBuilder.java
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/mountpoints/MountPointSwagger.java
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/swagger/Api.java [deleted file]
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/swagger/ApiDeclaration.java [deleted file]
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/swagger/CommonApiObject.java [new file with mode: 0644]
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/swagger/Components.java [new file with mode: 0644]
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/swagger/Info.java [new file with mode: 0644]
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/swagger/OpenApiObject.java [new file with mode: 0644]
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/swagger/Operation.java [deleted file]
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/swagger/Parameter.java [deleted file]
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/swagger/ResponseMessage.java [deleted file]
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/swagger/Server.java [new file with mode: 0644]
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/swagger/SwaggerObject.java [new file with mode: 0644]
restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/util/JsonUtil.java [new file with mode: 0644]
restconf/sal-rest-docgen/src/main/resources/18/explorer/index.html [deleted file]
restconf/sal-rest-docgen/src/main/resources/18/explorer/lib/odl/list_mounts.js [deleted file]
restconf/sal-rest-docgen/src/main/resources/18/explorer/static/index.html [deleted file]
restconf/sal-rest-docgen/src/main/resources/OSGI-INF/blueprint/blueprint.xml
restconf/sal-rest-docgen/src/main/resources/explorer/css/highlight.default.css [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/css/screen.css [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/css/simplePagination.css [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/css/swagger-ui.css [new file with mode: 0644]
restconf/sal-rest-docgen/src/main/resources/explorer/css/swagger-ui.css.map [new file with mode: 0644]
restconf/sal-rest-docgen/src/main/resources/explorer/css/ui-lightness/images/animated-overlay.gif [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/css/ui-lightness/images/ui-bg_diagonals-thick_18_b81900_40x40.png [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/css/ui-lightness/images/ui-bg_diagonals-thick_20_666666_40x40.png [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/css/ui-lightness/images/ui-bg_flat_10_000000_40x100.png [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/css/ui-lightness/images/ui-bg_glass_100_f6f6f6_1x400.png [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/css/ui-lightness/images/ui-bg_glass_100_fdf5ce_1x400.png [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/css/ui-lightness/images/ui-bg_glass_65_ffffff_1x400.png [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/css/ui-lightness/images/ui-bg_gloss-wave_35_f6a828_500x100.png [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/css/ui-lightness/images/ui-bg_highlight-soft_100_eeeeee_1x100.png [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/css/ui-lightness/images/ui-bg_highlight-soft_75_ffe45c_1x100.png [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/css/ui-lightness/images/ui-icons_222222_256x240.png [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/css/ui-lightness/images/ui-icons_228ef1_256x240.png [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/css/ui-lightness/images/ui-icons_ef8c08_256x240.png [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/css/ui-lightness/images/ui-icons_ffd27a_256x240.png [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/css/ui-lightness/images/ui-icons_ffffff_256x240.png [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/css/ui-lightness/jquery-ui-1.10.4.custom.css [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/css/ui-lightness/jquery-ui-1.10.4.custom.min.css [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/images/favicon-16x16.png [new file with mode: 0644]
restconf/sal-rest-docgen/src/main/resources/explorer/images/favicon-32x32.png [new file with mode: 0644]
restconf/sal-rest-docgen/src/main/resources/explorer/images/pet_store_api.png [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/images/throbber.gif [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/images/wordnik_api.png [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/index.html
restconf/sal-rest-docgen/src/main/resources/explorer/js/swagger-ui-bundle.js [new file with mode: 0644]
restconf/sal-rest-docgen/src/main/resources/explorer/js/swagger-ui-bundle.js.map [new file with mode: 0644]
restconf/sal-rest-docgen/src/main/resources/explorer/js/swagger-ui-standalone-preset.js [new file with mode: 0644]
restconf/sal-rest-docgen/src/main/resources/explorer/js/swagger-ui-standalone-preset.js.map [new file with mode: 0644]
restconf/sal-rest-docgen/src/main/resources/explorer/js/swagger-ui.js [new file with mode: 0644]
restconf/sal-rest-docgen/src/main/resources/explorer/js/swagger-ui.js.map [new file with mode: 0644]
restconf/sal-rest-docgen/src/main/resources/explorer/lib/backbone-min.js [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/lib/handlebars-1.0.0.js [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/lib/highlight.7.3.pack.js [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/lib/jquery-1.8.0.min.js [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/lib/jquery-ui-1.11.0.min.js [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/lib/jquery.ba-bbq.min.js [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/lib/jquery.simplePagination.js [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/lib/jquery.slideto.min.js [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/lib/jquery.wiggle.min.js [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/lib/odl/list_mounts.js [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/lib/odl/page.js [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/lib/odl/swagger.js [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/lib/shred.bundle.js [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/lib/shred/content.js [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/lib/swagger.js [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/lib/underscore-min.js [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/oauth2-redirect.html [new file with mode: 0644]
restconf/sal-rest-docgen/src/main/resources/explorer/static/fonts.css [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/static/index.html [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/static/opendaylight.css [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/static/swagger-ui.js [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/static/swagger.js [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/swagger-ui.js [deleted file]
restconf/sal-rest-docgen/src/main/resources/explorer/swagger-ui.min.js [deleted file]
restconf/sal-rest-docgen/src/test/java/org/opendaylight/controller/sal/rest/doc/impl/ApiDocGeneratorTest.java
restconf/sal-rest-docgen/src/test/java/org/opendaylight/controller/sal/rest/doc/impl/ApiDocServiceImplTest.java
restconf/sal-rest-docgen/src/test/java/org/opendaylight/controller/sal/rest/doc/impl/MountPointSwaggerTest.java
restconf/sal-rest-docgen/src/test/java/org/opendaylight/controller/sal/rest/doc/impl/SwaggerObjectTest.java [moved from restconf/sal-rest-docgen/src/test/java/org/opendaylight/controller/sal/rest/doc/impl/ModelGeneratorTest.java with 79% similarity]