springboot同时配置thymeleaf和jsp两种模板引擎

简介：

Spring框架功能很强大，但是就算是一个很简单的项目，我们也要配置很多东西。因此就有了Spring Boot框架，它的作用很简单，就是帮我们自动配置。Spring Boot框架的核心就是自动配置，只要存在相应的jar包，Spring就帮我们自动配置。如果默认配置不能满足需求，我们还可以替换掉自动配置类，使用我们自己的配置。另外，Spring Boot还集成了嵌入式的Web服务器，系统监控等很多有用的功，让我们快速构建企业及应用程序。

可以使用STS进行springboot开发，也可以使用intellij来开发springboot。但是springboot中建议使用的模板引擎是thymeleaf，我们如果想使springboot支持jsp开发，还需要做一些配置。

下面一步一步介绍如何使springboot通知支持thymeleaf和jsp两种模板引擎，可以使用thymeleaf和jsp进行组合web开发：

项目结构如下图：

1.首先新建一个springboot的war工程，并且将外部的Tomcat整合进我们的idea中，我们使用自己Tomcat，不再使用springboot嵌入式的Tomcat：详情见：https://blog.csdn.net/Hellowenpan/article/details/85219254

2.建立好工程以后开始将thymeleaf模板引擎整合进来

    ①.首先，在pom.xml文件中引入thymeleaf

    

		org.thymeleaf
		thymeleaf

    ②.整个pom.xml文件如下

	4.0.0
	
		org.springframework.boot
		spring-boot-starter-parent
		1.5.18.RELEASE
		 
	
	com.wp
	springboot-thymeleaf-jsp
	0.0.1-SNAPSHOT
	war
	springboot-thymeleaf-jsp
	Demo project for Spring Boot

	
		1.8
	

	

		
			org.springframework.boot
			spring-boot-starter-web
		

		
			org.springframework.boot
			spring-boot-starter-tomcat
			provided
		
		
			org.springframework.boot
			spring-boot-starter-test
			test
		

		
		
			org.springframework.boot
			spring-boot-starter-thymeleaf
		


		
			org.springframework.boot
			spring-boot-starter-web
		

		
			org.springframework.boot
			spring-boot-starter-thymeleaf
		

		
			com.jayway.jsonpath
			json-path
			test
		

		
		
			javax.servlet
			jstl
		

		
		
		
			org.springframework.boot
			spring-boot-starter-tomcat
		

		
		
			org.apache.tomcat.embed
			tomcat-embed-jasper
		

	
	
		
			
				org.springframework.boot
				spring-boot-maven-plugin
			

			
				org.apache.maven.plugins
				maven-war-plugin
				
					false
				
			
		

		
			
			
				
				src/main/webapp
				
				META-INF/resources
				
					**/**
				
			
			
				src/main/resources
				
					**/**
				
				false
			
		
	

    ③.编写多视图实现的视图解析器

package com.wp.springboot.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.ViewResolver;
import org.springframework.web.servlet.config.annotation.DefaultServletHandlerConfigurer;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter;
import org.springframework.web.servlet.view.InternalResourceViewResolver;
import org.thymeleaf.spring4.SpringTemplateEngine;
import org.thymeleaf.spring4.templateresolver.SpringResourceTemplateResolver;
import org.thymeleaf.spring4.view.ThymeleafViewResolver;
import org.thymeleaf.templateresolver.ITemplateResolver;

/**
 * 主要配置多视图实现的视图解析器相关bean实例,将该视图解析器注册到容器中
 *
 *
 * 其实关键点在于两个：
 * 1、配置order属性
 * 2、配置viewnames属性
 *
 */
@Configuration
public class ViewResolverConfiguration {

    @Configuration//用来定义 DispatcherServlet 应用上下文中的 bean
    @EnableWebMvc
    @ComponentScan("com.wp.springboot")
    public class WebConfig extends WebMvcConfigurerAdapter {

        //jsp页面的视图解析器，解析到webapp下的jsp/目录下查找对应的jsp页面
        @Bean
        public ViewResolver viewResolver() {
            InternalResourceViewResolver resolver = new InternalResourceViewResolver();
            resolver.setPrefix("/jsp/");
            resolver.setSuffix(".jsp");
            resolver.setViewNames("*");
            resolver.setOrder(2);
            return resolver;
        }

        @Bean
        public ITemplateResolver templateResolver() {
            SpringResourceTemplateResolver templateResolver = new SpringResourceTemplateResolver();
            templateResolver.setTemplateMode("HTML5");
            templateResolver.setPrefix("/");
            templateResolver.setSuffix(".html");
            templateResolver.setCharacterEncoding("utf-8");
            templateResolver.setCacheable(false);
            return templateResolver;
        }

        @Bean
        public SpringTemplateEngine templateEngine() {
            SpringTemplateEngine templateEngine = new SpringTemplateEngine();
            templateEngine.setTemplateResolver(templateResolver());
            // templateEngine
            return templateEngine;
        }

        /**
         * 对thymeleaf的视图解析器，解析到webapp下的html目录下查找对应的页面
         * @return
         */
        @Bean
        public ThymeleafViewResolver viewResolverThymeLeaf() {
            ThymeleafViewResolver viewResolver = new ThymeleafViewResolver();
            viewResolver.setTemplateEngine(templateEngine());
            viewResolver.setCharacterEncoding("utf-8");
            viewResolver.setOrder(1);
            viewResolver.setViewNames(new String[]{"html/*", "vue/*","jsps/*","templates/*"});
            return viewResolver;
        }

        @Override
        public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
            configurer.enable();
        }

        /**
         * 配置资源路径
         * @param registry
         */
        @Override
        public void addResourceHandlers(ResourceHandlerRegistry registry) {
            registry.addResourceHandler("/img/**").addResourceLocations("/img/");
            registry.addResourceHandler("/static/**").addResourceLocations("/WEB-INF/" + "/static/");
        }
    }

}

    ④.编写一个controller进行响应浏览器请求

package com.wp.springboot.controller;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class HelloController {

    @GetMapping("/jsp")
    public String jsp(Model model){
        model.addAttribute("msg","测试jsp页面！！！");
        return "myJsp";
    }

    @GetMapping("/thymeleaf")
    public String thymeleaf(Model model){
        model.addAttribute("msg","测试thymeleaf页面！！！");
        return "html/thymeleaf";
    }


}

    ⑤.在webapp目录下编写一个hello.jsp页面作为首页，该页面上有两个超链接，分别测试thymeleaf和jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>


    



    

    测试thymeleaf！！！

    

    测试jsp页面！！！

 

    ⑥.在webapp下创建两个目录：html和jsp,分别在这两个目录中编写请求后跳转的页面（myJsp.jsp和thymeleaf.html）

myJsp.jsp:

<%@ page contentType="text/html;charset=UTF-8" language="java" %>


    


    
这是jsp的测试页面：${msg}

thymeleaf.jsp:

    
    


    这是thymeleaf测试页面：

⑦.运行程序进行测试：

测试jsp：

、

测试thymeleaf：

注：新建项目的时候版本要选择2.0以上，不然在视图解析会出现错误！