빠른 시작: Java용 Azure Blob Storage 클라이언트 라이브러리

참고 항목

처음부터 빌드 옵션은 새 프로젝트를 만들고, 패키지를 설치하고, 코드를 작성하고, 기본 콘솔 앱을 실행하는 프로세스를 단계별로 안내합니다. 이 방법은 Azure Blob Storage에 연결하는 앱을 만드는 데 관련된 모든 세부 정보를 이해하려는 경우에 권장됩니다. 배포 작업을 자동화하고 완료된 프로젝트로 시작하려면 템플릿으로 시작을 선택합니다.

참고 항목

템플릿으로 시작 옵션은 Azure Developer CLI를 사용하여 배포 작업을 자동화하고 완성된 프로젝트부터 시작됩니다. 이 방법은 설정 작업을 거치지 않고 코드를 최대한 빨리 탐색하려는 경우에 권장됩니다. 앱을 빌드하는 단계별 지침을 원하는 경우 처음부터 빌드를 선택합니다.

Java용 Azure Blob Storage 클라이언트 라이브러리를 시작하여 Blob 및 컨테이너를 관리합니다.

이 문서에서는 패키지를 설치하고 기본 작업에 대한 예제 코드를 사용해 보는 단계를 수행합니다.

이 문서에서는 Azure Developer CLI를 사용하여 Azure 리소스를 배포하고 몇 가지 명령만으로 완성된 콘솔 앱을 실행합니다.

Spring 애플리케이션에서 Azure Storage 리소스로 작업하는 경우 대안으로 Spring Cloud Azure를 고려하는 것이 좋습니다. Spring Cloud Azure는 Azure 서비스와 원활한 Spring 통합을 제공하는 오픈 소스 프로젝트입니다. Spring Cloud Azure에 대해 자세히 알아보고 Blob Storage를 사용하는 예제를 보려면 Azure Storage Blob에 파일 업로드를 참조하세요.

API 참조 설명서 | 라이브러리 소스 코드 | 패키지(Maven) | 샘플

필수 조건

설정

이 섹션에서는 Java용 Azure Blob Storage 클라이언트 라이브러리를 사용하는 프로젝트를 준비합니다.

프로젝트 만들기

blob-quickstart라는 Java 애플리케이션을 만듭니다.

  1. 콘솔 창(예: PowerShell 또는 Bash)에서 Maven을 사용하여 blob-quickstart라는 새 콘솔 앱을 만듭니다. 다음 mvn 명령을 입력하여 "Hello world!" Java 프로젝트를 만듭니다.

    mvn archetype:generate `
        --define interactiveMode=n `
        --define groupId=com.blobs.quickstart `
        --define artifactId=blob-quickstart `
        --define archetypeArtifactId=maven-archetype-quickstart `
        --define archetypeVersion=1.4
    
  2. 프로젝트를 생성하는 출력은 다음과 같습니다.

    [INFO] Scanning for projects...
    [INFO]
    [INFO] ------------------< org.apache.maven:standalone-pom >-------------------
    [INFO] Building Maven Stub Project (No POM) 1
    [INFO] --------------------------------[ pom ]---------------------------------
    [INFO]
    [INFO] >>> maven-archetype-plugin:3.1.2:generate (default-cli) > generate-sources @ standalone-pom >>>
    [INFO]
    [INFO] <<< maven-archetype-plugin:3.1.2:generate (default-cli) < generate-sources @ standalone-pom <<<
    [INFO]
    [INFO]
    [INFO] --- maven-archetype-plugin:3.1.2:generate (default-cli) @ standalone-pom ---
    [INFO] Generating project in Batch mode
    [INFO] ----------------------------------------------------------------------------
    [INFO] Using following parameters for creating project from Archetype: maven-archetype-quickstart:1.4
    [INFO] ----------------------------------------------------------------------------
    [INFO] Parameter: groupId, Value: com.blobs.quickstart
    [INFO] Parameter: artifactId, Value: blob-quickstart
    [INFO] Parameter: version, Value: 1.0-SNAPSHOT
    [INFO] Parameter: package, Value: com.blobs.quickstart
    [INFO] Parameter: packageInPathFormat, Value: com/blobs/quickstart
    [INFO] Parameter: version, Value: 1.0-SNAPSHOT
    [INFO] Parameter: package, Value: com.blobs.quickstart
    [INFO] Parameter: groupId, Value: com.blobs.quickstart
    [INFO] Parameter: artifactId, Value: blob-quickstart
    [INFO] Project created from Archetype in dir: C:\QuickStarts\blob-quickstart
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD SUCCESS
    [INFO] ------------------------------------------------------------------------
    [INFO] Total time:  7.056 s
    [INFO] Finished at: 2019-10-23T11:09:21-07:00
    [INFO] ------------------------------------------------------------------------
        ```
    
    
  3. 새로 만들어진 blob-quickstart 폴더로 전환합니다.

    cd blob-quickstart
    
  4. blob-quickstart 디렉터리에서 data라는 다른 디렉터리를 만듭니다. 이 폴더는 Blob 데이터 파일이 생성되고 저장되는 위치입니다.

    mkdir data
    

패키지 설치

텍스트 편집기에서 pom.xml 파일을 엽니다.

azure-sdk-bom을 추가하여 최신 버전의 라이브러리에 대한 종속성을 가져옵니다. 다음 코드 조각에서 {bom_version_to_target} 자리 표시자를 버전 번호로 바꿉니다. azure-sdk-bom을 사용하면 각 개별 종속성의 버전을 지정하지 않아도 됩니다. BOM에 대해 자세히 알아보려면 Azure SDK BOM 추가 정보를 참조하세요.

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.azure</groupId>
            <artifactId>azure-sdk-bom</artifactId>
            <version>{bom_version_to_target}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

그런 다음, 종속성 그룹에 다음 종속성 요소를 추가합니다. Azure 서비스에 대한 암호 없는 연결에는 azure-identity 종속성이 필요합니다.

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-storage-blob</artifactId>
</dependency>
<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity</artifactId>
</dependency>

앱 프레임워크 설정

프로젝트 디렉터리에서 단계에 따라 앱의 기본 구조를 만듭니다.

  1. /src/main/java/com/blobs/quickstart 디렉터리로 이동합니다.
  2. 편집기에서 App.java 파일을 엽니다.
  3. System.out.println("Hello world!"); 줄을 삭제합니다.
  4. 필요한 import 지시문 추가

코드는 이 프레임워크와 유사해야 합니다.

package com.blobs.quickstart;

/**
 * Azure Blob Storage quickstart
 */
import com.azure.identity.*;
import com.azure.storage.blob.*;
import com.azure.storage.blob.models.*;
import java.io.*;

public class App
{
    public static void main(String[] args) throws IOException
    {
        // Quickstart code goes here
    }
}

Azure Developer CLI를 설치하면 몇 가지 명령만으로 스토리지 계정을 만들고 샘플 코드를 실행할 수 있습니다. 로컬 개발 환경이나 DevContainer에서 프로젝트를 실행할 수 있습니다.

Azure Developer CLI 템플릿 초기화 및 리소스 배포

빈 디렉터리에서 다음 단계에 따라 azd 템플릿을 초기화하고, Azure 리소스를 프로비전하고, 코드를 시작합니다.

  • GitHub에서 빠른 시작 리포지토리 자산을 복제하고 템플릿을 로컬로 초기화합니다.

    azd init --template blob-storage-quickstart-java
    

    다음 정보를 입력하라는 메시지가 표시됩니다.

    • 환경 이름: 이 값은 Azure Developer CLI에서 만든 모든 Azure 리소스에 대한 접두사로 사용됩니다. 이름은 모든 Azure 구독에서 고유해야 하며 길이는 3자에서 24자 사이여야 합니다. 이름은 숫자와 소문자만 포함할 수 있습니다.
  • Azure에 로그인:

    azd auth login
    
  • Azure에 리소스를 프로비전하고 배포합니다.

    azd up
    

    다음 정보를 입력하라는 메시지가 표시됩니다.

    • 구독: 리소스가 배포되는 Azure 구독입니다.
    • 위치: 리소스가 배포되는 Azure 지역입니다.

    배포를 완료하는 데 몇 분 정도 걸릴 수 있습니다. azd up 명령의 출력에는 새로 만든 스토리지 계정의 이름이 포함되며, 나중에 코드를 실행하는 데 필요합니다.

샘플 코드 실행

이 시점에서 리소스는 Azure에 배포되고 코드를 실행할 준비가 거의 완료되었습니다. 다음 단계에 따라 코드에서 스토리지 계정의 이름을 업데이트하고 샘플 콘솔 앱을 실행합니다.

  • 스토리지 계정 이름을 업데이트합니다.
    1. 로컬 디렉터리에서 Blob-quickstart/src/기본/java/com/blobs/quickstart 디렉터리로 이동합니다.
    2. 편집기에서 App.java 파일을 엽니다. <storage-account-name> 자리 표시자를 찾아 azd up 명령으로 만든 스토리지 계정의 실제 이름으로 바꿉니다.
    3. 변경 내용을 저장합니다.
  • 프로젝트를 실행합니다.
    1. 파일이 포함된 Blob-quickstart 디렉터리로 pom.xml 이동합니다. 다음 mvn 명령을 사용하여 프로젝트를 컴파일합니다.
      mvn compile
      
    2. 컴파일된 코드를 배포 가능한 형식으로 패키지합니다.
      mvn package
      
    3. 다음 mvn 명령을 실행하여 앱을 실행합니다.
      mvn exec:java
      
  • 출력 관찰: 이 앱은 로컬 data 폴더에 테스트 파일을 만들고 스토리지 계정의 컨테이너에 업로드합니다. 그런 다음, 컨테이너에 Blob을 나열하고 이전 파일과 새 파일을 비교할 수 있도록 새 이름으로 해당 파일을 다운로드합니다.

샘플 코드의 작동 방식에 대한 자세한 내용은 코드 예제를 참조하세요.

코드 테스트를 마쳤으면 리소스 정리 섹션을 참조하여 azd up 명령으로 만든 리소스를 삭제합니다.

개체 모델

Azure Blob Storage는 대량의 비정형 데이터를 저장하는 데 최적화되어 있습니다. 비정형 데이터는 텍스트 또는 이진 데이터와 같은 특정 데이터 모델이나 정의를 따르지 않습니다. Blob Storage는 다음 세 가지 유형의 리소스를 제공합니다.

  • 스토리지 계정
  • 스토리지 계정의 컨테이너
  • 컨테이너의 blob

다음 다이어그램에서는 리소스 간의 관계를 보여줍니다.

Diagram of Blob storage architecture

다음 Java 클래스를 사용하여 이러한 리소스와 상호 작용합니다.

  • BlobServiceClient: BlobServiceClient 클래스를 사용하면 Azure Storage 리소스 및 Blob 컨테이너를 조작할 수 있습니다. 스토리지 계정은 Blob Service에 대한 최상위 네임스페이스를 제공합니다.
  • BlobServiceClientBuilder: BlobServiceClientBuilder 클래스는 BlobServiceClient 개체의 구성과 인스턴스화를 지원하기 위한 뛰어난 작성기 API를 제공합니다.
  • BlobContainerClient: BlobContainerClient 클래스를 사용하면 Azure Storage 컨테이너 및 해당 Blob을 조작할 수 있습니다.
  • BlobClient: BlobClient 클래스를 사용하면 Azure Storage Blob을 조작할 수 있습니다.
  • BlobItem: BlobItem 클래스는 listBlobs 호출에서 반환된 개별 Blob을 나타냅니다.

코드 예제

이러한 예제 코드 조각은 Java용 Azure Blob Storage 클라이언트 라이브러리를 사용하여 다음한 작업을 수행하는 방법을 보여줍니다.

Important

설정 섹션에 설명된 대로 pom.xml에 올바른 종속성과 코드 샘플이 작동하는 데 필요한 지시문이 있는지 확인합니다.

참고 항목

Azure 개발자 CLI 템플릿에는 샘플 코드가 이미 있는 파일이 포함되어 있습니다. 다음 예제에서는 샘플 코드의 각 부분에 대한 세부 정보를 제공합니다. 템플릿은 Azure 인증 섹션에 설명된 대로 권장되는 암호 없는 인증 방법을 구현합니다. 연결 문자열 메서드는 대안으로 표시되지만 템플릿에서 사용되지 않으며 프로덕션 코드에는 권장되지 않습니다.

Azure에 인증하고 Blob 데이터에 대한 액세스 권한 부여

Azure Blob Storage에 대한 애플리케이션 요청에 대한 권한을 부여해야 합니다. Azure.Identity 클라이언트 라이브러리에서 제공하는 DefaultAzureCredential 클래스를 사용하는 것은 Blob Storage를 포함하여 코드에서 Azure 서비스에 대한 암호 없는 연결을 구현하는 데 권장되는 방법입니다.

또한 계정 액세스 키를 사용하여 Azure Blob Storage 요청에 대한 권한을 부여할 수 있습니다. 그러나 이 방법은 신중하게 사용해야 합니다. 개발자는 액세스 키를 안전하지 않은 위치에 노출하지 않도록 끊임없이 노력해야 합니다. 액세스 키가 있는 사람은 누구나 스토리지 계정에 대한 요청에 권한을 부여할 수 있으며 모든 데이터에 효과적으로 액세스할 수 있습니다. DefaultAzureCredential은 암호 없는 인증을 허용하기 위해 계정 키보다 향상된 관리 및 보안 이점을 제공합니다. 두 옵션 모두에 대해 다음 예에서 설명하고 있습니다.

DefaultAzureCredential은 Java용 Azure ID 클라이언트 라이브러리에서 제공하는 클래스입니다. DefaultAzureCredential은 여러 인증 방법을 지원하고 런타임에 사용해야 하는 방법을 결정합니다. 이 방법을 사용하면 앱에서 환경별 코드를 구현하지 않고도 다양한 환경(로컬 및 프로덕션)에서 다양한 인증 방법을 사용할 수 있습니다.

DefaultAzureCredential에서 자격 증명을 찾는 순서와 위치는 Azure ID 라이브러리 개요에서 확인할 수 있습니다.

예를 들어 로컬로 개발할 때 앱에서 Visual Studio Code 로그인 자격 증명을 사용하여 인증할 수 있습니다. 그러면 앱이 Azure에 배포되면 관리 ID를 사용할 수 있습니다. 이 전환에서는 코드를 변경할 필요가 없습니다.

Microsoft Entra 사용자 계정에 역할 할당

로컬로 개발하는 경우 Blob 데이터에 액세스하는 사용자 계정에 올바른 권한이 있는지 확인합니다. Blob 데이터를 읽고 쓰려면 Storage Blob 데이터 참가자가 필요합니다. 이 역할을 자신에게 할당하려면 사용자 액세스 관리자 역할 또는 Microsoft.Authorization/roleAssignments/write 작업을 포함하는 다른 역할이 필요합니다. Azure Portal, Azure CLI 또는 Azure PowerShell을 사용하여 사용자에게 Azure RBAC 역할을 할당할 수 있습니다. 범위 개요 페이지에서 역할 할당에 사용할 수 있는 범위에 대해 자세히 알아볼 수 있습니다.

이 시나리오에서는 최소 권한 원칙을 따르기 위해 범위가 스토리지 계정으로 지정된 사용자 계정에 권한을 할당합니다. 이 방법은 사용자에게 필요한 최소 권한만 부여하고 더 안전한 프로덕션 환경을 만듭니다.

다음 예제에서는 스토리지 계정의 Blob 데이터에 대한 읽기 및 쓰기 액세스를 모두 제공하는 Storage Blob 데이터 참가자 역할을 사용자 계정에 할당합니다.

Important

대부분의 경우 Azure에서 역할 할당이 전파되는 데 1~2분이 걸리지만 드문 경우이지만 최대 8분이 걸릴 수 있습니다. 코드를 처음 실행할 때 인증 오류가 발생하면 잠시 기다렸다가 다시 시도하세요.

  1. Azure Portal에서 기본 검색 창 또는 왼쪽 탐색 영역을 사용하여 스토리지 계정을 찾습니다.

  2. 스토리지 계정 개요 페이지의 왼쪽 메뉴에서 액세스 제어(IAM)를 선택합니다.

  3. 액세스 제어(IAM) 페이지에서 역할 할당 탭을 선택합니다.

  4. 위쪽 메뉴에서 + 추가를 선택한 다음, 드롭다운 메뉴에서 역할 할당 추가를 선택합니다.

    A screenshot showing how to assign a role.

  5. 검색 상자를 사용하여 결과를 원하는 역할로 필터링합니다. 이 예에서는 Storage Blob 데이터 기여자를 검색하고, 일치하는 결과를 선택하고, 다음을 선택합니다.

  6. 다음에 대한 액세스 할당 아래에서 사용자, 그룹 또는 서비스 주체를 선택한 다음, + 멤버 선택을 선택합니다.

  7. 대화 상자에서 Microsoft Entra 사용자 이름(일반적으로 user@domain 이메일 주소)을 검색한 다음 대화 상자 하단에서 선택을 선택합니다.

  8. 검토 + 할당을 선택하여 최종 페이지로 이동한 다음, 검토 + 할당을 다시 선택하여 프로세스를 완료합니다.

DefaultAzureCredential을 사용하여 Azure에 로그인하고 앱 코드를 연결

다음 단계를 사용하여 스토리지 계정의 데이터에 대한 액세스 권한을 부여할 수 있습니다.

  1. 스토리지 계정에서 역할을 할당한 것과 동일한 Microsoft Entra 계정을 사용하여 인증되는지 확인합니다. Azure CLI, Visual Studio Code 또는 Azure PowerShell을 통해 인증할 수 있습니다.

    다음 명령을 사용하여 Azure CLI를 통해 Azure에 로그인합니다.

    az login
    
  2. DefaultAzureCredential을 사용하려면 azure-identity 종속성이 pom.xml에 추가되었는지 확인합니다.

    <dependency>
      <groupId>com.azure</groupId>
      <artifactId>azure-identity</artifactId>
    </dependency>
    
  3. 이 코드를 Main 메서드에 추가합니다. 코드가 로컬 워크스테이션에서 실행되면 Azure CLI 또는 Visual Studio Code와 같이 로그인한 우선 순위가 지정된 도구의 개발자 자격 증명을 사용하여 Azure에 인증합니다.

    /*
     * The default credential first checks environment variables for configuration
     * If environment configuration is incomplete, it will try managed identity
     */
    DefaultAzureCredential defaultCredential = new DefaultAzureCredentialBuilder().build();
    
    // Azure SDK client builders accept the credential as a parameter
    // TODO: Replace <storage-account-name> with your actual storage account name
    BlobServiceClient blobServiceClient = new BlobServiceClientBuilder()
            .endpoint("https://<storage-account-name>.blob.core.windows.net/")
            .credential(defaultCredential)
            .buildClient();
    
  4. BlobServiceClient의 URI에서 스토리지 계정 이름을 업데이트해야 합니다. 스토리지 계정 이름은 Azure Portal의 개요 페이지에서 찾을 수 있습니다.

    A screenshot showing how to find the storage account name.

    참고 항목

    Azure에 배포하는 경우 이 동일한 코드를 사용하여 Azure에서 실행되는 애플리케이션에서 Azure Storage 요청에 대한 권한을 부여할 수 있습니다. 그러나 Azure의 앱에서 관리 ID를 사용하도록 설정해야 합니다. 그런 다음, 해당 관리 ID에서 연결할 수 있도록 스토리지 계정을 구성합니다. 이 연결을 Azure 서비스 간에 구성하는 방법에 대한 자세한 지침은 Azure 호스팅 앱에서 인증 자습서를 참조하세요.

컨테이너 만들기

개체에서 createBlobContainer 메서드를 호출하여 스토리지 계정에 새 컨테이너를 blobServiceClient 만듭니다. 이 예제에서 코드는 컨테이너 이름이 고유하도록 GUID 값을 추가합니다.

이 코드를 Main 메서드의 끝에 추가합니다.

// Create a unique name for the container
String containerName = "quickstartblobs" + java.util.UUID.randomUUID();

// Create the container and return a container client object
BlobContainerClient blobContainerClient = blobServiceClient.createBlobContainer(containerName);

컨테이너를 만드는 방법에 대해 자세히 알아보고 더 많은 코드 샘플을 살펴보려면 Java를 사용하여 Blob 컨테이너 만들기를 참조하세요.

Important

컨테이너 이름은 소문자여야 합니다. 컨테이너 및 Blob 이름 지정에 대한 자세한 내용은 컨테이너, Blob, 메타데이터 이름 지정 및 참조를 참조하세요.

컨테이너에 Blob 업로드

uploadFromFile 메서드를 호출하여 컨테이너에 Blob을 업로드합니다. 예제 코드는 로컬 data 디렉터리에 컨테이너에 업로드할 텍스트 파일을 만듭니다.

이 코드를 Main 메서드의 끝에 추가합니다.

// Create the ./data/ directory and a file for uploading and downloading
String localPath = "./data/";
new File(localPath).mkdirs();
String fileName = "quickstart" + java.util.UUID.randomUUID() + ".txt";

// Get a reference to a blob
BlobClient blobClient = blobContainerClient.getBlobClient(fileName);

// Write text to the file
FileWriter writer = null;
try
{
    writer = new FileWriter(localPath + fileName, true);
    writer.write("Hello, World!");
    writer.close();
}
catch (IOException ex)
{
    System.out.println(ex.getMessage());
}

System.out.println("\nUploading to Blob storage as blob:\n\t" + blobClient.getBlobUrl());

// Upload the blob
blobClient.uploadFromFile(localPath + fileName);

Blob 업로드에 대해 자세히 알아보고 더 많은 코드 샘플을 살펴보려면 Java를 사용하여 Blob 업로드를 참조하세요.

컨테이너의 Blob 나열

listBlobs 메서드를 호출하여 컨테이너의 blob을 나열합니다. 이 경우 하나의 Blob만 컨테이너에 추가되었으므로 나열된 작업은 하나의 해당 Blob만 반환합니다.

이 코드를 Main 메서드의 끝에 추가합니다.

System.out.println("\nListing blobs...");

// List the blob(s) in the container.
for (BlobItem blobItem : blobContainerClient.listBlobs()) {
    System.out.println("\t" + blobItem.getName());
}

Blob을 나열하고 더 많은 코드 샘플을 탐색하는 방법에 대해 자세히 알아보려면 Java를 사용하여 Blob 나열을 참조하세요.

Blob 다운로드

downloadToFile 메서드를 호출하여 이전에 만든 blob을 다운로드합니다. 예제 코드는 로컬 파일 시스템에서 두 파일을 볼 수 있도록 파일 이름에 "DOWNLOAD" 접미사를 추가합니다.

이 코드를 Main 메서드의 끝에 추가합니다.

// Download the blob to a local file

// Append the string "DOWNLOAD" before the .txt extension for comparison purposes
String downloadFileName = fileName.replace(".txt", "DOWNLOAD.txt");

System.out.println("\nDownloading blob to\n\t " + localPath + downloadFileName);

blobClient.downloadToFile(localPath + downloadFileName);

Blob 다운로드에 대해 자세히 알아보고 더 많은 코드 샘플을 살펴보려면 Java를 사용하여 Blob 다운로드를 참조하세요.

컨테이너 삭제

다음 코드는 delete 메서드로 전체 컨테이너를 제거하여 앱이 만든 리소스를 정리합니다. 또한 앱에서 만든 로컬 파일도 삭제합니다.

앱은 blob, 컨테이너 및 로컬 파일을 삭제하기 전에 System.console().readLine()을 호출하여 사용자 입력을 일시 중지합니다. 리소스를 삭제하기 전에 올바르게 만들어졌는지 확인하는 것이 좋습니다.

이 코드를 Main 메서드의 끝에 추가합니다.

File downloadedFile = new File(localPath + downloadFileName);
File localFile = new File(localPath + fileName);

// Clean up resources
System.out.println("\nPress the Enter key to begin clean up");
System.console().readLine();

System.out.println("Deleting blob container...");
blobContainerClient.delete();

System.out.println("Deleting the local source and downloaded files...");
localFile.delete();
downloadedFile.delete();

System.out.println("Done");

컨테이너 삭제에 대해 자세히 알아보고 더 많은 코드 샘플을 살펴보려면 Java를 사용하여 Blob 컨테이너 삭제 및 복원을 참조하세요.

코드 실행

이 앱은 로컬 폴더에 테스트 파일을 만들고 Blob 스토리지에 업로드합니다. 그런 다음, 컨테이너에 Blob을 나열하고 이전 파일과 새 파일을 비교할 수 있도록 새 이름으로 해당 파일을 다운로드합니다.

다음 단계에 따라 코드를 컴파일, 패키지 및 실행합니다.

  1. pom.xml 파일이 포함된 디렉터리로 이동한 후 다음 mvn 명령을 사용하여 프로젝트를 컴파일합니다.
    mvn compile
    
  2. 컴파일된 코드를 배포 가능한 형식으로 패키지합니다.
    mvn package
    
  3. 다음 mvn 명령을 실행하여 앱을 실행합니다.
    mvn exec:java -D exec.mainClass=com.blobs.quickstart.App -D exec.cleanupDaemonThreads=false
    
    실행 단계를 간소화하기 위해 exec-maven-pluginpom.xml에 추가하고 아래와 같이 구성할 수 있습니다.
    <plugin>
      <groupId>org.codehaus.mojo</groupId>
      <artifactId>exec-maven-plugin</artifactId>
      <version>1.4.0</version>
      <configuration>
        <mainClass>com.blobs.quickstart.App</mainClass>
        <cleanupDaemonThreads>false</cleanupDaemonThreads>
      </configuration>
    </plugin>
    
    이 구성을 사용하면 다음 명령을 사용하여 앱을 실행할 수 있습니다.
    mvn exec:java
    

앱의 출력은 다음 예제와 유사합니다(가독성을 위해 UUID 값이 생략됨).

Azure Blob Storage - Java quickstart sample

Uploading to Blob storage as blob:
        https://mystorageacct.blob.core.windows.net/quickstartblobsUUID/quickstartUUID.txt

Listing blobs...
        quickstartUUID.txt

Downloading blob to
        ./data/quickstartUUIDDOWNLOAD.txt

Press the Enter key to begin clean up

Deleting blob container...
Deleting the local source and downloaded files...
Done

정리 프로세스를 시작하기 전에 data 폴더에서 두 파일을 확인합니다. 이를 비교하여 동일한지 확인할 수 있습니다.

리소스 정리

파일을 확인하고 테스트를 완료한 후 Enter 키를 눌러 스토리지 계정에서 만든 컨테이너와 함께 테스트 파일을 삭제합니다. Azure CLI를 사용하여 리소스를 삭제할 수도 있습니다.

빠른 시작을 마치면 다음 명령을 실행하여 만든 리소스를 정리할 수 있습니다.

azd down

리소스를 삭제할지 확인하는 메시지가 표시됩니다. y 키를 눌러 확인합니다.

다음 단계

이 빠른 시작에서는 Java를 사용하여 Blob을 업로드, 다운로드 및 나열하는 방법을 배웠습니다.

Blob 스토리지 샘플 앱을 보려면 다음을 계속 진행합니다.