Szybki start: biblioteka klienta usługi Azure Blob Storage dla środowiska Java SE

W tym artykule wykonasz kroki, aby zainstalować pakiet i wypróbować przykładowy kod dla podstawowych zadań.

W tym artykule użyjesz Azure Developer CLI, aby wdrożyć zasoby Azure i uruchomić gotową aplikację konsolową, wykorzystując tylko kilka poleceń.

• Konto platformy Azure z aktywną subskrypcją — utwórz bezpłatne konto
• Konto usługi Azure Storage — tworzenie konta magazynu.
• Java Development Kit (JDK) wersja 1.8_101 lub nowsza
• Apache Maven

• Subskrypcja platformy Azure — utwórz jedną bezpłatnie
• Java Development Kit (JDK) wersja 1.8_101 lub nowsza
• Apache Maven
• Interfejs wiersza polecenia dla deweloperów platformy Azure

Ta sekcja przeprowadzi Cię przez proces przygotowywania projektu do pracy z biblioteką klienta usługi Azure Blob Storage dla języka Java.

Tworzenie projektu

Utwórz aplikację Java o nazwie blob-quickstart.

1. W oknie konsoli (takim jak program PowerShell lub powłoka Bash) użyj narzędzia Maven, aby utworzyć nową aplikację konsolową z nazwą blob-quickstart. Wpisz następujące polecenie mvn , aby utworzyć "Hello world!" Projekt Java.

   • PowerShell
   • Bash

   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. Przeanalizuj wyniki generowania projektu.

   [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. Przejdź do nowo utworzonego folderu blob-quickstart .

   cd blob-quickstart
   

4. W katalogu blob-quickstart utwórz kolejny katalog o nazwie data. W tym folderze tworzone i przechowywane są pliki danych blob.

   mkdir data
   

Instalowanie pakietów

pom.xml Otwórz plik w edytorze tekstów.

Dodaj azure-sdk-bom , aby uzyskać zależność od najnowszej wersji biblioteki. W poniższym fragmencie kodu zastąp {bom_version_to_target} symbol zastępczy numerem wersji. Używając azure-sdk-bom, nie musisz określać wersji każdej zależności indywidualnie. Aby dowiedzieć się więcej na temat BOM, zobacz README BOM Azure SDK.

<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>

Następnie dodaj następujące elementy zależności do grupy zależności. Potrzebujesz zależności Azure-identity do połączeń bezhasłowych z usługami Azure.

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

Konfigurowanie struktury aplikacji

W katalogu projektu wykonaj następujące kroki, aby utworzyć podstawową strukturę aplikacji:

1. Przejdź do katalogu /src/main/java/com/blobs/quickstart
2. App.java Otwórz plik w edytorze
3. Usuwanie wiersza System.out.println("Hello world!");
4. Dodaj niezbędne dyrektywy import

Kod powinien przypominać następującą strukturę:

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
    }
}

Korzystając z CLI dla deweloperów Azure, możesz utworzyć konto pamięci masowej i uruchomić przykładowy kod za pomocą kilku poleceń. Możesz uruchomić projekt w lokalnym środowisku deweloperskim lub w DevContainer.

Inicjowanie szablonu interfejsu wiersza polecenia dewelopera platformy Azure i wdrażanie zasobów

W pustym katalogu wykonaj następujące kroki, aby zainicjować azd szablon, aprowizować zasoby platformy Azure i rozpocząć pracę z kodem:

• Sklonuj zasoby repozytorium szybkiego startu z usługi GitHub i zainicjuj szablon lokalnie:

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

  Zostanie wyświetlony monit o podanie następujących informacji:

  • Nazwa środowiska: interfejs wiersza polecenia Azure Developer CLI używa tej wartości jako prefiksu dla wszystkich zasobów Azure, które tworzy. Nazwa musi być unikatowa we wszystkich subskrypcjach Azure i mieć długość od 3 do 24 znaków. Nazwa może zawierać tylko cyfry i małe litery.

• Zaloguj się do platformy Azure:

  azd auth login
  

• Aprowizuj i wdróż zasoby na platformie Azure:

  azd up
  

  Zostanie wyświetlony monit o podanie następujących informacji:

  • Subskrypcja: Subskrypcja platformy Azure służąca do wdrażania twoich zasobów.
  • Lokalizacja: Region Azure używany do wdrażania zasobów.

  Ukończenie wdrożenia może potrwać kilka minut. Dane wyjściowe z polecenia azd up zawierają nazwę nowo utworzonego konta magazynu danych, która będzie później potrzebna, aby uruchomić kod.

Uruchamianie przykładowego kodu

Na tym etapie zasoby są wdrażane na platformie Azure, a kod jest prawie gotowy do uruchomienia. Wykonaj następujące kroki, aby zaktualizować nazwę konta przechowywania w kodzie i uruchomić przykładową aplikację konsolową:

• Zaktualizuj nazwę konta przechowywania
  1. W katalogu lokalnym przejdź do katalogu blob-quickstart/src/main/java/com/blobs/quickstart .
  2. Otwórz plik o nazwie App.java w edytorze. Znajdź symbol zastępczy <storage-account-name> i zastąp go rzeczywistą nazwą konta magazynu utworzonego przez polecenie azd up.
  3. Zapisz zmiany.
• Uruchom projekt:
  1. Przejdź do katalogu blob-quickstart zawierającego pom.xml plik. Skompiluj projekt przy użyciu następującego mvn polecenia:

     mvn compile
     

  2. Spakuj skompilowany kod w formacie dystrybucyjnym:

     mvn package
     

  3. Uruchom następujące mvn polecenie, aby wykonać aplikację:

     mvn exec:java
     

• Obserwuj wynik: Ta aplikacja tworzy plik testowy w lokalnym folderze danych i przesyła go do kontenera na koncie przechowywania. Przykład następnie wymienia obiekty blob w kontenerze i pobiera plik z nową nazwą, aby można było porównać stare i nowe pliki.

Aby dowiedzieć się więcej o sposobie działania przykładowego kodu, zobacz Przykłady kodu.

Po zakończeniu testowania kodu zobacz sekcję Czyszczenie zasobów , aby usunąć zasoby utworzone za azd up pomocą polecenia .

Dodaj ten kod na końcu main metody:

Dodaj ten kod na końcu main metody:

Dodaj ten kod na końcu main metody:

Dodaj ten kod na końcu main metody:

Dodaj ten kod na końcu main metody:

Uruchamianie kodu

Ta aplikacja tworzy plik testowy w folderze lokalnym i przekazuje go do usługi Blob Storage. Przykład następnie wymienia obiekty blob w kontenerze i pobiera plik z nową nazwą, aby można było porównać stare i nowe pliki.

Postępuj zgodnie z następującymi krokami, aby skompilować, zapakować i uruchomić kod:

1. Przejdź do katalogu zawierającego pom.xml plik i skompiluj projekt przy użyciu następującego mvn polecenia:

   mvn compile
   

2. Spakuj skompilowany kod w formacie dystrybucyjnym:

   mvn package
   

3. Uruchom następujące mvn polecenie, aby wykonać aplikację:

   mvn exec:java -D exec.mainClass=com.blobs.quickstart.App -D exec.cleanupDaemonThreads=false
   

   Aby uprościć krok uruchamiania, dodaj exec-maven-plugin do pom.xml i skonfiguruj go w sposób pokazany w poniższym kodzie:

   <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>
   

   W tej konfiguracji uruchom aplikację za pomocą następującego polecenia:

   mvn exec:java
   

Dane wyjściowe aplikacji są podobne do następujących przykładów (wartości UUID pominięte w celu zapewnienia czytelności):

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

Przed rozpoczęciem procesu oczyszczania sprawdź, czy folder danych zawiera dwa pliki. Można je porównać i zaobserwować, że są identyczne.

Po zweryfikowaniu plików i zakończeniu testowania naciśnij klawisz Enter , aby usunąć pliki testowe wraz z kontenerem utworzonym na koncie magazynu. Możesz również użyć interfejsu wiersza polecenia platformy Azure, aby usunąć zasoby.

Po zakończeniu pracy z przewodnikiem Szybki start wyczyść utworzone zasoby, uruchamiając następujące polecenie:

azd down

Otrzymujesz komunikat potwierdzający usunięcie zasobów. Wprowadź , y aby potwierdzić.