Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Empezar con el Spring Boot Starter

En este tutorial, aprenderá a crear una aplicación Spring Boot que almacena entidades de la API de persistencia de Java (JPA) en MongoDB mediante el uso de la extensión Hibernate ORM. La aplicación define una entidad Movie, un repositorio de Spring Data JPA y una query que se ejecuta en la empresa emergente.

Antes de empezar, complete los pasos Crear una implementación de MongoDB y Crear una cadena de conexión del tutorial Empezar a usar la extensión Hibernate ORM. Esos pasos crean la implementación de Atlas, los datos de muestra y la cadena de conexión que utiliza este tutorial.

1

Cree un proyecto de Spring Boot 4.x denominado MongoHibernateSpringQuickstart. Puede generar el proyecto utilizando el Spring Initializr o crearlo en su IDE.

El Spring Initializr genera una clase de aplicación principal con el nombre de su Proyecto, como MongoHibernateSpringQuickstartApplication.java. Si utiliza Spring Initializr para generar su Proyecto, borre el archivo de clase de aplicación principal autogenerado. Más adelante en este tutorial, crearás un archivo de aplicación principal para este Proyecto denominado Movie Application. Si su Proyecto contiene dos clases de aplicación principales, su aplicación no se inicia con un error Unable to find a single main class.

2

Para proyectos Maven, añada la siguiente dependencia a su archivo pom.xml:

<dependencies> <dependency> <groupId>org.mongodb</groupId> <artifactId>mongodb-hibernate-spring-boot-starter</artifactId> <version>1.0.0</version> </dependency></dependencies>

Para proyectos Gradle, añada la siguiente dependencia a su archivo build.gradle:

dependencies { implementation("org.mongodb:mongodb-hibernate-spring-boot-starter:1.0.0")}
3

El iniciador requiere Hibernate ORM 7.4 o posterior. Spring Boot gestiona la versión de Hibernate ORM a través de su lista de materiales (BOM), y algunas versiones de Spring Boot 4.x gestionan una versión anterior de Hibernate ORM que la versión que requiere el iniciador. Si la versión gestionada es anterior a 7.4, su aplicación no se iniciará y la extensión Hibernate ORM lanzará un NoSuchMethodError.

Para anular la versión gestionada en un proyecto Maven, agregue la siguiente propiedad a su archivo pom.xml:

<properties> <hibernate.version>7.4.7.Final</hibernate.version></properties>

Para sobrescribir la versión gestionada en un proyecto de Gradle, añada la siguiente línea a su archivo build.gradle:

ext['hibernate.version'] = '7.4.7.Final'

Recargar o sincronizar su Proyecto para completar la instalación.

1

En el directorio src/main/resources de su Proyecto, abra el archivo application.properties y agregue las siguientes propiedades:

spring.jpa.database-platform=MongoDBspring.mongodb.uri=<connection string>spring.jpa.properties.com.mongodb.hibernate.semantics.nulls=MQL

Reemplaza el marcador de posición <connection string> con la cadena de conexión sample_mflix que creaste en el paso Crear una cadena de conexión del tutorial Introducción a la extensión ORM de Hibernate. Su cadena de conexión debe ser similar al siguiente ejemplo:

mongodb+srv://<db_username>:<db_password>@<cluster>/sample_mflix?<options>

Las propiedades de la aplicación que establezca hacen lo siguiente:

  • spring.jpa.database-platform: Activa el motor de arranque. El iniciador permanece inactivo a menos que establezca esta propiedad en MongoDB.

  • spring.mongodb.uri: Configura la instancia MongoClient que el iniciador reutiliza. El iniciador no crea un cliente propio.

  • spring.jpa.properties.com.mongodb.hibernate.semantics.nulls: Declara la semántica de comparación de nulos que utiliza la query. Esta propiedad es obligatoria y su único valor admitido es MQL.

2

En el directorio src/main/java/org/example de su proyecto, cree un archivo llamado Movie.java y pegue el siguiente código en él:

package org.example; import com.mongodb.hibernate.annotations.ObjectIdGenerator;import org.bson.types.ObjectId; import jakarta.persistence.Entity;import jakarta.persistence.Id;import jakarta.persistence.Table; @Entity@Table(name = "movies")public class Movie { @Id @ObjectIdGenerator private ObjectId id; private String title; private int year; public Movie() { } public Movie(String title, int year) { this.title = title; this.year = year; } public ObjectId getId() { return id; } public String getTitle() { return title; } public void setTitle(String title) { this.title = title; } public int getYear() { return year; } public void setYear(int year) { this.year = year; }}

Esta entidad representa la colección sample_mflix.movies de los conjuntos de datos de muestra de Atlas. El iniciador escanea el paquete principal de su aplicación en busca de entidades, por lo que no necesita registrar la entidad.

3

En el mismo directorio, cree un archivo llamado MovieRepository.java y pegue el siguiente código en él:

package org.example; import org.bson.types.ObjectId;import org.springframework.data.jpa.repository.JpaRepository; import java.util.List; public interface MovieRepository extends JpaRepository<Movie, ObjectId> { List<Movie> findByTitle(String title);}

El iniciador habilita los repositorios de Spring Data JPA sin un SQL DataSource, por lo que Spring Boot implementa la interfaz MovieRepository para usted.

4

En el mismo directorio, cree un archivo llamado MovieApplication.java y pegue el siguiente código en él:

package org.example; import org.springframework.boot.CommandLineRunner;import org.springframework.boot.SpringApplication;import org.springframework.boot.autoconfigure.SpringBootApplication;import org.springframework.context.annotation.Bean; @SpringBootApplicationpublic class MovieApplication { public static void main(String[] args) { SpringApplication.run(MovieApplication.class, args); } @Bean CommandLineRunner run(MovieRepository repository) { return args -> { for (Movie movie : repository.findByTitle("Little Women")) { System.out.println("Title: " + movie.getTitle() + ", Year: " + movie.getYear()); } }; }}

Esta clase ejecuta una query de repositorio al inicio e imprime cada película coincidente.

Una vez que completes estos pasos, tu aplicación tiene la siguiente estructura de archivos:

MongoHibernateSpringQuickstart├── src│ └── main│ ├── java│ │ └── org/example│ │ ├── Movie.java│ │ ├── MovieApplication.java│ │ └── MovieRepository.java│ └── resources│ └── application.properties├── .gitignore├── pom.xml (for Maven projects)└── build.gradle (for Gradle projects)

Ejecute la clase MovieApplication en su IDE. Su resultado se asemeja al siguiente texto:

Title: Little Women, Year: 1949Title: Little Women, Year: 1994

Si su aplicación no se inicia, consulte Solucionar problemas de errores de empresa emergente para posibles errores de empresa emergente y consejos para la solución de problemas.

Para aprender a configurar las propiedades de JPA, cambiar la estrategia de nomenclatura de campos y personalizar el MongoClient, consulte Configurar el iniciador de Spring Boot.

Para aprender a modelar sus datos como entidades, consulte Crear entidades para representar colección.

Para aprender a query tus datos, consulta la sección Interacción con datos.