X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?a=blobdiff_plain;f=restconf%2Fsal-rest-docgen%2Fsrc%2Fmain%2Fjava%2Forg%2Fopendaylight%2Fnetconf%2Fsal%2Frest%2Fdoc%2Fimpl%2FBaseYangSwaggerGenerator.java;h=55c62b24a1b38fa22b1a806b61f325340f91d94b;hb=4914063256c8776e3dba65f7573fa6950754501b;hp=453a9d2da4cd066983c277efbce89d1cb18f34f9;hpb=3c03dd6d9a59a737293cad70062b5a0a7bd8e4a8;p=netconf.git diff --git a/restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/impl/BaseYangSwaggerGenerator.java b/restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/impl/BaseYangSwaggerGenerator.java index 453a9d2da4..55c62b24a1 100644 --- a/restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/impl/BaseYangSwaggerGenerator.java +++ b/restconf/sal-rest-docgen/src/main/java/org/opendaylight/netconf/sal/rest/doc/impl/BaseYangSwaggerGenerator.java @@ -62,7 +62,7 @@ public class BaseYangSwaggerGenerator { protected static final String API_VERSION = "1.0.0"; protected static final String SWAGGER_VERSION = "1.2"; protected static final String RESTCONF_CONTEXT_ROOT = "restconf"; - private static final String RESTCONF_DRAFT = "17"; + private static final String RESTCONF_DRAFT = "18"; static final String MODULE_NAME_SUFFIX = "_module"; protected static final DateFormat SIMPLE_DATE_FORMAT = new SimpleDateFormat("yyyy-MM-dd"); @@ -73,14 +73,15 @@ public class BaseYangSwaggerGenerator { private static boolean newDraft; protected BaseYangSwaggerGenerator() { - mapper.registerModule(new JsonOrgModule()); - mapper.configure(SerializationFeature.INDENT_OUTPUT, true); + this.mapper.registerModule(new JsonOrgModule()); + this.mapper.configure(SerializationFeature.INDENT_OUTPUT, true); } /** * Return list of modules converted to swagger compliant resource list. */ - public ResourceList getResourceListing(final UriInfo uriInfo, final SchemaContext schemaContext, final String context) { + public ResourceList getResourceListing(final UriInfo uriInfo, final SchemaContext schemaContext, + final String context) { final ResourceList resourceList = createResourceList(); @@ -94,7 +95,8 @@ public class BaseYangSwaggerGenerator { final String revisionString = SIMPLE_DATE_FORMAT.format(module.getRevision()); final Resource resource = new Resource(); LOG.debug("Working on [{},{}]...", module.getName(), revisionString); - final ApiDeclaration doc = getApiDeclaration(module.getName(), revisionString, uriInfo, schemaContext, context); + final ApiDeclaration doc = + getApiDeclaration(module.getName(), revisionString, uriInfo, schemaContext, context); if (doc != null) { resource.setPath(generatePath(uriInfo, module.getName(), revisionString)); @@ -121,11 +123,12 @@ public class BaseYangSwaggerGenerator { return uri.toASCIIString(); } - public ApiDeclaration getApiDeclaration(final String moduleName, final String revision, final UriInfo uriInfo, final SchemaContext schemaContext, final String context) { + public ApiDeclaration getApiDeclaration(final String moduleName, final String revision, final UriInfo uriInfo, + final SchemaContext schemaContext, final String context) { Date rev = null; try { - if (revision != null && !revision.equals("0000-00-00")) { + if ((revision != null) && !revision.equals("0000-00-00")) { rev = SIMPLE_DATE_FORMAT.parse(revision); } } catch (final ParseException e) { @@ -149,7 +152,8 @@ public class BaseYangSwaggerGenerator { return getApiDeclaration(module, rev, uriInfo, context, schemaContext); } - public ApiDeclaration getApiDeclaration(final Module module, final Date revision, final UriInfo uriInfo, final String context, final SchemaContext schemaContext) { + public ApiDeclaration getApiDeclaration(final Module module, final Date revision, final UriInfo uriInfo, + final String context, final SchemaContext schemaContext) { final String basePath = createBasePathFromUriInfo(uriInfo); final ApiDeclaration doc = getSwaggerDocSpec(module, basePath, context, schemaContext); @@ -165,13 +169,14 @@ public class BaseYangSwaggerGenerator { if (port != -1) { portPart = ":" + port; } - final String basePath = new StringBuilder(uriInfo.getBaseUri().getScheme()).append("://") - .append(uriInfo.getBaseUri().getHost()).append(portPart).append("/").append(RESTCONF_CONTEXT_ROOT) - .toString(); + final String basePath = + new StringBuilder(uriInfo.getBaseUri().getScheme()).append("://").append(uriInfo.getBaseUri().getHost()) + .append(portPart).append("/").append(RESTCONF_CONTEXT_ROOT).toString(); return basePath; } - public ApiDeclaration getSwaggerDocSpec(final Module m, final String basePath, final String context, final SchemaContext schemaContext) { + public ApiDeclaration getSwaggerDocSpec(final Module m, final String basePath, final String context, + final SchemaContext schemaContext) { final ApiDeclaration doc = createApiDeclaration(basePath); final List apis = new ArrayList<>(); @@ -187,15 +192,17 @@ public class BaseYangSwaggerGenerator { String resourcePath; /* - * Only when the node's config statement is true, such apis as GET/PUT/POST/DELETE config - * are added for this node. + * Only when the node's config statement is true, such apis as + * GET/PUT/POST/DELETE config are added for this node. */ - if (node.isConfiguration()) { // This node's config statement is true. + if (node.isConfiguration()) { // This node's config statement is + // true. resourcePath = getDataStorePath("config", context); /* - * When there are two or more top container or list nodes whose config statement is true in module, - * make sure that only one root post link is added for this module. + * When there are two or more top container or list nodes + * whose config statement is true in module, make sure that + * only one root post link is added for this module. */ if (!hasAddRootPostLink) { LOG.debug("Has added root post link for module {}", m.getName()); @@ -228,10 +235,10 @@ public class BaseYangSwaggerGenerator { JSONObject models = null; try { - models = jsonConverter.convertToJsonSchema(m, schemaContext); + models = this.jsonConverter.convertToJsonSchema(m, schemaContext); doc.setModels(models); if (LOG.isDebugEnabled()) { - LOG.debug(mapper.writeValueAsString(doc)); + LOG.debug(this.mapper.writeValueAsString(doc)); } } catch (IOException | JSONException e) { LOG.error("Exception occured in ModelGenerator", e); @@ -243,7 +250,7 @@ public class BaseYangSwaggerGenerator { } private void addRootPostLink(final Module module, final DataNodeContainer node, final List pathParams, - final String resourcePath, final String dataStore, final List apis) { + final String resourcePath, final String dataStore, final List apis) { if (containsListOrContainer(module.getChildNodes())) { final Api apiForRootPostUri = new Api(); apiForRootPostUri.setPath(resourcePath.concat(getContent(dataStore))); @@ -278,8 +285,9 @@ public class BaseYangSwaggerGenerator { return module + "(" + revision + ")"; } - private void addApis(final DataSchemaNode node, final List apis, final String parentPath, final List parentPathParams, - final SchemaContext schemaContext, final boolean addConfigApi, final String parentName, final String dataStore) { + private void addApis(final DataSchemaNode node, final List apis, final String parentPath, + final List parentPathParams, final SchemaContext schemaContext, final boolean addConfigApi, + final String parentName, final String dataStore) { final Api api = new Api(); final List pathParams = new ArrayList<>(parentPathParams); @@ -287,7 +295,7 @@ public class BaseYangSwaggerGenerator { LOG.debug("Adding path: [{}]", resourcePath); api.setPath(resourcePath.concat(getContent(dataStore))); - Iterable childSchemaNodes = Collections.emptySet(); + Iterable childSchemaNodes = Collections. emptySet(); if ((node instanceof ListSchemaNode) || (node instanceof ContainerSchemaNode)) { final DataNodeContainer dataNodeContainer = (DataNodeContainer) node; childSchemaNodes = dataNodeContainer.getChildNodes(); @@ -296,11 +304,12 @@ public class BaseYangSwaggerGenerator { apis.add(api); for (final DataSchemaNode childNode : childSchemaNodes) { - if (childNode instanceof ListSchemaNode || childNode instanceof ContainerSchemaNode) { + if ((childNode instanceof ListSchemaNode) || (childNode instanceof ContainerSchemaNode)) { // keep config and operation attributes separate. if (childNode.isConfiguration() == addConfigApi) { final String newParent = parentName + "/" + node.getQName().getLocalName(); - addApis(childNode, apis, resourcePath, pathParams, schemaContext, addConfigApi, newParent, dataStore); + addApis(childNode, apis, resourcePath, pathParams, schemaContext, addConfigApi, newParent, + dataStore); } } } @@ -319,17 +328,18 @@ public class BaseYangSwaggerGenerator { return ""; } } + private boolean containsListOrContainer(final Iterable nodes) { for (final DataSchemaNode child : nodes) { - if (child instanceof ListSchemaNode || child instanceof ContainerSchemaNode) { + if ((child instanceof ListSchemaNode) || (child instanceof ContainerSchemaNode)) { return true; } } return false; } - private List operation(final DataSchemaNode node, final List pathParams, final boolean isConfig, - final Iterable childSchemaNodes, final String parentName) { + private List operation(final DataSchemaNode node, final List pathParams, + final boolean isConfig, final Iterable childSchemaNodes, final String parentName) { final List operations = new ArrayList<>(); final Get getBuilder = new Get(node, isConfig); @@ -350,8 +360,9 @@ public class BaseYangSwaggerGenerator { return operations; } - private List operationPost(final String name, final String description, final DataNodeContainer dataNodeContainer, - final List pathParams, final boolean isConfig, final String parentName) { + private List operationPost(final String name, final String description, + final DataNodeContainer dataNodeContainer, final List pathParams, final boolean isConfig, + final String parentName) { final List operations = new ArrayList<>(); if (isConfig) { final Post postBuilder = new Post(name, parentName + name, description, dataNodeContainer); @@ -360,7 +371,8 @@ public class BaseYangSwaggerGenerator { return operations; } - private String createPath(final DataSchemaNode schemaNode, final List pathParams, final SchemaContext schemaContext) { + private String createPath(final DataSchemaNode schemaNode, final List pathParams, + final SchemaContext schemaContext) { final ArrayList pathListParams = new ArrayList<>(); final StringBuilder path = new StringBuilder(); final String localName = resolvePathArgumentsName(schemaNode, schemaContext); @@ -378,8 +390,7 @@ public class BaseYangSwaggerGenerator { pathListParams.add(((LeafSchemaNode) dataChildByName)); final String pathParamIdentifier; if (newDraft) { - pathParamIdentifier = keyBuilder.append("{").append(listKey.getLocalName()).append("}") - .toString(); + pathParamIdentifier = keyBuilder.append("{").append(listKey.getLocalName()).append("}").toString(); } else { pathParamIdentifier = "/{" + listKey.getLocalName() + "}"; } @@ -400,7 +411,8 @@ public class BaseYangSwaggerGenerator { return path.toString(); } - protected void addRpcs(final RpcDefinition rpcDefn, final List apis, final String parentPath, final SchemaContext schemaContext) { + protected void addRpcs(final RpcDefinition rpcDefn, final List apis, final String parentPath, + final SchemaContext schemaContext) { final Api rpc = new Api(); final String resourcePath = parentPath + "/" + resolvePathArgumentsName(rpcDefn, schemaContext); rpc.setPath(resourcePath);