java web 之springboot教程之三十二----多模块项目

比起传统复杂的单体工程，使用Maven的多模块配置，可以帮助项目划分模块，鼓励重用，防止POM变得过于庞大，方便某个模块的构建，而不用每次都构建整个项目，并且使得针对某个模块的特殊控制更为方便。

一，创建父工程

使用 Spring Initializr 来快速创建好一个Maven工程。然后删除无关的文件，只需保留pom.xml 文件。

在 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 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.example</groupId>
   <artifactId>multi-module</artifactId>
   <version>0.0.1-SNAPSHOT</version>
   <name>multi-module</name>
    <packaging>pom</packaging>
    <description>SpringBoot 多模块构建示例</description>

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

   <!-- 模块说明：这里声明多个子模块 -->
   <modules>
      <module>mm-web</module>
      <module>mm-service</module>
      <module>mm-repo</module>
      <module>mm-entity</module>
   </modules>

   <!-- 版本说明：这里统一管理依赖的版本号 -->
   <dependencyManagement>
      <dependencies>
         <dependency>
            <groupId>com.example</groupId>
            <artifactId>mm-web</artifactId>
            <version>0.0.1-SNAPSHOT</version>
         </dependency>
         <dependency>
            <groupId>com.example</groupId>
            <artifactId>mm-service</artifactId>
            <version>0.0.1-SNAPSHOT</version>
         </dependency>
         <dependency>
            <groupId>com.example</groupId>
            <artifactId>mm-repo</artifactId>
            <version>0.0.1-SNAPSHOT</version>
         </dependency>
         <dependency>
            <groupId>com.example</groupId>
            <artifactId>mm-entity</artifactId>
            <version>0.0.1-SNAPSHOT</version>
         </dependency>
      </dependencies>
   </dependencyManagement>


</project>

注意这里的<packaging>pom</packaging>

二，创建各子模块

对着父工程右键 - New - Module - > 输入 mm-web

也使用 Spring Initializr 来快速创建好一个Maven工程。然后删除无关的文件，保留pom.xml 文件和src。

其他几个子模块类似，mm-web的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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
   <modelVersion>4.0.0</modelVersion>
   <parent>
      <groupId>com.example</groupId>
      <artifactId>multi-module</artifactId>
      <version>0.0.1-SNAPSHOT</version>
      <relativePath/> <!-- lookup parent from repository -->
   </parent>
   <groupId>com.example</groupId>
   <artifactId>mm-web</artifactId>
   <version>0.0.1-SNAPSHOT</version>
   <name>mm-web</name>
    <packaging>jar</packaging>
   <description>Demo project for Spring Boot</description>

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

   <dependencies>

      <dependency>
         <groupId>com.example</groupId>
         <artifactId>mm-service</artifactId>
      </dependency>
      <dependency>
         <groupId>com.example</groupId>
         <artifactId>mm-entity</artifactId>
      </dependency>

      <dependency>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-starter</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-test</artifactId>
         <scope>test</scope>
      </dependency>
   </dependencies>

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

</project>

注意这里的<packaging>jar</packaging>。其他几个子模块类似。

再看下启动类：

package com.example.mmweb;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.domain.EntityScan;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.data.jpa.repository.config.EnableJpaRepositories;

@SpringBootApplication
@ComponentScan({"com.example.mmservice"})
@EntityScan("com.example.mmentity")
@EnableJpaRepositories("com.example.mmrepo")
public class MmWebApplication {

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

}

这里要加上几个扫包注解。不然会出错。

application.yml配置文件：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/socks?serverTimezone=GMT%2B8&useUnicode=true&characterEncoding=UTF-8&useSSL=false
    username: root
    password: root
    driver-class-name: com.mysql.cj.jdbc.Driver

sql文件：

SET FOREIGN_KEY_CHECKS=0;

-- ----------------------------
-- Table structure for t_user
-- ----------------------------
DROP TABLE IF EXISTS `t_user`;
CREATE TABLE `t_user` (
  `userid` int(11) NOT NULL AUTO_INCREMENT,
  `username` varchar(255) DEFAULT NULL,
  `password` varchar(255) DEFAULT NULL,
  PRIMARY KEY (`userid`)
) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8;

-- ----------------------------
-- Records of t_user
-- ----------------------------
INSERT INTO `t_user` VALUES ('1', 'admin', 'admin');
INSERT INTO `t_user` VALUES ('2', 'jack', 'buzhidao');

运行启动类，访问localhost:8080可以看到结果。当然要把controller加进去。

三，运维部署

启动模块是 mm-web ， 只需在它的pom.xml 添加打包插件（spring-boot-maven-plugin）:

<!--多模块打包：只需在启动类所在模块的POM文件：指定打包插件 -->
    <build>
        <plugins>
            <plugin>
                <!--该插件主要用途：构建可执行的JAR -->
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

在IDE打开Maven插件，然后在聚合父工程multi-module中点击 clean ，然后点击 package 进行打包。如图：

最后得到jar包，用命令行启动即可。