MongoClient 만들기
이 페이지의 내용
개요
MongoDB deployment에 연결하려면 다음 두 가지가 필요합니다.
연결할 배포서버 를 Sync 운전자 에 알려주는 연결 이라고도 하는 연결 string URI Kotlin MongoDB 입니다.
MongoDB deployment 에 대한 연결을 생성하고 작업을 수행하는 MongoClient 객체 입니다.
MongoClientSettings 를 사용하여 MongoDB 에 연결된 동안 코틀린 동기 (Kotlin Sync) 운전자 가 작동하는 방식을 사용자 지정할 수도 있습니다.
이 가이드에서는 연결 string 을 만들고 MongoClient 객체를 사용하여 MongoDB 에 연결하는 방법을 보여 줍니다.
연결 URI
표준 연결 string 에는 다음 구성 요소가 포함됩니다.
구성 요소 | 설명 |
|---|---|
mongodb:// | 필수 사항입니다. 표준 연결 형식의 문자열로 식별하는 접두사입니다. |
username:password | 선택 사항. 인증 자격 증명. 이를 포함하면 클라이언트 는 authSource 에 지정된 데이터베이스 에 대해 사용자를 인증합니다. |
host[:port] | 필수입니다. MongoDB가 실행 중인 호스트 및 선택적 포트 번호입니다. 포트 번호를 포함하지 않으면 드라이버는 기본 포트인 27017 을 사용합니다. |
/defaultauthdb | 선택 사항. 연결 string 에 username:password@ 인증 자격 증명이 포함되어 있지만 authSource 옵션이 없는 경우에 사용할 인증 데이터베이스입니다. 이 구성 요소를 포함하지 않으면 클라이언트는 admin 데이터베이스에 대해 사용자를 인증합니다. |
?<options> | 선택 사항. 연결별 옵션을 <name>=<value> 쌍으로 지정하는 쿼리 string 입니다. 이러한 옵션에 대한 전체 설명은 연결 옵션 지정 을 참조하세요. |
연결 생성에 대한 자세한 string 내용은 MongoDB Server 설명서에서 연결 문자열 을 참조하세요.
Atlas 연결 예시
Atlas 에서 MongoDB deployment 에 연결하려면 먼저 클라이언트 를 만들어야 합니다.
인스턴스 에 연결하기 위해 메서드에 연결 URI를 string 로 MongoClient.create() 전달할 수 MongoDB 있습니다.
// Replace the placeholder with your Atlas connection string val uri = "<connection string>" // Create a new client and connect to the server val mongoClient = MongoClient.create(uri) val database = mongoClient.getDatabase("sample_mflix")
MongoClientSettings 객체 를 MongoClient.create() 메서드에 전달하여 원하는 구성으로 클라이언트 를 만들 수도 있습니다.
MongoClientSettings 객체 를 인스턴스화하려면 빌더 메서드를 사용하여 연결 string 을 지정하고, applyConnectionString() 메서드를 사용하고, 기타 클라이언트 옵션을 사용합니다. 원하는 구성을 얻었으면 build() 메서드를 호출합니다.
새 서버 버전으로 업그레이드할 때 호환성이 손상되는 변경을 피하려면 Stable API 버전 클라이언트 옵션을 설정할 수 있습니다. Stable API 기능에 대해 자세히 알아보려면 Stable API 페이지를 참조하세요.
다음 코드는 Atlas의 MongoDB deployment에 연결할 때 연결 문자열과 Stable API 클라이언트 옵션을 지정하고 연결이 성공했는지 확인하는 방법을 보여줍니다.
// start-connect-to-atlas-w-uri // Replace the placeholder with your Atlas connection string val uri = "<connection string>" val mongoClient1 = MongoClient.create(uri) // end-connect-to-atlas-w-uri // Construct a ServerApi instance using the ServerApi.builder() method val serverApi = ServerApi.builder() .version(ServerApiVersion.V1) .build() val settings = MongoClientSettings.builder() .applyConnectionString(ConnectionString(uri)) .serverApi(serverApi) .build() // Create a new client and connect to the server val mongoClient = MongoClient.create(settings) val database = mongoClient.getDatabase("sample_mflix") try { // Send a ping to confirm a successful connection val command = Document("ping", BsonInt64(1)) val commandResult = database.runCommand(command) println("Pinged your deployment. You successfully connected to MongoDB!") } catch (me: MongoException) { System.err.println(me) }
API 문서
코틀린 동기 (Kotlin Sync) 운전자 를 사용하여 MongoClient 객체 를 만드는 방법에 대한 자세한 내용은 다음 API 문서를 참조하세요.