org.springdoc.api

Class AbstractOpenApiResource

java.lang.Object

io.swagger.v3.core.filter.SpecFilter

org.springdoc.api.AbstractOpenApiResource

public abstract class AbstractOpenApiResource
extends io.swagger.v3.core.filter.SpecFilter

The type Abstract open api resource.

Author:

bnasslahsen, kevinraddatz

Field Summary

Fields

Modifier and Type	Field and Description
protected String	groupName The Group name.
protected OpenAPIService	openAPIService The Open api builder.
protected Optional<ActuatorProvider>	optionalActuatorProvider The Actuator provider.
protected SpringDocConfigProperties	springDocConfigProperties The Spring doc config properties.

Constructor Summary

Constructors

Modifier

Constructor and Description

protected

AbstractOpenApiResource(String groupName, org.springframework.beans.factory.ObjectFactory<OpenAPIService> openAPIBuilderObjectFactory, AbstractRequestService requestBuilder, GenericResponseService responseBuilder, OperationService operationParser, Optional<List<OperationCustomizer>> operationCustomizers, Optional<List<OpenApiCustomiser>> openApiCustomisers, SpringDocConfigProperties springDocConfigProperties, Optional<ActuatorProvider> actuatorProvider) Instantiates a new Abstract open api resource.

Method Summary

Modifier and Type	Method and Description
static void	addHiddenRestControllers(Class<?>... classes) Add hidden rest controllers.
static void	addHiddenRestControllers(String... classes) Add hidden rest controllers.
static void	addRestControllers(Class<?>... classes) Add rest controllers.
protected void	calculatePath(org.springframework.web.method.HandlerMethod handlerMethod, RouterOperation routerOperation) Calculate path.
protected void	calculatePath(org.springframework.web.method.HandlerMethod handlerMethod, String operationPath, Set<org.springframework.web.bind.annotation.RequestMethod> requestMethods) Calculate path.
protected void	calculatePath(List<RouterOperation> routerOperationList) Calculate path.
protected void	calculatePath(RouterOperation routerOperation) Calculate path.
protected io.swagger.v3.oas.models.Operation	customiseOperation(io.swagger.v3.oas.models.Operation operation, org.springframework.web.method.HandlerMethod handlerMethod) Customise operation operation.
protected String	decode(String requestURI) Decode string.
protected URI	getActuatorURI(String scheme, String host) Gets actuator uri.
protected Set<org.springframework.web.bind.annotation.RequestMethod>	getDefaultAllowedHttpMethods() Gets default allowed http methods.
protected io.swagger.v3.oas.models.OpenAPI	getOpenApi() Gets open api.
protected abstract void	getPaths(Map<String,Object> findRestControllers) Gets paths.
protected void	getRouterFunctionPaths(String beanName, AbstractRouterFunctionVisitor routerFunctionVisitor) Gets router function paths.
protected void	initOpenAPIBuilder() Init open api builder.
protected boolean	isAdditionalRestController(Class<?> rawClass) Is additional rest controller boolean.
protected boolean	isConditionToMatch(String[] existingConditions, org.springdoc.api.AbstractOpenApiResource.ConditionType conditionType) Is condition to match boolean.
protected boolean	isFilterCondition(org.springframework.web.method.HandlerMethod handlerMethod, String operationPath, String[] produces, String[] consumes, String[] headers) Is filter condition boolean.
static boolean	isHiddenRestControllers(Class<?> rawClass) Is hidden rest controllers boolean.
protected boolean	isPackageToScan(Package aPackage) Is package to scan boolean.
protected boolean	isPathToMatch(String operationPath) Is path to match boolean.
protected boolean	isShowActuator() Is show actuator boolean.
protected void	mergeRouters(List<RouterFunctionData> routerFunctionDatas, List<RouterOperation> routerOperationList) Merge routers.
protected String	writeJsonValue(io.swagger.v3.oas.models.OpenAPI openAPI) Write json value string.
protected String	writeYamlValue(io.swagger.v3.oas.models.OpenAPI openAPI) Write yaml value string.

Methods inherited from class io.swagger.v3.core.filter.SpecFilter

filter, filterComponentsSchema, filterOpenAPI, filterOperation, filterParameter, filterPathItem, filterRequestBody, filterResponse, locateReferencedDefinitions, removeBrokenReferenceDefinitions, resolveAllNestedRefs

Methods inherited from class java.lang.Object

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

Field Detail

openAPIService

protected OpenAPIService openAPIService

The Open api builder.

springDocConfigProperties

protected final SpringDocConfigProperties springDocConfigProperties

The Spring doc config properties.

optionalActuatorProvider

protected final Optional<ActuatorProvider> optionalActuatorProvider

The Actuator provider.

groupName

protected final String groupName

The Group name.

Constructor Detail

AbstractOpenApiResource

protected AbstractOpenApiResource(String groupName,
                                  org.springframework.beans.factory.ObjectFactory<OpenAPIService> openAPIBuilderObjectFactory,
                                  AbstractRequestService requestBuilder,
                                  GenericResponseService responseBuilder,
                                  OperationService operationParser,
                                  Optional<List<OperationCustomizer>> operationCustomizers,
                                  Optional<List<OpenApiCustomiser>> openApiCustomisers,
                                  SpringDocConfigProperties springDocConfigProperties,
                                  Optional<ActuatorProvider> actuatorProvider)

Instantiates a new Abstract open api resource.

Parameters:

groupName - the group name

openAPIBuilderObjectFactory - the open api builder object factory

requestBuilder - the request builder

responseBuilder - the response builder

operationParser - the operation parser

operationCustomizers - the operation customizers

openApiCustomisers - the open api customisers

springDocConfigProperties - the spring doc config properties

actuatorProvider - the actuator provider

Method Detail

addRestControllers

public static void addRestControllers(Class<?>... classes)

Add rest controllers.

Parameters:

classes - the classes

addHiddenRestControllers

public static void addHiddenRestControllers(Class<?>... classes)

Add hidden rest controllers.

Parameters:

classes - the classes

addHiddenRestControllers

public static void addHiddenRestControllers(String... classes)

Add hidden rest controllers.

Parameters:

classes - the classes

getOpenApi

protected io.swagger.v3.oas.models.OpenAPI getOpenApi()

Gets open api.

Returns:

the open api

getPaths

protected abstract void getPaths(Map<String,Object> findRestControllers)

Gets paths.

Parameters:

findRestControllers - the find rest controllers

calculatePath

protected void calculatePath(org.springframework.web.method.HandlerMethod handlerMethod,
                             RouterOperation routerOperation)

Calculate path.

Parameters:

handlerMethod - the handler method

routerOperation - the router operation

calculatePath

protected void calculatePath(List<RouterOperation> routerOperationList)

Calculate path.

Parameters:

routerOperationList - the router operation list

calculatePath

protected void calculatePath(RouterOperation routerOperation)

Calculate path.

Parameters:

routerOperation - the router operation

calculatePath

protected void calculatePath(org.springframework.web.method.HandlerMethod handlerMethod,
                             String operationPath,
                             Set<org.springframework.web.bind.annotation.RequestMethod> requestMethods)

Calculate path.

Parameters:

handlerMethod - the handler method

operationPath - the operation path

requestMethods - the request methods

getRouterFunctionPaths

protected void getRouterFunctionPaths(String beanName,
                                      AbstractRouterFunctionVisitor routerFunctionVisitor)

Gets router function paths.

Parameters:

beanName - the bean name

routerFunctionVisitor - the router function visitor

isFilterCondition

protected boolean isFilterCondition(org.springframework.web.method.HandlerMethod handlerMethod,
                                    String operationPath,
                                    String[] produces,
                                    String[] consumes,
                                    String[] headers)

Is filter condition boolean.

Parameters:

handlerMethod - the handler method

operationPath - the operation path

produces - the produces

consumes - the consumes

headers - the headers

Returns:

the boolean

isConditionToMatch

protected boolean isConditionToMatch(String[] existingConditions,
                                     org.springdoc.api.AbstractOpenApiResource.ConditionType conditionType)

Is condition to match boolean.

Parameters:

existingConditions - the existing conditions

conditionType - the condition type

Returns:

the boolean

isPackageToScan

protected boolean isPackageToScan(Package aPackage)

Is package to scan boolean.

Parameters:

aPackage - the a package

Returns:

the boolean

isPathToMatch

protected boolean isPathToMatch(String operationPath)

Is path to match boolean.

Parameters:

operationPath - the operation path

Returns:

the boolean

decode

protected String decode(String requestURI)

Decode string.

Parameters:

requestURI - the request uri

Returns:

the string

isAdditionalRestController

protected boolean isAdditionalRestController(Class<?> rawClass)

Is additional rest controller boolean.

Parameters:

rawClass - the raw class

Returns:

the boolean

isHiddenRestControllers

public static boolean isHiddenRestControllers(Class<?> rawClass)

Is hidden rest controllers boolean.

Parameters:

rawClass - the raw class

Returns:

the boolean

getDefaultAllowedHttpMethods

protected Set<org.springframework.web.bind.annotation.RequestMethod> getDefaultAllowedHttpMethods()

Gets default allowed http methods.

Returns:

the default allowed http methods

customiseOperation

protected io.swagger.v3.oas.models.Operation customiseOperation(io.swagger.v3.oas.models.Operation operation,
                                                                org.springframework.web.method.HandlerMethod handlerMethod)

Customise operation operation.

Parameters:

operation - the operation

handlerMethod - the handler method

Returns:

the operation

mergeRouters

protected void mergeRouters(List<RouterFunctionData> routerFunctionDatas,
                            List<RouterOperation> routerOperationList)

Merge routers.

Parameters:

routerFunctionDatas - the router function datas

routerOperationList - the router operation list

initOpenAPIBuilder

protected void initOpenAPIBuilder()

Init open api builder.

writeYamlValue

protected String writeYamlValue(io.swagger.v3.oas.models.OpenAPI openAPI)
                         throws com.fasterxml.jackson.core.JsonProcessingException

Write yaml value string.

Parameters:

openAPI - the open api

Returns:

the string

Throws:

com.fasterxml.jackson.core.JsonProcessingException - the json processing exception

getActuatorURI

protected URI getActuatorURI(String scheme,
                             String host)

Gets actuator uri.

Parameters:

scheme - the scheme

host - the host

Returns:

the actuator uri

isShowActuator

protected boolean isShowActuator()

Is show actuator boolean.

Returns:

the boolean

writeJsonValue

protected String writeJsonValue(io.swagger.v3.oas.models.OpenAPI openAPI)
                         throws com.fasterxml.jackson.core.JsonProcessingException

Write json value string.

Parameters:

openAPI - the open api

Returns:

the string

Throws:

com.fasterxml.jackson.core.JsonProcessingException - the json processing exception