pom.xml中pom全称_摆脱pom XML…几乎

pom.xml中pom全称

介绍

POM文件是XML格式的文件，声明性地描述了要使用Maven构建的Java项目的构建结构。 维护大型Java项目的POM XML文件通常很麻烦。 XML是冗长的，POM的结构也需要维护冗余信息。 多次对工件进行命名是多余的，在groupId和artifactId重复名称的某些部分。 如果是多模块项目，则项目的版本应出现在许多文件中。 使用父pom中定义的属性可以减少某些重复，但是您仍然必须在每个模块pom中定义父pom版本，因为您通过工件坐标引用了POM，而不仅仅是将其称为“ pom”。在父目录中”。 依赖项和插件的参数可以在pluginManagement和dependency管理的父POM中pluginManagement ，但是尽管每个模块POM通常都是相同的，但您仍然无法摆脱每个模块POM中的插件和依赖项列表。

您可能会与我争论，因为这也是您的口味问题，但是对我来说，XML格式的POM文件太多余了，很难阅读。 也许我不够细致，但是很多时候我错过了POM文件中的一些错误，并且很难修复它们。

有一些技术可以支持其他格式，但是并未广泛使用。 一种摆脱XML的方法是Poyglot Maven 。 但是，如果您在第一个示例（Ruby格式的POM）上查看Github页面，您仍然可以看到很多重复的信息。 这是因为Polyglot Maven插入了Maven本身，并且仅将XML格式替换为其他格式，但是无助于POM结构本身的冗余。

在本文中，我将描述一种比其他解决方案更好的方法，POM文件在构建过程中仍然是XML，因此不需要任何新的插件或更改构建过程，而是使用这些pom.xml文件是使用Jamal宏语言从pom.xml.jam文件以及模块共享的一些其他宏文件生成的。

贾马尔

想法是使用基于文本的宏语言从某些源文件生成XML文件，该源文件包含相同的信息（一种简化格式）。 这是某种编程。 宏描述是一个输出详细XML格式的程序。 当宏语言足够强大时，源代码就可以具有足够的描述性，而又不会太冗长。 我的选择是贾马尔。 老实说，选择Jamal的原因之一是它是我大约20年前使用Perl开发的宏语言，而半年前我在Java中重新实现了它。

语言本身非常简单。 文本和宏混合在一起，输出是文本和宏的结果。 宏以{字符或配置的任何其他字符串开头，并以相应的}字符或配置为结束字符串的字符串结尾。 宏可以嵌套，并且可以很好地控制应评估嵌套宏的顺序。 有用户定义的内置宏。 define宏是内置宏之一，用于定义用户定义的宏。

一个例子说得更好。 让我们看一下下面的test.txt.jam文件。

 {@define GAV(_groupId,_artifactId,_version)= 
     { #if |_groupId|<groupId>_groupId</groupId>} 
     { #if |_artifactId|<artifactId>_artifactId</artifactId>} 
     { #if |_version|<version>_version</version>}  }  {GAV :com.javax0.geci:javageci-parent:1.1.2-SNAPSHOT} 

用Jamal处理它，我们将得到

 <groupId>com.javax0.geci< /groupId > 
     <artifactId>javageci-parent< /artifactId > 
     <version>1.1.2-SNAPSHOT< /version > 

尽管出于排版原因，我还是手动删除了空行，但是您有一个大致的了解。 GAV是使用内置宏define 。 它具有三个名为_groupId ， _artifactId和_version 。 使用宏时，宏主体中的格式参数名称将替换为实际值，并在文本中替换用户定义的宏。 define内置宏本身的文本是一个空字符串。 何时在内置宏前面使用@以及何时使用#有特殊含义，但是在本文中，我无法深入探讨这一细节。

if宏还可以省略groupId ， artifactId或version ，因此

 {GAV :com.javax0.geci:javageci-parent:} 

也可以并且会产生

 <groupId>com.javax0.geci< /groupId > 
     <artifactId>javageci-parent< /artifactId > 

如果您觉得宏的定义中仍然有很多冗余之处，那您是对的。 这是定义GAV的简单方法，但是您可以走极端：

 { #define GAV(_groupId,_artifactId,_version)= 
     {@ for z in (groupId,artifactId,version)= 
         { #if |_z|<z>_z</z>} 
     }  }{GAV :com.javax0.geci:javageci-parent:} 

请注意，这需要对宏观评估顺序有一个疯狂的了解，但是作为示例，它表明了这种力量。 关于Jamal的更多信息https://github.com/verhas/jamal

让我们回到原始主题：Jamal如何用于维护POM文件。

烹饪pom果酱

可以有很多方法，每种方法都可能很好。 在这里，我描述了用于Java :: Geci项目的第一种方法。 我创建一个pom.jim文件（ jim代表Jamal导入或包含的文件）。 其中包含宏的定义，例如GAV ， dependencies ， dependency和许多其他定义。 您可以从Java :: Geci源代码存储库下载该文件： https : pom.jim文件对于所有项目都可以相同，其中没有任何特定的项目。 还有一个version.jim文件，其中包含一个宏，该宏在一个地方定义了项目版本，我在项目中使用的Java版本以及项目的groupId。 当我将发行版号从-SNAPSHOT到下一个发行版或从发行版扩展到下一个-SNAPSHOT这是唯一需要更改它的地方，并且该宏可用于引用顶级POM中的项目版本？ 而且在模块POM中引用父对象。

在每个目录中都应该有一个pom.xml文件的地方，我创建了一个pom.xml.jam文件。 该文件导入pom.jim文件，因此可以在其中使用定义的宏。 作为示例，Java :: Geci javageci-engine模块pom.xml.jam文件如下：

 {@ import .. /pom .jim}  {project |jar| 
     {GAV ::javageci-engine:{VERSION}} 
     {parent :javageci-parent} 
     {name|javageci engine} 
     {description|Javageci macro library execution engine} 
     {@include .. /plugins .jim} 
     {dependencies # 
         {@ for MODULE in (api,tools,core)= 
             {dependency :com.javax0.geci:javageci-MODULE:}} 
         {@ for MODULE in (api,engine)= 
             {dependency :org.junit.jupiter:junit-jupiter-MODULE:}} 
     }  } 

我认为这是相当可读的，至少对我而言，它比原始的pom.xml更可读：

<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
         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>
    <packaging>jar</packaging>
    <artifactId>javageci-engine</artifactId>
    <version>1.1.1-SNAPSHOT</version>
    <parent>
        <groupId>com.javax0.geci</groupId>
        <artifactId>javageci-parent</artifactId>
        <version>1.1.1-SNAPSHOT</version>
    </parent>
    <name>javageci engine</name>
    <description>Javageci macro library execution engine</description>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-source-plugin</artifactId>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-javadoc-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
    <dependencies>
        <dependency>
            <groupId>com.javax0.geci</groupId>
            <artifactId>javageci-api</artifactId>
        </dependency>
        <dependency>
            <groupId>com.javax0.geci</groupId>
            <artifactId>javageci-tools</artifactId>
        </dependency>
        <dependency>
            <groupId>com.javax0.geci</groupId>
            <artifactId>javageci-core</artifactId>
        </dependency>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-api</artifactId>
        </dependency>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-engine</artifactId>
        </dependency>
    </dependencies>
</project>

要启动Jamal，我可以使用Jamal Maven插件。 为此，最简单的方法是在根目录中包含genpom.xml POM文件，其内容为：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.javax0.jamal</groupId>
    <artifactId>pom.xml_files</artifactId>
    <version>out_of_pom.xml.jam_files</version>
    <build>
        <plugins>
            <plugin>
                <groupId>com.javax0.jamal</groupId>
                <artifactId>jamal-maven-plugin</artifactId>
                <version>1.0.2</version>
                <executions>
                    <execution>
                        <id>execution</id>
                        <phase>clean</phase>
                        <goals>
                            <goal>jamal</goal>
                        </goals>
                        <configuration>
                            <transformFrom>\.jam$</transformFrom>
                            <transformTo></transformTo>
                            <filePattern>.*pom\.xml\.jam$</filePattern>
                            <exclude>target|\.iml$|\.java$|\.xml$</exclude>
                            <sourceDirectory>.</sourceDirectory>
                            <targetDirectory>.</targetDirectory>
                            <macroOpen>{</macroOpen>
                            <macroClose>}</macroClose>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

有了这个，我可以使用命令行mvn -f genpom.xml clear启动Maven。 这不仅会创建所有POM文件，而且会清除项目的先前编译结果，这在更改POM文件时可能是个好主意。 当目录中还没有pom.xml时，或者由于果酱煮熟的POM文件中可能存在某些错误而导致文件无效时，也可以执行该命令。 不幸的是，所有递归都必须在某处结束，尽管将genpom.xml为果酱熟的POM文件是可行的，但这是不可行的。

摘要

我所描述的是一种使用宏语言作为源而不是原始编辑pom.xml文件的方法。 优点是项目定义更短，更简单。 缺点是需要额外的POM生成步骤，这是手动操作，而不是构建过程的一部分。 您还会失去直接使用Maven版本插件的可能性，因为该插件会修改POM文件。 我本人在使用该插件时总是遇到问题，但这可能是我的错误，而不是该插件的错误。 另外，您必须学习一些Jamal，但是如果您碰巧喜欢它，那么这也可能是一个优势。 简而言之：如果您愿意，可以尝试一下。 启动该工具很容易，因为该工具（Jamal）已发布在中央存储库中，其源代码和文档位于Github上，因此，您所需genpom.xml只是制作genpom.xml文件，煮一些果酱并启动插件。

POM文件不是唯一可以与果酱一起使用的源文件。 我可以轻松想象在产品文档中使用Jamal宏。 您所需.md.jam就是创建一个documentationfile.md.jam文件作为源文件，并修改主POM以在将.md.jam转换为生成的宏处理的降价文档的生成过程中运行Jamal。 您也可以像本文中一样设置一个单独的POM，以防您严格执行转换。 如果您想为Java文件准备一个预处理器，甚至可以拥有java.jam文件，但是我求您不要这样做。 我不想因为给你贾马尔而在地狱里燃烧着永恒的火焰。 不是为了这个目的。

Jamal还有其他许多可能的用途。 它是一种功能强大的宏语言，易于嵌入到应用程序中，并且易于使用Java编写的宏进行扩展。 Java :: Geci还具有一个1.0版本的模块，该模块支持Jamal来简化代码生成，但仍然缺少一些内置宏，这些宏计划使通过反射到达Java代码结构成为可能。 我也在考虑开发一些简单的宏来读取Java源文件并将其包含在文档中。 当我在其中取得一些结果时，我会写。

如果您有任何想法可以使用该技术，请随时与我联系。

翻译自: https://www.javacodegeeks.com/2019/03/get-rid-pom-xml-almost.html

pom.xml中pom全称