Guida alla programmazione Java di Amazon DocumentDB

Questa guida completa fornisce una guida dettagliata per lavorare con Amazon DocumentDB utilizzando i driver Java di MongoDB, coprendo gli aspetti essenziali delle operazioni e della gestione dei database.

Argomenti

• Introduzione

• Prerequisiti

• Modelli di dati

• Connessione con un driver Java

• Operazioni CRUD con Java

• Gestione degli indici con Java

• Programmazione basata sugli eventi

Introduzione

La guida inizia con la connettività, spiegando come stabilire connessioni sicure ai cluster DocumentDB utilizzando il driver Java MongoDB. Descrive in dettaglio i componenti della stringa di connessione, SSL/TLS l'implementazione e le varie opzioni di connessione, tra cui l'autenticazione IAM e il pool di connessioni, oltre a solide strategie di gestione degli errori.

Nella sezione sulle operazioni CRUD (create, read, update, delete), la guida tratta in modo approfondito la manipolazione dei documenti, dimostrando come creare, leggere, aggiornare ed eliminare documenti utilizzando operazioni singole e in blocco. Spiega l'uso di filtri, interrogazioni e varie opzioni operative, enfatizzando al contempo le migliori pratiche per la gestione degli errori e l'implementazione della logica dei tentativi per una maggiore affidabilità. La guida tratta ampiamente anche la gestione degli indici, descrivendo in dettaglio la creazione e la manutenzione di diversi tipi di indici, tra cui indici a campo singolo, composti, sparsi e di testo. Spiega come ottimizzare le prestazioni delle query attraverso la corretta selezione degli indici e l'utilizzo della funzione per analizzare i piani di esecuzione delle explain() query.

L'ultima sezione si concentra sulla programmazione basata sugli eventi utilizzando i flussi di modifica di Amazon DocumentDB, dimostrando come implementare il monitoraggio delle modifiche dei dati in tempo reale nelle applicazioni Java. Copre l'implementazione dei cursori Change Stream, la gestione dei token di curriculum per il funzionamento continuo e le operazioni basate sul tempo per l'elaborazione dei dati storici. In tutta la guida vengono forniti esempi pratici di codice e best practice, che la rendono una risorsa inestimabile per la creazione di applicazioni Java affidabili con Amazon DocumentDB.

Prerequisiti

Prima di iniziare, assicurati di disporre di quanto segue:

• Un AWS account con un cluster DocumentDB configurato. Vedi questo post di blog introduttivo sulla configurazione del cluster DocumentDB.

• Java Development Kit (JDK) installato (per questa guida utilizzeremo Amazon Corretto 21).

• Maven per la gestione delle dipendenze.

Modelli di dati per questa guida

Tutto il codice di esempio in questa guida presuppone una connessione a un database di test «ProgGuideData» che contiene una raccolta «Ristoranti». Tutti i codici di esempio di questa guida funzionano su un sistema di elenchi di ristoranti e di seguito è riportato un esempio di come appare un documento in questo 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
    }
}

Tutti gli esempi di codice che mostrano CRUD, la gestione degli indici e la programmazione basata sugli eventi presuppongono la presenza di un MongoClientoggettodbClient, un oggetto e un MongoDatabaseoggettoconnectionDB. MongoCollectioncollection

Nota

Tutti gli esempi di codice in questa guida sono stati testati con il driver Java MongoDB versione 5.3.0.