Guia de programação Java do Amazon DocumentDB

Este guia abrangente fornece um guia detalhado para trabalhar com o Amazon DocumentDB usando os drivers Java do MongoDB, abordando aspectos essenciais das operações e do gerenciamento do banco de dados.

Tópicos

• Introdução

• Pré-requisitos

• Modelos de dados

• Conectando-se com um driver Java

• Operações CRUD com Java

• Gerenciamento de índices com Java

• Programação orientada por eventos

Introdução

O guia começa com a conectividade, explicando como estabelecer conexões seguras com clusters do DocumentDB usando o driver Java do MongoDB. Ele detalha os componentes da cadeia de conexão, a SSL/TLS implementação e várias opções de conexão, incluindo autenticação do IAM e agrupamento de conexões, além de estratégias robustas de tratamento de erros.

Na seção de operações CRUD (criar, ler, atualizar, excluir), o guia aborda detalhadamente a manipulação de documentos, demonstrando como criar, ler, atualizar e excluir documentos usando operações únicas e em massa. Ele explica o uso de filtros, consultas e várias opções de operação, ao mesmo tempo em que enfatiza as melhores práticas para tratamento de erros e implementação da lógica de repetição para melhorar a confiabilidade. O guia também aborda extensivamente o gerenciamento de índices, detalhando a criação e a manutenção de diferentes tipos de índice, incluindo índices de campo único, compostos, esparsos e de texto. Ele explica como otimizar o desempenho da consulta por meio da seleção adequada do índice e do uso da explain() função para analisar os planos de execução da consulta.

A seção final se concentra na programação orientada a eventos usando os fluxos de mudança do Amazon DocumentDB, demonstrando como implementar o monitoramento de alterações de dados em tempo real em aplicativos Java. Ele abrange a implementação de cursores de fluxo de mudança, o manuseio de tokens de currículo para operação contínua e operações baseadas em tempo para processamento de dados históricos. Ao longo do guia, exemplos práticos de código e melhores práticas são fornecidos, tornando-o um recurso inestimável para você ao criar aplicativos Java robustos com o Amazon DocumentDB.

Pré-requisitos

Antes de começar, verifique se você tem o seguinte:

• Uma AWS conta com um cluster DocumentDB configurado. Veja esta postagem de introdução no blog sobre a configuração do cluster DocumentDB.

• O Java Development Kit (JDK) instalado (usaremos o Amazon Corretto 21 para este guia).

• Maven para gerenciamento de dependências.

Modelos de dados para este guia

Todo o código de exemplo neste guia pressupõe uma conexão com um banco de dados de teste “ProgGuideData” que tem uma coleção “Restaurantes”. Todos os códigos de amostra neste guia funcionam em um sistema de listagem de restaurantes e, abaixo, há um exemplo da aparência de um documento nesse 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
    }
}

Todas as amostras de código que mostram CRUD, gerenciamento de índices e programação orientada a eventos pressupõem que você tenha um MongoClientobjetodbClient, um objeto e um MongoDatabaseobjetoconnectionDB. MongoCollectioncollection

nota

Todos os exemplos de código neste guia foram testados com o driver Java MongoDB versão 5.3.0.