Использование Spring Boot для отправки файла в хранилище BLOB-объектов Azure

Статья
04/02/2025

В этом руководстве показано, как загружать и осуществлять чтение из объектов blob контейнеров в учетной записи Azure Blob Storage в приложении на базе Spring Boot.

Хранилище BLOB-объектов Azure — это решение корпорации Майкрософт для хранения объектов в облаке. Хранилище BLOB-объектов оптимизировано для хранения большого количества неструктурированных данных, таких как текстовые или двоичные данные.

Предварительные требования

Подписка Azure — создайте бесплатную учетную запись.
Пакет средств разработки Java (JDK) версии 8 или более поздней.
Apache Maven версии 3.0 или более поздней.
cURL или подобная служебная HTTP-программа, с помощью которой можно протестировать функциональные возможности.
Учетная запись хранения Azure и контейнер. Если у вас нет учетной записи хранения, создайте учетную запись хранения.
Приложение Spring Boot. Если у вас его нет, создайте проект Maven с помощью Spring Initializr. Обязательно выберите Проект Maven и в разделе "Зависимости" добавьте зависимость Spring Web , а затем выберите Java версии 8 или более поздней.

Примечание.

Чтобы предоставить вашей учетной записи доступ к ресурсам, в недавно созданной учетной записи хранилища Azure назначьте роль Storage Blob Data Contributor учетной записи Microsoft Entra, которую вы используете. Дополнительные сведения см. в разделе Назначение ролей Azure с помощью портала Azure.

Внимание

Для выполнения действий, описанных в этом руководстве, требуется Spring Boot версии 2.5 или более поздней.

Создание контейнера

Сначала создайте контейнер с именем testcontainer, следуя инструкциям в кратком руководстве «Краткое начало: загрузка, скачивание и перечисление двоичных объектов с помощью портала Azure».

Отправка и чтение объектов BLOB из контейнера учетной записи службы хранения Azure

Теперь, когда у вас есть учетная запись хранилища Azure и контейнер, вы можете загружать и считывать файлы из блобов с помощью Spring Cloud Azure.

Чтобы установить модуль Spring Cloud Azure Storage Blob Starter, добавьте следующие зависимости в ваш файл pom.xml:

Ведомость материалов Spring Cloud Azure (BOM):
```
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.azure.spring</groupId>
      <artifactId>spring-cloud-azure-dependencies</artifactId>
      <version>5.20.1</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>
```
Примечание.

Если вы используете Spring Boot 2.x, обязательно установите его версию на spring-cloud-azure-dependencies4.19.0. Этот счет материалов (BOM) должен быть настроен в <dependencyManagement> разделе pom.xml файла. Это гарантирует, что все зависимости Spring Cloud Azure используют одну и ту же версию. Дополнительные сведения о версии, используемой для этого BOM, см. в статье "Какая версия Spring Cloud Azure должна использоваться".

Артефакт запуска Spring Cloud Azure Storage Blob:

<dependency>
  <groupId>com.azure.spring</groupId>
  <artifactId>spring-cloud-azure-starter-storage-blob</artifactId>
</dependency>

Написание кода приложения

Чтобы загрузить и считать файлы из хранилища BLOB-объектов, используя стартер Spring Cloud Azure Storage Blob, настройте приложение, выполнив следующие действия.

Настройте имя учетной записи хранения и конечную точку в файле конфигурации application.properties , как показано в следующем примере.
```
spring.cloud.azure.storage.blob.account-name=${AZURE_STORAGE_ACCOUNT_NAME}
spring.cloud.azure.storage.blob.endpoint=${AZURE_STORAGE_ACCOUNT_ENDPOINT}
```
Создайте класс BlobController Java, как показано в следующем примере. Этот класс используется для загрузки и чтения файлов из BLOB-объектов контейнера в учетной записи хранилища Azure.
```
package com.example.demo;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.core.io.Resource;
import org.springframework.core.io.WritableResource;
import org.springframework.util.StreamUtils;
import org.springframework.web.bind.annotation.*;

import java.io.IOException;
import java.io.OutputStream;
import java.nio.charset.Charset;

@RestController
@RequestMapping("blob")
public class BlobController {

    @Value("azure-blob://testcontainer/test.txt")
    private Resource blobFile;

    @GetMapping("/readBlobFile")
    public String readBlobFile() throws IOException {
        return StreamUtils.copyToString(
                this.blobFile.getInputStream(),
                Charset.defaultCharset());
    }

    @PostMapping("/writeBlobFile")
    public String writeBlobFile(@RequestBody String data) throws IOException {
        try (OutputStream os = ((WritableResource) this.blobFile).getOutputStream()) {
            os.write(data.getBytes());
        }
        return "file was updated";
    }
}
```
Совет

В этом руководстве нет операций проверки подлинности в конфигурациях или коде. Однако для подключения к службам Azure требуется проверка подлинности. Чтобы завершить проверку подлинности, необходимо использовать удостоверение Azure. Spring Cloud Azure использует DefaultAzureCredential библиотеку Azure Identity, чтобы получить учетные данные без изменений кода.

DefaultAzureCredential поддерживает несколько методов проверки подлинности и определяет, какой метод следует использовать во время выполнения. Этот подход позволяет приложению использовать различные методы проверки подлинности в разных средах (например, локальных и рабочих средах), не реализуя код, зависящий от среды. Дополнительные сведения см. в разделе DefaultAzureCredential.

Для выполнения проверки подлинности в локальных средах разработки можно использовать Azure CLI, Visual Studio Code, PowerShell или другие методы. Дополнительные сведения см. в статье о проверке подлинности Azure в средах разработки Java. Чтобы завершить проверку подлинности в средах размещения Azure, рекомендуется использовать управляемое удостоверение, назначаемое пользователем. См. сведения об управляемых удостоверениях для ресурсов Azure.
После запуска приложения используйте curl для тестирования приложения, выполнив следующие действия.
1. Отправьте запрос POST для обновления содержимого файла с помощью следующей команды:
```
curl http://localhost:8080/blob/writeBlobFile -d "new message" -H "Content-Type: text/plain"
```
  Вы увидите ответ, который говорит file was updated.
2. Отправьте запрос GET, чтобы проверить содержимое файла с помощью следующей команды:
```
curl -X GET http://localhost:8080/blob/readBlobFile
```
  Вы должны увидеть текст "новое сообщение", который вы опубликовали.

Развертывание в Azure Spring Apps

Теперь, когда у вас есть приложение Spring Boot, работающее локально, пришло время переместить его в рабочую среду. Azure Spring Apps упрощает развертывание приложений Spring Boot в Azure без каких-либо изменений кода. Эта служба управляет инфраструктурой приложений Spring, благодаря чему разработчики могут сосредоточиться на коде. Azure Spring Apps обеспечивает управление жизненным циклом за счет комплексного мониторинга и диагностики, управления конфигурацией, обнаружения служб, интеграции CI/CD, выполнения сине-зеленых развертываний и прочего. Сведения о развертывании приложения в Azure Spring Apps см. в статье "Развертывание первого приложения в Azure Spring Apps".

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

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

Azure для разработчиков Spring Примеры использования хранилища Spring Cloud Azure

См. также

Дополнительные сведения о дополнительных начальных средах Spring Boot, доступных для Microsoft Azure, см. в статье "Что такое Spring Cloud Azure?

Дополнительные сведения о дополнительных API службы хранилища Azure, которые можно вызвать из приложений Spring Boot, см. в следующих статьях:

Поделиться через