Join us at MongoDB.local London on 7 May to unlock new possibilities for your data. Use WEB50 to save 50%.
Register now >
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 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.

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 el Guía de autenticación.

host[:port]

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, 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, consulta Cadenas de conexión en la documentación del servidor MongoDB.

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.

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