Maven pom.xml与settings.xml详解

Maven pom.xml与settings.xml详解

1. pom.xml

1.1 意义

pom.xml 是 Maven 项目的 XML 形式的配置文件。它存储关于项目的信息，例如它的依赖项，它编译时的类路径，构建插件及其配置，开发者列表，许可证等。

1.2 样例配置

下面是一个标准的pom.xml的例子：

<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>com.example</groupId>
  <artifactId>my-app</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>jar</packaging>

  <name>My App</name>
  <description>My App Description</description>

  <dependencies>
    <dependency>
      <groupId>commons-lang</groupId>
      <artifactId>commons-lang</artifactId>
      <version>2.0</version>
    </dependency>
  </dependencies>

  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>2.3.2</version>
        <configuration>
          <source>1.8</source>
          <target>1.8</target>
        </configuration>
      </plugin>
    </plugins>
  </build>

</project>

1.3 结构分析

• project - 根元素，它是 pom.xml 文件的任何版本中必须的。
• modelVersion - POM 模型的版本。当前版本为 4.0.0。
• groupId - 表示项目所属的组织。例如，你的组织可能有一个部门叫做 IT，那么 groupId 就可以为 com.it。
• artifactId - 表示生成的构件的文件名。例如，如果你正在构建一个 JAR 文件，artifactId 就可以为 sample-jar。
• version - 表示构件的版本号。例如，1.0.0-SNAPSHOT。
• dependencies - 库依赖列表。
• build - 由 Maven 使用的构建设置。
• plugins - 能够扩展 Maven 构建生命周期的插件列表。

2. settings.xml

2.1 意义

settings.xml 是 Maven 的全局设置文件。它包括了 Maven 运行时的设置，如仓库位置，代理设置，开发者身份等。

2.2 样例配置

下面例子展示了一个settings.xml的基本配置：

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 
        http://maven.apache.org/xsd/settings-1.0.0.xsd">
  <localRepository>/path/to/local/repo</localRepository>
    <profiles>
      <profile>
        <id>local</id>
        <repositories>
          <repository>
            <id>central</id>
            <url>http://central</url>
          </repository>
        </repositories>
        <pluginRepositories>
          <pluginRepository>
            <id>central</id>
            <url>http://central</url>
          </pluginRepository>
        </pluginRepositories>
      </profile>
    </profiles>
</settings>

2.3 结构分析

• localRepository - 设置本地Maven仓库的地址。
• profiles - 描述特定的部署环境。可以为不同的项目创建不同的profile，并为他们制定不同的repository，pluginRepository以及other settings。
• profile - 包含一个或多个 repository 元素，用于描述该 profile 所使用的仓库地址。
• repositories - 需要下载所需依赖的远程仓库地址。
• pluginRepositories - 需要下载构建时所需插件的远程仓库地址。

另外，还有其他常用的设置可以在 settings.xml 中进行设置，例如代理服务器的设置、镜像仓库设置、开发者身份等。这里就不再一一列举了。

3. 总结

pom.xml 和 settings.xml 是 Maven 在代码管理中的两个核心配置文件，帮助我们更加高效的管理和构建项目。pom.xml 通过定义依赖及插件集中管理了项目所需依赖及插件，而settings.xml定义了 Maven 运行时的设置，帮助我们完善地管理开发过程中的存储和发布。