Использование 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. Создайте каталог ресурсов в корневом каталогепроекта /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.