org.springdoc.webmvc.api

Class OpenApiActuatorResource

java.lang.Object

io.swagger.v3.core.filter.SpecFilter

org.springdoc.api.AbstractOpenApiResource

org.springdoc.webmvc.api.OpenApiResource

org.springdoc.webmvc.api.OpenApiActuatorResource

@RestControllerEndpoint(id="openapi")
 @ConditionalOnProperty(name="springdoc.enable-default-api-docs",
                       havingValue="true",
                       matchIfMissing=true)
public class OpenApiActuatorResource
extends OpenApiResource

The type Open api actuator resource.

Author:

bnasslashen

Field Summary

Fields inherited from class org.springdoc.api.AbstractOpenApiResource

groupName, openAPIService, springDocConfigProperties, springDocCustomizers, springDocProviders

Constructor Summary

Constructors

Constructor and Description
OpenApiActuatorResource(org.springframework.beans.factory.ObjectFactory<OpenAPIService> openAPIBuilderObjectFactory, AbstractRequestService requestBuilder, GenericResponseService responseBuilder, OperationService operationParser, SpringDocConfigProperties springDocConfigProperties, SpringDocProviders springDocProviders, SpringDocCustomizers springDocCustomizers) Instantiates a new Open api actuator resource.
OpenApiActuatorResource(String groupName, org.springframework.beans.factory.ObjectFactory<OpenAPIService> openAPIBuilderObjectFactory, AbstractRequestService requestBuilder, GenericResponseService responseBuilder, OperationService operationParser, SpringDocConfigProperties springDocConfigProperties, SpringDocProviders springDocProviders, SpringDocCustomizers springDocCustomizers) Instantiates a new Open api actuator resource.

Method Summary

Modifier and Type	Method and Description
protected String	getServerUrl(javax.servlet.http.HttpServletRequest request, String apiDocsUrl) Gets server url.
byte[]	openapiJson(javax.servlet.http.HttpServletRequest request, Locale locale) Openapi json string.
byte[]	openapiYaml(javax.servlet.http.HttpServletRequest request, Locale locale) Openapi yaml string.

Methods inherited from class org.springdoc.webmvc.api.OpenApiResource

calculatePath, calculateServerUrl, getPaths, openapiJson, openapiYaml

Methods inherited from class org.springdoc.api.AbstractOpenApiResource

addHiddenRestControllers, addHiddenRestControllers, addRestControllers, calculatePath, calculatePath, calculatePath, calculatePath, containsResponseBody, customizeOperation, customizeRouterOperation, decode, getActuatorURI, getDefaultAllowedHttpMethods, getOpenApi, getRouterFunctionPaths, initOpenAPIBuilder, isActuatorRestController, isAdditionalRestController, isConditionToMatch, isFilterCondition, isHiddenRestControllers, isMethodToFilter, isPackageToScan, isPathToMatch, isRestController, mergeRouters, setModelAndViewClass, writeJsonValue, writeYamlValue

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

Constructor Detail

OpenApiActuatorResource

public OpenApiActuatorResource(org.springframework.beans.factory.ObjectFactory<OpenAPIService> openAPIBuilderObjectFactory,
                               AbstractRequestService requestBuilder,
                               GenericResponseService responseBuilder,
                               OperationService operationParser,
                               SpringDocConfigProperties springDocConfigProperties,
                               SpringDocProviders springDocProviders,
                               SpringDocCustomizers springDocCustomizers)

Instantiates a new Open api actuator resource.

Parameters:

openAPIBuilderObjectFactory - the open api builder object factory

requestBuilder - the request builder

responseBuilder - the response builder

operationParser - the operation parser

springDocConfigProperties - the spring doc config properties

springDocProviders - the spring doc providers

springDocCustomizers - the spring doc customizers

OpenApiActuatorResource

public OpenApiActuatorResource(String groupName,
                               org.springframework.beans.factory.ObjectFactory<OpenAPIService> openAPIBuilderObjectFactory,
                               AbstractRequestService requestBuilder,
                               GenericResponseService responseBuilder,
                               OperationService operationParser,
                               SpringDocConfigProperties springDocConfigProperties,
                               SpringDocProviders springDocProviders,
                               SpringDocCustomizers springDocCustomizers)

Instantiates a new Open api actuator 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

springDocConfigProperties - the spring doc config properties

springDocProviders - the spring doc providers

springDocCustomizers - the spring doc customizers

Method Detail

openapiJson

@GetMapping(value="/",
            produces="application/json")
public byte[] openapiJson(javax.servlet.http.HttpServletRequest request,
                                                                                          Locale locale)
                                                                                   throws com.fasterxml.jackson.core.JsonProcessingException

Openapi json string.

Parameters:

request - the request

locale - the locale

Returns:

the string

Throws:

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

openapiYaml

@GetMapping(value="/yaml",
            produces="application/vnd.oai.openapi")
public byte[] openapiYaml(javax.servlet.http.HttpServletRequest request,
                                                                                                         Locale locale)
                                                                                                  throws com.fasterxml.jackson.core.JsonProcessingException

Openapi yaml string.

Parameters:

request - the request

locale - the locale

Returns:

the string

Throws:

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

getServerUrl

protected String getServerUrl(javax.servlet.http.HttpServletRequest request,
                              String apiDocsUrl)

Description copied from class: OpenApiResource

Gets server url.

Specified by:

getServerUrl in class OpenApiResource

Parameters:

request - the request

apiDocsUrl - the api docs url

Returns:

the server url