com.holonplatform.jaxrs.swagger.v2.spring

Class JerseySwaggerV2AutoConfiguration

java.lang.Object

com.holonplatform.jaxrs.swagger.internal.spring.AbstractJaxrsApiEndpointsAutoConfiguration<A,io.swagger.config.SwaggerConfig>

com.holonplatform.jaxrs.swagger.v2.internal.spring.AbstractSwaggerV2AutoConfiguration<org.glassfish.jersey.server.ResourceConfig>

com.holonplatform.jaxrs.swagger.v2.spring.JerseySwaggerV2AutoConfiguration

All Implemented Interfaces:

org.springframework.beans.factory.Aware, org.springframework.beans.factory.BeanClassLoaderAware, org.springframework.beans.factory.BeanFactoryAware

@Configuration
 @ConditionalOnClass(name={"org.glassfish.jersey.server.ResourceConfig","io.swagger.models.Swagger"})
 @ConditionalOnBean(type="org.glassfish.jersey.server.ResourceConfig")
 @AutoConfigureOrder(value=2147482647)
 @AutoConfigureAfter(value=org.springframework.boot.autoconfigure.jersey.JerseyAutoConfiguration.class)
 @EnableConfigurationProperties(value=SwaggerConfigurationProperties.class)
public class JerseySwaggerV2AutoConfiguration
extends com.holonplatform.jaxrs.swagger.v2.internal.spring.AbstractSwaggerV2AutoConfiguration<org.glassfish.jersey.server.ResourceConfig>

Spring Boot Swagger V2 auto-configuration class for Jersey runtime.

This class configures API listing endpoints according to one or more API configuration definitions. An API configuration endpoint can be decalred and configured using either:

• One or more SwaggerConfig type beans (using for example the BeanConfig implementation). The ApiConfiguration annotation can be used on each API configuration bean to setup the API listing endpoint, for example to declare the JAX-RS endpoint path. When more then one SwaggerConfig type bean is declared, the ApiConfiguration.contextId() attribute should be used to declare a different API context id for each configuration.
• When no SwaggerConfig type bean is defined, the SwaggerConfigurationProperties application properties can be used to configure the API definition and the API listing endpoints. To declare more than one API definition subset, a set of API group can be declared. Each group id will be used as API context id.

By default, the ApiDefaults.DEFAULT_API_ENDPOINT_PATH path is used as JAX-RS API listing endpoint path if not configured otherwise.

A Jersey ResourceConfig type bean must be available in context to enable the API listing endpoints auto-configuration.

Since:

5.2.0

Constructor Summary

Constructors

Constructor and Description
JerseySwaggerV2AutoConfiguration(SwaggerConfigurationProperties configurationProperties, org.springframework.beans.factory.ObjectProvider<io.swagger.config.SwaggerConfig> apiConfigurations)

Method Summary

Modifier and Type	Method and Description
org.springframework.boot.autoconfigure.jersey.ResourceConfigCustomizer	jerseySwaggerV2ResourceConfigCustomizer()

Methods inherited from class com.holonplatform.jaxrs.swagger.v2.internal.spring.AbstractSwaggerV2AutoConfiguration

getContextIdByPath, jaxrsApiEndpointsDefinitionsV2InitializerApplicationListenerOnContextRefresh

Methods inherited from class com.holonplatform.jaxrs.swagger.internal.spring.AbstractJaxrsApiEndpointsAutoConfiguration

legacyContactToContactNamePropertyConverter, legacyLicenseToLicenseNamePropertyConverter, setBeanClassLoader, setBeanFactory

Methods inherited from class java.lang.Object

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

Constructor Detail

JerseySwaggerV2AutoConfiguration

public JerseySwaggerV2AutoConfiguration(SwaggerConfigurationProperties configurationProperties,
                                        org.springframework.beans.factory.ObjectProvider<io.swagger.config.SwaggerConfig> apiConfigurations)

Method Detail

jerseySwaggerV2ResourceConfigCustomizer

@Bean
public org.springframework.boot.autoconfigure.jersey.ResourceConfigCustomizer jerseySwaggerV2ResourceConfigCustomizer()