Spring Boot 学习系列（10）—SpringBoot+JSP的使

此文已由作者易国强授权网易云社区发布。

欢迎访问网易云社区，了解更多网易技术产品运营经验。

解决问题

• 随着spring boot 框架的逐步使用，我们期望对于一些已有的系统进行改造，做成通用的脚手架，方便在后续新项目中继续使用。

• 本章主要介绍了如何采用Spring Boot改造传统的jsp项目。

难点

• 首先，Spring Boot + JSP的方式肯定是可以使用的。不过官方早就说过不推荐使用jsp来进行前端页面的开发，官方推荐的是Themeleaf,更加符合现在前后端分离的开发模式。

• 使用Spring Boot + JSP 的方式，主要是注意一下配置上的变化，下面一起来看下。

使用介绍

• 既然我们选择Spring Boot的框架，还是比较推荐采用jar的形式进行打包部署，这样开发人员可以更方便的控制tomcat容器(内置默认容器)的参数配置，应用部署也更加简单。

• 首先，项目pom.xml文件中的packaging类型确保是jar类型。示例如下：

com.netease.mscommon-msjar1.0.0

• spring boot的版本可根据使用需求而定，这里我使用的是目前最新的稳定版本1.5.9.RELEASE。示例如下：

    org.springframework.boot
    spring-boot-starter-parent
    1.5.9.RELEASE

• 然后，引入starter-web组件，这个组件中会包含内置的tomcat容器。示例如下：

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

• 此外，还需要加入内置tomcat对jsp文件解析的支持，如果有用到jstl标签的话，也一并加入相关的依赖。示例如下：

    org.apache.tomcat.embed
    tomcat-embed-jasper
    jstl
    jstl
    ${jstl.version}

• 加入上述依赖后，注意在build插件中加入如下配置，需要注意的是，这里spring-boot-maven-plugin插件的版本指定的是1.4.2.RELEASE，自己有测试使用默认的1.5.9.RELEASE或其他1.5.x版本不行（IDEA直接运行启动没问题，打成jar包单独运行就会报404的错误，找不到相关的jsp页面），至于除1.4.2.RELEASE版本外其他版本是否可行，笔者并未尝试，有清楚原因的读者欢迎指教。另外一个比较关键的是，打成jar包后，实际上是识别不了webapp目录的，所以我们把webapp目录下的相关文件copy到META_INF/resources下面了。这样spring boot的fat jar在启动时是能够识别这个资源路径的。

    
        
            
                org.springframework.boot
                spring-boot-maven-plugin
                1.4.2.RELEASE
                
                    test.Application
                
                
                    
                        
                            repackage
                        
                    
                
                
                    
                    
                        org.springframework
                        springloaded
                        1.2.6.RELEASE
                    
                
            
            
            
                
                
                
                    
                
            
        
        
            
            
                
                src/main/webapp
                
                META-INF/resources
                
                    **/**
                
            
             
            
                src/main/resources
                
                    **/**
                
                false
            
        
    

• 完成上述配置后，pom.xml文件的必要配置就ok了，接下来我们把项目中用到的静态资源由原来的webapp目录移到src/main/resources目录下，主要的目录结构如下图所示。

• 最后，我们在application.properties文件中配置上jsp的解析前缀和后缀，以及静态资源的映射路径，如下所示，这里因为我的jsp存放路径是WEB-INF/views，所以前缀加上了这个路径，如果你自己项目下并无此路径，做相应的修改即可，如spring.mvc.view.prefix=/

spring.mvc.view.prefix=/WEB-INF/views/
spring.mvc.view.suffix=.jsp
#定义静态资源的映射路径
spring.mvc.static-path-pattern=/resources/**

• 另外传统的web项目中，肯定是有web.xml文件的，关于这个文件，我们主要是配置了一些servlet、filter以及listener，改成代码的方式配置也很简单，大家可以参照前面系列文章中介绍进行相应的改写即可，在此不再赘述。

• 还有一个需要提下的地方，就是把我们传统的项目改造成spring boot 项目时，往往会觉得很麻烦，其原因主要是在于spring boot的去xml化，如果把已有的xml中的配置再一点点的改成java代码的实现方式，确实会令人崩溃。所以，对于已有项目的改造，尽可能的保留原有的xml配置方式，这样更简单方便。示例如下：

@ImportResource("classpath:spring/application-context.xml")@SpringBootApplication(scanBasePackages = {"......"})public class CommonMsApplication {
    ......
}

最后

• 改造完成后，发现其实spring boot + jsp的方式使用并不复杂，只是在改造传统项目时，相应的配置需要做些变更。当然，每个项目使用的组件不尽相同，也许在实际的改造过程中，会遇到这样或那样的问题，耐下心来一步步找到问题原因，相信也能很快解决的。

• 不足之处，欢迎指正，谢谢~

免费体验云安全(易盾)内容安全、验证码等服务

更多网易技术、产品、运营经验分享请点击。

相关文章：
【推荐】 搜索凑单页大促显示延迟方案设计
【推荐】 用双十一的故事串起碎片的网络协议（上）