Simplifica la Integración de Bases de Datos NoSQL en Java con Eclipse JNoSQL 1.1.3

Tutoriales

NoSQL

Las bases de datos NoSQL se han convertido en una piedra angular del desarrollo de aplicaciones modernas, ofreciendo escalabilidad y flexibilidad para manejar diversos tipos de datos. Sin embargo, para muchos desarrolladores de Java, integrar bases de datos NoSQL puede ser complejo y llevar mucho tiempo. Aquí es donde Eclipse JNoSQL entra en juego, proporcionando una forma fluida y estandarizada de conectar tus aplicaciones Java a varias bases de datos NoSQL.

Este artículo explora cómo Eclipse JNoSQL 1.1.3 simplifica la integración de bases de datos, mejora la productividad del desarrollador y ofrece flexibilidad a través de diferentes bases de datos. También te guiaremos a través de un ejemplo práctico utilizando Quarkus y ArangoDB para demostrar sus características.

Por qué los desarrolladores de Java deberían interesarse por Eclipse JNoSQL

Para muchos desarrolladores, trabajar con bases de datos NoSQL implica aprender APIs específicas de bases de datos, lo que puede llevar a un código fragmentado y no portable. Eclipse JNoSQL elimina estos desafíos al ofrecer:

Facilidad de Uso: Con anotaciones intuitivas como @Entity, @Id y @Column, puedes mapear objetos Java a colecciones NoSQL en segundos.
Flexibilidad: Cambia entre bases de datos NoSQL (por ejemplo, Redis, MongoDB, ArangoDB, Oracle NoSQL) sin cambiar el código de tu aplicación.
Cumplimiento de Estándares: Implementa las especificaciones de Jakarta Data y Jakarta NoSQL, asegurando una solución portátil y a prueba de futuro.
Preparado para la integración: Funciona perfectamente con los componentes Jakarta EE y MicroProfile, aprovechando CDI para la inyección de dependencias y la gestión de configuraciones.

Qué hay de nuevo en Eclipse JNoSQL 1.1.3

Eclipse JNoSQL acaba de lanzar la versión 1.1.3, aportando nuevas características, correcciones de errores y mejoras de rendimiento a su ecosistema ya robusto. Este lanzamiento es un hito significativo en la simplificación de las interacciones de los desarrolladores de Java con las bases de datos NoSQL. En este artículo, exploraremos los objetivos de Eclipse JNoSQL y las nuevas características introducidas en esta versión, y proporcionaremos un ejemplo práctico de cómo utilizarlo con Quarkus y ArangoDB.

Eclipse JNoSQL tiene como objetivo simplificar la integración de aplicaciones Java con bases de datos NoSQL mediante la provisión de una API y una arquitectura unificadas. Al adherirse a las especificaciones de Jakarta EE, JNoSQL capacita a los desarrolladores para trabajar sin problemas con diversas bases de datos NoSQL, ya sean bases de datos clave-valor, de documentos, de grafos o de familia de columnas.

Interoperabilidad: Esta abstracción simplifica las complejidades específicas de cada base de datos, facilitando el cambio entre bases de datos como MongoDB, Redis, ArangoDB y Oracle NoSQL.
Impulsado por especificaciones: Implementa las especificaciones de Jakarta Data y Jakarta NoSQL, ofreciendo una forma estandarizada de trabajar con bases de datos NoSQL.
Integración con el ecosistema Java: Aprovecha CDI para la inyección de dependencias y Eclipse MicroProfile para la configuración, asegurando la compatibilidad con frameworks modernos de Java como Quarkus y Spring Boot.

Limitaciones y consideraciones para Eclipse JNoSQL

Si bien Eclipse JNoSQL ofrece beneficios significativos para la integración de bases de datos NoSQL, es esencial considerar algunas desventajas para mantener una perspectiva equilibrada:

Curva de aprendizaje para nuevos estándares: Los desarrolladores poco familiarizados con Jakarta EE o MicroProfile pueden necesitar tiempo para comprender y adaptarse a las especificaciones y APIs utilizadas por JNoSQL.
Características específicas de la base de datos: Si bien JNoSQL abstrae operaciones comunes de NoSQL, es posible que no admita completamente capacidades avanzadas específicas de la base de datos sin personalización adicional.
Comunidad y ecosistema: Al ser una herramienta relativamente especializada, su ecosistema y soporte de la comunidad son más pequeños que los marcos Java más amplios como Hibernate o Spring Data.
Ajuste de rendimiento: Las APIs generalizadas pueden introducir una ligera sobrecarga de rendimiento en comparación con las bibliotecas nativas específicas de la base de datos, especialmente para aplicaciones de alto rendimiento.

Comprender estas limitaciones ayuda a los desarrolladores a tomar decisiones informadas y considerar dónde encaja mejor JNoSQL en sus proyectos.

Especificaciones de Jakarta EE admitidas por Eclipse JNoSQL

Eclipse JNoSQL admite Jakarta Data y Jakarta NoSQL, dos especificaciones críticas en el ecosistema de Jakarta EE.

Jakarta Data

Proporciona una API estándar para acceder y gestionar repositorios de datos, permitiendo a los desarrolladores realizar operaciones CRUD de manera sencilla. Se centra en simplificar la paginación, la clasificación y las consultas dinámicas.

Jakarta NoSQL

Define una API uniforme para interacciones con bases de datos NoSQL. Proporciona anotaciones como @Entity, @Id y @Column para mapear clases de Java a colecciones NoSQL y simplificar operaciones de base de datos.

Estas especificaciones reducen el código repetitivo y promueven la portabilidad entre bases de datos, haciéndolas esenciales para los desarrolladores de Java.

La última versión, versión 1.1.3, se centra en mejorar la confiabilidad, la seguridad y el rendimiento mientras introduce emocionantes nuevas características:

Redis: Soporte mejorado para Redis Sentinel para una mejor disponibilidad.
ArangoDB: Actualizaciones de seguridad y gestión de claves.
Oracle NoSQL: Nuevas opciones de credenciales para mejor integración.
JNoSQL Lite: Soporte agregado para grabaciones, mejorando la trazabilidad.
Actualizaciones de Controladores: Controladores mejorados para varias bases de datos NoSQL.
CDI Lite: Ahora tiene soporte para registros de Java

Para mostrar el poder de Eclipse JNoSQL 1.1.3, crearemos una aplicación Quarkus que gestione “Metas” utilizando ArangoDB. Gracias a las especificaciones de Jakarta EE, cambiar a otras bases de datos NoSQL como MongoDB u Oracle NoSQL se puede hacer con cambios mínimos.

Paso a Paso

Paso 1: Configuración de Quarkus

Inicie su proyecto Quarkus utilizando la Interfaz de Inicio de Quarkus, seleccionando las siguientes extensiones:

REST
JSON
ARC (CDI Lite)
Controlador de ArangoDB

Su pom.xml debería incluir:

XML

<dependencies>

    <dependency>

        <groupId>io.quarkus</groupId>

        <artifactId>quarkus-rest</artifactId>

    </dependency>

    <dependency>

        <groupId>io.quarkus</groupId>

        <artifactId>quarkus-rest-jsonb</artifactId>

    </dependency>

    <dependency>

        <groupId>io.quarkus</groupId>

        <artifactId>quarkus-arc</artifactId>

    </dependency>

    <dependency>

        <groupId>io.quarkiverse.jnosql</groupId>

        <artifactId>quarkus-jnosql-document-arangodb</artifactId>

        <version>3.3.2</version>

    </dependency>

    <!-- Test dependencies -->

    <dependency>

        <groupId>io.quarkus</groupId>

        <artifactId>quarkus-junit5</artifactId>

        <scope>test</scope>

    </dependency>

    <dependency>

        <groupId>io.rest-assured</groupId>

        <artifactId>rest-assured</artifactId>

        <scope>test</scope>

    </dependency>

</dependencies>

Paso 2: Implementación de la Conectividad a la Base de Datos

Establezca la conexión a su base de datos en application.properties:

Properties files

jnosql.arangodb.host=localhost:8529

jnosql.document.database=goals

jnosql.keyvalue.database=goals

Ejecute una instancia de ArangoDB localmente utilizando Docker:

Shell

docker run -e ARANGO_NO_AUTH=1 -d --name arangodb-instance -p 8529:8529 -d arangodb/arangodb

Cree una base de datos llamada goals y una colección Goal en la interfaz web de ArangoDB.

Paso 3: Modelando Sus Datos

Utilice la característica de registro de Java con CDI Lite:

Java

import jakarta.json.bind.annotation.JsonbProperty;

import jakarta.json.bind.annotation.JsonbPropertyOrder;

import jakarta.nosql.Column;

import jakarta.nosql.Entity;

import jakarta.nosql.Id;

​

import java.util.List;

​

@JsonbPropertyOrder({"id", "title", "description", "priority", "tasks"})

@Entity

public record Goal(

        @Id @JsonbProperty("id") String id,

        @JsonbProperty("title") @Column String title,

        @JsonbProperty("description") @Column String description,

        @JsonbProperty("priority") @Column int priority,

        @JsonbProperty("tasks") @Column List<String> tasks) {}

Paso 4: Configurando un Repositorio

Defina un repositorio utilizando Jakarta Data:

Java

@Repository

public interface NewYearWishes extends BasicRepository<Goal, String> {}

Paso 5: Implementación de una Capa de Servicio

Cree una capa de servicio para gestionar la lógica de negocio:

Java

@ApplicationScoped

public class GoalService {

​

    private final NewYearWishes newYearWishes;

​

    @Inject

    public GoalService(@Database(DatabaseType.DOCUMENT) NewYearWishes newYearWishes) {

        this.newYearWishes = newYearWishes;

    }

​

    public List<Goal> findGoals(int page, int size) {

        PageRequest pageRequest = PageRequest.ofPage(page).size(size);

        return newYearWishes.findAll(pageRequest, Order.by(Sort.asc("priority"))).content();

    }

​

    public Goal save(Goal goal) {

        return newYearWishes.save(goal);

    }

​

    public Optional<Goal> findById(String id) {

        return newYearWishes.findById(id);

    }

}

Paso 6: Creando Endpoints REST

Defina un recurso REST:

Java

@Path("/goals")

@Consumes(MediaType.APPLICATION_JSON)

@Produces(MediaType.APPLICATION_JSON)

public class GoalResource {

​

    private final GoalService goalService;

​

    @Inject

    public GoalResource(GoalService goalService) {

        this.goalService = goalService;

    }

​

    @GET

    public List<Goal> goals(@QueryParam("page") int page, @QueryParam("size") int size) {

        return goalService.findGoals(page, size);

    }

​

    @POST

    public Goal create(Goal goal) {

        return goalService.save(goal);

    }

​

    @GET

    @Path("{id}")

    public Goal findById(@PathParam("id") String id) {

        return goalService.findById(id).orElseThrow(() -> new WebApplicationException("Goal not found", 404));

    }

}

Paso 7: Probando la Aplicación

A continuación se muestra cómo probar su aplicación utilizando curl:

Shell

curl -X POST -H "Content-Type: application/json" \

-d '{

      "title": "Learn JNoSQL",

      "description": "Master NoSQL with JNoSQL",

      "priority": 1,

      "tasks": ["Read documentation", "Write sample code"]

    }' \

http://localhost:8080/goals

​

curl -X POST -H "Content-Type: application/json" \

-d '{

      "title": "Get Fit",

      "description": "Adopt a healthier lifestyle",

      "priority": 2,

      "tasks": ["Exercise daily", "Eat balanced meals", "Stay hydrated"]

    }' \

http://localhost:8080/goals

​

curl -X POST -H "Content-Type: application/json" \

-d '{

      "title": "Learn Quarkus",

      "description": "Explore Quarkus framework features",

      "priority": 3,

      "tasks": ["Set up Quarkus", "Create REST endpoints", "Integrate JNoSQL"]

    }' \

http://localhost:8080/goals

Listar Metas:

Shell

curl http://localhost:8080/goals?page=1&size=10

Conclusión

Eclipse JNoSQL 1.1.3 muestra su compromiso de hacer que las interacciones con bases de datos NoSQL sean más sencillas para los desarrolladores de Java. Las características mejoradas y capacidades de integración permiten a los desarrolladores construir aplicaciones flexibles y escalables. Para más detalles, echa un vistazo al ejemplo completo en GitHub.

Source:
https://dzone.com/articles/nosql-database-integration-in-java-with-eclipse-jnosql-1-1-3