Использование 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. Щелкните Строки подключения и скопируйте значение поля Основная строка подключения. Используйте это значение для настройки приложения позже.

   

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

1. Откройте командную оболочку и клонируйте пример проекта с помощью команды Git. Рассмотрим пример.

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

2. Создайте каталог resources в каталоге <корня проекта>/complete/src/main учебного проекта. Затем создайте файл application.properties в каталоге ресурсов .

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.

Весна в Azure

См. также

Дополнительные сведения об использовании Azure с Java см. в Azure для разработчиков Java и в работе с Azure DevOps и Java.