/** Builds the document header of the swagger model */
private void overview() {
Info info = swagger.getInfo();
this.markupDocBuilder.documentTitle(info.getTitle());
this.markupDocBuilder.sectionTitleLevel1(OVERVIEW);
if (isNotBlank(info.getDescription())) {
this.markupDocBuilder.textLine(info.getDescription());
}
if (isNotBlank(info.getVersion())) {
this.markupDocBuilder.sectionTitleLevel2(CURRENT_VERSION);
this.markupDocBuilder.textLine(VERSION + info.getVersion());
}
Contact contact = info.getContact();
if (contact != null) {
this.markupDocBuilder.sectionTitleLevel2(CONTACT_INFORMATION);
if (isNotBlank(contact.getName())) {
this.markupDocBuilder.textLine(CONTACT_NAME + contact.getName());
}
if (isNotBlank(contact.getEmail())) {
this.markupDocBuilder.textLine(CONTACT_EMAIL + contact.getEmail());
}
}
License license = info.getLicense();
if (license != null && (isNotBlank(license.getName()) || isNotBlank(license.getUrl()))) {
this.markupDocBuilder.sectionTitleLevel2(LICENSE_INFORMATION);
if (isNotBlank(license.getName())) {
this.markupDocBuilder.textLine(LICENSE + license.getName());
}
if (isNotBlank(license.getUrl())) {
this.markupDocBuilder.textLine(LICENSE_URL + license.getUrl());
}
}
if (isNotBlank(info.getTermsOfService())) {
this.markupDocBuilder.textLine(TERMS_OF_SERVICE + info.getTermsOfService());
}
if (isNotBlank(swagger.getHost())
|| isNotBlank(swagger.getBasePath())
|| isNotEmpty(swagger.getSchemes())) {
this.markupDocBuilder.sectionTitleLevel2(URI_SCHEME);
if (isNotBlank(swagger.getHost())) {
this.markupDocBuilder.textLine(HOST + swagger.getHost());
}
if (isNotBlank(swagger.getBasePath())) {
this.markupDocBuilder.textLine(BASE_PATH + swagger.getBasePath());
}
if (isNotEmpty(swagger.getSchemes())) {
List<String> schemes = new ArrayList<>();
for (Scheme scheme : swagger.getSchemes()) {
schemes.add(scheme.toString());
}
this.markupDocBuilder.textLine(SCHEMES + join(schemes, ", "));
}
}
if (isNotEmpty(swagger.getTags())) {
this.markupDocBuilder.sectionTitleLevel2(TAGS);
List<String> tags = new ArrayList<>();
for (Tag tag : swagger.getTags()) {
String name = tag.getName();
String description = tag.getDescription();
if (isNoneBlank(description)) {
tags.add(name + ": " + description);
} else {
tags.add(name);
}
}
this.markupDocBuilder.unorderedList(tags);
}
if (isNotEmpty(swagger.getConsumes())) {
this.markupDocBuilder.sectionTitleLevel2(CONSUMES);
this.markupDocBuilder.unorderedList(swagger.getConsumes());
}
if (isNotEmpty(swagger.getProduces())) {
this.markupDocBuilder.sectionTitleLevel2(PRODUCES);
this.markupDocBuilder.unorderedList(swagger.getProduces());
}
}
