Class SpringCodegen
java.lang.Object
io.swagger.codegen.v3.generators.DefaultCodegenConfig
io.swagger.codegen.v3.generators.java.AbstractJavaCodegen
io.swagger.codegen.v3.generators.java.SpringCodegen
- All Implemented Interfaces:
io.swagger.codegen.v3.CodegenConfig,BeanValidationFeatures,NotNullAnnotationFeatures,OptionalFeatures
public class SpringCodegen
extends AbstractJavaCodegen
implements BeanValidationFeatures, OptionalFeatures, NotNullAnnotationFeatures
-
Field Summary
FieldsModifier and TypeFieldDescriptionprotected booleanstatic final Stringstatic final Stringprotected Stringstatic final Stringprotected Stringstatic final Stringstatic final Stringstatic final Stringstatic final Stringprotected booleanstatic final Stringprotected booleanprotected booleanstatic final Stringprotected booleanstatic final Stringprotected booleanprotected booleanprotected booleanprotected booleanstatic final Stringprotected Stringstatic final Stringprotected booleanstatic final Stringstatic final Stringstatic final Stringstatic final Stringstatic final Stringstatic final Stringstatic final Stringprotected Stringprotected Stringprotected Stringstatic final Stringprotected booleanstatic final Stringstatic final Stringprotected booleanprotected Stringstatic final Stringstatic final Stringprotected booleanprotected booleanprotected booleanstatic final Stringstatic final Stringstatic final Stringstatic final Stringstatic final Stringprotected StringFields inherited from class io.swagger.codegen.v3.generators.java.AbstractJavaCodegen
apiDocPath, artifactDescription, artifactId, artifactUrl, artifactVersion, CHECK_DUPLICATED_MODEL_NAME, DATE_LIBRARY, dateLibrary, developerEmail, developerName, developerOrganization, developerOrganizationUrl, ERROR_ON_UNKNOWN_ENUM, FULL_JAVA_UTIL, fullJavaUtil, groupId, invokerPackage, jakarta, JAKARTA, JAVA11_MODE, java11Mode, JAVA8_MODE, java8Mode, javaUtilPrefix, licenseName, licenseUrl, localVariablePrefix, modelDocPath, projectFolder, projectTestFolder, scmConnection, scmDeveloperConnection, scmUrl, serializableModel, serializeBigDecimalAsString, sourceFolder, SUPPORT_JAVA6, supportJava6, testFolder, USE_NULLABLE_FOR_NOTNULL, useNullableForNotNull, WIREMOCK_OPTION, WITH_XML, withXmlFields inherited from class io.swagger.codegen.v3.generators.DefaultCodegenConfig
additionalProperties, allowUnicodeIdentifiers, apiDocTemplateFiles, apiPackage, apiTemplateFiles, apiTestTemplateFiles, cliOptions, commonTemplateDir, configFiles, customTemplateDir, DEFAULT_CONTENT_TYPE, DEFAULT_TEMPLATE_DIR, defaultIncludes, embeddedTemplateDir, ensureUniqueParams, fileSuffix, gitRepoBaseURL, gitRepoId, gitUserId, hideGenerationTimestamp, httpUserAgent, ignoreFilePathOverride, ignoreImportMapping, importMapping, inputSpec, inputURL, instantiationTypes, IS_NULLABLE_FALSE, IS_NULLABLE_TRUE, languageArguments, languageSpecificPrimitives, library, modelDocTemplateFiles, modelNamePrefix, modelNameSuffix, modelPackage, modelTemplateFiles, modelTestTemplateFiles, openAPI, outputFolder, releaseNote, removeOperationIdPrefix, REQUEST_BODY_NAME, reservedWords, reservedWordsMappings, skipOverwrite, sortParamsByRequiredFlag, specialCharReplacements, supportedLibraries, supportingFiles, supportsInheritance, supportsMixins, templateDir, templateEngine, templateVersion, testPackage, typeAliases, typeMapping, unflattenedOpenAPI, useOas2, vendorExtensionsFields inherited from interface io.swagger.codegen.v3.generators.features.BeanValidationFeatures
USE_BEANVALIDATIONFields inherited from interface io.swagger.codegen.v3.generators.features.NotNullAnnotationFeatures
NOT_NULL_JACKSON_ANNOTATIONFields inherited from interface io.swagger.codegen.v3.generators.features.OptionalFeatures
USE_OPTIONAL -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected voidaddCodegenContentParameters(io.swagger.codegen.v3.CodegenOperation codegenOperation, List<io.swagger.codegen.v3.CodegenContent> codegenContents) voidaddOperationToGroup(String tag, String resourcePath, io.swagger.v3.oas.models.Operation operation, io.swagger.codegen.v3.CodegenOperation co, Map<String, List<io.swagger.codegen.v3.CodegenOperation>> operations) Add operation to groupio.swagger.codegen.v3.CodegenPropertyfromProperty(String name, io.swagger.v3.oas.models.media.Schema propertySchema) Convert Swagger Property object to Codegen Property objectgetHelp()getName()io.swagger.codegen.v3.CodegenTypegetTag()booleanmodelInheritanceSupport(List<?> allModels) postProcessAllModels(Map<String, Object> objs) voidpostProcessModelProperty(io.swagger.codegen.v3.CodegenModel model, io.swagger.codegen.v3.CodegenProperty property) postProcessModelsEnum(Map<String, Object> objs) post process enum defined in model's propertiespostProcessOperations(Map<String, Object> objs) voidpreprocessOpenAPI(io.swagger.v3.oas.models.OpenAPI openAPI) voidvoidsetAsync(boolean async) voidsetBasePackage(String configPackage) voidsetConfigPackage(String configPackage) voidsetDefaultInterfaces(boolean defaultInterfaces) voidsetDelegatePattern(boolean delegatePattern) voidsetImplicitHeaders(boolean implicitHeaders) voidsetInterfaceOnly(boolean interfaceOnly) voidsetJava11(boolean java11) voidsetJava8(boolean java8) voidsetNotNullJacksonAnnotation(boolean notNullJacksonAnnotation) voidsetOpenFeign(boolean openFeign) voidsetParameterExampleValue(io.swagger.codegen.v3.CodegenParameter p) Return the example value of the parameter.voidsetResponseWrapper(String responseWrapper) voidsetSingleContentTypes(boolean singleContentTypes) voidsetSwaggerDocketConfig(boolean swaggerDocketConfig) voidsetThrowsException(boolean throwsException) voidvoidsetUseBeanValidation(boolean useBeanValidation) voidsetUseOptional(boolean useOptional) voidsetUseTags(boolean useTags) voidsetValidationMode(String validationMode) Output the API (class) name (capitalized) ending with "Api" Return DefaultApi if name is emptytoApiTestFilename(String name) Return the file name of the Api TestMethods inherited from class io.swagger.codegen.v3.generators.java.AbstractJavaCodegen
addAdditionPropertiesToCodeGenModel, addHandlebarHelpers, apiDocFileFolder, apiFileFolder, apiTestFileFolder, camelizeVarName, checkAliasModel, checkDuplicatedModelNameIgnoringCase, convertPropertyToBoolean, escapeQuotationMark, escapeReservedWord, escapeUnderscore, escapeUnsafeCharacters, fixUpParentAndInterfaces, fromModel, fromOperation, getAlias, getSchemaType, getTypeDeclaration, isSameEnum, modelDocFileFolder, modelFileFolder, needToImport, postProcessModels, postProcessParameter, replaceDuplicatedInModelProperties, replaceDuplicatedInPaths, sanitizeTag, sanitizeVarName, setArtifactDescription, setArtifactId, setArtifactUrl, setArtifactVersion, setDateLibrary, setDeveloperEmail, setDeveloperName, setDeveloperOrganization, setDeveloperOrganizationUrl, setFullJavaUtil, setGroupId, setInvokerPackage, setJakarta, setJava11Mode, setJava8Mode, setLanguageArguments, setLicenseName, setLicenseUrl, setLocalVariablePrefix, setScmConnection, setScmDeveloperConnection, setScmUrl, setSerializableModel, setSerializeBigDecimalAsString, setSourceFolder, setSupportJava6, setTestFolder, setUseNullableForNotnull, setWithXml, toApiDocFilename, toApiFilename, toBooleanGetter, toDefaultValue, toEnumName, toEnumValue, toEnumVarName, toExampleValue, toModelDocFilename, toModelFilename, toModelName, toOperationId, toParamName, toRegularExpression, toVarName, writePropertyBackMethods inherited from class io.swagger.codegen.v3.generators.DefaultCodegenConfig
addConsumesInfo, addImport, additionalProperties, addOperationImports, addOption, addOption, addParameters, addParentContainer, addProducesInfo, addProperties, addRegularExpressionDelimiter, addSwitch, addVars, apiDocFilename, apiDocTemplateFiles, apiFilename, apiPackage, apiTemplateFiles, apiTestFilename, apiTestTemplateFiles, buildLibraryCliOption, camelize, camelize, cliOptions, configFiles, configureDataForTestTemplate, configuresParameterForMediaType, convertPropertyToBooleanAndWriteBack, copyFirstAllOfProperties, customTemplateDir, dashize, defaultIgnoreImportMappingOption, defaultIncludes, detectParent, embeddedTemplateDir, ensureUniqueParameters, escapeText, fileSuffix, findCommonPrefixOfVars, findMethodResponse, fromModel, fromOperation, fromParameter, fromRequestBody, fromResponse, fromSecurity, generateExamplePath, getCollectionFormat, getCommonTemplateDir, getConsumesInfo, getContentType, getGitRepoBaseURL, getGitRepoId, getGitUserId, getHideGenerationTimestamp, getHttpUserAgent, getIgnoreFilePathOverride, getIgnoreImportMapping, getInnerEnumAllowableValues, getInputSpec, getInputURL, getLanguageArguments, getLibrary, getOpenAPI, getOptionValue, getOrGenerateOperationId, getOutputDir, getParameterFromRef, getParentName, getProducesInfo, getReleaseNote, getSchemaFromBody, getSchemaFromParameter, getSchemaFromResponse, getSchemaHandler, getSortParamsByRequiredFlag, getSymbolName, getTemplateDir, getTemplateEngine, getTemplateVersion, getterAndSetterCapitalize, getTypeDeclaration, hasSchemaProperties, hasTrueAdditionalProperties, importMapping, initialCaps, instantiationTypes, isDataTypeBinary, isDataTypeFile, isFileTypeSchema, isObjectSchema, isPrimivite, isPropertyInnerMostEnum, isRemoveOperationIdPrefix, isReservedWord, isSkipOverwrite, languageSpecificPrimitives, modelDocTemplateFiles, modelPackage, modelTemplateFiles, modelTestFileFolder, modelTestTemplateFiles, needsUnflattenedSpec, outputFolder, postProcessAllCodegenModels, postProcessOperationsWithModels, processCompiler, processMapSchema, processModelEnums, processOpenAPI, processPropertySchemaContainerTypes, processPropertySchemaTypes, readLanguageArguments, removeNonNameElementToCamelCase, removeNonNameElementToCamelCase, reservedWords, reservedWordsMappings, sanitizeName, setAllowUnicodeIdentifiers, setApiPackage, setCommonTemplateDir, setEnsureUniqueParams, setGitRepoBaseURL, setGitRepoId, setGitUserId, setHideGenerationTimestamp, setHttpUserAgent, setIgnoreFilePathOverride, setIgnoreImportMapping, setInputSpec, setInputURL, setLibrary, setModelNamePrefix, setModelNameSuffix, setModelPackage, setNonArrayMapProperty, setOutputDir, setParameterBooleanFlagWithCodegenProperty, setParameterJson, setParameterNullable, setReleaseNote, setRemoveOperationIdPrefix, setReservedWords, setReservedWordsLowerCase, setSchemaProperties, setSkipOverwrite, setSortParamsByRequiredFlag, setTemplateDir, setTemplateEngine, setTemplateVersion, setUnflattenedOpenAPI, setUseOas2, shouldOverwrite, snakeCase, supportedLibraries, supportingFiles, templateDir, testPackage, toApiImport, toApiVarName, toDefaultValueWithParam, toEnumDefaultValue, toExamples, toGetter, toInstantiationType, toModelImport, toModelTestFilename, toSetter, typeMapping, underscore, updateCodegenModelEnumVars, updateCodegenPropertyEnum, updateDataTypeWithEnumForArray, updateDataTypeWithEnumForMap, updatePropertyForArray, updatePropertyForMap, vendorExtensions, writeOptional, writeOptionalMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface io.swagger.codegen.v3.CodegenConfig
getCodeName, getPriority, isPrivileged
-
Field Details
-
DEFAULT_LIBRARY
- See Also:
-
TITLE
- See Also:
-
CONFIG_PACKAGE
- See Also:
-
BASE_PACKAGE
- See Also:
-
INTERFACE_ONLY
- See Also:
-
DELEGATE_PATTERN
- See Also:
-
SINGLE_CONTENT_TYPES
- See Also:
-
ASYNC
- See Also:
-
RESPONSE_WRAPPER
- See Also:
-
USE_TAGS
- See Also:
-
SPRING_MVC_LIBRARY
- See Also:
-
SPRING_CLOUD_LIBRARY
- See Also:
-
SPRING_BOOT_3_LIBRARY
- See Also:
-
IMPLICIT_HEADERS
- See Also:
-
SWAGGER_DOCKET_CONFIG
- See Also:
-
TARGET_OPENFEIGN
- See Also:
-
DEFAULT_INTERFACES
- See Also:
-
SPRING_BOOT_VERSION
- See Also:
-
SPRING_BOOT3_VERSION
- See Also:
-
SPRING_BOOT3_JAVA_VERSION
- See Also:
-
SPRING_BOOT_VERSION_2
- See Also:
-
DATE_PATTERN
- See Also:
-
DATE_TIME_PATTERN
- See Also:
-
THROWS_EXCEPTION
- See Also:
-
VALIDATION_MODE_OPTION
- See Also:
-
VALIDATION_MODE_LEGACY
- See Also:
-
VALIDATION_MODE_LEGACY_NULLABLE
- See Also:
-
VALIDATION_MODE_STRICT
- See Also:
-
VALIDATION_MODE_LOOSE
- See Also:
-
title
-
configPackage
-
basePackage
-
interfaceOnly
protected boolean interfaceOnly -
delegatePattern
protected boolean delegatePattern -
delegateMethod
protected boolean delegateMethod -
singleContentTypes
protected boolean singleContentTypes -
java8
protected boolean java8 -
java11
protected boolean java11 -
async
protected boolean async -
responseWrapper
-
useTags
protected boolean useTags -
useBeanValidation
protected boolean useBeanValidation -
implicitHeaders
protected boolean implicitHeaders -
swaggerDocketConfig
protected boolean swaggerDocketConfig -
useOptional
protected boolean useOptional -
openFeign
protected boolean openFeign -
defaultInterfaces
protected boolean defaultInterfaces -
springBootVersion
-
springBoot3Version
-
springBoot3JavaVersion
-
throwsException
protected boolean throwsException -
validationMode
-
-
Constructor Details
-
SpringCodegen
public SpringCodegen()
-
-
Method Details
-
addCodegenContentParameters
protected void addCodegenContentParameters(io.swagger.codegen.v3.CodegenOperation codegenOperation, List<io.swagger.codegen.v3.CodegenContent> codegenContents) - Overrides:
addCodegenContentParametersin classDefaultCodegenConfig
-
getTag
public io.swagger.codegen.v3.CodegenType getTag()- Specified by:
getTagin interfaceio.swagger.codegen.v3.CodegenConfig
-
getName
- Specified by:
getNamein interfaceio.swagger.codegen.v3.CodegenConfig
-
getHelp
- Specified by:
getHelpin interfaceio.swagger.codegen.v3.CodegenConfig
-
processOpts
public void processOpts()- Specified by:
processOptsin interfaceio.swagger.codegen.v3.CodegenConfig- Overrides:
processOptsin classAbstractJavaCodegen
-
fromProperty
public io.swagger.codegen.v3.CodegenProperty fromProperty(String name, io.swagger.v3.oas.models.media.Schema propertySchema) Description copied from class:DefaultCodegenConfigConvert Swagger Property object to Codegen Property object- Overrides:
fromPropertyin classDefaultCodegenConfig- Parameters:
name- name of the propertypropertySchema- Schema object- Returns:
- Codegen Property object TODO : improve repeated code
-
addOperationToGroup
public void addOperationToGroup(String tag, String resourcePath, io.swagger.v3.oas.models.Operation operation, io.swagger.codegen.v3.CodegenOperation co, Map<String, List<io.swagger.codegen.v3.CodegenOperation>> operations) Description copied from class:DefaultCodegenConfigAdd operation to group- Specified by:
addOperationToGroupin interfaceio.swagger.codegen.v3.CodegenConfig- Overrides:
addOperationToGroupin classDefaultCodegenConfig- Parameters:
tag- name of the tagresourcePath- path of the resourceoperation- Swagger Operation objectco- Codegen Operation objectoperations- map of Codegen operations
-
getArgumentsLocation
- Overrides:
getArgumentsLocationin classDefaultCodegenConfig
-
getDefaultTemplateDir
- Specified by:
getDefaultTemplateDirin classDefaultCodegenConfig
-
preprocessOpenAPI
public void preprocessOpenAPI(io.swagger.v3.oas.models.OpenAPI openAPI) - Specified by:
preprocessOpenAPIin interfaceio.swagger.codegen.v3.CodegenConfig- Overrides:
preprocessOpenAPIin classAbstractJavaCodegen
-
postProcessOperations
- Specified by:
postProcessOperationsin interfaceio.swagger.codegen.v3.CodegenConfig- Overrides:
postProcessOperationsin classAbstractJavaCodegen
-
setNotNullJacksonAnnotation
public void setNotNullJacksonAnnotation(boolean notNullJacksonAnnotation) - Specified by:
setNotNullJacksonAnnotationin interfaceNotNullAnnotationFeatures
-
isNotNullJacksonAnnotation
public boolean isNotNullJacksonAnnotation()- Specified by:
isNotNullJacksonAnnotationin interfaceNotNullAnnotationFeatures
-
postProcessSupportingFileData
- Specified by:
postProcessSupportingFileDatain interfaceio.swagger.codegen.v3.CodegenConfig- Overrides:
postProcessSupportingFileDatain classDefaultCodegenConfig
-
toApiName
Description copied from class:DefaultCodegenConfigOutput the API (class) name (capitalized) ending with "Api" Return DefaultApi if name is empty- Specified by:
toApiNamein interfaceio.swagger.codegen.v3.CodegenConfig- Overrides:
toApiNamein classAbstractJavaCodegen- Parameters:
name- the name of the Api- Returns:
- capitalized Api name ending with "Api"
-
toApiTestFilename
Description copied from class:DefaultCodegenConfigReturn the file name of the Api Test- Specified by:
toApiTestFilenamein interfaceio.swagger.codegen.v3.CodegenConfig- Overrides:
toApiTestFilenamein classAbstractJavaCodegen- Parameters:
name- the file name of the Api- Returns:
- the file name of the Api
-
setParameterExampleValue
public void setParameterExampleValue(io.swagger.codegen.v3.CodegenParameter p) Description copied from class:DefaultCodegenConfigReturn the example value of the parameter.- Overrides:
setParameterExampleValuein classAbstractJavaCodegen- Parameters:
p- Swagger property object
-
setTitle
-
setConfigPackage
-
setValidationMode
-
setBasePackage
-
setInterfaceOnly
public void setInterfaceOnly(boolean interfaceOnly) -
setDelegatePattern
public void setDelegatePattern(boolean delegatePattern) -
setSingleContentTypes
public void setSingleContentTypes(boolean singleContentTypes) -
setJava8
public void setJava8(boolean java8) -
setJava11
public void setJava11(boolean java11) -
setAsync
public void setAsync(boolean async) -
setResponseWrapper
-
setUseTags
public void setUseTags(boolean useTags) -
setImplicitHeaders
public void setImplicitHeaders(boolean implicitHeaders) -
setSwaggerDocketConfig
public void setSwaggerDocketConfig(boolean swaggerDocketConfig) -
postProcessModelProperty
public void postProcessModelProperty(io.swagger.codegen.v3.CodegenModel model, io.swagger.codegen.v3.CodegenProperty property) - Specified by:
postProcessModelPropertyin interfaceio.swagger.codegen.v3.CodegenConfig- Overrides:
postProcessModelPropertyin classAbstractJavaCodegen
-
postProcessAllModels
- Specified by:
postProcessAllModelsin interfaceio.swagger.codegen.v3.CodegenConfig- Overrides:
postProcessAllModelsin classDefaultCodegenConfig
-
modelInheritanceSupport
-
postProcessModelsEnum
Description copied from class:DefaultCodegenConfigpost process enum defined in model's properties- Overrides:
postProcessModelsEnumin classDefaultCodegenConfig- Parameters:
objs- Map of models- Returns:
- maps of models with better enum support
-
setUseBeanValidation
public void setUseBeanValidation(boolean useBeanValidation) - Specified by:
setUseBeanValidationin interfaceBeanValidationFeatures
-
setUseOptional
public void setUseOptional(boolean useOptional) - Specified by:
setUseOptionalin interfaceOptionalFeatures
-
setOpenFeign
public void setOpenFeign(boolean openFeign) -
setDefaultInterfaces
public void setDefaultInterfaces(boolean defaultInterfaces) -
setThrowsException
public void setThrowsException(boolean throwsException)
-