Заметки о создании многомодульного проекта Spring boot maven

Spring Boot

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>
  1. Удалить содержимое зависимостей
  2. добавить помпон Пакет родительского проекта не может быть jar по умолчанию, поэтому его необходимо изменить на pom
  3. удалять

Окончательный 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>
        <groupId>com.boyuantang</groupId>
        <artifactId>btp-parent</artifactId>
        <version>0.0.1-SNAPSHOT</version>
    </parent>
  1. Удалить содержимое зависимостей Добавьте зависимости в соответствии с вашими потребностями.Если это веб-модуль, вам нужно добавить целый набор зависимостей Spring. Если это модуль модуля, добавьте зависимости по мере необходимости. В то же время подмодули также могут ссылаться друг на друга, как показано ниже.
<dependency>
	<groupId>com.boyuantang</groupId>
	<artifactId>btp-dao</artifactId>
	<version>0.0.1-SNAPSHOT</version>
</dependency>
  1. Удалить, если не веб-модуль

Для не-веб-модулей окончательный файл 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 запускается.

В-четвертых, проблема конфигурации

  1. Вы столкнетесь с ошибкой о том, что xxxDAO не существует, добавьте@MapperScan
@MapperScan("com.boyuantang.dao")
@SpringBootApplication
public class BtpAdminApplication {
    public static void main(String[] args) {
        SpringApplication.run(BtpAdminApplication.class, args);
    }
}
  1. Вы столкнетесь с компонентом, который не может быть зарегистрирован в сервисном модуле, добавьте@ComponentScan
@ComponentScan("com.boyuantang")
@SpringBootApplication
public class BtpAdminApplication {

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

}
  1. Не удалось отсканировать xml-файл mybatis, добавьте в application.properties
mybatis.mapper-locations=classpath*:mapper/*.xml

5. Зависимости между проектами

  1. Родительский проект импортирует глобальные зависимости, поэтому подмодулям не нужно импортировать эти модули.
    Напримерlombok,fastjsonТакие как
  2. Веб-модуль импортирует сервисный модуль без импорта сущности и общего, потому что сервис уже содержит эти подмодули.