Overview
Para conectarte a una implementación de MongoDB, necesitas dos cosas:
Una URI de conexión, también conocida como cadena de conexión, que le indica al driver de Java Reactive Streams a qué implementación de MongoDB conectarse.
Una instancia MongoClient, que crea conexiones a la implementación de MongoDB y permite realizar operaciones sobre ella.
También puede usar cualquiera de estos componentes para personalizar el comportamiento del driver Java Reactive Streams mientras se conecta a MongoDB.
Esta guía muestra cómo crear una cadena de conexión y utilizar un MongoClient instancia para conectar con MongoDB.
URI de conexión
Una cadena de conexión estándar incluye los siguientes componentes:
Componente | Descripción |
|---|---|
| Obligatorio. Un prefijo que identifica el URI como una cadena en el formato de conexión estándar. |
| |
| Requerido. El host y el número de puerto donde se está ejecutando MongoDB. Si no incluye un número de puerto, el driver usa el puerto por defecto, |
| Opcional. La base de datos de autenticación que se debe usar si la cadena de conexión incluye las credenciales de autenticación |
| Opcional. Un string de la query que especifica opciones específicas de conexión como pares Para obtener una descripción completa de estas opciones, consulte la guía Especificar opciones de URI de conexión. |
Para obtener más información sobre cómo crear una cadena de conexión, consulta Cadenas de conexión en la documentación del servidor MongoDB.
MongoClient
Para crear una conexión a MongoDB, proporciona un URI de conexión como una cadena al método que construye un objeto MongoClient. En el siguiente ejemplo, el driver utiliza un URI de conexión de muestra para conectarse a una instancia de MongoDB en el puerto 27017 de localhost:
import com.mongodb.reactivestreams.client.MongoClients; import com.mongodb.reactivestreams.client.MongoClient; public class MongoConnection { public static void main(String[] args) { String uri = "mongodb://localhost:27017/"; try (MongoClient client = MongoClients.create(uri)) { // use `client` here } } }
Tip
Reutilizando su cliente
Debido a que cada instancia MongoClient agrupa conexiones a la base de datos, la mayoría de las aplicaciones requieren solo una única instancia de MongoClient, incluso en múltiples solicitudes.
Documentación de la API
Para obtener más información sobre cómo crear una instancia de MongoClient en el driver Java Reactive Streams, consulta la siguiente documentación de la API: