Comienza con el driver de Java

Instalar las dependencias del controlador.

Antes de comenzar este tutorial, asegúrese de instalar las siguientes dependencias:

• JDK versión 8 o posterior

• Entorno de desarrollo integrado (IDE), como IntelliJ IDEA o Eclipse

Agregue la lista de materiales del controlador Java.

En el IDE, se debe crear un nuevo proyecto Maven o Gradle. Se debe añadir la Lista de materiales (BOM) para los artefactos de la JVM de MongoDB al proyecto para organizar las versiones de dependencias. El BOM simplifica la gestión de dependencias al garantizar que se mantengan versiones coherentes y compatibles de las dependencias, como entre el driver de Java y la biblioteca principal del driver. Se debe usar el BOM para evitar conflictos de versión y simplificar la actualización.

Seleccione entre las siguientes opciones Maven y Gradle pestañas para ver instrucciones para agregar la lista de materiales para cada administrador de dependencia:

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.mongodb</groupId>
            <artifactId>mongodb-driver-bom</artifactId>
            <version>5.6.3</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

dependencies {
    implementation(platform("org.mongodb:mongodb-driver-bom:5.6.3"))
}

Para ver una lista de dependencias que gestiona el BOM, consulta la mongodb-driver-bom dependency listing en el sitio web de Maven Repositorio.

Instalar el controlador Java.

Si utilizas Maven, añade el siguiente código a la lista de dependencias de pom.xml:

<dependencies>
   ...
    <dependency>
        <groupId>org.mongodb</groupId>
        <artifactId>mongodb-driver-sync</artifactId>
    </dependency>
</dependencies>

Si utiliza Gradle, añada el siguiente código a su lista de dependencias de build.gradle.kts:

dependencies {
  ...
  implementation("org.mongodb:mongodb-driver-sync")
}

Debido a que se instaló el BOM, se puede omitir una versión en la entrada de dependencia del driver Java. La versión que se especifique en el BOM determina las versiones de las dependencias a instalar.

Después de configurar las dependencias, es necesario garantizar que estén disponibles para el proyecto ejecutando el administrador de dependencias y actualizando el proyecto en el IDE.

Cree una implementación gratuita de MongoDB en Atlas.

Se debe completar la guía de inicio de MongoDB para configurar una nueva cuenta de Atlas y una implementación de MongoDB en el nivel gratuito. Es necesario garantizar la carga de datos de muestra y añadir la dirección IP a la lista de acceso IP.

Guarda tus credenciales.

Después de crear un usuario de base de datos, guardar el nombre de usuario y la contraseña de ese usuario en una ubicación segura para usarlos en un paso próximo.

Encuentra tu cadena de conexión de MongoDB Atlas.

Para recuperar la cadena de conexión para la implementación que creó en el paso anterior, inicie sesión en su cuenta de Atlas y navegue a la página Clusters bajo la sección Database. Haga clic en el botón Connect para la nueva implementación.

Si aún no tienes un usuario de base de datos configurado, MongoDB te pedirá que crees y configures un nuevo usuario.

Haga clic en el botón Drivers debajo de Connect to your application y seleccione "Java" en el menú de selección Driver y la versión que mejor coincida con la versión que instaló en el menú de selección Version.

Asegúrate de que la opción View full code sample esté desmarcada para ver solo la cadena de conexión.

Copie su cadena de conexión.

Haz clic en el botón a la derecha de la cadena de conexión para copiarla en el portapapeles, como se muestra en la siguiente captura de pantalla:

Actualiza el marcador de posición de la contraseña.

Pega esta cadena de conexión en un archivo en tu editor de texto preferido y reemplaza el marcador de posición <db_password> con la contraseña de tu usuario de base de datos. La cadena de conexión ya está completada con el nombre de usuario de tu usuario de base de datos.

Guarda este archivo en una ubicación segura para usarlo en el siguiente paso.

Crea tu archivo de aplicación Java.

En el directorio del paquete base del proyecto, crea un archivo llamado QuickStart.java. Copia y pega el siguiente código en este archivo, que consulta la colección movies en la base de datos sample_mflix:

import static com.mongodb.client.model.Filters.eq;
import org.bson.Document;
import com.mongodb.client.MongoClient;
import com.mongodb.client.MongoClients;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase;
public class QuickStart {
    public static void main( String[] args ) {
        // Replace the placeholder with your MongoDB deployment's connection string
        String uri = "<connection string uri>";
        try (MongoClient mongoClient = MongoClients.create(uri)) {
            MongoDatabase database = mongoClient.getDatabase("sample_mflix");
            MongoCollection<Document> collection = database.getCollection("movies");
            Document doc = collection.find(eq("title", "Back to the Future")).first();
            if (doc != null) {
                System.out.println(doc.toJson());
            } else {
                System.out.println("No matching documents found.");
            }
        }
    }
}

Asigna la cadena de conexión.

Reemplaza el marcador de posición <connection string uri> con la cadena de conexión que se copió del paso Crear una cadena de conexión de esta guía.

Ejecute su aplicación Java.

Ejecute su aplicación en su IDE o en su shell. Su salida contiene detalles sobre el documento de la película recuperado:

{
  _id: ...,
  plot: 'A young man is accidentally sent 30 years into the past...',
  genres: [ 'Adventure', 'Comedy', 'Sci-Fi' ],
  ...
  title: 'Back to the Future',
  ...
}

Si encuentras un error o no ve salida, asegúrate de haber especificado la cadena de conexión correcta y de haber cargado los datos de muestra.

javax.net.ssl.SSLHandshakeException: extension (5) should not be presented in certificate_request