我在某处读到，如果 Maven 项目使用继承，那么它的子项目将使用子项目的 artifactId 自动向 URL 添加一个子路径。 .但是现在我找不到引用。

Maven 将从父 POM 逐字继承哪些继承的 URL，以及它将为子 POM 添加一个子路径？例如，这里有一些我可以找到的 URL:

• <project><url>
• <project><scm><url>
• <project><distributionManagement><site><url>

也许我弄错了，他们都没有添加子路径，但我在笔记中有。不幸的是，我似乎无法通过互联网搜索找到明确的答案。

请尽量在您的回答中提供权威引用。 (当然，如果没有这方面的文档，直接测试将是次要的。)提前致谢。

最佳答案

所有这些元素都在 maven XSD schema 中定义已正确记录(xs:documentation 标签)。

这是 url 的文档:

project.url(第 102 行):

The URL to the project's homepage.
Default value is: parent value [+ path adjustment] + (artifactId or project.directory property)

仅当子项目的路径与其 artifactid 不匹配时才应用路径调整。

project.directory 是一个属性，您可以在 properties 中覆盖它标签。

site.url(第 544 行):

The url of the location where website is deployed, in the form protocol://hostname/path.
Default value is: parent value [+ path adjustment] + artifactId

scm.url(第 823 行):

The URL to the project's browsable SCM repository, such as ViewVC or Fisheye.
Default value is: parent value [+ path adjustment] + artifactId

因此，所有这些元素的默认值包括路径调整和 artifactId。

还有其他几个名为 url 的元素。并非所有这些都经过路径调整，例如存储库的 url 不是。

例子

让我们创建一个涵盖上述所有选项的示例。

对于这个例子，我们需要一个包含三个模块的项目(maven-urls):

• child-project - 一个不覆盖任何内容的常规子模块。
• child-with-a-project-directory - 声明 project.directory 属性的子模块。
• path-adjusted-child - 具有意外相对路径的子模块。

.目录结构应如下所示:

maven-urls
    child-project
    child-with-a-project-directory
    path
        path-adjusted-child

父项目pom

这里我们将声明三个不同的 url 和子项目(注意 path-adjusted-child 的路径):

...
<url>https://example.com</url>
<scm>
    <url>https://example.com/scm</url>
</scm>
<modules>
    <module>child-project</module>
    <module>path/path-adjusted-child</module>
    <module>child-with-a-project-directory</module>
</modules>
<distributionManagement>
    <site>
        <url>https://example.com/distribution</url>
    </site>
</distributionManagement>
...

项目目录

对于 child-with-a-project-directory 我们将设置一个 project.directory 属性

...
<properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    <project.directory>project</project.directory>
</properties>
...

路径调整项目

路径调整后的项目需要声明父模块的相对路径:

...
<parent>
    ...
    <relativePath>../../pom.xml</relativePath>
</parent>
...

你可以在github上查看完整代码:https://github.com/defaultlocale/maven-urls .

结果

现在我们可以构建整个项目并检查值。我们可以使用 maven 帮助插件，它是 effective-pom目标是找到每个子项目的有效 URL。

mvn help:effective-pom

这是所有这些的输出:

子项目:

<url>https://example.com/child-project</url>
<scm>
    <url>https://example.com/scm/child-project</url>
</scm>
<distributionManagement>
    <site>
        <url>https://example.com/distribution/child-project</url>
    </site>
</distributionManagement>

这里没有意外。每个 URL 只是一个附加了 artifactId 的父 URL。

child-with-a-project-directory:

...
<url>https://example.com/project</url>
<scm>
    <url>https://example.com/scm/project</url>
</scm>
<distributionManagement>
    <site>
        <url>https://example.com/distribution/project</url>
    </site>
</distributionManagement>
...

事实证明，project.directory 覆盖了所有三个 URL 的 artifactId。这是意外的，文档中未涵盖。

路径调整子:

<url>https://example.com/path/path-adjusted-child</url>
<scm>
    <url>https://example.com/scm/path/path-adjusted-child</url>
</scm>
<distributionManagement>
    <site>
        <url>https://example.com/distribution/path/path-adjusted-child</url>
    </site>
</distributionManagement>
...

毫不奇怪，每个 url 都包含一个相对路径和 artifactId。

关于java - Maven 使用子 POM 中的子路径解析哪些 URL？，我们在Stack Overflow上找到一个类似的问题： https://stackoverflow.com/questions/50321827/