Skip to main content

Documentation for the asciidoc Generator

METADATA

PropertyValueNotes
generator nameasciidocpass this to the generate command after -g
generator stabilitySTABLE
generator typeDOCUMENTATION
generator languageJava
generator default templating enginemustache
helpTxtGenerates asciidoc markup based documentation.

CONFIG OPTIONS

These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to configuration docs for more details.

OptionDescriptionValuesDefault
allowUnicodeIdentifiersboolean, toggles whether unicode identifiers are allowed in names or not, default is falsefalse
appDescriptiondescription of the applicationnull
appNameshort name of the applicationnull
artifactIdartifactId in generated pom.xml. This also becomes part of the generated library's filenamenull
artifactVersionartifact version in generated pom.xml. This also becomes part of the generated library's filename. If not provided, uses the version from the OpenAPI specification file. If that's also not present, uses the default value of the artifactVersion option.null
disallowAdditionalPropertiesIfNotPresentIf false, the 'additionalProperties' implementation (set to true by default) is compliant with the OAS and JSON schema specifications. If true (default), keep the old (incorrect) behaviour that 'additionalProperties' is set to false by default.
false
The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications.
true
Keep the old (incorrect) behaviour that 'additionalProperties' is set to false by default.
true
ensureUniqueParamsWhether to ensure parameter names are unique in an operation (rename parameters that are not).true
enumUnknownDefaultCaseIf the server adds new enum cases, that are unknown by an old spec/client, the client will fail to parse the network response.With this option enabled, each enum will have a new case, 'unknown_default_open_api', so that when the server sends an enum case that is not known by the client/spec, they can safely fallback to this case.
false
No changes to the enum's are made, this is the default option.
true
With this option enabled, each enum will have a new case, 'unknown_default_open_api', so that when the enum case sent by the server is not known by the client/spec, can safely be decoded to this case.
false
groupIdgroupId in generated pom.xmlnull
headerAttributesgeneration of asciidoc header meta data attributes (set to false to suppress, default: true)true
infoEmailan email address to contact for inquiries about the applicationnull
infoUrla URL where users can get more information about the applicationnull
invokerPackageroot package for generated codenull
legacyDiscriminatorBehaviorSet to false for generators with better support for discriminators. (Python, Java, Go, PowerShell, C# have this enabled by default).
true
The mapping in the discriminator includes descendent schemas that allOf inherit from self and the discriminator mapping schemas in the OAS document.
false
The mapping in the discriminator includes any descendent schemas that allOf inherit from self, any oneOf schemas, any anyOf schemas, any x-discriminator-values, and the discriminator mapping schemas in the OAS document AND Codegen validates that oneOf and anyOf schemas contain the required discriminator and throws an error if the discriminator is missing.
true
licenseInfoa short description of the licensenull
licenseUrla URL pointing to the full licensenull
prependFormOrBodyParametersAdd form or body parameters to the beginning of the parameter list.false
skipExamplesskip examples sections (default: false)false
snippetDirpath with includable markup snippets (e.g. test output generated by restdoc, default: .).
sortModelPropertiesByRequiredFlagSort model properties to place required parameters before optional parameters.true
sortParamsByRequiredFlagSort method arguments to place required parameters before optional parameters.true
specDirpath with includable markup spec files (e.g. handwritten additional docs, default: ..)..
useIntroductionuse introduction section, rather than an initial abstract (default: false)false
useMethodAndPathUse HTTP method and path as operation heading, instead of operation id (default: false)false
useTableTitlesUse titles for tables, rather than wrapping tables instead their own section (default: false)false

IMPORT MAPPING

Type/AliasImports

INSTANTIATION TYPES

Type/AliasInstantiated By

LANGUAGE PRIMITIVES

    RESERVED WORDS

      FEATURE SET

      Client Modification Feature

      NameSupportedDefined By
      BasePathToolingExtension
      AuthorizationsToolingExtension
      UserAgentToolingExtension
      MockServerToolingExtension

      Data Type Feature

      NameSupportedDefined By
      CustomOAS2,OAS3
      Int32OAS2,OAS3
      Int64OAS2,OAS3
      FloatOAS2,OAS3
      DoubleOAS2,OAS3
      DecimalToolingExtension
      StringOAS2,OAS3
      ByteOAS2,OAS3
      BinaryOAS2,OAS3
      BooleanOAS2,OAS3
      DateOAS2,OAS3
      DateTimeOAS2,OAS3
      PasswordOAS2,OAS3
      FileOAS2
      Uuid
      ArrayOAS2,OAS3
      NullOAS3
      AnyTypeOAS2,OAS3
      ObjectOAS2,OAS3
      MapsToolingExtension
      CollectionFormatOAS2
      CollectionFormatMultiOAS2
      EnumOAS2,OAS3
      ArrayOfEnumToolingExtension
      ArrayOfModelToolingExtension
      ArrayOfCollectionOfPrimitivesToolingExtension
      ArrayOfCollectionOfModelToolingExtension
      ArrayOfCollectionOfEnumToolingExtension
      MapOfEnumToolingExtension
      MapOfModelToolingExtension
      MapOfCollectionOfPrimitivesToolingExtension
      MapOfCollectionOfModelToolingExtension
      MapOfCollectionOfEnumToolingExtension

      Documentation Feature

      NameSupportedDefined By
      ReadmeToolingExtension
      ModelToolingExtension
      ApiToolingExtension

      Global Feature

      NameSupportedDefined By
      HostOAS2,OAS3
      BasePathOAS2,OAS3
      InfoOAS2,OAS3
      SchemesOAS2,OAS3
      PartialSchemesOAS2,OAS3
      ConsumesOAS2
      ProducesOAS2
      ExternalDocumentationOAS2,OAS3
      ExamplesOAS2,OAS3
      XMLStructureDefinitionsOAS2,OAS3
      MultiServerOAS3
      ParameterizedServerOAS3
      ParameterStylingOAS3
      CallbacksOAS3
      LinkObjectsOAS3

      Parameter Feature

      NameSupportedDefined By
      PathOAS2,OAS3
      QueryOAS2,OAS3
      HeaderOAS2,OAS3
      BodyOAS2
      FormUnencodedOAS2
      FormMultipartOAS2
      CookieOAS3

      Schema Support Feature

      NameSupportedDefined By
      SimpleOAS2,OAS3
      CompositeOAS2,OAS3
      PolymorphismOAS2,OAS3
      UnionOAS3
      allOfOAS2,OAS3
      anyOfOAS3
      oneOfOAS3
      notOAS3

      Security Feature

      NameSupportedDefined By
      BasicAuthOAS2,OAS3
      ApiKeyOAS2,OAS3
      OpenIDConnectOAS3
      BearerTokenOAS3
      OAuth2_ImplicitOAS2,OAS3
      OAuth2_PasswordOAS2,OAS3
      OAuth2_ClientCredentialsOAS2,OAS3
      OAuth2_AuthorizationCodeOAS2,OAS3
      SignatureAuthOAS3
      AWSV4SignatureToolingExtension

      Wire Format Feature

      NameSupportedDefined By
      JSONOAS2,OAS3
      XMLOAS2,OAS3
      PROTOBUFToolingExtension
      CustomOAS2,OAS3