Class AbstractView
- java.lang.Object
- org.springframework.web.reactive.result.view.AbstractView
- All Implemented Interfaces:
Aware,BeanNameAware,ApplicationContextAware,View
- Direct Known Subclasses:
AbstractUrlBasedView
public abstract class AbstractView extends Object implements View, BeanNameAware, ApplicationContextAware
Base class forViewimplementations.- Since:
- 5.0
- Author:
- Rossen Stoyanchev, Sam Brannen
Field Summary
Fields Modifier and Type Field Description protected LogloggerLogger that is available to subclasses.static StringREQUEST_DATA_VALUE_PROCESSOR_BEAN_NAMEWell-known name for the RequestDataValueProcessor in the bean factory.Fields inherited from interface org.springframework.web.reactive.result.view.View
BINDING_CONTEXT_ATTRIBUTE
Constructor Summary
Constructors Constructor Description AbstractView()AbstractView(ReactiveAdapterRegistry reactiveAdapterRegistry)
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods Modifier and Type Method Description protected RequestContextcreateRequestContext(ServerWebExchange exchange, Map<String,Object> model)Create aRequestContextto expose under the specified attribute name.protected StringformatViewName()ApplicationContextgetApplicationContext()StringgetBeanName()Get the view's name.CharsetgetDefaultCharset()Get the default charset, used when the content type does not contain one.protected reactor.core.publisher.Mono<Map<String,Object>>getModelAttributes(Map<String,?> model, ServerWebExchange exchange)Prepare the model to use for rendering.StringgetRequestContextAttribute()Get the name of theRequestContextattribute for this view, if any.protected RequestDataValueProcessorgetRequestDataValueProcessor()Get theRequestDataValueProcessorto use.List<MediaType>getSupportedMediaTypes()Get the configured media types supported by this view.protected ApplicationContextobtainApplicationContext()Obtain theApplicationContextfor actual use.reactor.core.publisher.Mono<Void>render(Map<String,?> model, MediaType contentType, ServerWebExchange exchange)Prepare the model to render.protected abstract reactor.core.publisher.Mono<Void>renderInternal(Map<String,Object> renderAttributes, MediaType contentType, ServerWebExchange exchange)Subclasses must implement this method to actually render the view.protected reactor.core.publisher.Mono<Void>resolveAsyncAttributes(Map<String,Object> model)Deprecated.as of 5.1.8 this method is still invoked but it is a no-op.protected reactor.core.publisher.Mono<Void>resolveAsyncAttributes(Map<String,Object> model, ServerWebExchange exchange)Use the configuredReactiveAdapterRegistryto adapt asynchronous attributes toMono<T>orMono<List<T>>and then wait to resolve them into actual values.voidsetApplicationContext(ApplicationContext applicationContext)Set the ApplicationContext that this object runs in.voidsetBeanName(String beanName)Set the view's name.voidsetDefaultCharset(Charset defaultCharset)Set the default charset for this view, used when the content type does not contain one.voidsetRequestContextAttribute(String requestContextAttribute)Set the name of theRequestContextattribute for this view.voidsetSupportedMediaTypes(List<MediaType> supportedMediaTypes)Set the supported media types for this view.StringtoString()Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface org.springframework.web.reactive.result.view.View
isRedirectView
Field Detail
REQUEST_DATA_VALUE_PROCESSOR_BEAN_NAME
public static final String REQUEST_DATA_VALUE_PROCESSOR_BEAN_NAME
Well-known name for the RequestDataValueProcessor in the bean factory.- See Also:
- Constant Field Values
Constructor Detail
AbstractView
public AbstractView()
AbstractView
public AbstractView(ReactiveAdapterRegistry reactiveAdapterRegistry)
Method Detail
setSupportedMediaTypes
public void setSupportedMediaTypes(List<MediaType> supportedMediaTypes)
Set the supported media types for this view.Default is
"text/html;charset=UTF-8".
getSupportedMediaTypes
public List<MediaType> getSupportedMediaTypes()
Get the configured media types supported by this view.- Specified by:
getSupportedMediaTypesin interfaceView
setDefaultCharset
public void setDefaultCharset(Charset defaultCharset)
Set the default charset for this view, used when the content type does not contain one.Default is UTF 8.
getDefaultCharset
public Charset getDefaultCharset()
Get the default charset, used when the content type does not contain one.
setRequestContextAttribute
public void setRequestContextAttribute(@Nullable String requestContextAttribute)
Set the name of theRequestContextattribute for this view.Default is none (
null).
getRequestContextAttribute
@Nullable public String getRequestContextAttribute()
Get the name of theRequestContextattribute for this view, if any.
setBeanName
public void setBeanName(@Nullable String beanName)
Set the view's name. Helpful for traceability.Framework code must call this when constructing views.
- Specified by:
setBeanNamein interfaceBeanNameAware- Parameters:
beanName- the name of the bean in the factory. Note that this name is the actual bean name used in the factory, which may differ from the originally specified name: in particular for inner bean names, the actual bean name might have been made unique through appending "#..." suffixes. Use theBeanFactoryUtils.originalBeanName(String)method to extract the original bean name (without suffix), if desired.
getBeanName
@Nullable public String getBeanName()
Get the view's name.Should never be
nullif the view was correctly configured.
setApplicationContext
public void setApplicationContext(@Nullable ApplicationContext applicationContext)
Description copied from interface:ApplicationContextAwareSet the ApplicationContext that this object runs in. Normally this call will be used to initialize the object.Invoked after population of normal bean properties but before an init callback such as
InitializingBean.afterPropertiesSet()or a custom init-method. Invoked afterResourceLoaderAware.setResourceLoader(org.springframework.core.io.ResourceLoader),ApplicationEventPublisherAware.setApplicationEventPublisher(org.springframework.context.ApplicationEventPublisher)andMessageSourceAware, if applicable.- Specified by:
setApplicationContextin interfaceApplicationContextAware- Parameters:
applicationContext- the ApplicationContext object to be used by this object- See Also:
BeanInitializationException
getApplicationContext
@Nullable public ApplicationContext getApplicationContext()
obtainApplicationContext
protected final ApplicationContext obtainApplicationContext()
Obtain theApplicationContextfor actual use.- Returns:
- the
ApplicationContext(nevernull) - Throws:
IllegalStateException- if the ApplicationContext cannot be obtained- See Also:
getApplicationContext()
render
public reactor.core.publisher.Mono<Void> render(@Nullable Map<String,?> model, @Nullable MediaType contentType, ServerWebExchange exchange)
Prepare the model to render.- Specified by:
renderin interfaceView- Parameters:
model- a map with attribute names as keys and corresponding model objects as values (the map can also benullin case of an empty model)contentType- the content type selected to render with, which should match one of thesupported media typesexchange- the current exchange- Returns:
- a
Monothat represents when and if rendering succeeds
getModelAttributes
protected reactor.core.publisher.Mono<Map<String,Object>> getModelAttributes(@Nullable Map<String,?> model, ServerWebExchange exchange)
Prepare the model to use for rendering.The default implementation creates a combined output Map that includes model as well as static attributes with the former taking precedence.
resolveAsyncAttributes
protected reactor.core.publisher.Mono<Void> resolveAsyncAttributes(Map<String,Object> model, ServerWebExchange exchange)
Use the configuredReactiveAdapterRegistryto adapt asynchronous attributes toMono<T>orMono<List<T>>and then wait to resolve them into actual values. When the returnedMono<Void>completes, the asynchronous attributes in the model will have been replaced with their corresponding resolved values.- Returns:
- result a
Monothat completes when the model is ready - Since:
- 5.1.8
resolveAsyncAttributes
@Deprecated protected reactor.core.publisher.Mono<Void> resolveAsyncAttributes(Map<String,Object> model)
Deprecated.as of 5.1.8 this method is still invoked but it is a no-op. Please useresolveAsyncAttributes(Map, ServerWebExchange)instead. It is invoked after this one and does the actual work.Use the configuredReactiveAdapterRegistryto adapt asynchronous attributes toMono<T>orMono<List<T>>and then wait to resolve them into actual values. When the returnedMono<Void>completes, the asynchronous attributes in the model would have been replaced with their corresponding resolved values.- Returns:
- result
Monothat completes when the model is ready
createRequestContext
protected RequestContext createRequestContext(ServerWebExchange exchange, Map<String,Object> model)
Create aRequestContextto expose under the specified attribute name.The default implementation creates a standard
RequestContextinstance for the given exchange and model.Can be overridden in subclasses to create custom instances.
- Parameters:
exchange- the current exchangemodel- a combined output Map (nevernull), with dynamic values taking precedence over static attributes- Returns:
- the
RequestContextinstance - See Also:
setRequestContextAttribute(java.lang.String)
getRequestDataValueProcessor
@Nullable protected RequestDataValueProcessor getRequestDataValueProcessor()
Get theRequestDataValueProcessorto use.The default implementation looks in the
ApplicationContextfor aRequestDataValueProcessorbean with the nameREQUEST_DATA_VALUE_PROCESSOR_BEAN_NAME.- Returns:
- the
RequestDataValueProcessor, ornullif there is none in the application context
renderInternal
protected abstract reactor.core.publisher.Mono<Void> renderInternal(Map<String,Object> renderAttributes, @Nullable MediaType contentType, ServerWebExchange exchange)
Subclasses must implement this method to actually render the view.- Parameters:
renderAttributes- combined output Map (nevernull), with dynamic values taking precedence over static attributescontentType- the content type selected to render with, which should match one of the supported media typesexchange- current exchange- Returns:
- a
Monothat represents when and if rendering succeeds
formatViewName
protected String formatViewName()