/** * 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 NewApiEntity mapSwagger12ToNewApi(Swagger swagger) { if (swagger == null || swagger.getInfo() == null) { return null; } NewApiEntity apiEntity = new NewApiEntity(); apiEntity.setName(swagger.getInfo().getTitle()); apiEntity.setDescription(swagger.getInfo().getDescription()); apiEntity.setVersion(swagger.getInfo().getVersion()); String scheme = (swagger.getSchemes() == null || swagger.getSchemes().isEmpty()) ? defaultScheme : swagger.getSchemes().iterator().next().toValue(); apiEntity.setEndpoint(scheme + "://" + swagger.getHost() + swagger.getBasePath()); apiEntity.setPaths(new ArrayList<>( swagger.getPaths().keySet() .stream() .map(path -> path.replaceAll("\\{(.[^/]*)\\}", ":$1")) .collect(Collectors.toList()))); return apiEntity; }
private NewApiEntity mapSwagger12ToNewApi(Swagger swagger) { if (swagger == null || swagger.getInfo() == null) { return null; } NewApiEntity apiEntity = new NewApiEntity(); apiEntity.setName(swagger.getInfo().getTitle()); apiEntity.setDescription(swagger.getInfo().getDescription()); apiEntity.setVersion(swagger.getInfo().getVersion()); String scheme = (swagger.getSchemes() == null || swagger.getSchemes().isEmpty()) ? defaultScheme : swagger.getSchemes().iterator().next().toValue(); apiEntity.setEndpoint(scheme + "://" + swagger.getHost() + swagger.getBasePath()); apiEntity.setPaths(new ArrayList<>( swagger.getPaths().keySet() .stream() .map(path -> path.replaceAll("\\{(.[^/]*)\\}", ":$1")) .collect(Collectors.toList()))); return apiEntity; }
@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; }
.append(specInfo.getTitle()) .append("**") .append(ofNullable(specInfo.getDescription()).map(specDesc -> " - " + specDesc).orElse("")));
/** * Adds additional information to {@link Service} object. * * @throws OpenApiConversionException */ private void createServiceInfoFromOpenApi( Service.Builder serviceBuilder, List<OpenApiFile> openApiFiles) throws OpenApiConversionException { for (OpenApiFile openApiFile : openApiFiles) { //TODO(user): need better way to resolve conflicts here if (openApiFile.swagger().getInfo() != null) { Info info = openApiFile.swagger().getInfo(); if (info.getTitle() != null) { serviceBuilder.setTitle(info.getTitle()); } if (info.getDescription() != null) { serviceBuilder.getDocumentationBuilder().setSummary(info.getDescription()); } } } }
/** * Adds additional information to {@link Service} object. * * @throws OpenApiConversionException */ private void createServiceInfoFromOpenApi( Service.Builder serviceBuilder, List<OpenApiFile> openApiFiles) throws OpenApiConversionException { for (OpenApiFile openApiFile : openApiFiles) { //TODO(user): need better way to resolve conflicts here if (openApiFile.swagger().getInfo() != null) { Info info = openApiFile.swagger().getInfo(); if (info.getTitle() != null) { serviceBuilder.setTitle(info.getTitle()); } if (info.getDescription() != null) { serviceBuilder.getDocumentationBuilder().setSummary(info.getDescription()); } } } }
@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(); }
.description(swaggerInfo.getModel().getInfo().getDescription())//
String apiName = apiInfo.getTitle(); String apiVersion = apiInfo.getVersion(); String apiDescription = apiInfo.getDescription(); CompositeAPI.Builder apiBuilder = new CompositeAPI.Builder(). provider(provider).
String apiName = apiInfo.getTitle(); String apiVersion = apiInfo.getVersion(); String apiDescription = apiInfo.getDescription(); CompositeAPI.Builder apiBuilder = new CompositeAPI.Builder(). provider(provider).
String apiName = apiInfo.getTitle(); String apiVersion = apiInfo.getVersion(); String apiDescription = apiInfo.getDescription(); Contact contact = apiInfo.getContact(); BusinessInformation businessInformation = new BusinessInformation();
String apiName = apiInfo.getTitle(); String apiVersion = apiInfo.getVersion(); String apiDescription = apiInfo.getDescription(); Contact contact = apiInfo.getContact(); BusinessInformation businessInformation = new BusinessInformation();
public Info convert(io.swagger.models.Info v2Info) { Info info = new Info(); info.setContact(convert(v2Info.getContact())); info.setDescription(v2Info.getDescription()); info.setLicense(convert(v2Info.getLicense())); info.setTermsOfService(v2Info.getTermsOfService()); info.setTitle(v2Info.getTitle()); info.setVersion(v2Info.getVersion()); info.setExtensions(convert(v2Info.getVendorExtensions())); return info; }
public Info convert(io.swagger.models.Info v2Info) { Info info = new Info(); info.setContact(convert(v2Info.getContact())); info.setDescription(v2Info.getDescription()); info.setLicense(convert(v2Info.getLicense())); info.setTermsOfService(v2Info.getTermsOfService()); info.setTitle(v2Info.getTitle()); info.setVersion(v2Info.getVersion()); info.setExtensions(convert(v2Info.getVendorExtensions())); return info; }
public Info convert(io.swagger.models.Info v2Info) { Info info = new Info(); info.setContact(convert(v2Info.getContact())); info.setDescription(v2Info.getDescription()); info.setLicense(convert(v2Info.getLicense())); info.setTermsOfService(v2Info.getTermsOfService()); info.setTitle(v2Info.getTitle()); info.setVersion(v2Info.getVersion()); info.setExtensions(convert(v2Info.getVendorExtensions())); return info; }
/** * 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; }