如何通过Maven配置引入JOOQ Express依赖

你完全不需要将JOOQ Express相关的jar包提交到Git源码仓库。付费版本的jOOQ为购买用户提供了专属私有Maven仓库，直接通过配置仓库拉取依赖即可。将二进制jar文件提交到Git是非常不推荐的做法，会无意义膨胀仓库体积，也提升后续依赖升级的维护成本。

1. 本地项目Maven配置 #

首先在项目根目录的pom.xml中添加jOOQ私有仓库配置：

<repositories>
  <repository>
    <id>jooq-private</id>
    <url>替换为你购买后在许可证详情页获取的私有Maven仓库地址</url>
  </repository>
</repositories>

再添加对应JOOQ Express的依赖，将版本号替换为你购买的实际版本即可，可按需引入codegen、meta等扩展模块：

<dependencies>
  <dependency>
    <groupId>org.jooq.pro</groupId>
    <artifactId>jooq</artifactId>
    <version>你的JOOQ Express实际版本号</version>
  </dependency>
</dependencies>

注意不要将仓库访问的账号密码明文写在pom.xml中，将访问凭证配置到本地用户目录下的~/.m2/settings.xml的servers节点下，其中id字段的值需要和pom.xml中仓库配置的id完全一致，Maven会自动匹配对应凭证：

<servers>
  <server>
    <id>jooq-private</id>
    <username>许可证绑定的访问用户名</username>
    <password>许可证对应的访问密钥</password>
  </server>
</servers>

2. GitHub Actions 自动化构建配置 #

GitHub Actions的构建环境默认没有你本地的Maven凭证配置，你不需要将本地的settings.xml提交到源码仓库，只需要先在GitHub项目的Secrets配置项中，提前存入JOOQ私有仓库的访问用户名和密码，再在CI工作流配置中动态生成Maven配置文件即可，配置片段参考：

- name: 配置Maven私有仓库凭证
  run: |
    cat > ~/.m2/settings.xml << EOF
    <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 https://maven.apache.org/xsd/settings-1.0.0.xsd">
      <servers>
        <server>
          <id>jooq-private</id>
          <username>${{ secrets.JOOQ_REPO_USER }}</username>
          <password>${{ secrets.JOOQ_REPO_PASSWORD }}</password>
        </server>
      </servers>
    </settings>
    EOF

配置完成后，GitHub Actions执行构建时会自动从jOOQ私有仓库拉取对应依赖，和拉取公共Maven仓库依赖的逻辑完全一致，不需要额外调整构建流程。

• 二进制文件不适合Git做版本管理，jar包的变更会导致Git仓库体积快速增长，大幅降低后续代码克隆、拉取的操作效率
• 后续升级JOOQ版本时需要手动替换所有相关jar包，操作繁琐，还容易出现本地、CI环境依赖版本不一致的问题
• 手动管理jar包时很容易混入冲突版本、损坏的依赖包，提升构建排错的成本

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