【Maven】将普通Eclipse项目改造为Maven项目（非SpringBoot项目）

文章目录

• 将普通Eclipse项目改造为Maven项目（非SpringBoot项目）
• • Maven安装与配置
  • 项目结构改造
  • 父子Pom.xml文件配置（继承与集成）
  • • 父项目下的pom.xml文件配置
    • 普通子模块下的pom.xml配置
    • 启动模块的pom.xml配置
  • 多模块编译
  • 总结
• Maven插件配置
• • 一、maven-compiler-plugin
  • • 功能
    • 常用参数
    • 配置示例
    • 注意事项
  • 二、maven-jar-plugin
  • • 功能
    • 常用参数
    • 配置示例
    • 注意事项
  • 三、maven-dependency-plugin
  • • 功能
    • 常用参数
    • 配置示例
    • 注意事项
  • 四、maven-resources-plugin
  • • 功能
    • 常用参数
    • 配置示例
    • 注意事项
  • 五、maven-shade-plugin
  • • 功能
    • 常用参数
    • 配置示例
    • 注意事项
  • 六、maven-assembly-plugin
  • • 功能
    • 常用参数
    • 配置示例
    • 自定义`assembly.xml`示例
    • 注意事项
  • 总结

将普通Eclipse项目改造为Maven项目（非SpringBoot项目）

Maven安装与配置

网上资料很多，可自行搜索，不再赘述。

项目结构改造

需要将普通Eclipse项目结构改造为Maven标准结构，如下

src/
|--main/
	|--java/
	|--resources/

多模块项目结构

Demo/
|--module1/
	|--java/
	|--resources/
	|--pom.xml
|--module2/
	|--java/
	|--resources/
	|--pom.xml
|--module3/
	|--java/
	|--resources/
	|--pom.xml
|--pom.xml

父子Pom.xml文件配置（继承与集成）

父项目下的pom.xml文件配置

注意事项：

1. 为了方便管理子模块的依赖，防止出现依赖冲突，在这里配置好所有模块的依赖项，后面等所有模块配置好后会一起下载依赖项
2. 按子模块间的依赖顺序集成子模块，作为后续构建jar包的打包顺序
3. 可配置下载依赖的Maven仓库地址

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

	<!-- GAV坐标 -->
    <groupId>com.regan</groupId> 	<!-- 公司或组织ID -->
    <artifactId>Demo</artifactId> 	<!-- 项目模块ID -->
    <version>1.0.0</version> 		<!-- 版本号 -->
    <packaging>pom</packaging>      <!-- 打包形式，pom工程 -->

    <name>Demo</name>  			<!-- 项目名称 -->
    <description>Demo</description><!-- 项目描述 -->

	<!-- 自定义属性 -->
    <properties>
        <!-- 应用版本号 -->
        <demo.version>1.0.0</demo.version>

        <!-- 编译版本 -->
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>

        <!-- 编码格式 -->
        <project.build.sourceEncoding>GBK</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>

        <!-- Java版本 -->
        <java.version>1.8</java.version>

        <!-- 第三方库版本 -->
        <dom4j.version>2.1.3</dom4j.version>
        <fastjson2.version>2.0.53</fastjson2.version>
        <gson.version>2.8.9</gson.version>
        <log4j-core.version>1.2.17</log4j-core.version>
        <junit.version>5.9.2</junit.version>
		
        <!-- 外部资源路径 -->
        <external-resources-path>${project.basedir}/../..</external-resources-path>

        <!-- maven插件 -->
        <maven-compiler-plugin.version>3.8.1</maven-compiler-plugin.version>
        <maven-jar-plugin.version>3.3.0</maven-jar-plugin.version>
        <maven-shade-plugin.version>3.2.4</maven-shade-plugin.version>
        <maven-dependency-plugin.version>3.6.0</maven-dependency-plugin.version>
        <maven-resources-plugin.version>3.3.1</maven-resources-plugin.version>

    </properties>

    <!-- 依赖项管理 -->
    <dependencyManagement>
        <dependencies>
            <!-- xml解析 -->
            <dependency>
                <groupId>org.dom4j</groupId>
                <artifactId>dom4j</artifactId>
                <version>${dom4j.version}</version>
            </dependency>

            <!-- 阿里json解析器 -->
            <dependency>
                <groupId>com.alibaba.fastjson2</groupId>
                <artifactId>fastjson2</artifactId>
                <version>${fastjson2.version}</version>
            </dependency>

            <!-- json-java object 转换 -->
            <dependency>
                <groupId>com.google.code.gson</groupId>
                <artifactId>gson</artifactId>
                <version>${gson.version}</version>
            </dependency>

            <!-- 日志记录工具 -->
            <dependency>
                <groupId>org.apache.logging.log4j</groupId>
                <artifactId>log4j</artifactId>
                <version>${log4j-core.version}</version>
            </dependency>

            <!-- 编写测试的API -->
            <dependency>
                <groupId>org.junit.jupiter</groupId>
                <artifactId>junit-jupiter-api</artifactId>
                <version>${junit.version}</version>
                <scope>test</scope>
            </dependency>

            <!-- 基础模块 -->
            <dependency>
                <groupId>com.regan</groupId>
                <artifactId>module1</artifactId>
                <version>${demo.version}</version>
            </dependency>

            <!-- 基础工具模块 -->
            <dependency>
                <groupId>com.regan</groupId>
                <artifactId>module2</artifactId>
                <version>${demo.version}</version>
            </dependency>

            <!-- 核心模块 -->
            <dependency>
                <groupId>com.regan</groupId>
                <artifactId>module3</artifactId>
                <version>${demo.version}</version>
            </dependency>

			<!-- 启动模块 -->
            <dependency>
                <groupId>com.regan</groupId>
                <artifactId>demo</artifactId>
                <version>${demo.version}</version>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <!-- 子模块,根据依赖顺序排序 -->
    <modules>
        <module>module1</module>
        <module>module2</module>
        <module>module3</module>
        <module>demo</module>
    </modules>

    <!-- 统一管理插件版本 -->
    <build>
		<!-- 打包后的Jar包名称 -->
        <finalName>Demo-${project.artifactId}-${demo.version}</finalName>
        <pluginManagement>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <version>${maven-compiler-plugin.version}</version>
                    <configuration>
                        <source>${java.version}</source>
                        <target>${java.version}</target>
                        <encoding>${project.build.sourceEncoding}</encoding>
                    </configuration>
                </plugin>
            </plugins>
        </pluginManagement>
    </build>

	<!-- 仓库 -->
    <repositories>
        <repository>
            <id>public</id>
            <name>aliyun nexus</name>
            <url>https://maven.aliyun.com/repository/public</url>
            <releases>
                <enabled>true</enabled>
            </releases>
        </repository>
    </repositories>

	<!-- 插件仓库 -->
    <pluginRepositories>
        <pluginRepository>
            <id>public</id>
            <name>aliyun nexus</name>
            <url>https://maven.aliyun.com/repository/public</url>
            <releases>
                <enabled>true</enabled>
            </releases>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </pluginRepository>
    </pluginRepositories>
</project>

普通子模块下的pom.xml配置

注意事项

1. 注意要继承parent
2. 依赖的其它模块也要写上

<?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>com.regan</groupId>
        <artifactId>Demo</artifactId>
        <version>1.0.0</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <packaging>jar</packaging>  <!-- 子模块打包成Jar包 -->
    <artifactId>module2</artifactId>

    <description>基础模块</description>

    <dependencies>
        <dependency>
            <groupId>org.dom4j</groupId>
            <artifactId>dom4j</artifactId>
        </dependency>

        <!-- 依赖的其它模块 -->
        <dependency>
            <groupId>com.regan</groupId>
            <artifactId>module1</artifactId>
        </dependency>
    </dependencies>
</project>

启动模块的pom.xml配置

注意事项

1. 启动模块需要配置程序入口

2. 在这里进行打包配置(依赖、资源文件)

3. 如果所依赖的资源路径在项目执行路径之外(${project.basedir})，就需要在打包配置时使用

   ${project.basedir}/..--相当于执行路径下的上一级目录

   <resources>
       <resource>
           <directory>你的资源路径</directory>
       </resource>
   </resources>

<?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>com.regan</groupId>
        <artifactId>Demo</artifactId>
        <version>1.0.0</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <packaging>jar</packaging>
    <artifactId>module3</artifactId>
    <properties>
        <external-resources-path>${project.basedir}/../..</external-resources-path>
    </properties>

    <description>启动模块</description>


    <dependencies>
        <!-- xml解析 -->
        <dependency>
            <groupId>org.dom4j</groupId>
            <artifactId>dom4j</artifactId>
            <version>${dom4j.version}</version>
            <scope>system</scope>
            <systemPath>${external-resources-path}/safri_build/dom4j-2.1.1.jar</systemPath>
        </dependency>

        <!-- 日志记录工具 -->
        <dependency>
            <groupId>org.apache.logging.log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>${log4j-core.version}</version>
            <scope>system</scope>
            <systemPath>${external-resources-path}/safri_build/log4j-1.2.17.jar</systemPath>
        </dependency>

        <!-- json库 -->
        <dependency>
            <groupId>org.json</groupId>
            <artifactId>json</artifactId>
            <version>${json.version}</version>
            <scope>system</scope>
            <systemPath>${external-resources-path}/safri_build/json.jar</systemPath>
        </dependency>

        <!-- 语法高亮文本编辑器 -->
        <dependency>
            <groupId>com.fifesoft</groupId>
            <artifactId>rsyntaxtextarea</artifactId>
            <version>${rsyntaxtextarea.version}</version>
            <scope>system</scope>
            <systemPath>${external-resources-path}/safri_build/rsyntaxtextarea-3.5.3.jar</systemPath>
        </dependency>

        <!-- 阿里json解析器 -->
        <dependency>
            <groupId>com.alibaba.fastjson2</groupId>
            <artifactId>fastjson2</artifactId>
            <version>${fastjson2.version}</version>
            <scope>system</scope>
            <systemPath>${external-resources-path}/safri_build/fastjson2-2.0.53.jar</systemPath>
        </dependency>

        <dependency>
            <groupId>com.regan</groupId>
            <artifactId>module1</artifactId>
        </dependency>

        <dependency>
            <groupId>com.regan</groupId>
            <artifactId>module2</artifactId>
        </dependency>
    </dependencies>

    <!-- 配置可执行Jar -->
    <build>
        <!-- 可选：配置从指定目录下开始编译,不拘泥于Maven结构-- <sourceDirectory>src</sourceDirectory> -->
        <plugins>
            <!-- 1. 生成主JAR（不含依赖） -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>${maven-jar-plugin.version}</version>
                <configuration>
                    <archive>
                        <manifest>
                            <addClasspath>true</addClasspath>
                            <classpathPrefix>lib/</classpathPrefix>
                            <mainClass>cnpo.Demo.app.ApplicationEntrance</mainClass>
                        </manifest>
                    </archive>
                </configuration>
            </plugin>

            <!-- 2. 复制所有依赖到target/lib -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-dependency-plugin</artifactId>
                <version>${maven-dependency-plugin.version}</version>
                <executions>
                    <execution>
                        <id>copy-dependencies</id>
                        <phase>package</phase>
                        <goals>
                            <goal>copy-dependencies</goal>
                        </goals>
                        <configuration>
                            <outputDirectory>${project.build.directory}/lib</outputDirectory>
                            <excludeTransitive>false</excludeTransitive>
                            <stripVersion>false</stripVersion>
                            <overWriteReleases>false</overWriteReleases>
                            <overWriteSnapshots>false</overWriteSnapshots>
                            <includeScope>runtime</includeScope>
                            <includeScope>system</includeScope>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

            <!-- 3. 处理资源文件 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-resources-plugin</artifactId>
                <version>${maven-resources-plugin.version}</version>
                <executions>
                    <execution>
                        <id>copy-resources</id>
                        <phase>process-resources</phase>
                        <goals>
                            <goal>copy-resources</goal>
                        </goals>
                        <configuration>
                            <outputDirectory>${project.build.directory}</outputDirectory>
                            <resources>
                                <!-- 资源1 目录 -->
                                <resource>
                                    <directory>${external-resources-path}/images</directory>
                                    <excludes>
                                        <exclude>**/*.webg</exclude>
                                    </excludes>
                                    <targetPath>images</targetPath>
                                </resource>

                                <!-- config 目录 -->
                                <resource>
                                    <directory>${external-resources-path}/config</directory>
                                    <includes>
                                        <include>**/*.*</include>
                                    </includes>
                                    <targetPath>config</targetPath>
                                </resource>

                                <!-- 单个文件 -->
                                <resource>
                                    <directory>${external-resources-path}/</directory> <!-- 指向父目录 -->
                                    <includes>
                                        <include>*.properties</include>
                                        <include>admin.txt</include>
                                    </includes>
                                </resource>
                            </resources>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

多模块编译

进行多模块编译主要就是需要在父类pom.xml文件中配置好modules，各子模块的pom.xml文件中配置好依赖模块和依赖包，最后在启动模块下进行Maven插件的配置。可参考上述pom.xml配置文件。

还需要注意的一点是依赖配置：

• 若使用 <systemPath>，需在所有依赖模块中显式重复配置该依赖。

<scope>system</scope>
<systemPath>依赖包路径</systemPath>

注意：这种依赖作用域默认没有依赖传递。

总结

Maven多模块项目主要就是注意父类Pom.xml文件与子模块Pom.xml文件的模块包含关系，以及依赖配置。

Maven插件配置

以下是对Maven核心插件的详细介绍，涵盖参数配置、使用场景及注意事项：

---

一、maven-compiler-plugin

功能

负责Java源代码的编译，控制编译版本、编码、内存分配等。

常用参数

1. <source>：指定源代码兼容的Java版本（如1.8）。
2. <target>：指定生成的字节码目标JVM版本。
3. <encoding>：设置字符编码（默认UTF-8）。
4. <fork>：是否启用独立进程编译（默认false）。
5. <compilerArgs> ：传递额外编译器参数（如-Xlint:unchecked）。
6. <showWarnings>：是否显示编译警告（默认false）。
7. <release>：兼容特定JDK版本（仅JDK9+支持）。

配置示例

<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>
    <compilerArgs>
      <arg>-Xlint:all</arg>
    </compilerArgs>
  </configuration>
</plugin>

注意事项

• 版本兼容性 ：<release>参数仅JDK9+支持，低版本需用<source>/<target>。
• 目标JVM限制 ：即使设置<target>为低版本，仍需避免使用高版本API，建议配合bootclasspath或Animal Sniffer插件验证。

---

二、maven-jar-plugin

功能

生成标准JAR包，配置清单文件（MANIFEST.MF）。

常用参数

1. <archive> ：配置JAR包元数据。
   • <manifest>：定义主类、类路径等。

• <mainClass>：指定入口类。
• <addClasspath>：是否添加类路径（默认false）。
• <classpathPrefix> ：类路径前缀（如lib/）。

2. <excludes> /<includes>：排除或包含特定文件。

配置示例

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-jar-plugin</artifactId>
  <version>3.3.0</version>
  <configuration>
    <archive>
      <manifest>
        <addClasspath>true</addClasspath>
        <classpathPrefix>lib/</classpathPrefix>
        <mainClass>com.example.Main</mainClass>
      </manifest>
    </archive>
    <excludes>
      <exclude>**/test/**</exclude>
    </excludes>
  </configuration>
</plugin>

注意事项

• 依赖管理 ：不会打包依赖库，需配合maven-dependency-plugin复制依赖到类路径目录。
• 版本冲突：若配置不生效，检查插件版本与Maven/JDK兼容性。

---

三、maven-dependency-plugin

功能

管理项目依赖，如复制依赖、生成依赖树。

常用参数

1. <copy-dependencies>目标 ：
   • <outputDirectory> ：依赖复制目标目录（如target/lib）。
   • <excludeTransitive>：是否排除传递依赖（默认false）。
   • <stripVersion>：移除依赖版本号（默认false）。
2. <dependency:tree>：生成依赖树分析。

配置示例

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-dependency-plugin</artifactId>
  <version>3.6.0</version>
  <executions>
    <execution>
      <id>copy-dependencies</id>
      <phase>package</phase>
      <goals>
        <goal>copy-dependencies</goal>
      </goals>
      <configuration>
        <outputDirectory>${project.build.directory}/lib</outputDirectory>
        <stripVersion>true</stripVersion>
      </configuration>
    </execution>
  </executions>
</plugin>

注意事项

• 参数兼容性 ：避免使用旧版本参数（如overwrite），推荐使用<overWriteIfNewer>。
• 依赖范围 ：通过<includeScope>控制复制范围（如runtime）。

---

四、maven-resources-plugin

功能

处理资源文件，支持过滤、编码、动态替换占位符。

常用参数

1. <encoding> ：资源文件编码（默认${project.build.sourceEncoding}）。
2. <resources> ：定义资源目录及过滤规则。
   • <filtering>：是否启用占位符替换（默认false）。
3. <excludes> /<includes>：排除或包含特定资源文件。
4. <escapeString> ：转义占位符前缀（如\${}避免替换）。

配置示例

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-resources-plugin</artifactId>
  <version>3.3.0</version>
  <configuration>
    <encoding>UTF-8</encoding>
    <resources>
      <resource>
        <directory>src/main/resources</directory>
        <filtering>true</filtering>
        <excludes>
          <exclude>**/*.key</exclude>
        </excludes>
      </resource>
    </resources>
  </configuration>
</plugin>

注意事项

• 二进制文件过滤 ：通过<nonFilteredFileExtensions>排除二进制文件（如PNG）。
• 目录覆盖 ：默认包含src/main/resources，自定义资源目录需显式声明。

---

五、maven-shade-plugin

功能

生成包含依赖的"胖JAR"（Uber-JAR），解决依赖冲突。

常用参数

1. <transformers> ：合并资源文件（如ManifestResourceTransformer）。
   • <mainClass>：指定入口类。
2. <filters> ：排除签名文件（如META-INF/*.SF）。
3. <relocations> ：重定位类路径以避免冲突（如com.google.guava→shaded.com.google.guava）。
4. <createDependencyReducedPom>：是否生成精简POM（默认true）。

配置示例

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-shade-plugin</artifactId>
  <version>3.5.0</version>
  <executions>
    <execution>
      <phase>package</phase>
      <goals>
        <goal>shade</goal>
      </goals>
      <configuration>
        <transformers>
          <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
            <mainClass>com.example.Main</mainClass>
          </transformer>
        </transformers>
        <filters>
          <filter>
            <artifact>*:*</artifact>
            <excludes>
              <exclude>META-INF/*.SF</exclude>
            </excludes>
          </filter>
        </filters>
      </configuration>
    </execution>
  </executions>
</plugin>

注意事项

• 资源冲突 ：多个依赖包含同名资源时需手动合并（如AppendingTransformer）。
• 体积控制 ：通过<minimizeJar>移除未使用的类，但可能破坏反射。

---

六、maven-assembly-plugin

功能

生成自定义分发包（如ZIP/TAR），包含脚本、配置文件等。

常用参数

1. <descriptorRefs> ：使用预定义描述符（如jar-with-dependencies）。
2. <descriptors> ：引用自定义assembly.xml文件。
3. <archive> ：配置清单文件（如Main-Class）。
4. <formats>：指定打包格式（如zip、tar.gz）。

配置示例

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-assembly-plugin</artifactId>
  <version>3.6.0</version>
  <configuration>
    <descriptors>
      <descriptor>src/main/assembly/custom.xml</descriptor>
    </descriptors>
  </configuration>
  <executions>
    <execution>
      <phase>package</phase>
      <goals>
        <goal>single</goal>
      </goals>
    </execution>
  </executions>
</plugin>

自定义assembly.xml示例

<assembly>
  <id>full-distribution</id>
  <formats>
    <format>zip</format>
  </formats>
  <fileSets>
    <fileSet>
      <directory>target</directory>
      <outputDirectory>/</outputDirectory>
      <includes>
        <include>*.jar</include>
      </includes>
    </fileSet>
    <fileSet>
      <directory>src/main/scripts</directory>
      <outputDirectory>/bin</outputDirectory>
    </fileSet>
  </fileSets>
</assembly>

注意事项

• 路径控制 ：<includeBaseDirectory>决定是否将文件放入顶级目录。
• 依赖管理 ：通过<dependencySets>控制依赖的打包方式（如解压或直接复制）。

---

总结

插件	核心用途	典型场景
maven-compiler-plugin	控制编译过程	多版本JDK兼容、编码调整
maven-jar-plugin	生成标准JAR包	可执行JAR、类路径配置
maven-dependency-plugin	依赖管理	依赖复制、依赖树分析
maven-resources-plugin	资源文件处理	配置文件过滤、编码统一
maven-shade-plugin	生成胖JAR	微服务部署、依赖冲突解决
maven-assembly-plugin	定制化打包分发	包含脚本/配置的完整发布包

通过合理配置这些插件，可实现从编译到分发的全流程控制，满足复杂项目需求。