Crea un MongoClient

Ejemplo

En este ejemplo, se muestra la especificación de un ConnectionString:

MongoClient mongoClient = MongoClients.create(
    MongoClientSettings.builder()
    .applyConnectionString(new ConnectionString("<your connection string>"))
    .build());

MongoClient mongoClient = MongoClients.create(
   MongoClientSettings.builder().applyConnectionString(new ConnectionString("mongodb+srv://<db_username>:<db_password>@<hostname>:<port>/<auth db>?connectTimeoutMS=2000"))
      .applyToSocketSettings(builder ->
      builder.connectTimeout(5L, SECONDS))
      .build());

Detección de servicios DNS

Para utilizar la detección de servicios DNS para buscar el registro DNS SRV del servicio al que te estás conectando, especifica el formato de conexión SRV en tu cadena de conexión. Si especificas este formato, el driver de Java vuelve a buscar nuevos hosts automáticamente. Tu implementación puede agregar hosts a tu topología sin necesidad de cambios en la configuración de tu cliente.

El siguiente código muestra una cadena de conexión que utiliza el formato de conexión SRV:

String uri = "mongodb+srv://<hostname>/";

Para aprender más sobre el formato de conexión SRV, consulta la entrada Formato de conexión SRV en el manual de MongoDB Server.

Conéctate a una implementación de MongoDB en tu máquina local

Si necesitas ejecutar una implementación de MongoDB en tu máquina local para fines de desarrollo en lugar de usar un clúster de Atlas, debes completar lo siguiente:

1. Descarga la versión Community o Empresa de MongoDB Server.

2. Instale y configure MongoDB Server.

3. Inicia la implementación.

Después de iniciar correctamente la implementación de MongoDB, especifica la cadena de conexión en el código de conexión del driver.

Si la implementación de MongoDB se está ejecutando localmente, puedes usar la cadena de conexión "mongodb://localhost:<port>" donde <port> es el número de puerto que configuraste para que el servidor escuche las conexiones entrantes.

Si debes especificar un nombre de host o una dirección IP diferente, consulta nuestra entrada del Manual del servidor sobre Cadenas de conexión.

Para probar si es posible conectarse a la implementación, se debe reemplazar la cadena de conexión en el ejemplo de código Conectar a MongoDB Atlas y ejecutarla.

Conectarse a un set de réplicas

Una implementación de un set de réplicas de MongoDB es un grupo de instancias conectadas que almacenan el mismo conjunto de datos. Esta configuración de instancias proporciona redundancia de datos y alta disponibilidad de datos.

Para conectarte a la implementación de un set de réplicas, especifica los nombres de host (o direcciones IP) y los números de puerto de los nodos del set de réplicas.

Si no puedes proporcionar una lista completa de los hosts del set de réplicas, puedes especificar uno o un subconjunto de los hosts de la réplica e indicar al driver que realice el descubrimiento automático de una de las siguientes formas:

• Especifica el nombre del set de réplicas como valor del parámetro replicaSet.

• Especifica false como el valor del parámetro directConnection.

• Especifica más de un host en el set de réplicas

En los siguientes ejemplos, se muestra cómo especificar varios hosts para una instancia de MongoClient con la clase ConnectionString o MongoClientSettings. Selecciona la pestaña que corresponde a tu clase preferida.

ConnectionString connectionString = new ConnectionString("mongodb://host1:27017,host2:27017,host3:27017");
MongoClient mongoClient = MongoClients.create(connectionString);

ServerAddress seed1 = new ServerAddress("host1", 27017);
ServerAddress seed2 = new ServerAddress("host2", 27017);
ServerAddress seed3 = new ServerAddress("host3", 27017);
MongoClientSettings settings = MongoClientSettings.builder()
        .applyToClusterSettings(builder ->
               builder.hosts(Arrays.asList(seed1, seed2, seed3)))
        .build();
MongoClient mongoClient = MongoClients.create(settings);

¿Por qué hay dos tipos de MongoClient en el driver de Java?

Hay dos tipos de MongoClient porque queríamos una API más limpia para los nuevos usuarios que no tuvieran la confusión de incluir varios CRUD con frecuencia como AsAPI. Queríamos asegurarnos de que la nueva API CRUD estuviera disponible en una estructura de paquetes Java que funcionara bien con el soporte de módulos Java introducido en Java 9.

¿Qué tipo de MongoClient se debe usar?

Las aplicaciones nuevas generalmente utilizan la interfaz com.mongodb.client.MongoClient, que admite las siguientes funcionalidades:

• Configuración con MongoClientSettings y ConnectionString. Puedes crear instancias de esta interfaz con métodos de fábrica definidos en la clase com.mongodb.client.MongoClients.

• Accede a la API CRUD mediante MongoDatabase y, desde allí, MongoCollection.

Utiliza la clase com.mongodb.MongoClient si necesitas soporte para la API heredada, que admite las siguientes funcionalidades:

• Configuración mediante MongoClientOptions y MongoClientURI.

• Accede a la API CRUD mediante DB y, desde allí, DBCollection. Puedes acceder a esta API con el método getDB().

Para las aplicaciones que requieren una combinación de API nuevas y heredadas, com.mongodb.MongoClient también admite las siguientes funcionalidades:

• Configuración mediante MongoClientSettings y ConnectionString; la única diferencia es que creas instancias mediante constructores en lugar de una clase de fábrica.

• Accede a la API CRUD mediante MongoDatabase y, desde allí, MongoCollection. Puedes acceder a esta API con el método getDatabase().

¿Cómo se puede evitar el error “java.lang.NoClassDefFoundError: com/mongodb/MongoClient”?

Puede producirse una excepción java.lang.NoClassDefFoundError cuando el entorno de ejecución de Java no pueda localizar un archivo de clase en el tiempo de ejecución. Cuando se intenta ejecutar el código de una aplicación que utilice el driver Java de MongoDB, se deben incluir los archivos JAR adecuados del driver en la ruta de clases.

Si se produce este error después de agregar los archivos JAR del driver de Java a la ruta de clases, deben verificarse los siguientes elementos en tu entorno:

• Los archivos JAR están en las ubicaciones especificadas por la ruta de clase.

• La sintaxis de la ruta de clase es correcta.

• Si defines la ruta de clases en una variable de entorno, el entorno de ejecución de Java utiliza esa variable.

• Si utilizas un administrador de dependencias, no informa de ningún conflicto sin resolver.

¿Cómo se puede evitar el error “com.mongodb.MongoSecurityException”?

Tu aplicación podría generar esta excepción si especificas credenciales no válidas o con formato incorrecto al conectarte a una implementación de MongoDB.

Si recibes este error cuando intentas conectarte a una implementación de MongoDB, verifica los siguientes elementos de tu código:

• El URI de conexión corresponde a la implementación de MongoDB correcta. Para aprender más sobre cómo configurar tu URI de conexión, consulta URI de conexión.

• Las credenciales para el mecanismo de autenticación que especificaste son correctas. Para aprender cómo especificar tus credenciales, consulta la guía de Mecanismos de autenticación.

• El nombre de la base de datos de autenticación que has especificado es correcto. Para aprender a configurar los usuarios y roles para tu implementación de MongoDB, consulta Administrar usuarios y roles en la documentación del servidor.

¿Cómo se puede evitar el error “IllegalStateException: state should be: open”?

Puede producirse esta excepción si llamas a una operación en una instancia MongoClient que cerró sus conexiones con MongoDB. Una vez que se llama al método close() en el MongoClient, cualquier otra llamada de operación en esa instancia generará esta excepción.

Para evitar esta excepción, no llames a operaciones en la instancia MongoClient después de cualquier código que llame a close() en ella.