mongo java driver
va Driver 4.11.5 (November 06, 2024)
릴리스 노트는 여기에서 확인할 수 있습니다.
Java 드라이버에 대한 참조 및 API 문서는 여기에서 확인할 수 있습니다.
Kotlin 드라이버에 대한 참조 및 API 문서는 여기에서 확인할 수 있습니다.
Scala 드라이버에 대한 참조 및 API 문서는 여기에서 확인할 수 있습니다.
MongoDB JVM 드라이버 사용 방법에 대한 튜토리얼은 MongoDB University를 참조하세요. Java 드라이버와 Kotlin 드라이버를 모두 사용하는 추가 튜토리얼, 비디오 및 코드 예제도 MongoDB 개발자 센터에서 찾을 수 있습니다.
MongoDB Java, Kotlin 및 Scala 드라이버에 대한 문제, 질문 또는 피드백이 있는 경우 지원 채널을 살펴보시기 바랍니다. 문제나 질문이 있는 경우 드라이버 개발자에게 직접 이메일을 보내지 마세요. MongoDB 커뮤니티 포럼이나 StackOverflow에서 답변을 얻을 가능성이 더 높습니다.
최소한 설명에 사용 중인 드라이버의 정확한 버전을 포함하십시오. 연결 문제가 있는 경우 생성자에 전달하는 모든 매개 변수의 값과 함께 MongoClient 인스턴스를 생성하는 코드 줄에 붙여넣는 것도 유용한 경우가 많습니다. 또한 연결 관련 예외가 있는지 애플리케이션 로그를 확인하고 해당 예외도 게시해야 합니다.
Java, Kotlin 또는 Scala 드라이버에서 버그를 발견했다고 생각하시나요? 드라이버의 새로운 기능을 보고 싶으십니까? 문제 관리 도구인 JIRA에서 사례를 개설하세요.
드라이버 및 Core Server(예: SERVER) 프로젝트에 대한 JIRA의 버그 보고서는 공개 됩니다.
드라이버나 기타 MongoDB 프로젝트에서 보안 취약점을 발견한 경우 여기 지침에 따라 보고해 주세요.
공개 API에 주요 변경 사항이 적용되면 주요 증분(예: 4.x -> 5.x)이 발생합니다. 주요 릴리스에서 제거된 모든 메서드와 클래스는 이전 주요 릴리스 분기의 이전 릴리스에서 더 이상 사용되지 않거나 릴리스 노트에서 언급되었습니다.
사소한 5.x 증분(예: 5.1, 5.2 등)은 사소한 새 기능이 추가되거나 중요한 개선 사항 또는 버그 수정이 발생하여 일부 극단적인 경우에 영향을 미칠 수 있는 동작 변경(예: 다음으로 인해 발생하는 동작에 대한 의존성)이 발생할 수 있습니다. 버그). 개선 사항의 예로는 MongoDB 서버에 추가된 새로운 기능을 지원하기 위해 추가된 메서드나 클래스가 있습니다. 부 릴리스는 아래에 명시된 경우를 제외하고 거의 항상 동일한 주요 릴리스 분기의 이전 부 릴리스와 바이너리 호환됩니다.
패치 5.xy 증분(예: 5.0.0 -> 5.0.1, 5.1.1 -> 5.1.2 등)은 버그 수정에만 발생하며 항상 동일한 부 릴리스 분기의 이전 패치 릴리스와 바이너리 호환됩니다. .
@Alpha 주석이 표시된 API는 개발 초기 단계에 있으므로 향후 릴리스에서 호환되지 않는 변경 또는 제거될 수 있으며 의도한 일부 기능이 부족할 수 있습니다. @Alpha 주석이 포함된 API에는 기능, 성능 및 안정성에 영향을 미치는 알려진 문제가 포함될 수 있습니다. 또한 포함된 라이브러리의 호환성 보장도 면제됩니다.
응용 프로그램이 프로덕션 환경에서 Alpha API를 사용하거나 라이브러리 (라이브러리 개발자의 제어 외부에서 사용자의 CLASSPATH에 포함됨)가 이러한 API에 의존하는 것은 권장되지 않습니다. 알파 API는 실험 목적 으로만 사용됩니다.
클래스 또는 메소드 수준에서 @Beta 주석이 표시된 API는 변경될 수 있습니다. 언제든지 어떤 방식으로든 수정하거나 제거할 수도 있습니다. 귀하의 코드가 라이브러리 자체인 경우(즉, 귀하가 제어할 수 없는 사용자의 CLASSPATH에서 사용되는 경우), 다시 패키지하지 않는 한(예: 음영 처리 등을 사용하여) 베타 API를 사용해서는 안 됩니다.
클래스 또는 메소드 수준에서 @Deprecated 주석이 표시된 API는 다음 주요 릴리스까지 계속 지원되지만 사용을 중지하는 것이 좋습니다.
com.mongodb.internal.* 패키지 내부의 모든 코드는 비공개 API로 간주되므로 전혀 의존해서는 안 됩니다. 언제든지 변경될 수 있습니다.
Maven, Gradle, Ivy 및 기타 항목에 대한 바이너리 및 종속성 정보는 http://search.maven.org에서 찾을 수 있습니다.
Maven의 예:
< dependency >
< groupId >org.mongodb</ groupId >
< artifactId >mongodb-driver-sync</ artifactId >
< version >x.y.z</ version >
</ dependency >스냅샷 빌드도 Sonatype을 통해 정기적으로 게시됩니다.
Maven의 예:
< repositories >
< repository >
< id >sonatype-snapshot</ id >
< url >https://oss.sonatype.org/content/repositories/snapshots/</ url >
</ repository >
</ repositories >소스를 빌드하고 컴파일하려면 Java 17+ 및 git이 필요합니다. 드라이버를 빌드하고 테스트하려면:
$ git clone https://github.com/mongodb/mongo-java-driver.git
$ cd mongo-java-driver
$ ./gradlew check
테스트 스위트에서는 mongod가 --setParameter enableTestCommands=1 명령줄 매개변수로 설정될 수 있는 enableTestCommands 사용하여 실행되어야 합니다.
$ mkdir -p data/db
$ mongod --dbpath ./data/db --logpath ./data/mongod.log --port 27017 --logappend --fork --setParameter enableTestCommands=1
테스트를 실행할 때 "Too many open files" 오류가 발생하면 https://www.mongodb.com/docs/manual/reference/ulimit에 설명된 대로 mongod를 시작하기 전에 사용 가능한 파일 설명자 수를 늘려야 합니다. /
IntelliJ에서 코드를 실행하려면 몇 가지 수동 구성 단계가 필요합니다.
소스를 빌드하고 컴파일하려면 Java 17 이상이 필요합니다.
오류: java: cannot find symbol: class SNIHostName location: package javax.net.ssl
수정: 설정/기본 설정 > 빌드, 실행, 배포 > 컴파일러 > Java 컴파일러 - "크로스 컴파일에 '--release' 옵션 사용(Java 9 이상)" 선택을 취소합니다.
오류: java: package com.mongodb.internal.build does not exist
수정 사항: 다음 중 하나:
generateBuildConfig 작업을 실행합니다. 예: ./gradlew generateBuildConfig 또는 Gradle > 드라이버 코어 > 작업 > buildconfig > generateBuildConfig를 통해generateBuildConfig 설정합니다. Gradle > 작업 > buildconfig를 통해 > generateBuildConfig를 마우스 오른쪽 버튼으로 클릭하고 "빌드 전 실행"을 클릭합니다.
