ViewResolver概述
ViewResolver组件的作用主要根据视图名和本地化的Locale,来解析出相应的视图View对象。
在SpringMvc的源码中,ViewResolver是一个接口。该接口主要定义了一个方法。
- View resolveViewName(String viewName, Locale locale)
接口方法中需要viewName 和locale两个参数,viewName是视图名称,locale是本地化的参数。一般情况下,我们只需要通过viewName来找到相应的视图。在国际化的场景中,可以根据不同的locale来展示不同语言的视图。
ViewResolver类图
从以上类图中可以看出,AbstractCachingViewResolver,BeanNameViewResolver,ContentNegotiatingViewResolver,ViewResolverComposite这四个类直接继承至 ViewResolver接口,都只有一层继承结构。
只有AbstractCachingViewResolver类的继承关系相对来说复杂一些,AbstractCachingViewResolver类可以缓存已经解析过的视图。
AbstractCachingViewResolver系列
AbstractCachingViewResolver
AbstractCachingViewResolver类是一个抽象类。它提供了对View的缓存功能,当视图解析过一次就被缓存起来, 直到缓存的视图被删除前,视图解析都是自动从缓存中获取的。
AbstractCachingViewResolver类继承了WebApplicationObjectSupport父类,实现了ViewResolver接口。
AbstractCachingViewResolver类实现了ViewResolver接口的resolveViewName方法。
@Override
@Nullable
public View resolveViewName(String viewName, Locale locale) throws Exception {
if (!isCache()) {
return createView(viewName, locale);
}
else {
Object cacheKey = getCacheKey(viewName, locale);
View view = this.viewAccessCache.get(cacheKey);
if (view == null) {
synchronized (this.viewCreationCache) {
view = this.viewCreationCache.get(cacheKey);
if (view == null) {
// Ask the subclass to create the View object.
view = createView(viewName, locale);
if (view == null && this.cacheUnresolved) {
view = UNRESOLVED_VIEW;
}
if (view != null && this.cacheFilter.filter(view, viewName, locale)) {
this.viewAccessCache.put(cacheKey, view);
this.viewCreationCache.put(cacheKey, view);
}
}
}
}
else {
if (logger.isTraceEnabled()) {
logger.trace(formatKey(cacheKey) + "served from cache");
}
}
return (view != UNRESOLVED_VIEW ? view : null);
}
}
resolveViewName方法中主要做了以下几件事情。
- 首先要判断是否开启缓存。如果没有开启缓存,就直接调用createView(viewName, locale)方法,来创建一个视图。
- 如果有开启缓存,首先获取视图缓存的key值。然后再通过key值,在viewAccessCache缓存中获取视图。如果视图存在就直接返回。
- 如果viewAccessCache缓存中不存在该视图,则到viewCreationCache缓存中去找这个视图,找到就返回该视图。
- 如果viewCreationCache缓存中也不存在该视图,则再调用createView(viewName, locale)方法来创建一个视图返回。并把创建的视图放到viewAccessCache和viewCreationCache的缓存中。
在createView方法中,其实又调用了loadView方法。loadView方法在AbstractCachingViewResolver类中只是一个抽象方法,专门留给子类来实现自身的业务逻辑。
AbstractCachingViewResolver 类的缓存
在AbstractCachingViewResolver类中,使用了viewAccessCache和viewCreationCache两个HashMap来做缓存。
viewAccessCache是ConcurrentHashMap的类型。ConcurrentHashMap是一个支持高并发,线程安全,高效的哈希表。
viewCreationCache是LinkedHashMap类型的。LinkedHashMap是HashMap和双向链表的组合,它通过维护一个双向链表保证了值是有序的。LinkedHashMap中有一个removeEldestEntry方法。该方法返回一个boolearn值,当返回值为true的时候,LinkedHashMap会自动删除最前面的一个Map值。该方法是在put和putAll方法被调用是被触发。
在AbstractCachingViewResolver类中,是这样定义viewCreationCache的。viewCreationCache的重写了父类的removeEldestEntry方法。在该方法中会判断视图的数量是否超过了限制。如果已超过限制,就会先在viewAccessCache缓存删除掉最先缓存的视图。然后返回true, viewCreationCache就会制动删除这个视图。这样就将两种类型的map各自优势结合起来了。
/** Map from view key to View instance, synchronized for View creation. */
@SuppressWarnings("serial")
private final Map<Object, View> viewCreationCache =
new LinkedHashMap<Object, View>(DEFAULT_CACHE_LIMIT, 0.75f, true) {
@Override
protected boolean removeEldestEntry(Map.Entry<Object, View> eldest) {
if (size() > getCacheLimit()) {
viewAccessCache.remove(eldest.getKey());
return true;
}
else {
return false;
}
}
};
UrlBasedViewResolver
UrlBasedViewResolver直接继承了AbstractCachingViewResolver类。它是对viewResolvers接口一个比较基本的实现。它提供了一种URL拼接的方式来解析视图。
UrlBasedViewResolver类可以通过prefix属性和suffix属性,来分别设置一个前缀和后缀,最后视图的URL就是前缀+逻辑视图+后缀。
它主要重写了父类的getCacheKey,createView,loadView三个方法。
- getCacheKey方法
/**
* This implementation returns just the view name,
* as this ViewResolver doesn't support localized resolution.
*/
@Override
protected Object getCacheKey(String viewName, Locale locale) {
return viewName;
}
getCacheKey方法直接返回viewName,舍弃了locale这个参数。可见UrlBasedViewResolver类是不支持Locale。
- createView
/**
* Overridden to implement check for "redirect:" prefix.
* <p>Not possible in {@code loadView}, since overridden
* {@code loadView} versions in subclasses might rely on the
* superclass always creating instances of the required view class.
* @see #loadView
* @see #requiredViewClass
*/
@Override
protected View createView(String viewName, Locale locale) throws Exception {
// If this resolver is not supposed to handle the given view,
// return null to pass on to the next resolver in the chain.
if (!canHandle(viewName, locale)) {
return null;
}
// Check for special "redirect:" prefix.
if (viewName.startsWith(REDIRECT_URL_PREFIX)) {
String redirectUrl = viewName.substring(REDIRECT_URL_PREFIX.length());
RedirectView view = new RedirectView(redirectUrl,
isRedirectContextRelative(), isRedirectHttp10Compatible());
String[] hosts = getRedirectHosts();
if (hosts != null) {
view.setHosts(hosts);
}
return applyLifecycleMethods(REDIRECT_URL_PREFIX, view);
}
// Check for special "forward:" prefix.
if (viewName.startsWith(FORWARD_URL_PREFIX)) {
String forwardUrl = viewName.substring(FORWARD_URL_PREFIX.length());
InternalResourceView view = new InternalResourceView(forwardUrl);
return applyLifecycleMethods(FORWARD_URL_PREFIX, view);
}
// Else fall back to superclass implementation: calling loadView.
return super.createView(viewName, locale);
}
createView方法主要做了以下四件事情。
- 在canHandle方法中,通过视图名称来检查视图是否能被解析。
- 判断视图名称是否是以“redirect:”开头,如果是,则创建一个RedirectView类型的视图返回。RedirectView视图是用于重定向跳转。
- 再判断视图名称是否是以“forward:”开头,如果是,则创建一个InternalResourceView类型的forward视图返回。forward视图是用于转发操作。
- 如果不是以上的3种情况,则调用父类的createView方法。父类的createView方法又会调用loadView方法。
- loadView方法
/**
* Delegates to {@code buildView} for creating a new instance of the
* specified view class. Applies the following Spring lifecycle methods
* (as supported by the generic Spring bean factory):
* <ul>
* <li>ApplicationContextAware's {@code setApplicationContext}
* <li>InitializingBean's {@code afterPropertiesSet}
* </ul>
* @param viewName the name of the view to retrieve
* @return the View instance
* @throws Exception if the view couldn't be resolved
* @see #buildView(String)
* @see org.springframework.context.ApplicationContextAware#setApplicationContext
* @see org.springframework.beans.factory.InitializingBean#afterPropertiesSet
*/
@Override
protected View loadView(String viewName, Locale locale) throws Exception {
AbstractUrlBasedView view = buildView(viewName);
View result = applyLifecycleMethods(viewName, view);
return (view.checkResource(locale) ? result : null);
}
在loadView方法主要做了三件事情。
- 使用buildView方法创建一个视图。在buildView方法中根据视图的类型,使用了org.springframework.beans.BeanUtils.instantiateClass方法,创建了一个AbstractUrlBasedView类型的实例。AbstractUrlBasedView的实例创建好后,再对这个实例进行一些属性的设置。
视图中的url属性就是在这里设置的,url就是前缀加视图名再加后缀组合而成的。
- 使用applyLifecycleMethods方法,对创建的视图进行初始化的设置。
- 判断视图模板是否存在,如存在则返回,不存在就返回NULL值。
UrlBasedViewResolver实现了视图解析的基本功能,作为UrlBasedViewResolver类的子类只需要重写父类的两个方法,便可实现自己的功能。
- 重写了父类的requiredViewClass方法,在这个方法中返回自己的类型。
- 类重写了父类的buildView方法,先调用父类的buildView方法得到一个View对象后,再对该对设置自己独有的属性。
InternalResourceViewResolver
InternalResourceViewResolver类继承至UrlBasedViewResolver类。Spring MVC容器在初始化ViewResolver类型的组件时,初始化的就有InternalResourceViewResolver组件。在实际应用中InternalResourceViewResolver也是使用的最广泛的一个视图解析器。InternalResourceViewResolver会把返回的视图名称都解析为InternalResourceView对象。
InternalResourceViewResolver类重写了父类的requiredViewClass方法,返回的是InternalResourceView类型。
InternalResourceViewResolver类重写了父类的buildView方法,在buildView方法中,先调用父类的方法构建一个InternalResourceView对象。再设置对象InternalResourceView的alwaysInclude,preventDispatchLoop的属性值。
ViewResolverComposite
ViewResolverComposite类继承至ViewResolver接口。从ViewResolverComposite类名称可以知道它是一系列ViewResolver的组合。
ViewResolverComposite类中有一个属性是viewResolvers。它是一个ViewResolver类型的集合。我们可以对这个属性值进行设置。
ViewResolverComposite类实现了ViewResolver接口的resolveViewName方法。在resolveViewName方法中,程序会循环遍历viewResolvers集合,针对集合中的每一个ViewResolver的实例。调用每一个实例的resolveViewName方法,直到得到一个View为止。代码如下所示:
@Override
@Nullable
public View resolveViewName(String viewName, Locale locale) throws Exception {
for (ViewResolver viewResolver : this.viewResolvers) {
View view = viewResolver.resolveViewName(viewName, locale);
if (view != null) {
return view;
}
}
return null;
}
原文: Spring MVC组件之ViewResolver - yaoxtao - 博客园 (cnblogs.com)
作者: yaoxtao