@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 } }
@Override public MarkupDocBuilder apply(MarkupDocBuilder markupDocBuilder, Parameters params) { String definitionName = params.definitionName; String definitionTitle = determineDefinitionTitle(params); Model model = params.model; applyDefinitionsDocumentExtension(new DefinitionsDocumentExtension.Context(Position.DEFINITION_BEFORE, markupDocBuilder, definitionName, model)); markupDocBuilder.sectionTitleWithAnchorLevel(params.titleLevel, definitionTitle, definitionName); applyDefinitionsDocumentExtension(new DefinitionsDocumentExtension.Context(Position.DEFINITION_BEGIN, markupDocBuilder, definitionName, model)); String description = model.getDescription(); if (isNotBlank(description)) { markupDocBuilder.paragraph(markupDescription(config.getSwaggerMarkupLanguage(), markupDocBuilder, description)); } inlineDefinitions(markupDocBuilder, typeSection(markupDocBuilder, definitionName, model), definitionName); applyDefinitionsDocumentExtension(new DefinitionsDocumentExtension.Context(Position.DEFINITION_END, markupDocBuilder, definitionName, model)); applyDefinitionsDocumentExtension(new DefinitionsDocumentExtension.Context(Position.DEFINITION_AFTER, markupDocBuilder, definitionName, model)); return markupDocBuilder; }
private void createModel(RestApi api, String modelName, io.swagger.models.Model model, Map<String, io.swagger.models.Model> definitions, String modelContentType) { LOG.info(format("Creating model for api id %s with name %s", api.getId(), modelName)); createModel(api, modelName, model.getDescription(), generateSchema(model, modelName, definitions), modelContentType); }
private static String determineTitleOf(final String name, final Model schema) { final String title = schema.getTitle(); if (title != null) { return title; } final String description = schema.getDescription(); if (description != null) { return description; } final String reference = schema.getReference(); if (reference != null) { return reference.replaceAll("^.*/", ""); } return name; }
private static String determineTitleOf(final String name, final Model schema) { final String title = schema.getTitle(); if (title != null) { return title; } final String description = schema.getDescription(); if (description != null) { return description; } final String reference = schema.getReference(); if (reference != null) { return reference.replaceAll("^.*/", ""); } return name; }
@Override public MarkupDocBuilder apply(MarkupDocBuilder markupDocBuilder, Parameters params) { String definitionName = params.definitionName; Model model = params.model; applyDefinitionsDocumentExtension(new DefinitionsDocumentExtension.Context(Position.DEFINITION_BEFORE, markupDocBuilder, definitionName, model)); markupDocBuilder.sectionTitleWithAnchorLevel(params.titleLevel, definitionName, definitionName); applyDefinitionsDocumentExtension(new DefinitionsDocumentExtension.Context(Position.DEFINITION_BEGIN, markupDocBuilder, definitionName, model)); String description = model.getDescription(); if (isNotBlank(description)) { markupDocBuilder.paragraph(markupDescription(config.getSwaggerMarkupLanguage(), markupDocBuilder, description)); } inlineDefinitions(markupDocBuilder, typeSection(markupDocBuilder, definitionName, model), definitionName); applyDefinitionsDocumentExtension(new DefinitionsDocumentExtension.Context(Position.DEFINITION_END, markupDocBuilder, definitionName, model)); applyDefinitionsDocumentExtension(new DefinitionsDocumentExtension.Context(Position.DEFINITION_AFTER, markupDocBuilder, definitionName, model)); return markupDocBuilder; }
objectProperty.setDescription(model.getDescription()); objectProperty.setTitle(model.getTitle()); objectProperty.setExample(model.getExample());
_builder.newLine(); _builder.append(" "); String _docHtml = this._docHelper.getDocHtml(this.definition.getDescription()); _builder.append(_docHtml, " "); _builder.newLineIfNotEmpty();