io.lighty.swagger.impl

Class ApiDocServiceImpl

java.lang.Object

io.lighty.swagger.impl.ApiDocServiceImpl

All Implemented Interfaces:

org.opendaylight.netconf.sal.rest.doc.api.ApiDocService

public class ApiDocServiceImpl
extends Object
implements org.opendaylight.netconf.sal.rest.doc.api.ApiDocService

This service generates swagger (See https://helloreverb.com/developers/swagger) compliant documentation for RESTCONF APIs. The output of this is used by embedded Swagger UI.

NOTE: These API's need to be synchronized due to bug 1198. Thread access to the SchemaContext is not synchronized properly and thus you can end up with missing definitions without this synchronization. There are likely otherways to work around this limitation, but given that this API is a dev only tool and not dependent UI, this was the fastest work around.

Constructor Summary

Constructors

Constructor and Description
ApiDocServiceImpl()

Method Summary

Modifier and Type	Method and Description
javax.ws.rs.core.Response	getApiExplorer(javax.ws.rs.core.UriInfo uriInfo) Redirects to embedded swagger ui.
javax.ws.rs.core.Response	getDocByModule(String module, String revision, javax.ws.rs.core.UriInfo uriInfo) Generates Swagger compliant document listing APIs for module.
static org.opendaylight.netconf.sal.rest.doc.api.ApiDocService	getInstance()
javax.ws.rs.core.Response	getListOfMounts(javax.ws.rs.core.UriInfo uriInfo)
javax.ws.rs.core.Response	getMountDocByModule(String instanceNum, String module, String revision, javax.ws.rs.core.UriInfo uriInfo)
javax.ws.rs.core.Response	getMountRootDoc(String instanceNum, javax.ws.rs.core.UriInfo uriInfo)
javax.ws.rs.core.Response	getRootDoc(javax.ws.rs.core.UriInfo uriInfo) Generates index document for Swagger UI.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ApiDocServiceImpl

public ApiDocServiceImpl()

Method Detail

getInstance

public static org.opendaylight.netconf.sal.rest.doc.api.ApiDocService getInstance()

getRootDoc

public javax.ws.rs.core.Response getRootDoc(javax.ws.rs.core.UriInfo uriInfo)

Generates index document for Swagger UI. This document lists out all modules with link to get APIs for each module. The API for each module is served by getDocByModule() method.

Specified by:

getRootDoc in interface org.opendaylight.netconf.sal.rest.doc.api.ApiDocService

getDocByModule

public javax.ws.rs.core.Response getDocByModule(String module,
                                                String revision,
                                                javax.ws.rs.core.UriInfo uriInfo)

Generates Swagger compliant document listing APIs for module.

Specified by:

getDocByModule in interface org.opendaylight.netconf.sal.rest.doc.api.ApiDocService

getApiExplorer

public javax.ws.rs.core.Response getApiExplorer(javax.ws.rs.core.UriInfo uriInfo)

Redirects to embedded swagger ui.

Specified by:

getApiExplorer in interface org.opendaylight.netconf.sal.rest.doc.api.ApiDocService

getListOfMounts

public javax.ws.rs.core.Response getListOfMounts(javax.ws.rs.core.UriInfo uriInfo)

Specified by:

getListOfMounts in interface org.opendaylight.netconf.sal.rest.doc.api.ApiDocService

getMountRootDoc

public javax.ws.rs.core.Response getMountRootDoc(String instanceNum,
                                                 javax.ws.rs.core.UriInfo uriInfo)

Specified by:

getMountRootDoc in interface org.opendaylight.netconf.sal.rest.doc.api.ApiDocService

getMountDocByModule

public javax.ws.rs.core.Response getMountDocByModule(String instanceNum,
                                                     String module,
                                                     String revision,
                                                     javax.ws.rs.core.UriInfo uriInfo)

Specified by:

getMountDocByModule in interface org.opendaylight.netconf.sal.rest.doc.api.ApiDocService