版本概要

springboot 版本 2.2.2.RELEASE
jdk 版本 1.8
maven 版本 3.6.0
idea 版本 2019.1.2 ultimate edition

近期对公司远古jsp mvc项目进行了springboot的改造,期间进行了一些springboot jsp-config的探究,故有此篇

项目准备

新建 spring Initializr 项目选择一些基本的依赖即可

image.png

在 pom 中追加 jsp 需要的依赖和资源文件扫描


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


    javax.servlet
    javax.servlet-api
    provided


    javax.servlet
    jstl


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

新建文件夹 webapp 与 resources 文件夹平级,并新建 index.jsp

目录结构

.
├── resources
├── webapp
│   └── WEB-INF
│       ├── index.jsp

内容



  
    
    index
  
  
    测试c if
    hello world 哈哈哈哈哈哈

在 yml 文件中配置访问文件夹

spring:
mvc:
  view:
    prefix: /WEB-INF/jsp/
    suffix: .jsp

新建访问控制器

@Controller
public class IndexController {
    @GetMapping
    public String index() {
        model.addAttribute("bool", true);
        return "index";
    }
}

jsp-config

准备工作完成后,项目事实上已经可以成功访问 jsp 页面了,但我们访问时会发现 jsp 页面的中文乱码了,并且c标签也并未生效

image.png

在老项目中我们发现 jsp 在 web.xml 文件中存在这么个配置


    
        false
        UTF-8
        /WEB-INF/tags/taglibs.jspf

taglibs.jspf文件中包含了一些通用的标签引入

<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%@taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %>
<%@taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>

这个配置的作用在于为所有的 jsp 页面增加统一的编码,和统一的头部信息,这些配置相当于在 jsp 页面头部加入:

<%@ include file="/WEB-INF/tags/taglibs.jspf" %>
<%@ page pageEncoding="UTF-8" isELIgnored="false"  %>

我们在index.jsp头部中加入上面那段代码,可以看到乱码解决了标签也生效了

image.png

在旧项目的改造中,如果我们需要在所有页面追加这个头部,那么工作量就太大了,我们需要找到一种方式使jsp-config的api在springboot中同样生效

springboot jsp-config

springboot本身是支持web.xml的,因此可以先尝试在WEB-INF下直接放入web.xml其中仅配置jsp-config
```
    
        
            *.jsp
            false
            UTF-8
            /WEB-INF/tags/taglibs.jspf
        
    
```
我们发现当springboot使用嵌入式容器启动时是忽略web.xml的,因此我们需要配置使用外部tomcat启动

配置外部tomcat启动

修改pom 打包方式改为war包
```
war
```

修改启动类

@SpringBootApplication
public class BootJspApplication extends SpringBootServletInitializer {
    public static void main(String[] args) {
        SpringApplication.run(BootJspApplication.class, args);
    }

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
        return builder.sources(BootJspApplication.class);
    }
}

配置tomcat启动

image.png
使用tomcat启动web.xml中的内容便生效了

配置java config

定制嵌入式容器,在tomcat的容器上下文中我们可以找到Jsp相关的配置类并配置它

@Bean
public ConfigurableServletWebServerFactory configurableServletWebServerFactory() {
    return new TomcatServletWebServerFactory() {
        @Override
        protected void postProcessContext(Context context) {
            super.postProcessContext(context);
            JspPropertyGroup jspPropertyGroup = new JspPropertyGroup();
            jspPropertyGroup.setElIgnored("false");
            jspPropertyGroup.addUrlPattern("*.jsp");
            jspPropertyGroup.setPageEncoding("UTF-8");
            jspPropertyGroup.addIncludePrelude("/WEB-INF/tags/taglibs.jspf");
            JspPropertyGroupDescriptorImpl jspPropertyGroupDescriptor =
                    new JspPropertyGroupDescriptorImpl(jspPropertyGroup);
            // jsp-property-group列表和taglib列表
            context.setJspConfigDescriptor(new JspConfigDescriptorImpl(Collections.singletonList(jspPropertyGroupDescriptor),
                    Collections.emptyList()));
        }
    };
}

加入这个bean以后重启项目,可以看到这个配置生效了

注:除了以上方式外,目前还没有找到更好的方式使用java config使该配置生效

可能的其他方式

在javax.servlet.ServletContext接口中有一个getJspConfigDescriptor方法,这给我们提供了一个修改jsp配置的可能,我们有几种可能的方式获取到ServletContext

// 可能修改的方法
servletContext.getJspConfigDescriptor().getJspPropertyGroups().add(new JspPropertyGroupDescriptorImpl());
// 实现ServletContextListener接口
@Component
public class JspConfig implements ServletContextListener {
  @Override
  public void contextInitialized(ServletContextEvent sce) {
      sce.getServletContext();
  }
}
// 实现ServletContextInitializer接口
@Component
public class JspConfig implements ServletContextInitializer {
    @Override
    public void onStartup(ServletContext servletContext) throws ServletException {
        servletContext.getJspConfigDescriptor();
    }
}

这两种方式可以获取到servletContext,但在未读取web.xml的情况下,后者获取到的Jsp config描述器为null,而前者则在调用时直接抛出一个异常

// 实现ServletContainerInitializer接口
@Component
public class JspConfig implements ServletContainerInitializer {
    @Override
    public void onStartup(Set> set, ServletContext servletContext) throws ServletException {
        servletContext.getJspConfigDescriptor();
    }
}

此方式与前面的第二种方式类似,不同的是此方式仅在程序使用外部tomcat容器启动时才会执行

springboot配置jsp-config的探究