| | | |
Jdbi 库提供了对 Java 和其他 JVM 技术(例如 Kotlin、Clojure 或 Scala)中的关系数据库的便捷、惯用的访问。
Jdbi 构建在 JDBC 之上。如果您的数据库有 JDBC 驱动程序,则可以将 Jdbi 与它一起使用。
另请查看示例模块中的代码示例。
Jdbi 需要 Java 11 或更高版本才能运行。
我们针对 Java 11、17 和 21 运行 CI 测试。
3.40.0之前的任何 Jdbi 版本都支持 Java 8、9 和 10。
Jdbi 需要 JDK 版本 17 或更高版本才能构建。我们对版本强制执行最新的 LTS(当前为 Java 21)。
Jdbi“包含电池”并使用 Apache Maven Wrapper。如果使用外部 Maven 安装,则需要 Apache Maven 3.9 或更高版本。使用make
目标需要 GNU make。
所有构建任务都组织为make
目标。
构建代码并将其安装到本地存储库中:
$ make install
运行make
或make help
会显示所有可用的构建目标以及简短的说明。有些目标需要项目成员权限。 CONTRIBUTING.md 文档包含所有支持的目标的列表。
要将命令行参数添加到 Makefile 中的 Maven 执行,请设置MAVEN_ARGS
变量:
% MAVEN_ARGS= " -B -fae " make install
运行make tests
会运行所有单元和集成测试。
一些测试使用 Postgres 和 H2 数据库(测试将根据需要启动临时数据库服务器)。大多数现代操作系统(Windows、MacOS、Linux)和主机架构(x86_64、aarch64)应该可以工作。
对于完整的版本构建,docker 或 docker 兼容环境必须可用。少数测试使用 testcontainers,而这又需要 docker。
make install-nodocker
在本地构建和安装 Jdbi 时会跳过测试。 make tests-nodocker
仅在运行测试时跳过测试。
支持的配置有
其他 docker 安装(例如 Colima)可能可以工作,但未经测试且不受支持。
对于 Linux 上的 podman,必须激活 podman 套接字(有关详细信息,请参阅 https://stackoverflow.com/questions/71549856/testcontainers-with-podman-in-java-tests)。如果 SELinux 处于活动状态,SELinux 有时会干扰测试容器;确保配置了例外。
对于 MacOS 上的 podman,需要正确设置DOCKER_HOST
环境变量。
请阅读 CONTRIBUTING.md 了解设置开发环境以构建 Jdbi 的说明。
Jdbi 使用 SemVer 来版本化其公共 API。
该项目根据 Apache 2.0 许可证获得许可。
Jdbi
函数扩展。 @BindFields
、 @BindMethods
注解。