Rychlý start: Klientská knihovna azure Blob Storage pro Javu

V tomto článku provedete instalaci balíčku a vyzkoušení ukázkového kódu pro základní úlohy.

V tomto článku pomocí Azure Developer CLI nasadíte prostředky Azure a spustíte dokončenou konzolovou aplikaci pomocí několika příkazů.

• Účet Azure s aktivním předplatným – bezplatné vytvoření účtu
• Účet azure Storage – vytvořte účet úložiště.
• Java Development Kit (JDK) verze 8 nebo novější
• Apache Maven

• Předplatné Azure – vytvoření bezplatného předplatného
• Java Development Kit (JDK) verze 8 nebo novější
• Apache Maven
• Azure Developer CLI

Tato část vás provede přípravou projektu pro práci s klientskou knihovnou Azure Blob Storage pro Javu.

Vytvoření projektu

Vytvořte aplikaci v Javě s názvem blob-quickstart.

1. V okně konzoly (například PowerShell nebo Bash) pomocí Mavenu vytvořte novou konzolovou aplikaci s názvem blob-quickstart. Zadáním následujícího příkazu mvn vytvořte "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. Výstup z generování projektu by měl vypadat přibližně takto:

   [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. Přepněte do nově vytvořené složky blob-quickstart .

   cd blob-quickstart
   

4. Na straně adresáře blob-quickstart vytvořte další adresář s názvem data. V této složce se vytvoří a uloží datové soubory objektů blob.

   mkdir data
   

Instalace balíčků

Otevřete soubor v textovém pom.xml editoru.

Přidejte azure-sdk-bom , abyste mohli využívat závislost na nejnovější verzi knihovny. V následujícím fragmentu {bom_version_to_target} kódu nahraďte zástupný symbol číslem verze. Použití azure-sdk-bom vám umožní určit verzi jednotlivých závislostí. Další informace o kusovníku najdete v souboru README pro 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>

Potom do skupiny závislostí přidejte následující prvky závislostí. Závislost azure-identity je potřebná pro připojení bez hesla ke službám Azure.

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

Nastavení architektury aplikace

V adresáři projektu vytvořte základní strukturu aplikace podle kroků:

1. Přejděte do adresáře /src/main/java/com/blobs/quickstart .
2. Otevření souboru v editoru App.java
3. Odstranění řádku System.out.println("Hello world!");
4. Přidání nezbytných import direktiv

Kód by měl vypadat přibližně takto:

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

S nainstalovaným rozhraním příkazového řádku Azure Developer CLI můžete vytvořit účet úložiště a spustit ukázkový kód pomocí několika příkazů. Projekt můžete spustit v místním vývojovém prostředí nebo v devContaineru.

Inicializace šablony Azure Developer CLI a nasazení prostředků

Z prázdného adresáře pomocí těchto kroků inicializujete azd šablonu, zřídíte prostředky Azure a začnete s kódem:

• Naklonujte prostředky úložiště pro rychlý start z GitHubu a inicializujte šablonu místně:

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

  Zobrazí se výzva k zadání následujících informací:

  • Název prostředí: Tato hodnota se používá jako předpona pro všechny prostředky Azure vytvořené pomocí Azure Developer CLI. Název musí být jedinečný pro všechna předplatná Azure a musí mít délku 3 až 24 znaků. Název může obsahovat pouze číslice a malá písmena.

• Přihlaste se k Azure:

  azd auth login
  

• Zřízení a nasazení prostředků do Azure:

  azd up
  

  Zobrazí se výzva k zadání následujících informací:

  • Předplatné: Předplatné Azure, do kterého jsou vaše prostředky nasazené.
  • Umístění: Oblast Azure, ve které jsou vaše prostředky nasazené.

  Dokončení nasazení může trvat několik minut. Výstup příkazu azd up obsahuje název nově vytvořeného účtu úložiště, který budete později potřebovat ke spuštění kódu.

Spuštění ukázkového kódu

V tomto okamžiku se prostředky nasadí do Azure a kód je téměř připravený ke spuštění. Následujícím postupem aktualizujte název účtu úložiště v kódu a spusťte ukázkovou konzolovou aplikaci:

• Aktualizujte název účtu úložiště:
  1. V místním adresáři přejděte do adresáře blob-quickstart/src/main/java/com/blobs/quickstart .
  2. Otevřete soubor s názvem App.java v editoru. <storage-account-name> Vyhledejte zástupný symbol a nahraďte ho skutečným názvem účtu úložiště vytvořeného příkazemazd up.
  3. Uložte změny.
• Spusťte projekt:
  1. Přejděte do adresáře rychlého startu objektu blob obsahujícího pom.xml soubor. Zkompilujte projekt pomocí následujícího mvn příkazu:

     mvn compile
     

  2. Zabalte kompilovaný kód v distribuovatelném formátu:

     mvn package
     

  3. Spuštěním následujícího mvn příkazu spusťte aplikaci:

     mvn exec:java
     

• Prohlédněte si výstup: Tato aplikace vytvoří testovací soubor ve složce místních dat a nahraje ho do kontejneru v účtu úložiště. Příklad pak vypíše objekty blob v kontejneru a stáhne soubor s novým názvem, abyste mohli porovnat staré a nové soubory.

Další informace o tom, jak ukázkový kód funguje, najdete v příkladech kódu.

Po dokončení testování kódu se podívejte do části Vyčištění prostředků a odstraňte prostředky vytvořené příkazem azd up .

Přidejte tento kód na konec Main metody:

Přidejte tento kód na konec Main metody:

Přidejte tento kód na konec Main metody:

Přidejte tento kód na konec Main metody:

Přidejte tento kód na konec Main metody:

Spuštění kódu

Tato aplikace vytvoří testovací soubor ve vaší místní složce a nahraje ho do úložiště objektů blob. Příklad pak vypíše objekty blob v kontejneru a stáhne soubor s novým názvem, abyste mohli porovnat staré a nové soubory.

Podle kroků zkompilujte, zabalte a spusťte kód.

1. Pomocí následujícího mvn příkazu přejděte do adresáře obsahujícího pom.xml soubor a zkompilujte projekt:

   mvn compile
   

2. Zabalte kompilovaný kód v distribuovatelném formátu:

   mvn package
   

3. Spuštěním následujícího mvn příkazu spusťte aplikaci:

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

   Pokud chcete zjednodušit krok spuštění, můžete ho přidat exec-maven-pluginpom.xml a nakonfigurovat, jak je znázorněno níže:

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

   S touto konfigurací můžete aplikaci spustit pomocí následujícího příkazu:

   mvn exec:java
   

Výstup aplikace je podobný následujícímu příkladu (hodnoty UUID vynechané pro čitelnost):

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

Než začnete s procesem čištění, zkontrolujte , jestli složka dat obsahuje dva soubory. Můžete je porovnat a sledovat, že jsou identické.

Po ověření souborů a dokončení testování stisknutím klávesy Enter odstraňte testovací soubory spolu s kontejnerem, který jste vytvořili v účtu úložiště. K odstranění prostředků můžete použít také Azure CLI .

Po dokončení tohoto rychlého startu můžete vyčistit prostředky, které jste vytvořili, spuštěním následujícího příkazu:

azd down

Zobrazí se výzva k potvrzení odstranění prostředků. Potvrďte akci zadáním y .