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仓库;