SpringBoot之多模塊項目

說明：我們通過maven的父子工程來搭建springboot的多模塊項目**

---

項目的整體結構

本項目涉及了到了五個模塊

framework-web模塊主要是放置前端的頁面等信息，framework-model放置領域對象,framework-service業務邏輯類放在這里,framework-mapper操作數據庫的對象放在這里,framework-common基礎公共的類放在這里

---

以上五個模塊的依賴關系如下：

秉承的是至上而下的依賴關系。

具體的項目結構圖如下

第一步：搭建父工程（framework-root）

父工程中只包含一個pom.xml文件，文件內容如下：

<?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>
    <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.triumphxx</groupId>
    <artifactId>framework-root</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>framework-root</name>
    <description>Demo project for Spring Boot</description>
    <packaging>pom</packaging>
    <modules>
        <module>framework-common</module>
        <module>framework-web</module>
        <module>framework-model</module>
        <module>framework-service</module>
        <module>framework-mapper</module>
    </modules>

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

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>com.triumphxx</groupId>
                <artifactId>framework-model</artifactId>
                <version>0.0.1-SNAPSHOT</version>
            </dependency>
            <dependency>
                <groupId>com.triumphxx</groupId>
                <artifactId>framework-mapper</artifactId>
                <version>0.0.1-SNAPSHOT</version>
            </dependency>
            <dependency>
                <groupId>com.triumphxx</groupId>
                <artifactId>framework-service</artifactId>
                <version>0.0.1-SNAPSHOT</version>
            </dependency>
            <dependency>
                <groupId>com.triumphxx</groupId>
                <artifactId>framework-common</artifactId>
                <version>0.0.1-SNAPSHOT</version>
            </dependency>
            <dependency>
                <groupId>com.triumphxx</groupId>
                <artifactId>framework-web</artifactId>
                <version>0.0.1-SNAPSHOT</version>
            </dependency>
        </dependencies>
    </dependencyManagement>

</project>

說明：我們將所有的模塊進行統一的版本信息管理，並將每一個模塊引入到父pom.xml中。

第二步：搭建framework-web模塊

由於本模塊是直接由前端進行調用的模塊（前后端分離），
或者是直接將前端文件放在這個模塊下，我們需要引入前端模版依賴，
和web依賴。也需要依賴framework-service,如下：

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-freemarker</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>com.triumphxx</groupId>
            <artifactId>framework-service</artifactId>
        </dependency>

模塊結構如下：

framework-web模塊主要是和前端交互的接口controller
在這個模塊我們創建一個控制器UserController

第三步：搭建framework-service模塊

由於本模塊是需要依賴framework-mapper模塊。如下：

        <dependency>
            <groupId>com.triumphxx</groupId>
            <artifactId>framework-mapper</artifactId>
        </dependency>

模塊結構如下：

framework-service模塊主要業務邏輯處理。我們創建了一個接口UserService和實現UserServiceImpl

第四步：搭建framework-mapper模塊

由於本模塊是需要依賴數據庫相關依賴,和數據表實體。如下：

        <dependency>
            <groupId>com.triumphxx</groupId>
            <artifactId>framework-model</artifactId>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <scope>runtime</scope>
        </dependency>
        <!--mybatis-plus-->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.2.0</version>
        </dependency>
        <!--數據庫連接池-->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid-spring-boot-starter</artifactId>
        <version>1.1.20</version>

模塊結構如下：

framework-mapper模塊主要操作數據庫。我們創建了一個接口UserMapper接口，並且實現查詢user表數據。如下：

/**
 * @author:triumphxx
 * @Date:2020/5/24
 * @Time:5:38 下午
 * @微信公眾號：北漂碼農有話說
 * @desc:用戶查詢
 **/
@Mapper
public interface UserMapper {
    @Select("select * from user")
    List<UserEntity> selectUser();
}

第五步：搭建framework-model模塊

我們只加入lombok如下：

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>

模塊結構如下：

framework-model模塊主要管理我們的數據表對象。我們創建UserEntity

/**
 * @author:triumphxx
 * @Date:2020/5/24
 * @Time:5:36 下午
 * @微信公眾號：北漂碼農有話說
 * @desc:用戶實體類
 **/
@Data
public class UserEntity {
    private String username;
    private int id;
    private String password;
}

第六步：搭建framework-common模塊

這個模塊主要是一些公共的組件，這邊就不詳細說了。

以上模塊搭建好以后我們創建數據表

CREATE TABLE `user` (
  `id` int(45) NOT NULL,
  `username` varchar(255) COLLATE utf8_bin DEFAULT NULL,
  `password` varchar(255) COLLATE utf8_bin DEFAULT NULL,
  PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin;

插入一條測試數據

在framework-web模塊的配置文件配置數據庫的信息

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/test?useUnicode=true&useSSL=false&characterEncoding=utf8&serverTimezone=UTC
    username: root
    password: root
    type: com.alibaba.druid.pool.DruidDataSource

第七步：測試

啟動項目並訪問接口。

小結

好啦，數據查詢到了，項目搭建完成，本次我們一起探究了，利用SpringBoot搭建一個多模塊的項目，
這樣做的目的是方便項目的管理