クイックスタート: Java Durable Functions アプリを作成する

必要な依存関係とプラグインをプロジェクトに追加する

pom.xml ファイルに次のコードを追加します。 コピーする前に、 your-unique-app-name をグローバルに一意の関数アプリ名に置き換えます。 環境に合わせて region、 javaVersion、 resourceGroup を調整します。

<properties>
  <azure.functions.maven.plugin.version>1.18.0</azure.functions.maven.plugin.version>
  <azure.functions.java.library.version>3.0.0</azure.functions.java.library.version>
  <durabletask.azure.functions>1.0.0</durabletask.azure.functions>
  <functionAppName>your-unique-app-name</functionAppName>
</properties>

<dependencies>
  <dependency>
    <groupId>com.microsoft.azure.functions</groupId>
    <artifactId>azure-functions-java-library</artifactId>
    <version>${azure.functions.java.library.version}</version>
  </dependency>
  <dependency>
    <groupId>com.microsoft</groupId>
    <artifactId>durabletask-azure-functions</artifactId>
    <version>${durabletask.azure.functions}</version>
  </dependency>
</dependencies>

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>3.8.1</version>
    </plugin>
    <plugin>
      <groupId>com.microsoft.azure</groupId>
      <artifactId>azure-functions-maven-plugin</artifactId>
      <version>${azure.functions.maven.plugin.version}</version>
      <configuration>
        <appName>${functionAppName}</appName>
        <resourceGroup>java-functions-group</resourceGroup>
        <appServicePlanName>java-functions-app-service-plan</appServicePlanName>
        <region>westus</region>
        <runtime>
          <os>windows</os>
          <javaVersion>11</javaVersion>
        </runtime>
        <appSettings>
          <property>
            <name>FUNCTIONS_EXTENSION_VERSION</name>
            <value>~4</value>
          </property>
        </appSettings>
      </configuration>
      <executions>
        <execution>
          <id>package-functions</id>
          <goals>
            <goal>package</goal>
          </goals>
        </execution>
      </executions>
    </plugin>
    <plugin>
      <artifactId>maven-clean-plugin</artifactId>
      <version>3.1.0</version>
    </plugin>
  </plugins>
</build>

必要な JSON ファイルを追加する

host.json ファイルをプロジェクト ディレクトリに追加します。 次の例のように表示されます。

{
  "version": "2.0",
  "logging": {
    "logLevel": {
      "DurableTask.AzureStorage": "Warning",
      "DurableTask.Core": "Warning"
    }
  },
  "extensions": {
    "durableTask": {
      "hubName": "JavaTestHub"
    }
  },
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.*, 5.0.0)"
  }
}

Durable Functions には、ランタイム状態を格納するためのストレージ プロバイダーが必要です。 local.settings.json ファイルをプロジェクト ディレクトリに追加して、ストレージ プロバイダーを構成します。 プロバイダーとして Azure Storage を使用するには、AzureWebJobsStorage の値を Azure Storage アカウントの接続文字列に設定します。

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "<your storage account connection string>",
    "FUNCTIONS_WORKER_RUNTIME": "java"
  }
}

Durable Functions オーケストレーター、アクティビティ、クライアント関数を作成する

次のサンプル コードは、各種類の関数の基本的な例を示しています。

import com.microsoft.azure.functions.annotation.*;
import com.microsoft.azure.functions.*;
import java.util.*;

import com.microsoft.durabletask.*;
import com.microsoft.durabletask.azurefunctions.DurableActivityTrigger;
import com.microsoft.durabletask.azurefunctions.DurableClientContext;
import com.microsoft.durabletask.azurefunctions.DurableClientInput;
import com.microsoft.durabletask.azurefunctions.DurableOrchestrationTrigger;

public class DurableFunctionsSample {
    /**
     * This HTTP-triggered function starts the orchestration.
     */
    @FunctionName("StartOrchestration")
    public HttpResponseMessage startOrchestration(
            @HttpTrigger(name = "req", methods = {HttpMethod.GET, HttpMethod.POST}, authLevel = AuthorizationLevel.ANONYMOUS) HttpRequestMessage<Optional<String>> request,
            @DurableClientInput(name = "durableContext") DurableClientContext durableContext,
            final ExecutionContext context) {
        context.getLogger().info("Java HTTP trigger processed a request.");

        DurableTaskClient client = durableContext.getClient();
        String instanceId = client.scheduleNewOrchestrationInstance("Cities");
        context.getLogger().info("Created new Java orchestration with instance ID = " + instanceId);
        return durableContext.createCheckStatusResponse(request, instanceId);
    }

    /**
     * This is the orchestrator function, which can schedule activity functions, create durable timers,
     * or wait for external events in a way that's completely fault-tolerant.
     */
    @FunctionName("Cities")
    public String citiesOrchestrator(
            @DurableOrchestrationTrigger(name = "taskOrchestrationContext") TaskOrchestrationContext ctx) {
        String result = "";
        result += ctx.callActivity("Capitalize", "Tokyo", String.class).await() + ", ";
        result += ctx.callActivity("Capitalize", "London", String.class).await() + ", ";
        result += ctx.callActivity("Capitalize", "Seattle", String.class).await() + ", ";
        result += ctx.callActivity("Capitalize", "Austin", String.class).await();
        return result;
    }

    /**
     * This is the activity function that is invoked by the orchestrator function.
     */
    @FunctionName("Capitalize")
    public String capitalize(@DurableActivityTrigger(name = "name") String name, final ExecutionContext context) {
        context.getLogger().info("Capitalizing: " + name);
        return name.toUpperCase();
    }
}

Maven コマンドを使用してローカル Durable Functions プロジェクトを作成する

次のコマンドを実行して、Durable Functions アプリの基本的な関数を持つプロジェクトを生成します。

mvn archetype:generate -DarchetypeGroupId=com.microsoft.azure -DarchetypeArtifactId=azure-functions-archetype -DarchetypeVersion=1.62 -Dtrigger=durablefunctions

mvn archetype:generate "-DarchetypeGroupId=com.microsoft.azure" "-DarchetypeArtifactId=azure-functions-archetype" "-DarchetypeVersion=1.62" "-Dtrigger=durablefunctions"

mvn archetype:generate "-DarchetypeGroupId=com.microsoft.azure" "-DarchetypeArtifactId=azure-functions-archetype" "-DarchetypeVersion=1.62" "-Dtrigger=durablefunctions"

プロンプトで、次の情報を指定します。

これで、基本的な Durable Functions アプリに含まれる 3 つの関数を持つローカル プロジェクトが作成されました。 アーキタイプには、com.microsoft:durabletask-azure-functionsの依存関係としてが自動的に含まれます。

Durable Functions用にバックエンド ストレージ プロバイダーを構成する

Durable Functions には、ランタイム状態を格納するためのストレージ プロバイダーが必要です。 local.settings.json 内で Azure Storage をストレージ プロバイダーとして設定することができます。 次の例のように、ご利用の Azure ストレージ アカウントの接続文字列を AzureWebJobsStorage に対する値として使用します。

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "<your storage account connection string>",
    "FUNCTIONS_WORKER_RUNTIME": "java"
  }
}

ローカル プロジェクトを作成する

1. Visual Studio Codeで F1 キーを押します (または Ctrl/Cmd + Shift + P キーを押して) コマンド パレットを開きます。 プロンプト (>) で、「Azure Functions: 新しいプロジェクトの作成を入力して選択します。

   

2. を選択し、を参照します。 [フォルダーの選択] ダイアログで、プロジェクトに使用するフォルダーに移動し、[選択] を選択します。

3. プロンプトで、次の情報を指定します。

   プロンプト	アクション
   Select a language (言語を指定してください)	Java を選択します。
   Java	Java 8 以降を選択します。 Azure 内で関数を実行する Java バージョンと、ローカルで検証したバージョンを選択します。
   Provide a group ID (グループ ID を指定してください)	「com.function」と入力します。
   Provide an artifact ID (成果物 ID を指定してください)	「myDurableFunction」と入力します。
   Provide a version (バージョンを指定してください)	「1.0-SNAPSHOT」と入力します。
   Provide a package name (パッケージ名を指定してください)	「com.function」と入力します。
   Provide an app name (アプリ名を指定してください)	「myDurableFunction」と入力します。
   Java プロジェクトのビルド ツールを選択します	[Maven] を選択します。
   プロジェクトを開く方法を選択してください	[新しいウィンドウで開く] を選択します。

これで HTTP 関数の例を含むプロジェクトが作成されました。 次の手順でDurable Functionsを追加するため、生成された HTTP 関数を削除できます。

プロジェクトへの関数の追加

1. コマンド パレットで、「Azure Functions: 関数の作成を入力して選択します。

2. [テンプレート フィルターの変更] では、[すべて] を選択します。

3. プロンプトで、次の情報を指定します。

   プロンプト	アクション
   関数のテンプレートを選択します	DurableFunctionsOrchestration を選択します。
   Provide a package name (パッケージ名を指定してください)	「com.function」と入力します。
   関数に名前を指定します	「DurableFunctionsOrchestrator」と入力します。

4. ダイアログで、[ストレージ アカウントの選択] を選択してストレージ アカウントを設定した後、プロンプトに従います。

これで、Durable Functions アプリの 3 つの基本的な関数が作成されたはずです。

Durable Functionsの pom.xml と host.json を構成する

pom.xml ファイルに次の依存関係を追加します。

<dependency>
  <groupId>com.microsoft</groupId>
  <artifactId>durabletask-azure-functions</artifactId>
  <version>1.0.0</version>
</dependency>

host.jsonextensions プロパティを追加します。 ファイルに既に他のプロパティがある場合は、 extensions ブロックを既存の JSON にマージします。

{
  "version": "2.0",
  "extensions": {
    "durableTask": {
      "hubName": "JavaTestHub"
    }
  },
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.*, 5.0.0)"
  }
}