Package org.springdoc.core

Class OpenAPIService

java.lang.Object

org.springdoc.core.OpenAPIService

All Implemented Interfaces:

org.springframework.beans.factory.Aware, org.springframework.context.ApplicationContextAware

public class OpenAPIService
extends Object
implements org.springframework.context.ApplicationContextAware

The type Open api builder.

Author:

bnasslahsen

Constructor Summary

Constructors

Constructor	Description
OpenAPIService(Optional<io.swagger.v3.oas.models.OpenAPI> openAPI, SecurityService securityParser, SpringDocConfigProperties springDocConfigProperties, PropertyResolverUtils propertyResolverUtils, Optional<List<OpenApiBuilderCustomizer>> openApiBuilderCustomizers, Optional<List<ServerBaseUrlCustomizer>> serverBaseUrlCustomizers)	Instantiates a new Open api builder.

Method Summary

Modifier and Type	Method	Description
void	addMappings(Map<String,Object> mappings)	Add mappings.
void	addTag(Set<org.springframework.web.method.HandlerMethod> handlerMethods, io.swagger.v3.oas.models.tags.Tag tag)	Add tag.
void	build(Locale locale)	Build.
io.swagger.v3.oas.models.Operation	buildTags(org.springframework.web.method.HandlerMethod handlerMethod, io.swagger.v3.oas.models.Operation operation, io.swagger.v3.oas.models.OpenAPI openAPI, Locale locale)	Build tags operation.
void	buildTagsFromClass(Class<?> beanType, Set<io.swagger.v3.oas.models.tags.Tag> tags, Set<String> tagsStr, Locale locale)	Build tags from class.
io.swagger.v3.oas.models.OpenAPI	getCachedOpenAPI(Locale locale)	Gets cached open api.
io.swagger.v3.oas.models.OpenAPI	getCalculatedOpenAPI()	Gets calculated open api.
org.springframework.context.ApplicationContext	getContext()	Gets context.
Map<String,Object>	getControllerAdviceMap()	Gets controller advice map.
Map<String,Object>	getMappingsMap()	Gets mappings map.
SecurityService	getSecurityParser()	Gets security parser.
String	getServerBaseUrl()	Gets server base URL
boolean	isAutoTagClasses(io.swagger.v3.oas.models.Operation operation)	Is auto tag classes boolean.
void	resetCalculatedOpenAPI()	Reset calculated open api.
void	setApplicationContext(org.springframework.context.ApplicationContext applicationContext)
void	setCachedOpenAPI(io.swagger.v3.oas.models.OpenAPI cachedOpenAPI, Locale locale)	Sets cached open api.
void	setServerBaseUrl(String serverBaseUrl)	Sets server base url.
void	setServersPresent(boolean serversPresent)	Sets servers present.
static String	splitCamelCase(String str)	Split camel case string.
io.swagger.v3.oas.models.OpenAPI	updateServers(io.swagger.v3.oas.models.OpenAPI openAPI)	Update servers open api.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

OpenAPIService

public OpenAPIService(Optional<io.swagger.v3.oas.models.OpenAPI> openAPI,
                      SecurityService securityParser,
                      SpringDocConfigProperties springDocConfigProperties,
                      PropertyResolverUtils propertyResolverUtils,
                      Optional<List<OpenApiBuilderCustomizer>> openApiBuilderCustomizers,
                      Optional<List<ServerBaseUrlCustomizer>> serverBaseUrlCustomizers)

Instantiates a new Open api builder.

Parameters:

openAPI - the open api

securityParser - the security parser

springDocConfigProperties - the spring doc config properties

propertyResolverUtils - the property resolver utils

openApiBuilderCustomizers - the open api builder customisers

Method Detail

splitCamelCase

public static String splitCamelCase(String str)

Split camel case string.

Parameters:

str - the str

Returns:

the string

build

public void build(Locale locale)

Build.

Parameters:

locale - the locale

updateServers

public io.swagger.v3.oas.models.OpenAPI updateServers(io.swagger.v3.oas.models.OpenAPI openAPI)

Update servers open api.

Parameters:

openAPI - the open api

Returns:

the open api

setServersPresent

public void setServersPresent(boolean serversPresent)

Sets servers present.

Parameters:

serversPresent - the servers present

buildTags

public io.swagger.v3.oas.models.Operation buildTags(org.springframework.web.method.HandlerMethod handlerMethod,
                                                    io.swagger.v3.oas.models.Operation operation,
                                                    io.swagger.v3.oas.models.OpenAPI openAPI,
                                                    Locale locale)

Build tags operation.

Parameters:

handlerMethod - the handler method

operation - the operation

openAPI - the open api

locale - the locale

Returns:

the operation

buildTagsFromClass

public void buildTagsFromClass(Class<?> beanType,
                               Set<io.swagger.v3.oas.models.tags.Tag> tags,
                               Set<String> tagsStr,
                               Locale locale)

Build tags from class.

Parameters:

beanType - the bean type

tags - the tags

tagsStr - the tags str

locale - the locale

setServerBaseUrl

public void setServerBaseUrl(String serverBaseUrl)

Sets server base url.

Parameters:

serverBaseUrl - the server base url

isAutoTagClasses

public boolean isAutoTagClasses(io.swagger.v3.oas.models.Operation operation)

Is auto tag classes boolean.

Parameters:

operation - the operation

Returns:

the boolean

addTag

public void addTag(Set<org.springframework.web.method.HandlerMethod> handlerMethods,
                   io.swagger.v3.oas.models.tags.Tag tag)

Add tag.

Parameters:

handlerMethods - the handler methods

tag - the tag

getMappingsMap

public Map<String,Object> getMappingsMap()

Gets mappings map.

Returns:

the mappings map

addMappings

public void addMappings(Map<String,Object> mappings)

Add mappings.

Parameters:

mappings - the mappings

getControllerAdviceMap

public Map<String,Object> getControllerAdviceMap()

Gets controller advice map.

Returns:

the controller advice map

getCachedOpenAPI

public io.swagger.v3.oas.models.OpenAPI getCachedOpenAPI(Locale locale)

Gets cached open api.

Parameters:

locale - associated the the cache entry

Returns:

the cached open api

setCachedOpenAPI

public void setCachedOpenAPI(io.swagger.v3.oas.models.OpenAPI cachedOpenAPI,
                             Locale locale)

Sets cached open api.

Parameters:

cachedOpenAPI - the cached open api

locale - associated the the cache entry

getCalculatedOpenAPI

public io.swagger.v3.oas.models.OpenAPI getCalculatedOpenAPI()

Gets calculated open api.

Returns:

the calculated open api

resetCalculatedOpenAPI

public void resetCalculatedOpenAPI()

Reset calculated open api.

getContext

public org.springframework.context.ApplicationContext getContext()

Gets context.

Returns:

the context

getSecurityParser

public SecurityService getSecurityParser()

Gets security parser.

Returns:

the security parser

getServerBaseUrl

public String getServerBaseUrl()

Gets server base URL

Returns:

the server base URL

setApplicationContext

public void setApplicationContext(org.springframework.context.ApplicationContext applicationContext)
                           throws org.springframework.beans.BeansException

Specified by:

setApplicationContext in interface org.springframework.context.ApplicationContextAware

Throws:

org.springframework.beans.BeansException