spring boot maven 多模块项目建立笔记

1、建立父项目（parent）

使用IDE建立功能

Intellij > File > New > Project > Spring Initializr
复制代码

设置项目名称，使用默认选项，建立空的主项目

修改pom.xml

1. 添加子模块

<!-- 模块说明：这里声明多个子模块 -->
    <modules>
        <module>btp-bean</module>
        <module>btp-common</module>
        <module>btp-dao</module>
        <module>btp-service</module>
        <module>btp-admin</module>
        <module>btp-user</module>
    </modules>
复制代码

2. 删除dependencies内容
3. 添加pom 父项目打包不能是默认的jar，因此得改为pom
4. 删除

最终的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.3.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.boyuantang</groupId>
    <artifactId>btp-parent</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>btp-parent</name>
    <description>Demo project for Spring Boot</description>

    <packaging>pom</packaging>
    <!-- 模块说明：这里声明多个子模块 -->
    <modules>
        <module>btp-bean</module>
        <module>btp-common</module>
        <module>btp-dao</module>
        <module>btp-service</module>
        <module>btp-admin</module>
        <module>btp-user</module>
    </modules>


    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
    </dependencies>

</project>
复制代码

父项目的做用

• 父项目继承spring框架
• 父项目定义版本号
• 父项目让子模块之间能够相互引用

2、建立子模块

在IDE中点击父项目，右键

New > Module > Spring Initializr
复制代码

设置项目名称，使用默认选项，建立空的子模块

修改pom.xml

1. 添加父项目

取代默认的parent spring, 由于父项目已经继承了parent spring

<!-- 继承本项目的父工程 -->
    <parent>
        <groupId>com.boyuantang</groupId>
        <artifactId>btp-parent</artifactId>
        <version>0.0.1-SNAPSHOT</version>
    </parent>
复制代码

2. 删除dependencies内容 根据本身的须要添加依赖，若是是web模块，要添加spring的一整套依赖。若是是module模块，则按须要添加依赖。同时子模块之间也能够相互引用,以下

<dependency>
	<groupId>com.boyuantang</groupId>
	<artifactId>btp-dao</artifactId>
	<version>0.0.1-SNAPSHOT</version>
</dependency>
复制代码

4. 若是非web模块，则删除

非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.boyuantang</groupId>
        <artifactId>btp-parent</artifactId>
        <version>0.0.1-SNAPSHOT</version>
    </parent>
    <groupId>com.boyuantang</groupId>
    <artifactId>btp-dao</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>btp-dao</name>
    <description>Demo project for Spring Boot</description>

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

    <dependencies>
        <dependency>
        	<groupId>com.boyuantang</groupId>
        	<artifactId>btp-service</artifactId>
        	<version>0.0.1-SNAPSHOT</version>
        </dependency>
    </dependencies>

</project>
复制代码

3、打包

子模块能够分开打包。生成的jar可运行。

4、配置问题

1. 会遇到报错说 xxxDAO 不存在, 添加@MapperScan

@MapperScan("com.boyuantang.dao")
@SpringBootApplication
public class BtpAdminApplication {
    public static void main(String[] args) {
        SpringApplication.run(BtpAdminApplication.class, args);
    }
}
复制代码

2. 会遇到没法注册service模块的bean, 添加@ComponentScan

@ComponentScan("com.boyuantang")
@SpringBootApplication
public class BtpAdminApplication {

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

}
复制代码

3. 没法扫描mybatis的xml文件,在application.properties中添加

mybatis.mapper-locations=classpath*:mapper/*.xml
复制代码

5、项目之间的依赖关系

1. 父项目导入全局依赖，这样子模块就不用再导入这些模块
   好比lombok,fastjson之类
2. web模块导入service模块，不用导入entity, common这些，由于service已经包含了这些子模块