Package io.microsphere.spring.webmvc.annotation

Annotation Interface EnableWebMvcExtension

@Retention(RUNTIME)
@Target(TYPE)
@Documented
@Import({WebMvcExtensionBeanDefinitionRegistrar.class,WebMvcExtensionConfiguration.class})
@EnableWebExtension
public @interface EnableWebMvcExtension

Enable annotation to extend the features of Spring WebMVC

Since:

1.0.0

Author:

Mercy

See Also:

• EnableWebMvc
• EnableWebExtension
• WebMvcExtensionBeanDefinitionRegistrar
• WebMvcExtensionConfiguration

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element	Description
Class<? extends org.springframework.web.servlet.HandlerInterceptor>[]	handlerInterceptors	Specify HandlerInterceptor types or its inherited types to register into InterceptorRegistry.
boolean	interceptHandlerMethods	Indicate whether Spring Web HandlerMethod should be intercepted.
boolean	publishEvents	Indicate whether it publishes the Spring Web extension events: HandlerMethodArgumentsResolvedEvent(if enabled) WebEndpointMappingsReadyEvent(if enabled)
boolean	registerHandlerInterceptors	Indicate whether the InterceptorRegistry registers the beans of HandlerInterceptor.
boolean	registerWebEndpointMappings	Indicate whether The Spring Web registers the instances of WebEndpointMapping that source from Spring WebMVC, Spring WebFlux or Classical Servlet.
boolean	storeRequestBodyArgument	Indicate that Stores the argument of HandlerMethod that annotated RequestBody
boolean	storeResponseBodyReturnValue	Stores the return value of HandlerMethod before write as the ResponseBody

Element Details

registerWebEndpointMappings

@AliasFor(annotation=io.microsphere.spring.web.annotation.EnableWebExtension.class)
boolean registerWebEndpointMappings

Indicate whether The Spring Web registers the instances of WebEndpointMapping that source from Spring WebMVC, Spring WebFlux or Classical Servlet.

Returns:

true as default

See Also:

• WebEndpointMapping
• WebEndpointMappingRegistry
• WebEndpointMappingRegistrar

Default:

true

interceptHandlerMethods

@AliasFor(annotation=io.microsphere.spring.web.annotation.EnableWebExtension.class)
boolean interceptHandlerMethods

Indicate whether Spring Web HandlerMethod should be intercepted. If true, HandlerMethodArgumentInterceptor and HandlerMethodInterceptor beans will be initialized and then be invoked around HandlerMethod being executed.

Returns:

true as default

See Also:

• HandlerMethodArgumentInterceptor
• HandlerMethodInterceptor

Default:

true

publishEvents

@AliasFor(annotation=io.microsphere.spring.web.annotation.EnableWebExtension.class)
boolean publishEvents

Indicate whether it publishes the Spring Web extension events:

• HandlerMethodArgumentsResolvedEvent(if enabled)
• WebEndpointMappingsReadyEvent(if enabled)

Returns:

true as default

See Also:

• WebEventPublisher
• WebEndpointMappingsReadyEvent
• HandlerMethodArgumentsResolvedEvent

Default:

true

registerHandlerInterceptors

boolean registerHandlerInterceptors

Indicate whether the InterceptorRegistry registers the beans of HandlerInterceptor. If it specifies true, handlerInterceptors() method will not work anymore.

Returns:

false as default

See Also:

• WebMvcConfigurer.addInterceptors(InterceptorRegistry)
• InterceptorRegistry

Default:

false

handlerInterceptors

Class<? extends org.springframework.web.servlet.HandlerInterceptor>[] handlerInterceptors

Specify HandlerInterceptor types or its inherited types to register into InterceptorRegistry. If registerHandlerInterceptors() is true, specified types will be ignored.

Returns:

null as default

See Also:

• WebMvcConfigurer.addInterceptors(InterceptorRegistry)
• InterceptorRegistry

Default:

{}

storeRequestBodyArgument

boolean storeRequestBodyArgument

Indicate that Stores the argument of HandlerMethod that annotated RequestBody

Returns:

false as default

See Also:

• RequestBody
• StoringRequestBodyArgumentAdvice
• HandlerMethod

Default:

false

storeResponseBodyReturnValue

boolean storeResponseBodyReturnValue

Stores the return value of HandlerMethod before write as the ResponseBody

Returns:

false as default

See Also:

• ResponseBody

Default:

false