记第一个ssm（spring+SpringMVC+Mybatis）转springboot项目

学完了Spring+SpringMVC+Mybatis框架，做了一个简单的oa项目。最近又接触了SpringBoot框架，所以想把这个项目改成SpringBoot框架。
这个办公自动化系统使用的是SSM框架，分成三个部分：分别是biz层，dao层和web层。贴上源码，有兴趣可以移步看看。这是原本项目的结构：

以下是比较关键的步骤记录：

1.框架搭建

关于框架搭建，个人认为是此次任务中花费时间最长的部门，弄了两天才把项目跑通能运行。首先我们需要明确，分模块的好处，在于代码的pom文件更加简洁，可读性更高，并且各模块各司其职，哪里出问题了我们也可以更快的定位。在这个项目中，我们分为三个模块，分别是dao层，biz层（service层）和web层，我们需要一个主模块来将三个子模块整合在一起。另外，web层依赖dao层和biz层，而biz层则依赖dao层，于是依赖图应该如下：

项目结构

项目构造图如下：

在完成中比较大的一个问题是我在完成搭建后发现biz层可以正常引用到dao层，而web层不可以引用到dao层和biz层，原因是在你的四个模块中，每一个模块都有有个iml文件，iml是 intellij idea的工程配置文件，里面是当前project的一些配置信息。即使你的maven把你所需要的dao层和biz层引了进来，你还是无法使用。因为iml文件没有更新。更新方法：直接删除当前的iml文件，然后使用cmd进入指定模块的目录，使用mvn idea:module命令即可重新生成此文件。

2.各模块需要引入的包

因为分了多个模块，因此我们要避免重复引入相同的包以及出现循环依赖的情况。例如在父模块引入的包，子模块不需要再次引入，而只有某个子模块需要的包，也应该只在该模块引入，力求pom文件精简可读性高。关于循环依赖，我们只需要注意分析各模块间的关系，小心引入即可。这里有篇文章可供参考：spring如何解决循环依赖
父模块需要引入的包：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <packaging>pom</packaging>
    <modules>
        <module>oa_biz</module>
        <module>oa_dao</module>
        <module>oa_web</module>
    </modules>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.3.0.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <groupId>com.yuan</groupId>
    <artifactId>oa_springboot</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>oa_springboot</name>

    <description>Demo project for Spring Boot</description>

    <properties>
        <java.version>1.8</java.version>
        <oa.version>0.0.1-SNAPSHOT</oa.version>
    </properties>
    <!--使用此注解进行统一的版本管理-->
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>com.yuan</groupId>
                <artifactId>oa_dao</artifactId>
                <version>${
    
    oa.version}</version>
            </dependency>
            <dependency>
                <groupId>com.yuan</groupId>
                <artifactId>oa_biz</artifactId>
                <version>${
    
    oa.version}</version>
            </dependency>
            <dependency>
                <groupId>com.yuan</groupId>
                <artifactId>oa_web</artifactId>
                <version>${
    
    oa.version}</version>
            </dependency>
        </dependencies>
    </dependencyManagement>
    <dependencies>
        <!--集成swagger-->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.5.0</version>
        </dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.5.0</version>
        </dependency>
        <!--支持全栈式Web开发，包括Tomcat和spring-webmvc。-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
            <exclusions>
                <exclusion>
                    <groupId>org.junit.vintage</groupId>
                    <artifactId>junit-vintage-engine</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>


    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <mainClass>com.yuan.oa_web.OaWebApplication</mainClass>
                </configuration>
            </plugin>
        </plugins>

    </build>
</project>

子模块一:oa_dao

	<dependencies>
        <!--springboot整合mybatis-->
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>2.1.3</version>
            <!--exclusions标签：用于排除jar包冲突-->
            <exclusions>
                <exclusion>
                    <groupId>mysql</groupId>
                    <artifactId>mysql-connector-java</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
     </dependencies>

子模块二：oa_biz

    <dependencies>
        <dependency>
            <groupId>com.yuan</groupId>
            <artifactId>oa_dao</artifactId>
            <version>${
    
    oa.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
    </dependencies>

子模块三：oa_web

	<dependencies>
        <dependency>
            <groupId>com.yuan</groupId>
            <artifactId>oa_biz</artifactId>
        </dependency>
        <dependency>
            <groupId>com.yuan</groupId>
            <artifactId>oa_springboot</artifactId>
            <version>0.0.1-SNAPSHOT</version>
            <scope>compile</scope>
        </dependency>
        <!--支持全栈式Web开发，包括Tomcat和spring-webmvc。-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-autoconfigure</artifactId>
            <version>2.3.0.RELEASE</version>
        </dependency>
        <!--springboot支持jsp的三个包-->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>servlet-api</artifactId>
            <version>2.5</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>jstl</artifactId>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat.embed</groupId>
            <artifactId>tomcat-embed-jasper</artifactId>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>org.testng</groupId>
            <artifactId>testng</artifactId>
            <version>RELEASE</version>
            <scope>test</scope>
        </dependency>
    </dependencies>

3.关键注释

springboot为简化spring应用的初始化搭建和开发过程而生，它以注解的形式来代替spring中大量的配置文件，使得没有代码生成，因此了解其中常见的注解是比较有必要的。

1、@SpringBootApplication(scanBasePackages = “com.yuan”)

每一个springboot项目都是集成了tomcat服务器的，我们通过运行主类来开启一个springboot项目，而标识主类的注解就是@SpringBootApplication，这个注解组合了三个注解，分别是@Configuration、 @EnableAutoConfiguration和@ComponentScan。@Configuration用于声明一个类是配置类，@EnableAutoConfiguration能够自动配置spring的上下文，而@ComponentScan则会自动扫描指定包下的全部标有@Component、@Service、@Repository和@Controller的类，并注册成bean。

2、@MapperScan(value = {“com.yuan.oa_dao.dao”})

在springboot集成了mybatis之后，我们使用@Mapper注解对dao接口进行声明，但给每一个接口都加上Mapper注解比较麻烦，我们可以使用@MapperScan注解来扫描某个包下的所有类。

3、@Configuration和@Bean

@Configuration将一个类标记为配置类，说明这个类可以作为Spring IOC容器作为bean定义的来源，@Bean说明该方法将返回一个对象，该对象应该被注册为Spring应用程序上下文的bean。

4、@RequestMapping

可以用来映射URL，应用在类或者方法上，可以映射一个或者多个。其中比较重要的属性有Value、method和params。分别代表请求的实际地址、请求的method类型和请求中必须包含的参数值。

5、@GetMapping

@GetMapping、@PostMapping等等是组合注解，@GetMapping=@RequestMapping(method=RequestMethod.GET)

6、@Controller、@Service、@Mapper和@Component

这四个注解用来标记某些类，而这些类都会被spring容器所管理。不同之处在于@Component泛指各类组件，@Controller用于标记控制层，@Service用于标记服务层，主要用来进行业务逻辑处理，@Repository用于标记数据层，主要用来与数据库交互。

7、@Repository和@Mapper的区别

他们都用来标记数据层，但不同在于@Repository需要在Spring中配置扫描地址（使用@MapperScan指定），然后生成bean的dao层才能被注入到Service层当中；@Mapper则不需要配置扫描地址，通过xml中的namespace里面的接口地址，生成bean之后注入Service层中。

8、@Scope

用于标记bean对象的作用域，默认是singleton，也就是单例模式，全局有且只有一个实例。另外还有prototype原型模式，也就是多例模式，每一次获取bean都会生成新的实例；web作用域（request、session和globalsession），request表示在每一次http请求时都会生成一个实例，并且这个实例只在当前Http request内有效；session表示在每一次http请求时都会生成一个实例，并且这个实例只在当前Http session内有效；globalsession – global session作用域类似于标准的HTTP Session作用域，不过它仅仅在基于portlet的web应用中才有意义。

9、@RequestBody和@RequestParam

@RequestBody主要用来接收前端传递给后端的json字符串中的数据的(请求体中的数据的)；GET方式无请求体，所以使用@RequestBody接收数据时，前端不能使用GET方式提交数据，而是用POST方式进行提交。
在后端的同一个接收方法里，@RequestBody与@RequestParam()可以同时使用，@RequestBody最多只能有一个，而@RequestParam()可以有多个。
@RequestBody 接收的是请求体里面的数据；而RequestParam接收的是key-value里面的参数。

10、@ResponseBody

将java对象转为json格式的数据，将controller方法返回的对象转化为指定的格式后直接返回前端，效果等同于通过response对象直接输出指定格式的数据。

4.web.xml的问题

在本项目的web.xml文件中，配置了编码过滤器和静态文件的过滤，而在Springboot中，这种配置文件我们都可以使用类来进行实现效果。

以下是编码过滤器的实现方法，其中的Configuration注解，其实就是标注此类是个配置类，继承了filter类，类似于一个过滤器，在页面发起请求时进行过滤并设置编码格式，WebFilter注解则是标注了需要过滤的url和拦截器的名字。

package com.yuan.oa_springboot.util;

import org.springframework.context.annotation.Configuration;

import javax.servlet.*;
import javax.servlet.annotation.WebFilter;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

/**
 * 编码过滤器
 */
@Configuration
@WebFilter(urlPatterns =  "/*",filterName ="encodingFilter")
public class encodingFilter implements Filter {
    
    
    private String encoding = "UTF-8";

    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
    
    
        if (filterConfig.getInitParameter("encoding") != null) {
    
    
            encoding = filterConfig.getInitParameter("encoding");
        }
    }

    @Override
    public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {
    
    
        HttpServletRequest request = (HttpServletRequest) servletRequest;
        HttpServletResponse response = (HttpServletResponse) servletResponse;
        request.setCharacterEncoding(encoding);
        response.setCharacterEncoding(encoding);
        filterChain.doFilter(request, response);
    }

    @Override
    public void destroy() {
    
    

    }
}

此处使用默认Servlet对静态资源进行过滤，使得MVC不进行拦截，页面元素能够正常显示。在原来的项目中，我们将未登录的用户进行拦截并重定向到登录界面，在编写完loginInterceptor之后，使用mvc自带的标签来进行配置。而在springboot中我们则需要使用类来进行配置。而对于静态资源我们只需要选择不进行拦截即可。

//spring-web.xml中的配置
<mvc:interceptors>
        <mvc:interceptor>
            <mvc:mapping path="/**"/>
            <bean class="com.yuan.oa.global.LoginInterceptor"/>
        </mvc:interceptor>
    </mvc:interceptors>
//配置拦截器的类
package com.yuan.oa_springboot.config;

import com.yuan.oa_springboot.util.LoginInterceptor;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

/**
 * 配置拦截器
 * addPathPatterns：用于添加拦截规则
 * excludepathPatterns：用于排除拦截
 *
 * @Configuration
 *  *等同于spring的XML配置文件；使用Java代码可以检查类型安全
 */
@Configuration
public class MyWebAppConfig implements WebMvcConfigurer{
    
    
    @Autowired
    private LoginInterceptor loginInterceptor;

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
    
    
        registry.addInterceptor(loginInterceptor)
                .addPathPatterns("/**")
                .excludePathPatterns("/","/assets/**","/js/**","/vendor/**");
    }
}

5. springboot对jsp的支持问题

不知不觉间，原来jsp已经这么老了。springboot是鼓励开发者们使用html来进行开发的，由于jsp之前的火爆，还有很多老项目在使用jsp，因此，springboot也是支持jsp的，只不过我们需要加上一点东西。首先是加在pom中的依赖包，然后是在配置文件中加入该有的前缀后缀即可！

		<dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>jstl</artifactId>
     	</dependency>
     	<dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat.embed</groupId>
            <artifactId>tomcat-embed-jasper</artifactId>
            <scope>provided</scope>
        </dependency>

6. 其他问题

关于springboot某些包的问题，如果遇到无法解决的问题并且代码框架逻辑无问题时，可以尝试换换其他的依赖包版本。
以下贴出转换后的项目源码以供参考：oa_springboot