Overview
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.
Instalar la plantilla de inicio de aplicaciones
Crear un proyecto de Spring Boot
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.
Agrega la dependencia de inicio
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")}Sobrescribir la versión gestionada de Hibernate ORM
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.
Configura tu aplicación
Establezca las propiedades de su aplicación
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=MQLReemplaza 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 enMongoDB.spring.mongodb.uri: Configura la instanciaMongoClientque 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 esMQL.
Define tu entidad Movie
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.
Defina su repositorio
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.
Defina su clase de aplicación
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)Ejecutar la aplicación
Ejecute la clase MovieApplication en su IDE. Su resultado se asemeja al siguiente texto:
Title: Little Women, Year: 1949Title: Little Women, Year: 1994Si 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.
Próximos pasos
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.