Использование Spring Data с AZURE Cosmos DB для API MongoDB

  • Статья

В этой статье показано создание примера приложения, использующего Spring Data для хранения и извлечения информации с помощью Azure Cosmos DB для MongoDB.

Необходимые компоненты

  • Клиент Git.

Создание учетной записи Azure Cosmos DB

создание учетной записи Azure Cosmos DB с помощью портала Azure;

Примечание.

Дополнительные сведения о создании учетных записей см. в документации по Azure Cosmos DB.

  1. Перейдите на портал Azure по адресу https://portal.azure.com/ и выполните вход.

  2. Выберите Создать ресурс, Базы данных и Azure Cosmos DB.

    Azure portal, create a resource, search for Azure Cosmos DB.

  3. На экране выбора API выберите Azure Cosmos DB для MongoDB.

    Azure portal, create a resource, select API option, Azure Cosmos DB for MongoDB selected.

  4. Укажите следующую информацию:

    • Подписка. Укажите используемую подписку Azure.
    • Группа ресурсов: укажите, следует ли создать новую группу ресурсов или выбрать существующую группу ресурсов.
    • Имя учетной записи: выберите уникальное имя для учетной записи Azure Cosmos DB. Это будет использоваться для создания полного доменного имени, например wingtiptoysmongodb.documents.azure.com.
    • API: укажите Azure Cosmos DB for MongoDB API для этого руководства.
    • Расположение. Укажите ближайший географический регион для базы данных.

  5. Когда вы ввели все приведенные выше сведения, нажмите кнопку "Просмотр и создание".

  6. Если при просмотре страницы все выглядит правильно, щелкните Создать.

    Review your Azure Cosmos DB account settings.

Получение строки подключения к учетной записи Azure Cosmos DB

  1. Перейдите на портал Azure по адресу https://portal.azure.com/ и выполните вход.

  2. Нажмите кнопку Все ресурсы, а затем щелкните только что созданную учетную запись Azure Cosmos DB.

  3. Щелкните Подключение строки и скопируйте значение для поля основной строки Подключение ion String. Это значение будет использоваться для настройки приложения позже.

    Retrieve your Azure Cosmos DB connection string.

Настройка примера приложения

  1. Откройте командную строку и клонируйте пример проекта с помощью команды Git, как в следующем примере:

    git clone https://github.com/spring-guides/gs-accessing-data-mongodb.git

  2. Создайте каталог resources в каталоге примера проекта <project root>/complete/src/main, а затем создайте файл application.properties в каталоге resources.

  3. Откройте файл application.properties в текстовом редакторе и добавьте указанные ниже строки в файл и замените примеры значений на соответствующие полученные ранее значения:

    spring.data.mongodb.database=wingtiptoysmongodb
spring.data.mongodb.uri=mongodb://wingtiptoysmongodb:AbCdEfGhIjKlMnOpQrStUvWxYz==@wingtiptoysmongodb.documents.azure.com:10255/?ssl=true&replicaSet=globaldb

    Где:

    Параметр Описание
    spring.data.mongodb.database Указывает имя учетной записи Azure Cosmos DB из предыдущей статьи.
    spring.data.mongodb.uri Указывает основную строку подключения, описанную в этой статье.

  4. Сохраните и закройте файл application.properties.

Упаковывание и тестирование примера приложения

Чтобы создать приложение, перейдите к каталогу /gs-accessing-data-mongodb/complete, который содержит файл pom.xml .

  1. Создайте пример приложения с помощью Maven, а затем настройте Maven на пропуск тестов, например:

    mvn clean package -DskipTests

  2. Запустите пример приложения, например:

    
java -jar target/accessing-data-mongodb-complete-0.0.1-SNAPSHOT.jar

    Приложение должно возвращать значения следующим образом:

    Customers found with findAll():
-------------------------------
Customer[id=5c1b4ae4d0b5080ac105cc13, firstName='Alice', lastName='Smith']
Customer[id=5c1b4ae4d0b5080ac105cc14, firstName='Bob', lastName='Smith']

Customer found with findByFirstName('Alice'):
--------------------------------
Customer[id=5c1b4ae4d0b5080ac105cc13, firstName='Alice', lastName='Smith']
Customers found with findByLastName('Smith'):
--------------------------------
Customer[id=5c1b4ae4d0b5080ac105cc13, firstName='Alice', lastName='Smith']
Customer[id=5c1b4ae4d0b5080ac105cc14, firstName='Bob', lastName='Smith']

Итоги

В этом руководстве вы создали пример приложения Java, использующего Spring Data для хранения и получения информации с помощью Azure Cosmos DB для MongoDB.

Очистка ресурсов

Если они больше не нужны, используйте портал Azure, чтобы удалить ресурсы, созданные в этой статье во избежание непредвиденных расходов.

Следующие шаги

Дополнительные сведения о Spring и Azure см. в центре документации об использовании Spring в Azure.

Spring в Azure

См. также

Дополнительные сведения об использовании Java в Azure см. в статьях Azure для разработчиков Java и Working with Azure DevOps and Java (Работа с Azure DevOps и Java).