| | | |
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
註解。