Docs Menu
Docs Home
/ /
/ / /

Crea un MongoClient

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.

Una cadena de conexión estándar incluye los siguientes componentes:

Componente
Descripción

mongodb://

Obligatorio. Un prefijo que identifica el URI como una cadena en el formato de conexión estándar.

username:password

Opcional. Credenciales de autenticación. Si se incluyen, el cliente autentica al usuario contra la base de datos especificada en authSource.

Para obtener más información sobre la opción de conexión authSource, consulte la Guía de autenticación.

host[:port]

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, 27017.

/defaultauthdb

Opcional. La base de datos de autenticación que se debe usar si la cadena de conexión incluye las credenciales de autenticación username:password@ pero no la opción authSource. Si no incluyes este componente, el cliente autentica al usuario contra la base de datos admin.

?<options>

Opcional. Un string de la query que especifica opciones específicas de conexión como pares <name>=<value>.

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.

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.

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:

Volver

Conectar

En esta página