Guía de programación Java de Amazon DocumentDB

Esta guía completa proporciona una guía detallada sobre cómo trabajar con Amazon DocumentDB mediante los controladores Java de MongoDB y abarca aspectos esenciales de las operaciones y la administración de bases de datos.

Temas

• Introducción

• Requisitos previos

• Modelos de datos

• Conexión con un controlador de Java

• Operaciones CRUD con Java

• Administración de índices con Java

• Programación basada en eventos

Introducción

La guía comienza con la conectividad y explica cómo establecer conexiones seguras a los clústeres de DocumentDB mediante el controlador Java de MongoDB. En ella se detallan los componentes de la cadena de conexión, SSL/TLS la implementación y las diversas opciones de conexión, incluidas la autenticación de IAM y la agrupación de conexiones, además de estrategias sólidas de gestión de errores.

En la sección de operaciones CRUD (crear, leer, actualizar, eliminar), la guía trata exhaustivamente la manipulación de documentos y muestra cómo crear, leer, actualizar y eliminar documentos mediante operaciones únicas o masivas. Explica el uso de filtros, consultas y diversas opciones de operación, al tiempo que hace hincapié en las mejores prácticas para la gestión de errores y la implementación de la lógica de reintento para mejorar la confiabilidad. La guía también cubre ampliamente la gestión de índices y detalla la creación y el mantenimiento de diferentes tipos de índices, incluidos los índices de un solo campo, compuestos, dispersos y de texto. En ella se explica cómo optimizar el rendimiento de las consultas mediante una selección adecuada de los índices y el uso de la explain() función para analizar los planes de ejecución de las consultas.

La última sección se centra en la programación basada en eventos mediante los flujos de cambios de Amazon DocumentDB y demuestra cómo implementar la supervisión de cambios de datos en tiempo real en aplicaciones Java. Abarca la implementación de cursores de flujo de cambios, el manejo de los tokens de currículum para un funcionamiento continuo y las operaciones basadas en el tiempo para el procesamiento de datos históricos. A lo largo de la guía, se proporcionan ejemplos de código prácticos y prácticas recomendadas, lo que la convierte en un recurso inestimable para crear aplicaciones Java sólidas con Amazon DocumentDB.

Requisitos previos

Antes de empezar, asegúrese de tener lo siguiente:

• Una AWS cuenta con un clúster de DocumentDB configurado. Consulte esta entrada de blog de introducción para obtener información sobre la configuración del clúster de DocumentDB.

• El kit de desarrollo de Java (JDK) está instalado (utilizaremos Amazon Corretto 21 para esta guía).

• Especialista en administración de dependencias.

Modelos de datos para esta guía

Todo el código de ejemplo de esta guía supone una conexión a una base de datos de prueba «ProgGuideData» que tiene una colección de «Restaurantes». Todos los códigos de ejemplo de esta guía funcionan en un sistema de listados de restaurantes y, a continuación, se muestra un ejemplo del aspecto de un documento de este sistema:

{
    "_id": "ab6ad8f119b5bca3efa2c7ae",
    "restaurantId": "REST-CRT9BL",
    "name": "Thai Curry Palace",
    "description": "Amazing Restaurant, must visit",
    "cuisine": "Thai",
    "address": {
        "street": "914 Park Street",
        "city": "Bryan",
        "state": "AL",
        "zipCode": "96865",
        "location": {
            "type": "Point",
            "coordinates": [-25.4619, 8.389]
        }
    },
    "contact": {
        "phone": "[phone] x6657"
    },
    "rating": {
        "average": 3.4,
        "totalReviews": 275
    },
    "priceRange": "$",
    "menu": [{
        "category": "Appetizers",
        "items": [{
            "name": "Buffalo Chicken Wings",
            "price": 13.42
        }]
    }],
    "features": [
        "Private Dining"
    ],
    "isActive": false“ michelin”: {“
        star”: 3,
        “ranking_years”: 4
    }
}

Todos los ejemplos de código que muestran el CRUD, la gestión de índices y la programación basada en eventos suponen que se tiene un MongoClientobjetodbClient, un MongoDatabaseobjeto connectionDB y un objeto. MongoCollectioncollection

nota

Todos los ejemplos de código de esta guía se han probado con el controlador Java de MongoDB versión 5.3.0.