Idea Maven项目打包工其他项目进行外部引用

2023-11-26 08:55:34

1、说明

我们在日常项目开发中经常会有许多公共的模块，如统一的父工程、工具类模块、中间实体类(DTO, VO)，如果我们针对每个子项目都单独的创建一套工具类，多个子项目会存在很多重复的工具类、中间实体类代码。因此，我们可以将这些公共模块统一打成jar包，在各子项目中引入depency依赖即可。

2、将父工程打包成jar包

创建一个maven工程，统一管理各种外部jar 包依赖版本，如Spring Boot，maven plugins，mybatis，lombok等。

2.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">
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.2.5.RELEASE</version>
    </parent>
    <packaging>pom</packaging>
    <modules>
        <module>cloud-common</module>
    </modules>
    <modelVersion>4.0.0</modelVersion>

    <groupId>cn.latiny</groupId>
    <artifactId>cloud-parent</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <project.build.sourceEncoding>UTF‐8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF‐8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>
        <mybatis.version>1.3.5</mybatis.version>
        <lombok.version>1.18.12</lombok.version>
        <swagger.version>2.7.0</swagger.version>
        <spring.cloud.version>Hoxton.SR6</spring.cloud.version>
        <mysql.version>5.1.47</mysql.version>
        <fastjson.version>1.2.47</fastjson.version>
        <jwt.version>1.0.10.RELEASE</jwt.version>
        <servlet.version>3.1.0</servlet.version>
        <mybatis.version>1.3.5</mybatis.version>
        <oauth2.version>2.2.5.RELEASE</oauth2.version>
    </properties>

    <!--全局依赖版本，不会引入具体的包，后期只需引入坐标，不用再指定版本了-->
    <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>

    <build>
        <plugins>
            <!-- Java编译插件 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.8.1</version>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                    <encoding>UTF-8</encoding>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

PS：一定要指定Java编译插件版本与encoding（UTF-8），否则打包时会报错。

2.2、工程目录

创建maven工程后，作为父工程，只用配置管理pom.xml文件，src文件删掉。

2.3、打包编译

打包编译时，可以设置跳过test步骤，先clean，再package或者install。

package：打包成jar包，在工程目录下的target中会出现对应的jar包；

install：安装jar包到本地的仓库中，该仓库是idea maven配置中的仓库路径；

2.4、父工程打包结果

这里面没有jar包，只有pom结尾的文件，因为父工程没有具体的代码。但是一旦打包成功，可以在其他项目引用该父工程的引用，PS：必须与父工程公用一个本地仓库。

添加父工程引用即可：

 <parent>
        <artifactId>cloud-parent</artifactId>
        <groupId>cn.latiny</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>

3、公共模块打包-子工程

3.1、在父工程下创建子工程cloud-common

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">
    <parent>
        <artifactId>cloud-parent</artifactId>
        <groupId>cn.latiny</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>cloud-common</artifactId>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.data</groupId>
            <artifactId>spring-data-commons</artifactId>
        </dependency>
    </dependencies>

</project>

此处以父工程的坐标作为common模块的parent，这里需要注意：

如果在同一个工程目录下，父工程不需要install就可以引用；
如果不在同一个工程目录下，需要先对父工程进行install才可以引用；

cloud-common工程结构

3.2、安装

先clean，后install，在maven配置的本地仓库路径下可以看到已安装好的jar包：

4、外部项目引用

在任何其他项目想要使用cloud-common的公共工具类，只需要在起pom.xml添加依赖即可：

 <dependency>
            <groupId>cn.latiny</groupId>
            <artifactId>cloud-common</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>

PS：该项目必须与cloud-common使用同一个本地maven仓库；

abc

码农公寓