| | | |
Jdbi 라이브러리는 Java 및 Kotlin, Clojure 또는 Scala와 같은 기타 JVM 기술의 관계형 데이터베이스에 대한 편리하고 관용적인 액세스를 제공합니다.
Jdbi는 JDBC 위에 구축되었습니다. 데이터베이스에 JDBC 드라이버가 있는 경우 Jdbi를 함께 사용할 수 있습니다.
또한 예제 모듈에서 코드 예제를 확인하세요.
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 호환 환경을 사용할 수 있어야 합니다. 소수의 테스트에서는 docker가 필요한 testcontainers를 사용합니다.
make install-nodocker
Jdbi를 로컬로 빌드하고 설치할 때 테스트를 건너뜁니다. make tests-nodocker
테스트만 실행할 때만 테스트를 건너뜁니다.
지원되는 구성은 다음과 같습니다.
Colima와 같은 다른 도커 설치는 작동할 수 있지만 테스트되지 않았으며 지원되지 않습니다.
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
주석.