Guide de programmation Java d'Amazon DocumentDB

Ce guide complet explique en détail comment utiliser Amazon DocumentDB à l'aide des pilotes Java de MongoDB, en abordant les aspects essentiels des opérations et de la gestion des bases de données.

Rubriques

• Introduction

• Prérequis

• Modèles de données

• Connexion à l'aide d'un pilote Java

• Opérations CRUD avec Java

• Gestion des index avec Java

• Programmation pilotée par les événements

Introduction

Le guide commence par la connectivité et explique comment établir des connexions sécurisées aux clusters DocumentDB à l'aide du pilote Java MongoDB. Il détaille les composants de la chaîne de connexion, la SSL/TLS mise en œuvre et les différentes options de connexion, notamment l'authentification IAM et le regroupement des connexions, ainsi que des stratégies robustes de gestion des erreurs.

Dans la section des opérations CRUD (créer, lire, mettre à jour, supprimer), le guide couvre en détail la manipulation de documents et montre comment créer, lire, mettre à jour et supprimer des documents à l'aide d'opérations uniques ou groupées. Il explique l'utilisation des filtres, des requêtes et des différentes options d'opération, tout en mettant l'accent sur les meilleures pratiques en matière de gestion des erreurs et en implémentant une logique de nouvelle tentative pour une fiabilité accrue. Le guide couvre également de manière approfondie la gestion des index, détaillant la création et la maintenance de différents types d'index, notamment les index à champ unique, composés, épars et textuels. Il explique comment optimiser les performances des requêtes grâce à une sélection d'index appropriée et à l'utilisation de la explain() fonction pour analyser les plans d'exécution des requêtes.

La dernière section se concentre sur la programmation pilotée par les événements à l'aide des flux de modifications d'Amazon DocumentDB et montre comment implémenter la surveillance des modifications des données en temps réel dans les applications Java. Il couvre la mise en œuvre de curseurs de flux de modifications, la gestion des jetons de CV pour un fonctionnement continu et les opérations temporelles pour le traitement des données historiques. Tout au long du guide, des exemples de code pratiques et les meilleures pratiques sont fournis, ce qui en fait une ressource inestimable pour vous lorsque vous créez des applications Java robustes avec Amazon DocumentDB.

Prérequis

Avant de commencer, assurez-vous que vous disposez des éléments suivants :

• Un AWS compte avec un cluster DocumentDB configuré. Consultez ce billet de blog consacré à la mise en route pour la configuration du cluster DocumentDB.

• Kit de développement Java (JDK) installé (nous utiliserons Amazon Corretto 21 pour ce guide).

• Maven pour la gestion des dépendances.

Modèles de données pour ce guide

Tous les exemples de code présentés dans ce guide supposent une connexion à une base de données de test « ProgGuideData » contenant une collection « Restaurants ». Tous les exemples de codes présentés dans ce guide fonctionnent sur un système de liste de restaurants. Vous trouverez ci-dessous un exemple de ce à quoi ressemble un document dans ce système :

{
    "_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
    }
}

Tous les exemples de code illustrant le CRUD, la gestion des index et la programmation pilotée par les événements supposent que vous disposez d'un MongoClientobjetdbClient, d'un MongoDatabaseobjet connectionDB et d'un objet. MongoCollectioncollection

Note

Tous les exemples de code présentés dans ce guide ont été testés avec le pilote Java MongoDB version 5.3.0.