如何基于自定义FIX字典构建QuickFixJ Jar包？

一、正确的Maven执行命令 #

直接执行以下命令即可触发代码生成：

mvn quickfixj-codegenerator:generate

如果插件配置已绑定到generate-sources阶段（推荐做法），执行常规编译命令也会自动触发代码生成：

mvn clean compile

二、确保生效的pom.xml插件配置 #

以下是标准配置模板，必须包含关键项，否则会出现配置不生效或NPE问题：

<build>
    <plugins>
        <plugin>
            <groupId>org.quickfixj</groupId>
            <artifactId>quickfixj-codegenerator</artifactId>
            <!-- 选择兼容JDK8的版本，比如2.3.0 -->
            <version>2.3.0</version>
            <executions>
                <execution>
                    <id>generate-fix-code</id>
                    <phase>generate-sources</phase>
                    <goals>
                        <goal>generate</goal>
                    </goals>
                    <configuration>
                        <!-- 自定义FIX44.xml的路径，根据实际位置调整 -->
                        <fixSpec>${project.basedir}/src/main/resources/FIX44.xml</fixSpec>
                        <!-- 生成代码的输出目录 -->
                        <outputDirectory>${project.build.directory}/generated-sources/quickfixj</outputDirectory>
                        <!-- 生成代码的包名 -->
                        <packageName>com.yourcompany.fix.custom</packageName>
                        <!-- 可选：是否生成消息工厂等额外类 -->
                        <generateMessageFactory>true</generateMessageFactory>
                        <generateSessionFactory>true</generateSessionFactory>
                    </configuration>
                </execution>
            </executions>
            <!-- 依赖的quickfixj-core版本要和插件版本一致 -->
            <dependencies>
                <dependency>
                    <groupId>org.quickfixj</groupId>
                    <artifactId>quickfixj-core</artifactId>
                    <version>2.3.0</version>
                </dependency>
            </dependencies>
        </plugin>
        <!-- 让Maven识别生成的源码目录 -->
        <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>build-helper-maven-plugin</artifactId>
            <version>3.3.0</version>
            <executions>
                <execution>
                    <id>add-source</id>
                    <phase>generate-sources</phase>
                    <goals>
                        <goal>add-source</goal>
                    </goals>
                    <configuration>
                        <sources>
                            <source>${project.build.directory}/generated-sources/quickfixj</source>
                        </sources>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

注意事项：

• 必须绑定到generate-sources阶段，否则代码生成不会在编译前执行
• fixSpec路径必须准确，文件必须存在，可先用绝对路径测试
• 插件版本和quickfixj-core版本必须一致，避免版本冲突

三、NullPointerException问题排查 #

出现NPE通常是以下原因：

• 自定义FIX44.xml格式非法：检查XML是否有缺失的闭合标签（比如<messages>、<fields>未闭合），字段定义是否有空属性值，或者缺少必要元素（比如<field>的number、name属性）
• 文件路径错误：fixSpec配置的路径不存在，或者Maven没有权限读取该文件，可在命令中加-X参数查看调试日志，确认插件是否找到指定的XML文件
• 版本兼容性问题：如果使用过高版本的插件（比如3.x），可能不兼容JDK8，建议降级到2.3.0这类支持JDK8的版本

四、验证配置是否生效的方法 #

1. 执行命令时添加调试参数，查看插件执行日志：

mvn quickfixj-codegenerator:generate -X

在日志中搜索fixSpec、outputDirectory等关键词，确认插件是否加载了正确的XML文件，以及是否有报错信息
2. 查看target/generated-sources/quickfixj目录，如果生成了对应包名的Java类，说明配置生效；如果目录为空，检查路径和阶段绑定是否正确

内容的提问来源于stack exchange，提问作者Yoshiro