Maven 实战案例：搭建微服务 Maven 工程结构

一、项目需求和结构分析

1、需求案例

搭建一个电商平台项目，该平台包括用户服务、订单服务、通用工具模块等。

2、项目架构

• 用户服务：负责处理用户相关的逻辑，例如用户信息的管理、用户注册、登录等。
• 订单服务：负责处理订单相关的逻辑，例如订单的创建、订单支付、退货、订单查看等。
• 通用模块：负责存储其他服务需要通用工具类，其他服务依赖此模块。

3、服务依赖

（1）用户服务 (1.0.1)

spring-context 6.0.6

spring-core 6.0.6

spring-beans 6.0.6

jackson-databind / jackson-core / jackson-annotations 2.15.0

（2）订单服务 (1.0.1)

shiro-core 1.10.1

spring-context 6.0.6

spring-core 6.0.6

spring-beans 6.0.6

（3）通用模块 (1.0.1)

commons-io 2.11.0

二、项目搭建和统一构建

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>

    <groupid>com.atguigu</groupid>
    <artifactid>micro-shop</artifactid>
    <version>1.0.1</version>
    <!-- 父工程不打包，所以选择pom值-->
    <packaging>pom</packaging>

    <properties>
        <spring.version>6.0.6</spring.version>
        <jackson.version>2.15.0</jackson.version>
        <shiro.version>1.10.1</shiro.version>
        <commons.version>2.11.0</commons.version>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceencoding>utf-8</project.build.sourceencoding>
    </properties>

    <!-- 依赖管理 -->
    <dependencymanagement>
        <dependencies>
            <!-- spring-context会依赖传递core/beans -->
            <dependency>
                <groupid>org.springframework</groupid>
                <artifactid>spring-context</artifactid>
                <version>${spring.version}</version>
            </dependency>

            <!-- jackson-databind会依赖传递core/annotations -->
            <dependency>
                <groupid>com.fasterxml.jackson.core</groupid>
                <artifactid>jackson-databind</artifactid>
                <version>${jackson.version}</version>
            </dependency>

            <!-- shiro-core -->
            <dependency>
                <groupid>org.apache.shiro</groupid>
                <artifactid>shiro-core</artifactid>
                <version>${shiro.version}</version>
            </dependency>
            <!-- commons-io -->
            <dependency>
                <groupid>commons-io</groupid>
                <artifactid>commons-io</artifactid>
                <version>${commons.version}</version>
            </dependency>

        </dependencies>

    </dependencymanagement>

    <dependencies>
        <!-- 父工程添加依赖，会自动传递给所有子工程，不推荐！ -->
    </dependencies>

    <!-- 统一更新子工程打包插件-->
    <build>
        <!-- jdk17 和 war包版本插件不匹配 -->
        <plugins>
            <plugin>
                <groupid>org.apache.maven.plugins</groupid>
                <artifactid>maven-war-plugin</artifactid>
                <version>3.2.2</version>
            </plugin>
        </plugins>
    </build>

</project>

2、通用模块 

• 创建模块

• 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.atguigu</groupid>
        <artifactid>micro-shop</artifactid>
        <version>1.0.1</version>
    </parent>
    <artifactid>common-service</artifactid>
    <!-- 打包方式默认就是jar！ -->
    <packaging>jar</packaging>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceencoding>utf-8</project.build.sourceencoding>
    </properties>

    <dependencies>
        <!-- 声明commons-io，继承父工程版本 -->
        <dependency>
            <groupid>commons-io</groupid>
            <artifactid>commons-io</artifactid>
        </dependency>
    </dependencies>

</project>

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>com.atguigu</groupid>  
    <artifactid>micro-shop</artifactid>  
    <version>1.0.1</version> 
  </parent>  
  <artifactid>user-service</artifactid>  
  <packaging>war</packaging>

  <properties> 
    <maven.compiler.source>17</maven.compiler.source>  
    <maven.compiler.target>17</maven.compiler.target>  
    <project.build.sourceencoding>utf-8</project.build.sourceencoding> 
  </properties>

  <dependencies>
    <!-- 添加spring-context 自动传递 core / beans -->
    <dependency>
      <groupid>org.springframework</groupid>
      <artifactid>spring-context</artifactid>
    </dependency>

    <!-- 添加jackson-databind 自动传递 core / annotations -->
    <dependency>
      <groupid>com.fasterxml.jackson.core</groupid>
      <artifactid>jackson-databind</artifactid>
    </dependency>
  </dependencies>
</project>

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>com.atguigu</groupid>
        <artifactid>micro-shop</artifactid>
        <version>1.0.1</version>
    </parent>

    <artifactid>order-service</artifactid>
    <packaging>war</packaging>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceencoding>utf-8</project.build.sourceencoding>
    </properties>

    <dependencies>
        <!-- 继承父工程依赖版本 -->
        <dependency>
            <groupid>org.springframework</groupid>
            <artifactid>spring-context</artifactid>
        </dependency>

        <!-- 继承父工程依赖版本 -->
        <dependency>
            <groupid>org.apache.shiro</groupid>
            <artifactid>shiro-core</artifactid>
        </dependency>
    </dependencies>

</project>