/** * Builds the overview MarkupDocument. * * @return the overview MarkupDocument */ @Override public MarkupDocBuilder apply(MarkupDocBuilder markupDocBuilder, OverviewDocument.Parameters params) { Swagger swagger = params.swagger; Info info = swagger.getInfo(); buildDocumentTitle(markupDocBuilder, info.getTitle()); applyOverviewDocumentExtension(new Context(Position.DOCUMENT_BEFORE, markupDocBuilder)); buildOverviewTitle(markupDocBuilder, labels.getLabel(Labels.OVERVIEW)); applyOverviewDocumentExtension(new Context(Position.DOCUMENT_BEGIN, markupDocBuilder)); buildDescriptionParagraph(markupDocBuilder, info.getDescription()); buildVersionInfoSection(markupDocBuilder, info); buildContactInfoSection(markupDocBuilder, info.getContact()); buildLicenseInfoSection(markupDocBuilder, info); buildUriSchemeSection(markupDocBuilder, swagger); buildTagsSection(markupDocBuilder, swagger.getTags()); buildConsumesSection(markupDocBuilder, swagger.getConsumes()); buildProducesSection(markupDocBuilder, swagger.getProduces()); buildExternalDocsSection(markupDocBuilder, swagger.getExternalDocs()); applyOverviewDocumentExtension(new Context(Position.DOCUMENT_END, markupDocBuilder)); applyOverviewDocumentExtension(new Context(Position.DOCUMENT_AFTER, markupDocBuilder)); return markupDocBuilder; }
private void correctInfo() { Info info = swagger.getInfo(); if (info == null) { info = new Info(); swagger.setInfo(info); } if (StringUtils.isEmpty(info.getTitle())) { info.setTitle("swagger definition for " + cls.getName()); } if (StringUtils.isEmpty(info.getVersion())) { info.setVersion("1.0.0"); } setJavaInterface(info, cls); }
private void initOperations() { if (swagger.getPaths() == null) { LOGGER.warn(swagger.getInfo().getTitle() + " with path " + swagger.getBasePath() + " is an empty interface, please delete it or fill with one method!"); return;
private String getApiName(Swagger swagger, String fileName) { String title = swagger.getInfo().getTitle(); return StringUtils.isNotBlank(title) ? title : fileName; }
public String getNewVersion() { return newSpecSwagger.getInfo().getVersion(); } }
public String getOldVersion() { return oldSpecSwagger.getInfo().getVersion(); }
protected void applyDefaultVersion(Swagger data) { if (applyDefaultVersion && data.getInfo() != null && data.getInfo().getVersion() == null && beanConfig != null && beanConfig.getResourcePackage() != null) { Package resourcePackage = Package.getPackage(beanConfig.getResourcePackage()); if (resourcePackage != null) { data.getInfo().setVersion(resourcePackage.getImplementationVersion()); } } }
private String getApplicationName(final Swagger swagger){ if(swagger.getInfo() != null && swagger.getInfo().getTitle() != null){ return swagger.getInfo().getTitle(); } else if(swagger.getHost() != null){ return swagger.getHost(); } else if(swagger.getBasePath() != null){ return swagger.getBasePath(); } throw new IllegalArgumentException("Unable to extract application name " + "from the following swagger config: " + swagger); }
private void correctInfo() { Info info = swagger.getInfo(); if (info == null) { info = new Info(); swagger.setInfo(info); } if (StringUtils.isEmpty(info.getTitle())) { info.setTitle("swagger definition for " + cls.getName()); } if (StringUtils.isEmpty(info.getVersion())) { info.setVersion("1.0.0"); } setJavaInterface(info, cls); }
@Override public void generate(Swagger swagger) throws GenerationException { Config config = Config.fromContext(context); File outputFile = new File(context.getOutputDirectory(), swagger.getInfo().getTitle() + " Client.cs"); try { new NSwagGenerator(config).generate(config.getNSwagRunFile(swagger, Output.CS_CLIENT, outputFile)); } catch (IOException e) { throw new GenerationException("Failed to run NSwag Generation", e); } }
@Override public void generate(Swagger swagger) throws GenerationException { Config config = Config.fromContext(context); File outputFile = new File(context.getOutputDirectory(), swagger.getInfo().getTitle() + "Controller.cs"); try { new NSwagGenerator(config).generate(config.getNSwagRunFile(swagger, Output.CS_SERVER, outputFile)); } catch (IOException e) { throw new GenerationException("Failed to run NSwag Generation", e); } }
@Override public void generate(Swagger swagger) throws GenerationException { Config config = Config.fromContext(context); File outputFile = new File(context.getOutputDirectory(), swagger.getInfo().getTitle() + " Client.js"); try { new NSwagGenerator(config).generate(config.getNSwagRunFile(swagger, Output.TS_CLIENT, outputFile)); } catch (IOException e) { throw new GenerationException("Failed to run NSwag Generation", e); } }
@Override protected final String determineConnectorName(final ConnectorTemplate connectorTemplate, final ConnectorSettings connectorSettings) { final Swagger swagger = parseSpecification(connectorSettings, false).getModel(); final Info info = swagger.getInfo(); if (info == null) { return super.determineConnectorName(connectorTemplate, connectorSettings); } final String title = info.getTitle(); if (title == null) { return super.determineConnectorName(connectorTemplate, connectorSettings); } return title; }
@Override protected final String determineConnectorDescription(final ConnectorTemplate connectorTemplate, final ConnectorSettings connectorSettings) { final Swagger swagger = parseSpecification(connectorSettings, false).getModel(); final Info info = swagger.getInfo(); if (info == null) { return super.determineConnectorDescription(connectorTemplate, connectorSettings); } final String description = info.getDescription(); if (description == null) { return super.determineConnectorDescription(connectorTemplate, connectorSettings); } return description; }
@Override protected final String determineConnectorDescription(final ConnectorTemplate connectorTemplate, final ConnectorSettings connectorSettings) { final Swagger swagger = parseSpecification(connectorSettings, false).getModel(); final Info info = swagger.getInfo(); if (info == null) { return super.determineConnectorDescription(connectorTemplate, connectorSettings); } final String description = info.getDescription(); if (description == null) { return super.determineConnectorDescription(connectorTemplate, connectorSettings); } return description; }
@Override protected final String determineConnectorDescription(final ConnectorTemplate connectorTemplate, final ConnectorSettings connectorSettings) { final Swagger swagger = parseSpecification(connectorSettings, false).getModel(); final Info info = swagger.getInfo(); if (info == null) { return super.determineConnectorDescription(connectorTemplate, connectorSettings); } final String description = info.getDescription(); if (description == null) { return super.determineConnectorDescription(connectorTemplate, connectorSettings); } return description; }
@Override protected final String determineConnectorDescription(final ConnectorTemplate connectorTemplate, final ConnectorSettings connectorSettings) { final Swagger swagger = parseSpecification(connectorSettings, APIValidationContext.NONE).getModel(); final Info info = swagger.getInfo(); if (info == null) { return super.determineConnectorDescription(connectorTemplate, connectorSettings); } final String description = info.getDescription(); if (description == null) { return super.determineConnectorDescription(connectorTemplate, connectorSettings); } return description; }
@Override public String createApi(Swagger swagger, String name) { this.swagger = swagger; this.processedModels.clear(); final RestApi api = createApi(getApiName(swagger, name), swagger.getInfo().getDescription()); LOG.info("Created API "+api.getId()); try { final Resource rootResource = getRootResource(api).get(); deleteDefaultModels(api); createModels(api, swagger.getDefinitions(), swagger.getProduces()); createResources(api, rootResource, swagger.getBasePath(), swagger.getProduces(), swagger.getPaths(), true); } catch (Throwable t) { LOG.error("Error creating API, rolling back", t); rollback(api); throw t; } return api.getId(); }