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


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.bootgroupId>
        <artifactId>spring-boot-starter-parentartifactId>
        <version>2.2.5.RELEASEversion>
    parent>
    <packaging>pompackaging>
    <modules>
        <module>cloud-commonmodule>
    modules>
    <modelVersion>4.0.0modelVersion>

    <groupId>cn.latinygroupId>
    <artifactId>cloud-parentartifactId>
    <version>1.0-SNAPSHOTversion>

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

    
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloudgroupId>
                <artifactId>spring-cloud-dependenciesartifactId>
                <version>${spring.cloud.version}version>
                <type>pomtype>
                <scope>importscope>
            dependency>
        dependencies>
    dependencyManagement>

    <build>
        <plugins>
            
            <plugin>
                <groupId>org.apache.maven.pluginsgroupId>
                <artifactId>maven-compiler-pluginartifactId>
                <version>3.8.1version>
                <configuration>
                    <source>1.8source>
                    <target>1.8target>
                    <encoding>UTF-8encoding>
                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-parentartifactId>
        <groupId>cn.latinygroupId>
        <version>1.0-SNAPSHOTversion>
    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-parentartifactId>
        <groupId>cn.latinygroupId>
        <version>1.0-SNAPSHOTversion>
    parent>
    <modelVersion>4.0.0modelVersion>

    <artifactId>cloud-commonartifactId>

    <dependencies>
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-webartifactId>
        dependency>

        <dependency>
            <groupId>org.springframework.datagroupId>
            <artifactId>spring-data-commonsartifactId>
        dependency>
    dependencies>

project>

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

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

cloud-common工程结构

3.2、安装

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

 4、外部项目引用

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

 <dependency>
            <groupId>cn.latinygroupId>
            <artifactId>cloud-commonartifactId>
            <version>1.0-SNAPSHOTversion>
        dependency>

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

abc