/** * Global context lazy initialization * * @param globalContext Global context */ public void setGlobalContext(Swagger2MarkupConverter.Context globalContext) { this.globalContext = globalContext; init(globalContext); }
private void initExtensions(Context context) { extensionRegistry.getSwaggerModelExtensions().forEach(extension -> extension.setGlobalContext(context)); extensionRegistry.getOverviewDocumentExtensions().forEach(extension -> extension.setGlobalContext(context)); extensionRegistry.getDefinitionsDocumentExtensions().forEach(extension -> extension.setGlobalContext(context)); extensionRegistry.getPathsDocumentExtensions().forEach(extension -> extension.setGlobalContext(context)); extensionRegistry.getSecurityDocumentExtensions().forEach(extension -> extension.setGlobalContext(context)); }
/** * Apply extension context to all OperationsContentExtension. * * @param context context */ private void applyPathsDocumentExtension(PathsDocumentExtension.Context context) { extensionRegistry.getPathsDocumentExtensions().forEach(extension -> extension.apply(context)); }
@Override public void apply(Context context) { MarkupDocBuilder markupBuilder = context.getMarkupDocBuilder(); //<2> Position position = context.getPosition(); //<3> String definitionName = context.getDefinitionName().get(); Model definitionModel = context.getModel().get(); if (position.equals(Position.DEFINITION_END)) { markupBuilder.sectionTitleLevel1(definitionName) //<4> .paragraph(definitionModel.getDescription()) .importMarkup(new StringReader("*Markup*"), MarkupLanguage.ASCIIDOC); } // apply is executed per definition } }
/** * Apply extension context to all SecurityContentExtension * * @param context context */ private void applySecurityDocumentExtension(Context context) { extensionRegistry.getSecurityDocumentExtensions().forEach(extension -> extension.apply(context)); }
/** * Apply extension context to all DefinitionsContentExtension * * @param context context */ private void applyDefinitionsDocumentExtension(Context context) { extensionRegistry.getDefinitionsDocumentExtensions().forEach(extension -> extension.apply(context)); }
/** * Builds the security MarkupDocument. * * @return the security MarkupDocument */ @Override public MarkupDocBuilder apply(MarkupDocBuilder markupDocBuilder, SecurityDocument.Parameters params) { Map<String, SecuritySchemeDefinition> definitions = params.securitySchemeDefinitions; if (MapUtils.isNotEmpty(definitions)) { applySecurityDocumentExtension(new Context(Position.DOCUMENT_BEFORE, markupDocBuilder)); buildSecurityTitle(markupDocBuilder, labels.getLabel(SECURITY)); applySecurityDocumentExtension(new Context(Position.DOCUMENT_BEGIN, markupDocBuilder)); buildSecuritySchemeDefinitionsSection(markupDocBuilder, definitions); applySecurityDocumentExtension(new Context(Position.DOCUMENT_END, markupDocBuilder)); applySecurityDocumentExtension(new Context(Position.DOCUMENT_AFTER, markupDocBuilder)); } return markupDocBuilder; }
/** * Apply extension context to all OverviewContentExtension * * @param context context */ private void applyOverviewDocumentExtension(Context context) { extensionRegistry.getOverviewDocumentExtensions().forEach(extension -> extension.apply(context)); }
case OPERATION_BEGIN: case OPERATION_END: levelOffset = increaseLevelOffset(2); break; case OPERATION_DESCRIPTION_BEFORE: case OPERATION_SECURITY_BEFORE: case OPERATION_SECURITY_AFTER: levelOffset = increaseLevelOffset(2); break; case OPERATION_DESCRIPTION_BEGIN:
private void applySwaggerExtensions(Context context) { extensionRegistry.getSwaggerModelExtensions().forEach(extension -> extension.apply(context.getSwagger())); } }
/** * Builds the paths MarkupDocument. * * @return the paths MarkupDocument */ @Override public MarkupDocBuilder apply(MarkupDocBuilder markupDocBuilder, PathsDocument.Parameters params) { Map<String, Path> paths = params.paths; if (MapUtils.isNotEmpty(paths)) { applyPathsDocumentExtension(new Context(Position.DOCUMENT_BEFORE, markupDocBuilder)); buildPathsTitle(markupDocBuilder); applyPathsDocumentExtension(new Context(Position.DOCUMENT_BEGIN, markupDocBuilder)); buildsPathsSection(markupDocBuilder, paths); applyPathsDocumentExtension(new Context(Position.DOCUMENT_END, markupDocBuilder)); applyPathsDocumentExtension(new Context(Position.DOCUMENT_AFTER, markupDocBuilder)); } return markupDocBuilder; }
/** * Builds the definitions MarkupDocument. * * @return the definitions MarkupDocument */ @Override public MarkupDocBuilder apply(MarkupDocBuilder markupDocBuilder, DefinitionsDocument.Parameters params) { Map<String, Model> definitions = params.definitions; if (MapUtils.isNotEmpty(definitions)) { applyDefinitionsDocumentExtension(new Context(Position.DOCUMENT_BEFORE, markupDocBuilder)); buildDefinitionsTitle(markupDocBuilder, labels.getLabel(Labels.DEFINITIONS)); applyDefinitionsDocumentExtension(new Context(Position.DOCUMENT_BEGIN, markupDocBuilder)); buildDefinitionsSection(markupDocBuilder, definitions); applyDefinitionsDocumentExtension(new Context(Position.DOCUMENT_END, markupDocBuilder)); applyDefinitionsDocumentExtension(new Context(Position.DOCUMENT_AFTER, markupDocBuilder)); } return markupDocBuilder; }
/** * 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; }
/** * Apply extension context to all OperationsContentExtension. * * @param context context */ private void applyPathsDocumentExtension(PathsDocumentExtension.Context context) { extensionRegistry.getPathsDocumentExtensions().forEach(extension -> extension.apply(context)); }
/** * Apply extension context to all SecurityContentExtension * * @param context context */ private void applySecurityDocumentExtension(SecurityDocumentExtension.Context context) { extensionRegistry.getSecurityDocumentExtensions().forEach(extension -> extension.apply(context)); }
/** * Apply extension context to all DefinitionsContentExtension * * @param context context */ private void applyDefinitionsDocumentExtension(DefinitionsDocumentExtension.Context context) { extensionRegistry.getDefinitionsDocumentExtensions().forEach(extension -> extension.apply(context)); }
@Override public MarkupDocBuilder apply(MarkupDocBuilder markupDocBuilder, Parameters params) { String securitySchemeDefinitionName = params.securitySchemeDefinitionName; SecuritySchemeDefinition securitySchemeDefinition = params.securitySchemeDefinition; applySecurityDocumentExtension(new SecurityDocumentExtension.Context(Position.SECURITY_SCHEME_BEFORE, markupDocBuilder, securitySchemeDefinitionName, securitySchemeDefinition)); markupDocBuilder.sectionTitleWithAnchorLevel(params.titleLevel, securitySchemeDefinitionName); applySecurityDocumentExtension(new SecurityDocumentExtension.Context(Position.SECURITY_SCHEME_BEGIN, markupDocBuilder, securitySchemeDefinitionName, securitySchemeDefinition)); String description = securitySchemeDefinition.getDescription(); if (isNotBlank(description)) { markupDocBuilder.paragraph(markupDescription(config.getSwaggerMarkupLanguage(), markupDocBuilder, description)); } buildSecurityScheme(markupDocBuilder, securitySchemeDefinition); applySecurityDocumentExtension(new SecurityDocumentExtension.Context(Position.SECURITY_SCHEME_END, markupDocBuilder, securitySchemeDefinitionName, securitySchemeDefinition)); applySecurityDocumentExtension(new SecurityDocumentExtension.Context(Position.SECURITY_SCHEME_AFTER, markupDocBuilder, securitySchemeDefinitionName, securitySchemeDefinition)); return markupDocBuilder; }
/** * Apply extension context to all OperationsContentExtension. * * @param context context */ private void applyPathsDocumentExtension(Context context) { extensionRegistry.getPathsDocumentExtensions().forEach(extension -> extension.apply(context)); }
/** * Apply extension context to all OperationsContentExtension. * * @param context context */ private void applyPathsDocumentExtension(PathsDocumentExtension.Context context) { extensionRegistry.getPathsDocumentExtensions().forEach(extension -> extension.apply(context)); }
/** * Apply extension context to all OperationsContentExtension. * * @param context context */ private void applyPathsDocumentExtension(PathsDocumentExtension.Context context) { extensionRegistry.getPathsDocumentExtensions().forEach(extension -> extension.apply(context)); }