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 controlador de Java Reactive Streams a qué implementación de MongoDB conectarse.
Una instancia de MongoClient, que crea conexiones a la implementación de MongoDB y le permite realizar operaciones en ella.
También puede utilizar cualquiera de estos componentes para personalizar la forma en que se comporta el controlador Java Reactive Streams mientras está conectado a MongoDB.
Esta guía le muestra cómo crear una cadena de conexión y utilizar una MongoClient instancia para conectarse a 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. |
| |
| Obligatorio. El host y el número de puerto donde se ejecuta MongoDB. Si no incluye un número de puerto, el controlador usa el puerto predeterminado, |
| 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, consulte Cadenas de conexión en la documentación del servidor MongoDB.
MongoClient
Para crear una conexión a MongoDB, pase una URI de conexión como cadena al método que construye un objeto MongoClient. En el siguiente ejemplo, el controlador utiliza una URI de conexión de ejemplo 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: