原来一直使用SSM 觉得也够用了，但是目前主流都是SpringBoot，于是计划着把自己的项目也来个升级，当中当然是各种坑不断。

花费两天时间，基础坑都趟了一遍。记录一下~

原项目：

SSM -> SpringBoot2.3 + Maven

jar包管理升级->Maven

旧项目依旧使用老的lib方式管理。但是为了利用Jenkins自动构建，简单升级为Maven导入本地jar的方式构建项目

1.Maven 导入本地lib（很多老项目升级时用的办法）lib置于${project.basedir}/src/main/webapp/WEB-INF/lib

<defaultGoal>compile</defaultGoal>
<plugins>
     <plugin>
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-compiler-plugin</artifactId>
         <version>3.8.1</version>
         <configuration>
            <skip>true</skip>
            <source>8</source>
            <target>8</target>
            <encoding>UTF-8</encoding>
            <compilerArgs>
                <verbose />
                <!-- windows下使用分号（;）分隔，linux/mac下使用冒号（:）分隔 为了避免环境引起的问题，推荐使用${path.separator}-->
<!--                        <bootclasspath>${java.home}/lib/rt.jar:${java.home}/lib/jce.jar</bootclasspath>-->
<!--                        <etxdir>${project.basedir}/web/WEB-INF/lib</etxdir>-->
                <arg>-verbose</arg>
                <arg>-Xlint:unchecked</arg>
                <arg>-Xlint:deprecation</arg>
                <arg>-bootclasspath</arg>
                <arg>${java.home}/lib/rt.jar${path.separator}${java.home}/lib/jce.jar</arg>
                <arg>-extdirs</arg>
                <arg>${project.basedir}/src/main/webapp/WEB-INF/lib</arg>
            </compilerArgs>
        </configuration>
     </plugin>
<plugins>

2.jar包升级为Maven依赖(这是一个大工程~)

1）利用IDEA提示，前提需要知道应该要导入哪个包，有些可能就是没有。

2）定位到类，然后去maven仓库自己搜索相关的包。

查看原来的项目，定位到具体jar，然后进行搜索

1.关于仓库无法搜索到jar的处理方案。

a.利用1当中的，建立lib文件夹，并引入。

b.利用maven中的scope为system的jar，进行本地引入。缺点如果是打成war包可能会有些问题

<dependency>
    <groupId>com.baidu.ueditor</groupId>
     <artifactId>ueditor</artifactId>
     <version>1.1.2</version>
     <scope>system</scope>
     <systemPath>${project.basedir}/lib/ueditor-1.1.2.jar</systemPath>
</dependency>

c.自己建立一个maven仓库。

SpringBoot

1.搭建脚手架

写博客居然遇上官网挂掉~

官方提供的搭建工具非常棒，可以满足绝大部分需求。

https://start.spring.io/

按需填写，以及引入相关依赖，下载即可

2.Mybatis迁移

迁移到springBoot只需要几个配置项即可

#配置扫描实体类
mybatis.type-aliases-package=com.ls.entity,com.ls.domain
#配置原来的配置文件
mybatis.config-location=classpath:sqlMapConfig.xml
#配置xml位置
mybatis.mapper-locations=classpath:mapper/*.xml
#数据库四要素
spring.datasource.url=xxx
spring.datasource.username=xxx
spring.datasource.password=xxx
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

配置文件主要是配置了plugin

<plugins>
        <!--分页过滤器-->
        <plugin interceptor="com.github.pagehelper.PageInterceptor"/>
        <!--自定义sql过滤器-->
        <plugin interceptor="com.ls.interceptors.MybatisInterceptors"/>
</plugins>

如果顺便升级了mybatis的版本，可能会遇到以下问题：

StatementHandler 出现异常，原因是作者修改了参数，导致拦截器配置出现问题。

@Intercepts({
    // 之前 @Signature(method = "prepare", type = StatementHandler.class, args = {Connection.class})
        @Signature(method = "prepare", type = StatementHandler.class, args = {Connection.class,Integer.class})})

3.FreeMarker迁移

FreeMarker Only

抛弃原来的配置文件，都走向了参数化

## 是否允许HttpServletRequest属性覆盖(隐藏)控制器生成的同名模型属性。
#spring.freemarker.allow-request-override=true
## 是否允许HttpSession属性覆盖(隐藏)控制器生成的同名模型属性。
#spring.freemarker.allow-session-override=true
## 是否启用模板缓存。
#spring.freemarker.cache=false
## 模板编码。
#spring.freemarker.charset=UTF-8
## 是否检查模板位置是否存在。
#spring.freemarker.check-template-location=true
## Content-Type value.
#spring.freemarker.content-type=text/html
## 是否启用freemarker
#spring.freemarker.enabled=true
## 设定所有request的属性在merge到模板的时候，是否要都添加到model中.
#spring.freemarker.expose-request-attributes=true
## 是否在merge模板的时候，将HttpSession属性都添加到model中
#spring.freemarker.expose-session-attributes=true
## 设定是否以springMacroRequestContext的形式暴露RequestContext给Spring’s macro library使用
#spring.freemarker.expose-spring-macro-helpers=false
## 是否优先从文件系统加载template，以支持热加载，默认为true
#spring.freemarker.prefer-file-system-access=true
## 设定模板的后缀.
#spring.freemarker.suffix=.ftl
## 设定模板的加载路径，多个以逗号分隔，默认:
#spring.freemarker.template-loader-path=classpath:/templates/ftl/
## 设定FreeMarker keys.
#spring.freemarker.settings.template_update_delay=0
#spring.freemarker.settings.default_encoding=UTF-8
#spring.freemarker.settings.classic_compatible=true
#spring.freemarker.request-context-attribute=request

依赖：

<dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>

JSP Only

因为一些特殊原因、我需要引入JSP

如果不引入模板，只引入JSP可以这么配置

#配置jsp相关解析功能
spring.mvc.view.prefix =classpath:/templates/jsp/
spring.mvc.view.suffix =.jsp

这些依赖必不可少，否则无法解析jsp

<!--        jstl依赖      (jsp)  -->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>jstl</artifactId>
</dependency>
<!--        jasper依赖    (jsp)   -->
<dependency>
    <groupId>org.apache.tomcat.embed</groupId>
    <artifactId>tomcat-embed-jasper</artifactId>
    <scope>provided</scope>
</dependency>
<!--     -->
 <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-tomcat</artifactId>
</dependency>

JSP + FreeMarker

我需要同时解析JSP与FTL

依据官方提供的一种方案，此时我们不能再通过配置进行编写，而是需要通过编写对应类来注入。配置文件中的配置需要进行屏蔽。

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.ViewResolver;
import org.springframework.web.servlet.view.InternalResourceViewResolver;
import org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer;
import org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver;
@Configuration
public class FreeMarkerAndJspConfiguration {
    @Bean
    public ViewResolver getJspViewResolver() {
        InternalResourceViewResolver internalResourceViewResolver = new InternalResourceViewResolver();
        internalResourceViewResolver.setPrefix("/WEB-INF/jsp/");
        internalResourceViewResolver.setSuffix(".jsp");
        internalResourceViewResolver.setOrder(2);
        return internalResourceViewResolver;
    }
    @Bean
    public FreeMarkerViewResolver getFreeMarkerViewResolver() {
        FreeMarkerViewResolver freeMarkerViewResolver = new FreeMarkerViewResolver();
        freeMarkerViewResolver.setCache(false);
        freeMarkerViewResolver.setSuffix(".ftl");
        freeMarkerViewResolver.setRequestContextAttribute("request");
        freeMarkerViewResolver.setOrder(1);
        freeMarkerViewResolver.setContentType("text/html;charset=UTF-8");
        freeMarkerViewResolver.setAllowRequestOverride(true);
        freeMarkerViewResolver.setAllowSessionOverride(true);
        freeMarkerViewResolver.setExposeRequestAttributes(true);
        freeMarkerViewResolver.setExposeSpringMacroHelpers(false);
        freeMarkerViewResolver.setRequestContextAttribute("request");
        freeMarkerViewResolver.setViewClass(org.springframework.web.servlet.view.freemarker.FreeMarkerView.class);
        return freeMarkerViewResolver;
    }
    @Bean
    public FreeMarkerConfigurer getFreeMarkerConfigurer(){
        FreeMarkerConfigurer freeMarkerConfigurer = new FreeMarkerConfigurer();
        freeMarkerConfigurer.setTemplateLoaderPath("classpath:/templates/ftl/");
        freeMarkerConfigurer.setDefaultEncoding("UTF-8");
        freeMarkerConfigurer.setPreferFileSystemAccess(true);
        return freeMarkerConfigurer;
    }
}

这里需要特别注意的一点，就是jsp存放位置

/src/main/resources/META-INF/resources/WEB-INF/jsp/controller.jsp

找了好半天问题，因为基本都说是在WEB-INF 绝大部分都说明是在webapp下，结果试了，还是不行。此处应该还是与springBoot版本有关。我目前直接使用的为2.3

4.外置Jetty 转内置Tomcat

磁盘映射

其实主要就是涉及到原来磁盘静态文件的读取，俗称磁盘映射。

@Configuration
public class WebMvcConfiguration implements WebMvcConfigurer {
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        //意思就是,前端浏览器访问路径带有/file/**就转到对应磁盘下读取图片,
        //类似前端访问tomcat webapp下file文件夹中文件
        //**注意/结尾 否则可能出现无法匹配
        registry.addResourceHandler("/resource/**").addResourceLocations("file:" + EnvConfig.getConfig(EnvConfig.PathConfig.RESOURCE_PATH) + File.separator);
    }
}

RealPath路径获取

其中jsp中包含下面一句

application.getRealPath("/")

如果经过测试，可以发现此路径是一个private开头，但是里面什么内容都没有的路径。说明并没有获取到项目真正的路径

此时需要我们在主项目根目录下，可以创建一个public文件夹，然后该代码就可以找到正确的绝对路径了。

可以参考：

SpringBoot 内置tomcat 的 request.getServletContext().getRealPath(“/”) 问题与tomat-docbase 和 basedir的关系

5.其他问题

关于动态加载的静态参数问题

例如此静态属性：

//其具体值是通过java启动进过condition计算得出的
    public static final String DOCUMENT_HTML_BASE_PAHT = EnvConfig.getConfig(EnvConfig.PathConfig.BASE_PATH)+ File.separator+"document"+File.separator+"html";

关于springBoot devTool不同类加载器的问题

如果springBoot在加载应用代码的时候使用

org.springframework.boot.devtools.restart.classloader.RestartClassLoader

类加载器，但是加载某些jar包的时候，又会使用

sun.misc.Launcher$AppClassLoader

可能某些代码会破坏单例性质，也可能像我遇到了一个静态属性类被初始化了2次，原因是我调用某个jar包，此jar包的类又被我重写调用了，然后就出现这个情况了。

此类问题解决办法：

1.关闭devTools

spring.devtools.restart.enabled=false

2.把这个jar包加入配置，让jar包中的类加载也通过RestartClassLoader加载

restart.include.companycommonlibs=/ueditor-[\\w-]+\\.jar
restart.include.projectcommon=/cxxz/core/

可以参考：

Springboot之devtools类加载问题研究

SpringBoot配置devtools实现热部署

写在最后

自己的项目也不是什么大项目，花费了2天时间，终于调整完毕，但是后续加入Jenkins集成，还有好多路要走。

产生这种改变的想法原因是在将项目部署到阿里云的时候，需要先布置jetty，配置映射。再上传war。感觉就一个小项目，却要四处配置。

而springBoot 的jar形式，则更像java宣传的，一次编译，到处跑。

当然这种约定优先，感觉还是需要先去熟悉他的默认配置，否则就是从一个坑进入另一个坑~

如果有天遇到一个问题，解决不了，试试官网文档，也许会有你想要的答案~

价值不言而喻，SSM项目升级springBoot复盘，又是一个极小的细节

jar包管理升级->Maven

SpringBoot

1.搭建脚手架

2.Mybatis迁移

3.FreeMarker迁移

FreeMarker Only

JSP Only

JSP + FreeMarker

4.外置Jetty 转内置Tomcat

磁盘映射

RealPath路径获取

5.其他问题

关于动态加载的静态参数问题

关于springBoot devTool不同类加载器的问题

写在最后

热门文章

最新文章

相关课程

相关电子书

相关实验场景

热门

活动广场

任务中心

开发者评测

高校计划

乘风者计划

训练营

阿里云MVP

话题

直播

下载

镜像站

技术资料

插件

价值不言而喻，SSM项目升级springBoot复盘，又是一个极小的细节

jar包管理升级->Maven

SpringBoot

1.搭建脚手架

2.Mybatis迁移

3.FreeMarker迁移

FreeMarker Only

JSP Only

JSP + FreeMarker

4.外置Jetty 转 内置Tomcat

磁盘映射

RealPath路径获取

5.其他问题

关于动态加载的静态参数问题

关于springBoot devTool不同类加载器的问题

写在最后

热门文章

最新文章

相关课程

相关电子书

相关实验场景

4.外置Jetty 转内置Tomcat