ExamplesApplication: docs, disable @EnableWebMvc use spring boot default conventions, redirect in index.html; /click/* is served by spring/container

Author: magicprinc

examples/src/main/java/org/apache/click/examples/ExamplesApplication.java

@@ -14,50 +14,76 @@
 import org.springframework.context.Lifecycle;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.ComponentScan;
-import org.springframework.web.servlet.config.annotation.EnableWebMvc;
-import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
-import org.springframework.web.servlet.config.annotation.ViewControllerRegistry;
-import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
 
 import java.util.Collections;
 import java.util.HashMap;
 import java.util.Map;
 
+/**
+ spring-boot-starter-web
+
+ ⛔ If you want to take complete control of Spring MVC, you can add your own `@Configuration` annotated with `@EnableWebMvc`.
+    If you want to keep Spring Boot MVC features, and you just want to add additional MVC configuration (interceptors, formatters, view controllers etc.)
+ 				you can add your own `@Bean` of type WebMvcConfigurerAdapter, but without `@EnableWebMvc`!
+
+ https://stackoverflow.com/questions/42393211/how-can-i-serve-static-html-from-spring-boot
+
+ spring-boot-autoconfigure-2.7.18.jar!\META-INF\spring-configuration-metadata.json
+ <pre><code>
+ "name": "spring.web.resources.static-locations",
+ "type": "java.lang.String[]",
+ "description": "Locations of static resources. Defaults to classpath:[\/META-INF\/resources\/, \/resources\/, \/static\/, \/public\/].",
+ "sourceType": "org.springframework.boot.autoconfigure.web.WebProperties$Resources",
+ "defaultValue": [
+ "classpath:\/META-INF\/resources\/",
+ "classpath:\/resources\/",
+ "classpath:\/static\/",
+ "classpath:\/public\/"
+ ]
+
+ "name": "spring.web.resources.cache.period",
+ "type": "java.time.Duration",
+ "description": "Cache period for the resources served by the resource handler. If a duration suffix is not specified, seconds will be used. Can be overridden by the 'spring.web.resources.cache.cachecontrol' properties.",
+ "sourceType": "org.springframework.boot.autoconfigure.web.WebProperties$Resources$Cache"
+
+ </code></pre>
+ */
 @SpringBootApplication // (scanBasePackageClasses = { LunaApplication.class, RemoteMvelConsoleController.class })
-@EnableWebMvc
+//@EnableWebMvc → WebMvcConfigurer
 @ComponentScan(// == <context:component-scan base-package="org.apache.click.examples" scope-resolver="org.apache.click.extras.spring.PageScopeResolver"/>
 	basePackages = "org.apache.click.examples",
-	scopeResolver = PageScopeResolver.class
+	scopeResolver = PageScopeResolver.class,
+	basePackageClasses = ExamplesApplication.class
 )
 @Slf4j
-public class ExamplesApplication implements WebMvcConfigurer, Lifecycle {
+public class ExamplesApplication implements Lifecycle {
 	public static void main (String[] args) {
 		System.out.println(" *** main thread started *** "+Thread.currentThread());
 		SpringApplication.run(ExamplesApplication.class, args);
 		System.err.println(" *** main thread finishes *** "+Thread.currentThread());
   }
-	private static final String[] CLASSPATH_RESOURCE_LOCATIONS = {
-			"classpath:/META-INF/resources/",// todo classpath*:
-			"classpath:/resources/",
-			"classpath:/static/",
-			"classpath:/public/"
-	};
-
-	@Override
-	public void addResourceHandlers(ResourceHandlerRegistry registry) {
-		registry.addResourceHandler("/**").addResourceLocations(CLASSPATH_RESOURCE_LOCATIONS);
-		registry.addResourceHandler("/static/**").addResourceLocations("classpath*:/static/").setCachePeriod(3600);// .resourceChain(true)
-		registry.addResourceHandler("/resources/**").addResourceLocations("classpath:/resources/", "classpath:/static/", "classpath:/public/").setCachePeriod(3600).resourceChain(true);
-	}
+//	private static final String[] CLASSPATH_RESOURCE_LOCATIONS = {
+//			"classpath:/META-INF/resources/",// todo classpath*:
+//			"classpath:/resources/",
+//			"classpath:/static/",
+//			"classpath:/public/"
+//	};
+//	@Override
+//	public void addResourceHandlers(ResourceHandlerRegistry registry) {
+//		registry.addResourceHandler("/**").addResourceLocations(CLASSPATH_RESOURCE_LOCATIONS);
+//		registry.addResourceHandler("/static/**").addResourceLocations("classpath*:/static/").setCachePeriod(3600);// .resourceChain(true)
+//		registry.addResourceHandler("/resources/**").addResourceLocations("classpath:/resources/", "classpath:/static/", "classpath:/public/").setCachePeriod(3600).resourceChain(true);
+//	}
 
 	/**
-	 The Spring Click Servlet which handles *.htm requests.
-	 Add mapping informing ClickServlet to serve static resources contained under /click/* directly from Click's JAR files.
+	 The Spring Click Servlet which handles *.htm requests ~ "*.htm"
+	 Add mapping informing ClickServlet to serve static resources contained under /click/* directly from Click's JAR files ~ "/click/*"
 	 Please note, you only need this mapping in restricted environments where Click cannot deploy resources to the file system.
 	 */
 	@Bean
 	public ServletRegistrationBean<SpringClickServlet> clickServlet() {
-		val reg = new ServletRegistrationBean<>(new SpringClickServlet(), "*.htm", "/click/*");
+		//val reg = new ServletRegistrationBean<>(new SpringClickServlet(), "*.htm", "/click/*");
+		val reg = new ServletRegistrationBean<>(new SpringClickServlet(), "*.htm");
 		reg.setName("ClickServlet");
 		reg.setLoadOnStartup(0);
 
@@ -73,10 +99,10 @@ public ServletRegistrationBean<SpringClickServlet> clickServlet() {
 		return reg;
 	}
 
-	@Override
-	public void addViewControllers(ViewControllerRegistry registry) {
-		registry.addViewController("/").setViewName("forward:/home.htm");
-	}
+//	@Override
+//	public void addViewControllers(ViewControllerRegistry registry) {
+//		registry.addViewController("/").setViewName("forward:/home.htm");
+//	}
 
 	/**
 	 Provides an in memory database initialization listener.