| | | |
Jdbi ライブラリは、Java およびその他の JVM テクノロジ (Kotlin、Clojure、Scala など) のリレーショナル データベースへの便利で慣用的なアクセスを提供します。
Jdbi は JDBC 上に構築されています。データベースに JDBC ドライバーがある場合は、Jdbi を使用できます。
Examples モジュールのコード例も確認してください。
Jdbi を実行するには Java 11 以降が必要です。
Java 11、17、および 21 に対して CI テストを実行します。
Java 8、9、および 10 は、 3.40.0より前の Jdbi バージョンでサポートされています。
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 データベースを使用します (テストは必要に応じて一時データベース サーバーを起動します)。最新の OS (Windows、MacOS、Linux) およびホスト アーキテクチャ (x86_64、aarch64) のほとんどが動作するはずです。
完全なリリースのビルドには、docker または docker と互換性のある環境が利用可能である必要があります。少数のテストでは testcontainer が使用されますが、これには docker が必要です。
make install-nodocker
Jdbi をローカルにビルドしてインストールするときにテストをスキップします。 make tests-nodocker
テストのみを実行する場合にテストをスキップします。
サポートされている構成は次のとおりです。
Colima などの他の Docker インストールは動作する可能性がありますが、テストもサポートもされていません。
Linux 上の podman の場合、podman ソケットをアクティブにする必要があります (詳細については、https://stackoverflow.com/questions/71549856/testcontainers-with-podman-in-java-tests を参照)。 SELinux がアクティブな場合、SELinux はテストコンテナに干渉することがあります。例外が設定されていることを確認してください。
MacOS 上の podman の場合、 DOCKER_HOST
環境変数を正しく設定する必要があります。
Jdbi を構築するための開発環境をセットアップする手順については、CONTRIBUTING.md をお読みください。
Jdbi は SemVer を使用してパブリック API のバージョンを管理します。
このプロジェクトは、Apache 2.0 ライセンスに基づいてライセンスされています。
Jdbi
関数の拡張機能がチェックされていません。 @BindFields
、 @BindMethods
アノテーション。