【Maven】Maven实战案例:搭建微服务Maven工程架构

PS:本项目不会写业务,只是来搭建一个微服务的项目,通过导入依赖和构建过程去严正大家是否对Maven掌握。

一、项目需求和结构分析

需求案例:搭建一个电商平台项目,该平台包括用户服务、订单服务、通用工具模块等。

项目架构:

  1. 用户服务:负责处理用户相关的逻辑,例如用户信息的管理、用户注册、登录等。普通的Web工程。
  2. 订单服务:负责处理订单相关的逻辑,例如订单的创建、订单支付、退货、订单查看等。普通的Web工程。
  3. 通用模块:负责存储其他服务需要通用工具类,其他服务依赖此模块。普通的Java工程。

因为我们需要将 common-service 放到Maven仓库,然后再让用户服务和订单服务引入,因为能放到Maven仓库的都是普通工程。

PS:部署必须是jar包形式,也就是说你只能是一个Java普通工程才能被别人引用;而web工程应该放到服务器软件,而不是放到仓库的。

服务依赖:

  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)
    1. shiro-core 1.10.1
    2. spring-context 6.0.6
    3. spring-core 6.0.6
    4. spring-beans 6.0.6
  3. 通用模块 (1.0.1)
    1. commons-io 2.11.0

二、步骤总结

  1. 搭建父工程

  2. 删除父工程下的src目录,打包方式改为pom

  3. 搭建用户服务、订单服务,并且转为Web项目

  4. 搭建通用模块

  5. 将父工程的gavp中的v改为 1.0.1,这样子工程的版本都是由父工程继承下来的,子工程中只需要写ga属性

  6. 在父工程中使用 <dependencyManage> 统一管理依赖的版本

  7. 在子工程中使用 <dependencies> 导入依赖,只需要写ga属性即可,版本由父工程统一管理

  8. Maven工程之间是无法直接引用的,需要将你的工程放到本地仓库(使用install部署)或者私服(使用deploy部署)

    image-20240731130338402
  9. 在父工程中声明版本信息

    <!-- 自己的工程 -->
    <dependency>
        <groupId>com.atguigu</groupId>
        <artifactId>common-service</artifactId>
        <version>1.0.1</version>
    </dependency>
    
  10. 最后在用户服务、订单服务中引入即可,无需声明版本信息

    <!-- 自己的工程 -->
    <dependency>
        <groupId>com.atguigu</groupId>
        <artifactId>common-service</artifactId>
    </dependency>
    
  11. 使用父工程统一更新子工程打包插件

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

三、父模块搭建 (micro-shop)

1)创建父工程

然后删除父工程的src目录


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>

    <groupId>com.atguigu</groupId>
    <artifactId>micro-shop</artifactId>
    <!-- 由需求分析,子工程对应的版本号都是1.0.1 -->
    <version>1.0.1</version>
    <!-- 父工程不打包,所以选择pom值-->
    <packaging>pom</packaging>
    <modules>
        <module>common-service</module>
        <module>user-service</module>
        <module>order-service</module>
    </modules>
</project>

3)父工程统一依赖管理

在写依赖管理之前,一定要先想想这些依赖会不会有自己的依赖传递。

例如

  • spring-context 6.0.6
  • spring-core 6.0.6
  • spring-beans 6.0.6

到Maven官网中搜索 spring-context:https://mvnrepository.com/

就会发现,其实 spring-corespring-beans 会因为以来传递跟着 spring-context 一起被导入进来,因此其实是只需要导入 spring-context 的依赖即可。

image-20240731125529782

<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>

        <!-- 自己的工程 -->
        <dependency>
            <groupId>com.atguigu</groupId>
            <artifactId>common-service</artifactId>
            <version>1.0.1</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>

四、通用模块 (common-service)

1)创建模块


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>

五、用户模块 (user-service)

1)创建模块


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>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>
        <!-- 自己的工程 -->
        <dependency>
            <groupId>com.atguigu</groupId>
            <artifactId>common-service</artifactId>
        </dependency>
    </dependencies>
</project>

六、订单模块 (order-service)

1)创建模块


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>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>
        <!-- 自己的工程 -->
        <dependency>
            <groupId>com.atguigu</groupId>
            <artifactId>common-service</artifactId>
        </dependency>
    </dependencies>

</project>
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值