Polish contribution

See gh-22606

Author: poutsma

spring-webmvc/src/main/java/org/springframework/web/servlet/view/AbstractCachingViewResolver.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2018 the original author or authors.
+ * Copyright 2002-2019 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -24,6 +24,7 @@
 import javax.servlet.http.HttpServletResponse;
 
 import org.springframework.lang.Nullable;
+import org.springframework.util.Assert;
 import org.springframework.web.context.support.WebApplicationObjectSupport;
 import org.springframework.web.servlet.View;
 import org.springframework.web.servlet.ViewResolver;
@@ -58,19 +59,22 @@ public void render(@Nullable Map<String, ?> model, HttpServletRequest request, H
 		}
 	};
 
+	/** Default cache filter that always caches. */
+	private static final CacheFilter DEFAULT_CACHE_FILTER = (view, viewName, locale) -> true;
+
 
 	/** The maximum number of entries in the cache. */
 	private volatile int cacheLimit = DEFAULT_CACHE_LIMIT;
 
 	/** Whether we should refrain from resolving views again if unresolved once. */
 	private boolean cacheUnresolved = true;
 
+	/** Filter function that determines if view should be cached. */
+	private CacheFilter cacheFilter = DEFAULT_CACHE_FILTER;
+
 	/** Fast access cache for Views, returning already cached instances without a global lock. */
 	private final Map<Object, View> viewAccessCache = new ConcurrentHashMap<>(DEFAULT_CACHE_LIMIT);
 
-	/** Filter function which determines if view should be cached. */
-	private ViewCacheFilter viewCacheFilter = (viewName, view, locale) -> true;
-
 	/** Map from view key to View instance, synchronized for View creation. */
 	@SuppressWarnings("serial")
 	private final Map<Object, View> viewCreationCache =
@@ -138,28 +142,28 @@ public void setCacheUnresolved(boolean cacheUnresolved) {
 	}
 
 	/**
-	 * Filter function which determines if view should be cached.
-	 * Default behaviour is to cache all views.
+	 * Return if caching of unresolved views is enabled.
 	 */
-	public void setViewCacheFilter(ViewCacheFilter cacheFilter) {
-		this.viewCacheFilter = cacheFilter;
+	public boolean isCacheUnresolved() {
+		return this.cacheUnresolved;
 	}
 
 	/**
-	 * Return filter function which determines if view should be cached.
+	 * Sets the filter that determines if view should be cached.
+	 * Default behaviour is to cache all views.
 	 */
-	public ViewCacheFilter getViewCacheFilter() {
-		return this.viewCacheFilter;
+	public void setCacheFilter(CacheFilter cacheFilter) {
+		Assert.notNull(cacheFilter, "CacheFilter must not be null");
+		this.cacheFilter = cacheFilter;
 	}
 
 	/**
-	 * Return if caching of unresolved views is enabled.
+	 * Return filter function that determines if view should be cached.
 	 */
-	public boolean isCacheUnresolved() {
-		return this.cacheUnresolved;
+	public CacheFilter getCacheFilter() {
+		return this.cacheFilter;
 	}
 
-
 	@Override
 	@Nullable
 	public View resolveViewName(String viewName, Locale locale) throws Exception {
@@ -178,7 +182,7 @@ public View resolveViewName(String viewName, Locale locale) throws Exception {
 						if (view == null && this.cacheUnresolved) {
 							view = UNRESOLVED_VIEW;
 						}
-						if (view != null && this.viewCacheFilter.filter(viewName, view, locale)) {
+						if (view != null && this.cacheFilter.filter(view, viewName, locale)) {
 							this.viewAccessCache.put(cacheKey, view);
 							this.viewCreationCache.put(cacheKey, view);
 						}
@@ -284,4 +288,26 @@ protected View createView(String viewName, Locale locale) throws Exception {
 	@Nullable
 	protected abstract View loadView(String viewName, Locale locale) throws Exception;
 
+
+	/**
+	 * Filter that determines if view should be cached.
+	 *
+	 * @author Sergey Galkin
+	 * @author Arjen Poutsma
+	 * @since 5.2
+	 */
+	@FunctionalInterface
+	public interface CacheFilter {
+
+		/**
+		 * Indicates whether the given view should be cached. The name and
+		 * locale used to resolve the view are also provided.
+		 * @param view the view
+		 * @param viewName the name used to resolve {@code view}
+		 * @param locale the locale used to resolve {@code view}
+		 * @return {@code true} if the view should be cached; {@code false}
+		 * otherwise
+		 */
+		boolean filter(View view, String viewName, Locale locale);
+	}
 }

spring-webmvc/src/main/java/org/springframework/web/servlet/view/ViewCacheFilter.java

@@ -516,6 +516,47 @@ protected View loadView(String viewName, Locale locale) {
 		assertThat(count.intValue()).isEqualTo(3);
 	}
 
+	@Test
+	public void cacheFilterEnabled() throws Exception {
+		AtomicInteger count = new AtomicInteger();
+
+		// filter is enabled by default
+		AbstractCachingViewResolver viewResolver = new AbstractCachingViewResolver() {
+			@Override
+			protected View loadView(String viewName, Locale locale) {
+				assertThat(viewName).isEqualTo("view");
+				assertThat(locale).isEqualTo(Locale.getDefault());
+				count.incrementAndGet();
+				return new TestView();
+			}
+		};
+
+		viewResolver.resolveViewName("view", Locale.getDefault());
+		viewResolver.resolveViewName("view", Locale.getDefault());
+
+		assertThat(count.intValue()).isEqualTo(1);
+	}
+
+	@Test
+	public void cacheFilterDisabled() throws Exception {
+		AtomicInteger count = new AtomicInteger();
+
+		AbstractCachingViewResolver viewResolver = new AbstractCachingViewResolver() {
+			@Override
+			protected View loadView(String viewName, Locale locale) {
+				count.incrementAndGet();
+				return new TestView();
+			}
+		};
+
+		viewResolver.setCacheFilter((view, viewName, locale) -> false);
+
+		viewResolver.resolveViewName("view", Locale.getDefault());
+		viewResolver.resolveViewName("view", Locale.getDefault());
+
+		assertThat(count.intValue()).isEqualTo(2);
+	}
+
 
 	public static class TestView extends InternalResourceView {