SpringCloud下的多模块maven项目

曾经终败给现在 2022-04-18 06:26 228阅读 0赞

编写一个登陆微服务pf-login，并注册到Eureka，先看我创建完的目录结构：

![SouthEast][]

简单分析一下，最外层是pf-login，下面有client、server、dao三个模块：   
①、client模块用于注册服务，提供服务的调用接口，是调用login服务的入口。   
②、server模块用于处理业务逻辑。   
③、dao模块用于数据持久，和数据库打交道。   
我们还可以加一些其他的模块，比如common,base之类的用来存放公共工具等等。   
模块间的依赖关系：client 依赖 server ，server 依赖 dao。

1、pf-login的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>cn.pw</groupId>
        <artifactId>pf-login</artifactId>
        <version>1.0-SNAPSHOT</version>
        <packaging>pom</packaging>
        <properties>
            <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
            <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
            <java.version>1.8</java.version>
            <spring-cloud.version>Dalston.SR4</spring-cloud.version>
            <fastjson-version>1.2.15</fastjson-version>
        </properties>
        <parent>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-parent</artifactId>
            <version>1.5.8.RELEASE</version>
            <relativePath/> 
        </parent>
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
            </dependency>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-starter-eureka</artifactId>
            </dependency>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-test</artifactId>
            </dependency>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-data-jpa</artifactId>
            </dependency>
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
                <scope>runtime</scope>
            </dependency>
            <dependency>
                <groupId>com.alibaba</groupId>
                <artifactId>fastjson</artifactId>
                <version>${fastjson-version}</version>
            </dependency>
        </dependencies>
        <dependencyManagement>
            <dependencies>
                <dependency>
                    <groupId>org.springframework.cloud</groupId>
                    <artifactId>spring-cloud-dependencies</artifactId>
                    <version>${spring-cloud.version}</version>
                    <type>pom</type>
                    <scope>import</scope>
                </dependency>
            </dependencies>
        </dependencyManagement>
        <modules>
            <module>pf-login-client</module>
            <module>pf-login-dao</module>
            <module>pf-login-server</module>
        </modules>
    </project>

所有关于pf-login模块的依赖都统一写在了这里 ，为了方便管理和避免重复依赖。与之前略有不同的是，我们加入了数据库的依赖组件，jpa和mysql。   
我们也注意到了pom中引入了阿里巴巴的fastjson，这个与其他依赖写法不同，也就 证明SpringBoot是支持第三方依赖，也支持自定义依赖的。   
<modules>是多模块项目的关键，模块简的关系正是通过父pom添加<modules>，子pom添加<parent>来建立的。

2、pf-login-client的pom.xml

上面我们设计了client 依赖 server，所以pom中添加了对 server的dependency。

3、pf-login-server的pom.xml

4、pf-login-dao的pom.xml

5、每个模块下都创建一个相同的root包，我这里是cn.pw.platform包，保证每个模块的启动类都在这个root包下。

原因：我们前面说过，springBoot启动类默认扫描当前包及子包，项目打包时，所有依赖的模块以jar的形式打进来，这样做能保证springBoot顺利扫描到所有依赖jar的组件。如果包名完全不一致，或父包、子包混乱，打包编译不会有问题，但项目启动时，会找不到所依赖的jar中的组件。（当然，也可以通过@ComponentScans注解来指定。）  
在调用此client接口的模块的启动类的注解上加上@EnableFeignClients(basePackages = "cn.pw.platform.pf-login-client")

6、分步打包   
打包一定从被完全依赖的模块开始，也就是从dao开始，使用 mvn install 命令，maven会在本地仓库生成相关的jar，其他依赖该组件的模块便能从本地仓库找到依赖的jar。   
依次install dao 和 server，最后再client 模块package，这样client中就用了dao和 server 的jar。   
如果直接打包client 或 server，maven会报错，提示找不到依赖的jar。  
(mvn -Dmaven.test.skip=true -U clean install)将项目打包成jar包放在本地仓库

7、统一打包   
统一打包很简单，在所有模块的父目录下打包，也就是通过pf-login的pom.xml打包，在pf-login下直接使用 mvn package 命令即可。

8、借助idea打包

![SouthEast 1][]

![SouthEast 2][]  
原文：https://blog.csdn.net/m15801049086/article/details/78547965

[SouthEast]: /images/20220418/a3c91cd343dd4342a8c82934199e8e2c.png
[SouthEast 1]: /images/20220418/b9baeb5ba3f54763a37fc166466379b4.png
[SouthEast 2]: /images/20220418/267653c865914d36ad22297de0f21307.png