Maven 项目有哪些额外的目录约定？

Question

Maven 2 对项目使用标准目录布局，记录如下：

http://maven.apache.org/guides/introduction/introduction-to-the-standard-directory-layout.html

我想知道的是：除了普通的之外，是否还有其他项目的推荐约定-vanilla Java 库、Java EE 和 WebApp 项目？ 具体来说，在哪里放置 ant 文件、启动脚本、配置文件、示例应用程序等。

此外，将文件放置在 src/ 目录树之外的约定是什么？ 例如，将文档放在 doc/ 下（作为 src 的同级）是否常见？

有没有一个页面可以编译这些约定？ 如果没有，其他读者可以提供他们自己项目中的示例吗？

Answer 1

我放置额外配置文件的主文件夹位于 src/main/java/resources 下。 通常我在那里创建子目录。 测试可以有自己的配置文件 src/test/resources。

您可以使用 pom.xml 的构建部分中的指令来指定其他资源目录以及将文件复制到目标目录中特定位置的位置。 通常，您尝试使用的语言或框架会出现约定。 在这种情况下，混乱可以隐藏在父 pom.xml 中，

请参阅 http://maven.apache .org/pom.html#资源

Answer 2

我认为桌面应用程序没有官方布局，但这是我们使用的布局。

• src/main/config - 配置文件，复制并过滤到 ${project.build.directory}/config。
• src/main/scripts - 复制并过滤到 ${project.build.directory} 的 sh、bat、README 和其他纯文本文件。
• src/main/bin - 未过滤并复制到 ${project.build.directory} 的二进制文件。
• src/main/build - 构建过程使用但不包含在应用程序中的任何其他脚本、ant 文件或资源。
• src/main/ assembly - 用于创建应用程序程序集的程序集描述符。
• 使用 maven-dependency 插件将依赖项复制到 ${project.build.directory}/lib 。
• 如果您使用共享程序集描述符 jar（其中包括 config 和 lib 目录以及与所有项目共享的标准文件类型），则会获得加分。 一组好的默认文件类型包括具有可执行权限的 .sh、.bat 和 .exe； 具有标准权限的 .jar、.zip、.txt、.pdf、.xml、.properties、.conf、.ico、.png、.jpg。
• 使用 maven-jar 插件将 config 目录和 lib/ 前缀添加到类路径中以制作可运行的 jar。
• 添加一个安装程序配置文件，使用 maven- assembly 插件和程序集描述符构建应用程序的程序集。 如果需要，该程序集可以由单独的安装程序项目使用。
• 避免在 src/ 级别放置任何其他内容。 相反，如果确实需要，请将文档放入 src/site/ 目录（例如 src/site/sphinx）或 src/doc 中。
• 将以上所有配置放入父/公司 pom 中，以便与您的所有项目共享。 只需引用项目中的 maven-dependency、maven-resources、maven-jar 和 maven-assemble 插件即可构建整个应用程序，几乎无需任何配置（不要忘记为 maven-jar 插件设置主类） 。