從零開始使用spring boot搭建前后端分離框架（一、WEB框架的搭建）

公司一個新項目，不想使用之前的老框架，准備搭建一個新的，記錄下以便后續回顧！

話不多說，開始第一步！使用idea創建new project創建一個項目

 

設置包名

 

 

設置依賴項目：如果是web項目就選web，不是可以省略，這里我們使用jdbc做連接池，使用mybatis做持久層框架

 

 

設置項目名稱：

 

 

 finish！

 

 

項目創建好了，接下來進行第二步

配置端口，數據庫以及mybatis配置文件application.properties：

# 端口
server.port=9090
# 管理端點，上下文路徑
server.servlet.context-path=/fzf
# 會話超時（秒）
server.servlet.session.timeout=10000

#數據庫配置
spring.datasource.url=jdbc:mysql://rm-bp14to8mn841swfk6so.mysql.rds.aliyuncs.com:3306/fzf?Unicode\=true&characterEncoding\=utf-8&ssl=true&ssl\=true
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
spring.datasource.username=root
spring.datasource.password=123456



#配置Controller層返回JSP
#配置 前后綴
spring.mvc.view.prefix=/WEB-INF/jsp/
spring.mvc.view.suffix=.jsp

#掃描實體類位置
mybatis.typeAliasesPackage=com.fzf.web.model
#掃描mybatis的xml文件
mybatis.mapperLocations=classpath:mapper/*.xml 

# 定義靜態資源文件位置
spring.resources.static-locations=classpath:/META-INF/resource/, classpath:/resource/, classpath:/static/
##表示訪問該路徑時代表請求靜態資源，用戶可以直接訪問該請求路徑中的靜態資源
spring.mvc.static-path-pattern=/static/**


#打印sql日志 , 使用mybatis自帶的方法,會將sql的返回結果也打印出來
#mybatis.configuration.log-impl= org.apache.ibatis.logging.stdout.StdOutImpl

　配置pom.xml文件中的dependencies依賴項和plugins代碼生成器generator

<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.1.4.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.fzf</groupId>
    <artifactId>web</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>web</name>
    <description>Pure back-end interface -Spring boot</description>

    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-redis</artifactId>
        </dependency>
        <!-- https://mvnrepository.com/artifact/org.mybatis.spring.boot/mybatis-spring-boot-starter -->
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>2.1.0</version>
        </dependency>

        <!-- https://mvnrepository.com/artifact/org.apache.commons/commons-lang3 -->
        <dependency>
            <groupId>org.apache.commons</groupId>
            <artifactId>commons-lang3</artifactId>
            <version>3.9</version>
        </dependency>

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


        <!--mysql連接驅動包-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.44</version>
        </dependency>
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid</artifactId>
            <version>1.1.5</version>
        </dependency>

        <!-- json -->
        <dependency>
            <groupId>com.google.code.gson</groupId>
            <artifactId>gson</artifactId>
        </dependency>
        <!--pagehelper 分頁插件-->
        <dependency>
            <groupId>com.github.pagehelper</groupId>
            <artifactId>pagehelper-spring-boot-starter</artifactId>
            <version>1.2.3</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>

                <configuration>
                    <executable>true</executable>
                </configuration>
            </plugin>

            <!--要打包了這個生成代碼要禁止掉，本地開發開啟-->
            <plugin>
                <groupId>org.mybatis.generator</groupId>
                <artifactId>mybatis-generator-maven-plugin</artifactId>
                <version>1.3.5</version>
                <dependencies>
                    <!--配置這個依賴主要是為了等下在配置mybatis-generator.xml的時候可以不用配置classPathEntry這樣的一個屬性，避免代碼的耦合度太高-->
                    <dependency>
                        <groupId>mysql</groupId>
                        <artifactId>mysql-connector-java</artifactId>
                        <version>5.1.44</version>
                    </dependency>
                    <dependency>
                        <groupId>tk.mybatis</groupId>
                        <artifactId>mapper</artifactId>
                        <version>3.4.0</version>
                    </dependency>
                </dependencies>
                <executions>
                    <execution>
                        <id>Generate MyBatis Artifacts</id>
                        <phase>package</phase>
                        <goals>
                            <goal>generate</goal>
                        </goals>
                    </execution>
                </executions>
                <configuration>
                    <!--允許移動生成的文件 -->
                    <verbose>true</verbose>
                    <!-- 是否覆蓋 -->
                    <overwrite>true</overwrite>
                    <!-- 自動生成的配置 -->
                    <configurationFile>src/main/resources/generator/mybatis-generator.xml</configurationFile>
                </configuration>
            </plugin>
        </plugins>
    </build>

</project>

　配置maven:

 第三步使用攔截器打印請求入參，和跨域問題：

首先配置攔截器：

@Configuration
public class WebConfig extends WebMvcConfigurationSupport {
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new CommonInterceptor()).addPathPatterns("/**");
        super.addInterceptors(registry);
    }
}

　　攔截請求，配置跨域和打印請求

package com.fzf.web.common;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.Map;

/**
 * 配置公共攔截器，將每次請求的入參打印在日志上
 * 基於shiro允許跨域
 */
public class CommonInterceptor implements HandlerInterceptor {
    private static final Logger logger = LoggerFactory.getLogger(CommonInterceptor.class);
    /**
     * 配置公共request路徑basePath
     * @param o
     * @return
     * @throws Exception
     */
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object o) throws Exception {
        //允許跨域,不能放在postHandle內
        response.setHeader("Access-Control-Allow-Origin", "*");
        if (request.getMethod().equals("OPTIONS")) {
            response.addHeader("Access-Control-Allow-Methods", "GET,HEAD,POST,PUT,DELETE,TRACE,OPTIONS,PATCH");
            response.addHeader("Access-Control-Allow-Headers", "Content-Type, Accept, Authorization");
        }

        /**
        * 對來自后台的請求統一進行日志處理
        */
        String url = request.getRequestURL().toString();
        String method = request.getMethod();
        Map<String, String[]> map=request.getParameterMap();
        System.out.println("---------------------------------------------------------------------------------------------------");
        logger.info("url--"+url);
        logger.info("method--"+method);
        logger.info("request-params--");
        map.forEach((k,v) ->{
            logger.info("    " + k+": "+v[0]);
        });
        System.out.println("---------------------------------------------------------------------------------------------------");
        return true;
    }

    @Override
    public void postHandle(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, Object o, ModelAndView modelAndView) throws Exception {

    }

    @Override
    public void afterCompletion(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, Object o, Exception e) throws Exception {

    }
}

 第四步創建mybatis-generator.xml配置文件：並生成表中數據：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE generatorConfiguration
        PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"
        "http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">
<generatorConfiguration>
    <!--加載配置文件，為下面讀取數據庫信息准備-->
    <properties resource="application.properties"/>

    <!-- targetRuntime = MyBatis3 會生成 Selective結尾的方法, MyBatis3Simple 不會生成-->
    <context id="Mysql" targetRuntime="MyBatis3" defaultModelType="flat">

        <!-- 阻止生成自動注釋 -->
        <commentGenerator>
            <property name="javaFileEncodings" value="UTF-8"/>
            <property name="suppressDate" value="true"/>
            <property name="suppressAllComments" value="true"/>
        </commentGenerator>

        <!--數據庫鏈接地址賬號密碼，這里由於我使用的是根據開發和生產分離的配置文件，所以這里直接寫上了-->
        <jdbcConnection driverClass="com.mysql.jdbc.Driver"
                        connectionURL="jdbc:mysql://rm-bp14to8mn841swfk6so.mysql.rds.aliyuncs.com:3306/fzf?useUnicode=true&characterEncoding=utf-8"
                        userId="root"
                        password="123456>
        </jdbcConnection>

        <javaTypeResolver>
            <property name="forceBigDecimals" value="false"/>
        </javaTypeResolver>

        <!--生成Model類存放位置-->
        <javaModelGenerator targetPackage="com.fzf.web.model" targetProject="src/main/java">
            <property name="enableSubPackages" value="true"/>
            <property name="trimStrings" value="true"/>
        </javaModelGenerator>

        <!--生成映射文件存放位置-->
        <sqlMapGenerator targetPackage="mapper" targetProject="src/main/resources">
            <property name="enableSubPackages" value="true"/>
        </sqlMapGenerator>

        <!--生成Dao類存放位置-->
        <!-- 客戶端代碼，生成易於使用的針對Model對象和XML配置文件 的代碼
                type="ANNOTATEDMAPPER",生成Java Model 和基於注解的Mapper對象
                type="XMLMAPPER",生成SQLMap XML文件和獨立的Mapper接口
        -->
        <javaClientGenerator type="XMLMAPPER" targetPackage="com.fzf.web.mapper" targetProject="src/main/java">
            <property name="enableSubPackages" value="true"/>
        </javaClientGenerator>

        <!--生成對應表及類名 去掉Mybatis Generator生成的一堆 example-->
        <table tableName="t_student" domainObjectName="Student" enableCountByExample="false" enableUpdateByExample="false" enableDeleteByExample="false" enableSelectByExample="false" selectByExampleQueryId="false">
            <generatedKey column="id" sqlStatement="Mysql" identity="true"/>
        </table>

    </context>
</generatorConfiguration>

　之前在pom.xml文件中配置了pulgs,在這個地方會有下面的依賴，雙擊mybatis-generator:generate執行，就可以了

 

 

 

 

 

 現在實體和mapper文件生成了，開始書寫service和controller層

 

@Service
@Transactional
public class StudentService {
    @Resource
    private StudentMapper studentMapper;

    /**
     * @param userId
     * @return
     */
    public Student getEntity(int userId) {
        return studentMapper.selectByPrimaryKey(userId);
    }

}

　　

@Controller
@RequestMapping("/user/")
public class StudentController {

    @Resource
    private StudentService studentService;

    /**
     * 用戶信息
     * @param userId
     * @return
     */
    @ResponseBody
    @RequestMapping("info")
    public ResponseVO info(@RequestParam(value = "userId") int userId){
        return new ResponseVO(studentService.getEntity(userId));

    }
}

在啟動項目之前，配置掃描mapper，

@SpringBootApplication
@MapperScan("com.fzf.web.mapper")//掃描mapper
public class WebApplication {

    public static void main(String[] args) {
            SpringApplication.run(WebApplication.class, args);
    }

}

　　

debug啟動項目：

 

 

 等待啟動成功之后： 

 

 

 在瀏覽器中訪問鏈接：

http://localhost:9090/fzf/user/info?userId=1

鏈接為IP + 端口號 +項目路徑 + controller映射路徑

 

 

 

 

 結果： 

 

 

 控制台：