빠른 시작: Java Durable Functions 앱 만들기

프로젝트에 필요한 종속성 및 플러그인 추가

pom.xml 파일에 다음 코드를 추가합니다.

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

함수 만들기

다음 샘플 코드는 각 함수 유형의 기본적인 예를 보여줍니다.

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 앱의 기본 함수를 포함하는 프로젝트를 생성합니다.

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 앱에 있는 세 가지 함수가 포함된 로컬 프로젝트가 생성되었습니다.

com.microsoft:durabletask-azure-functions가 pom.xml 파일에서 종속성으로 설정되어 있는지 확인합니다.

백 엔드 스토리지 공급자 구성

Durable Functions에서 런타임 상태를 저장하려면 저장소 공급자가 필요합니다. local.settings.json에서 Azure Storage를 스토리지 공급자로 설정할 수 있습니다. 다음 예와 같이 Azure Storage 계정의 연결 문자열을 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. 프롬프트에서 다음 정보를 제공합니다.

   프롬프트	작업
   언어 선택	Java를 선택합니다.
   Java 버전 선택	Java 8 이상을 선택합니다. Azure에서 함수가 실행되는 Java 버전과 로컬에서 확인한 버전을 선택합니다.
   그룹 ID 제공	com.function을 입력합니다.
   아티팩트 ID 제공	myDurableFunction을 입력합니다.
   버전 제공	1.0-SNAPSHOT을 입력합니다.
   패키지 이름 제공	com.function을 입력합니다.
   앱 이름 제공	myDurableFunction을 입력합니다.
   Java 프로젝트에 대한 빌드 도구 선택	Maven을 선택합니다.
   프로젝트를 여는 방법 선택	새 창에서 열기를 선택합니다.

이제 예시 HTTP 함수가 포함된 프로젝트가 생성되었습니다. 다음 단계에서 Durable Functions 앱의 기본 함수를 추가하므로 원하는 경우 이 함수를 제거해도 됩니다.

프로젝트 항목에 함수 추가

1. 명령 팔레트에서 Azure Functions: 함수 만들기를 입력한 다음 선택합니다.

2. 템플릿 필터 변경에서 모두를 선택합니다.

3. 프롬프트에서 다음 정보를 제공합니다.

   프롬프트	작업
   함수의 템플릿 선택	DurableFunctionsOrchestration을 선택합니다.
   패키지 이름 제공	com.function을 입력합니다.
   함수 이름 제공	DurableFunctionsOrchestrator를 입력합니다.

4. 대화 상자에서 스토리지 계정 선택을 선택하여 스토리지 계정을 설정한 다음, 프롬프트를 따릅니다.

이제 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.json 파일에 extensions 속성을 추가합니다.

"extensions": { "durableTask": { "hubName": "JavaTestHub" }}