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

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

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

• Подписка Azure — создайте бесплатную учетную запись.

• Пакет средств разработки Java (JDK) версии 8 или более поздней.

• Apache Maven.

• Azure CLI.

• Клиент Git.

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

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

Примечание.

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

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

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

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

   

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

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

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

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

   

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

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

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

3. Щелкните Подключение строки и скопируйте значение для поля основной строки Подключение ion 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).