Align Java API with other languages

mcruzdev · mcruzdev · commit f7ef1a9bda0f · 2025-09-20T16:56:55.000-03:00
Signed-off-by: Matheus Cruz &lt;matheuscruz.dev@gmail.com&gt;
diff --git a/daprdocs/content/en/java-sdk-docs/java-client/_index.md b/daprdocs/content/en/java-sdk-docs/java-client/_index.md
@@ -514,7 +514,7 @@ public class DemoWorkflowClient {
 
       System.out.println(separatorStr);
       System.out.println("**GetInstanceMetadata:Running Workflow**");
-      WorkflowInstanceStatus workflowMetadata = client.getInstanceState(instanceId, true);
+      WorkflowInstanceStatus workflowMetadata = client.getWorkflowState(instanceId, true);
       System.out.printf("Result: %s%n", workflowMetadata);
 
       System.out.println(separatorStr);
@@ -545,13 +545,13 @@ public class DemoWorkflowClient {
 
 
       System.out.println(separatorStr);
-      System.out.println("**WaitForInstanceCompletion**");
+      System.out.println("**waitForWorkflowCompletion**");
       try {
-        WorkflowInstanceStatus waitForInstanceCompletionResult =
-            client.waitForInstanceCompletion(instanceId, Duration.ofSeconds(60), true);
-        System.out.printf("Result: %s%n", waitForInstanceCompletionResult);
+        WorkflowInstanceStatus waitForWorkflowCompletionResult =
+            client.waitForWorkflowCompletion(instanceId, Duration.ofSeconds(60), true);
+        System.out.printf("Result: %s%n", waitForWorkflowCompletionResult);
       } catch (TimeoutException ex) {
-        System.out.printf("waitForInstanceCompletion has an exception:%s%n", ex);
+        System.out.printf("waitForWorkflowCompletion has an exception:%s%n", ex);
       }
 
       System.out.println(separatorStr);
diff --git a/daprdocs/content/en/java-sdk-docs/java-workflow/java-workflow-howto.md b/daprdocs/content/en/java-sdk-docs/java-workflow/java-workflow-howto.md
@@ -104,7 +104,7 @@ public class DemoWorkflowClient {
 
       System.out.println(separatorStr);
       System.out.println("**GetInstanceMetadata:Running Workflow**");
-      WorkflowInstanceStatus workflowMetadata = client.getInstanceState(instanceId, true);
+      WorkflowInstanceStatus workflowMetadata = client.getWorkflowState(instanceId, true);
       System.out.printf("Result: %s%n", workflowMetadata);
 
       System.out.println(separatorStr);
@@ -135,13 +135,13 @@ public class DemoWorkflowClient {
 
 
       System.out.println(separatorStr);
-      System.out.println("**WaitForInstanceCompletion**");
+      System.out.println("**waitForWorkflowCompletion**");
       try {
-        WorkflowInstanceStatus waitForInstanceCompletionResult =
-            client.waitForInstanceCompletion(instanceId, Duration.ofSeconds(60), true);
-        System.out.printf("Result: %s%n", waitForInstanceCompletionResult);
+        WorkflowInstanceStatus waitForWorkflowCompletionResult =
+            client.waitForWorkflowCompletion(instanceId, Duration.ofSeconds(60), true);
+        System.out.printf("Result: %s%n", waitForWorkflowCompletionResult);
       } catch (TimeoutException ex) {
-        System.out.printf("waitForInstanceCompletion has an exception:%s%n", ex);
+        System.out.printf("waitForWorkflowCompletion has an exception:%s%n", ex);
       }
 
       System.out.println(separatorStr);
@@ -213,7 +213,7 @@ Events raised for workflow with instanceId: 0b4cc0d5-413a-4c1c-816a-a71fa24740d4
 ** Registering Event to be captured by anyOf(t1,t2,t3) **
 Event raised for workflow with instanceId: 0b4cc0d5-413a-4c1c-816a-a71fa24740d4
 *******
-**WaitForInstanceCompletion**
+**WaitForWorkflowCompletion**
 Result: [Name: 'io.dapr.examples.workflows.DemoWorkflow', ID: '0b4cc0d5-413a-4c1c-816a-a71fa24740d4', RuntimeStatus: FAILED, CreatedAt: 2023-09-13T13:02:30.547Z, LastUpdatedAt: 2023-09-13T13:02:55.054Z, Input: '"input data"', Output: '']
 *******
 **purgeInstance**
diff --git a/examples/src/main/java/io/dapr/examples/workflows/chain/DemoChainClient.java b/examples/src/main/java/io/dapr/examples/workflows/chain/DemoChainClient.java
@@ -35,7 +35,7 @@ public static void main(String[] args) {
 
       System.out.printf("Started a new chaining model workflow with instance ID: %s%n", instanceId);
       WorkflowInstanceStatus workflowInstanceStatus =
-          client.waitForInstanceCompletion(instanceId, null, true);
+          client.waitForWorkflowCompletion(instanceId, null, true);
 
       String result = workflowInstanceStatus.readOutputAs(String.class);
       System.out.printf("workflow instance with ID: %s completed with result: %s%n", instanceId, result);
diff --git a/examples/src/main/java/io/dapr/examples/workflows/childworkflow/DemoChildWorkerflowClient.java b/examples/src/main/java/io/dapr/examples/workflows/childworkflow/DemoChildWorkerflowClient.java
@@ -31,7 +31,7 @@ public static void main(String[] args) {
       String instanceId = client.scheduleNewWorkflow(DemoWorkflow.class);
       System.out.printf("Started a new child-workflow model workflow with instance ID: %s%n", instanceId);
       WorkflowInstanceStatus workflowInstanceStatus =
-          client.waitForInstanceCompletion(instanceId, null, true);
+          client.waitForWorkflowCompletion(instanceId, null, true);
 
       String result = workflowInstanceStatus.readOutputAs(String.class);
       System.out.printf("workflow instance with ID: %s completed with result: %s%n", instanceId, result);
diff --git a/examples/src/main/java/io/dapr/examples/workflows/compensation/BookTripClient.java b/examples/src/main/java/io/dapr/examples/workflows/compensation/BookTripClient.java
@@ -27,7 +27,7 @@ public static void main(String[] args) {
             String instanceId = RetryUtils.callWithRetry(() -> client.scheduleNewWorkflow(BookTripWorkflow.class), Duration.ofSeconds(60));
             System.out.printf("Started a new trip booking workflow with instance ID: %s%n", instanceId);
 
-            WorkflowInstanceStatus status = client.waitForInstanceCompletion(instanceId, Duration.ofMinutes(30), true);
+            WorkflowInstanceStatus status = client.waitForWorkflowCompletion(instanceId, Duration.ofMinutes(30), true);
             System.out.printf("Workflow instance with ID: %s completed with status: %s%n", instanceId, status);
             System.out.printf("Workflow output: %s%n", status.getSerializedOutput());
         } catch (TimeoutException | InterruptedException e) {
diff --git a/examples/src/main/java/io/dapr/examples/workflows/continueasnew/DemoContinueAsNewClient.java b/examples/src/main/java/io/dapr/examples/workflows/continueasnew/DemoContinueAsNewClient.java
@@ -30,7 +30,7 @@ public static void main(String[] args) {
       String instanceId = client.scheduleNewWorkflow(DemoContinueAsNewWorkflow.class);
       System.out.printf("Started a new continue-as-new model workflow with instance ID: %s%n", instanceId);
 
-      client.waitForInstanceCompletion(instanceId, null, true);
+      client.waitForWorkflowCompletion(instanceId, null, true);
       System.out.printf("workflow instance with ID: %s completed.", instanceId);
 
     } catch (TimeoutException | InterruptedException e) {
diff --git a/examples/src/main/java/io/dapr/examples/workflows/crossapp/CrossAppWorkflowClient.java b/examples/src/main/java/io/dapr/examples/workflows/crossapp/CrossAppWorkflowClient.java
@@ -49,7 +49,7 @@ public static void main(String[] args) {
       // Wait for the workflow to complete
       System.out.println("Waiting for workflow completion...");
       WorkflowInstanceStatus workflowInstanceStatus = 
-          client.waitForInstanceCompletion(instanceId, null, true);
+          client.waitForWorkflowCompletion(instanceId, null, true);
       
       // Get the result
       String result = workflowInstanceStatus.readOutputAs(String.class);
diff --git a/examples/src/main/java/io/dapr/examples/workflows/externalevent/DemoExternalEventClient.java b/examples/src/main/java/io/dapr/examples/workflows/externalevent/DemoExternalEventClient.java
@@ -33,7 +33,7 @@ public static void main(String[] args) {
       client.raiseEvent(instanceId, "Approval", true);
       //client.raiseEvent(instanceId, "Approval", false);
 
-      client.waitForInstanceCompletion(instanceId, null, true);
+      client.waitForWorkflowCompletion(instanceId, null, true);
       System.out.printf("workflow instance with ID: %s completed.", instanceId);
 
     } catch (TimeoutException | InterruptedException e) {
diff --git a/examples/src/main/java/io/dapr/examples/workflows/faninout/DemoFanInOutClient.java b/examples/src/main/java/io/dapr/examples/workflows/faninout/DemoFanInOutClient.java
@@ -48,7 +48,7 @@ public static void main(String[] args) throws InterruptedException {
       System.out.printf("Started a new fan out/fan in model workflow with instance ID: %s%n", instanceId);
 
       // Block until the orchestration completes. Then print the final status, which includes the output.
-      WorkflowInstanceStatus workflowInstanceStatus = client.waitForInstanceCompletion(
+      WorkflowInstanceStatus workflowInstanceStatus = client.waitForWorkflowCompletion(
           instanceId,
           Duration.ofSeconds(30),
           true);
diff --git a/examples/src/main/java/io/dapr/examples/workflows/suspendresume/DemoSuspendResumeClient.java b/examples/src/main/java/io/dapr/examples/workflows/suspendresume/DemoSuspendResumeClient.java
@@ -38,21 +38,21 @@ public static void main(String[] args) {
       System.out.printf("Suspending Workflow Instance: %s%n", instanceId );
       client.suspendWorkflow(instanceId, "suspending workflow instance.");
 
-      WorkflowInstanceStatus instanceState = client.getInstanceState(instanceId, false);
+      WorkflowInstanceStatus instanceState = client.getWorkflowState(instanceId, false);
       assert instanceState != null;
       System.out.printf("Workflow Instance Status: %s%n", instanceState.getRuntimeStatus().name() );
 
       System.out.printf("Let's resume the Workflow Instance before sending the external event: %s%n", instanceId );
       client.resumeWorkflow(instanceId, "resuming workflow instance.");
 
-      instanceState = client.getInstanceState(instanceId, false);
+      instanceState = client.getWorkflowState(instanceId, false);
       assert instanceState != null;
       System.out.printf("Workflow Instance Status: %s%n", instanceState.getRuntimeStatus().name() );
 
       System.out.printf("Now that the instance is RUNNING again, lets send the external event. %n");
       client.raiseEvent(instanceId, "Approval", true);
 
-      client.waitForInstanceCompletion(instanceId, null, true);
+      client.waitForWorkflowCompletion(instanceId, null, true);
       System.out.printf("workflow instance with ID: %s completed.", instanceId);
 
     } catch (TimeoutException | InterruptedException e) {
diff --git a/sdk-tests/src/test/java/io/dapr/it/testcontainers/workflows/DaprWorkflowsIT.java b/sdk-tests/src/test/java/io/dapr/it/testcontainers/workflows/DaprWorkflowsIT.java
@@ -104,11 +104,11 @@ public void testWorkflows() throws Exception {
     TestWorkflowPayload payload = new TestWorkflowPayload(new ArrayList<>());
     String instanceId = workflowClient.scheduleNewWorkflow(TestWorkflow.class, payload);
 
-    workflowClient.waitForInstanceStart(instanceId, Duration.ofSeconds(10), false);
+    workflowClient.waitForWorkflowStart(instanceId, Duration.ofSeconds(10), false);
     workflowClient.raiseEvent(instanceId, "MoveForward", payload);
 
     Duration timeout = Duration.ofSeconds(10);
-    WorkflowInstanceStatus workflowStatus = workflowClient.waitForInstanceCompletion(instanceId, timeout, true);
+    WorkflowInstanceStatus workflowStatus = workflowClient.waitForWorkflowCompletion(instanceId, timeout, true);
 
     assertNotNull(workflowStatus);
 
@@ -124,25 +124,25 @@ public void testWorkflows() throws Exception {
   public void testSuspendAndResumeWorkflows() throws Exception {
     TestWorkflowPayload payload = new TestWorkflowPayload(new ArrayList<>());
     String instanceId = workflowClient.scheduleNewWorkflow(TestWorkflow.class, payload);
-    workflowClient.waitForInstanceStart(instanceId, Duration.ofSeconds(10), false);
+    workflowClient.waitForWorkflowStart(instanceId, Duration.ofSeconds(10), false);
 
     workflowClient.suspendWorkflow(instanceId, "testing suspend.");
 
 
-    WorkflowInstanceStatus instanceState = workflowClient.getInstanceState(instanceId, false);
+    WorkflowInstanceStatus instanceState = workflowClient.getWorkflowState(instanceId, false);
     assertNotNull(instanceState);
     assertEquals(WorkflowRuntimeStatus.SUSPENDED, instanceState.getRuntimeStatus());
 
     workflowClient.resumeWorkflow(instanceId, "testing resume");
 
-    instanceState = workflowClient.getInstanceState(instanceId, false);
+    instanceState = workflowClient.getWorkflowState(instanceId, false);
     assertNotNull(instanceState);
     assertEquals(WorkflowRuntimeStatus.RUNNING, instanceState.getRuntimeStatus());
 
     workflowClient.raiseEvent(instanceId, "MoveForward", payload);
 
     Duration timeout = Duration.ofSeconds(10);
-    instanceState = workflowClient.waitForInstanceCompletion(instanceId, timeout, true);
+    instanceState = workflowClient.waitForWorkflowCompletion(instanceId, timeout, true);
 
     assertNotNull(instanceState);
     assertEquals(WorkflowRuntimeStatus.COMPLETED, instanceState.getRuntimeStatus());
@@ -154,10 +154,10 @@ public void testNamedActivitiesWorkflows() throws Exception {
     TestWorkflowPayload payload = new TestWorkflowPayload(new ArrayList<>());
     String instanceId = workflowClient.scheduleNewWorkflow(TestNamedActivitiesWorkflow.class, payload);
 
-    workflowClient.waitForInstanceStart(instanceId, Duration.ofSeconds(10), false);
+    workflowClient.waitForWorkflowStart(instanceId, Duration.ofSeconds(10), false);
 
     Duration timeout = Duration.ofSeconds(10);
-    WorkflowInstanceStatus workflowStatus = workflowClient.waitForInstanceCompletion(instanceId, timeout, true);
+    WorkflowInstanceStatus workflowStatus = workflowClient.waitForWorkflowCompletion(instanceId, timeout, true);
 
     assertNotNull(workflowStatus);
 
@@ -178,10 +178,10 @@ public void testExecutionKeyWorkflows() throws Exception {
     TestWorkflowPayload payload = new TestWorkflowPayload(new ArrayList<>());
     String instanceId = workflowClient.scheduleNewWorkflow(TestExecutionKeysWorkflow.class, payload);
 
-    workflowClient.waitForInstanceStart(instanceId, Duration.ofSeconds(100), false);
+    workflowClient.waitForWorkflowStart(instanceId, Duration.ofSeconds(100), false);
     
     Duration timeout = Duration.ofSeconds(1000);
-    WorkflowInstanceStatus workflowStatus = workflowClient.waitForInstanceCompletion(instanceId, timeout, true);
+    WorkflowInstanceStatus workflowStatus = workflowClient.waitForWorkflowCompletion(instanceId, timeout, true);
 
     assertNotNull(workflowStatus);
 
diff --git a/sdk-tests/src/test/java/io/dapr/it/testcontainers/workflows/crossapp/WorkflowsCrossAppCallActivityIT.java b/sdk-tests/src/test/java/io/dapr/it/testcontainers/workflows/crossapp/WorkflowsCrossAppCallActivityIT.java
@@ -175,9 +175,9 @@ public void testCrossAppWorkflow() throws Exception {
     try {
       String instanceId = workflowClient.scheduleNewWorkflow(CrossAppWorkflow.class, input);
       assertNotNull(instanceId, "Workflow instance ID should not be null");
-      workflowClient.waitForInstanceStart(instanceId, Duration.ofSeconds(30), false);
+      workflowClient.waitForWorkflowStart(instanceId, Duration.ofSeconds(30), false);
 
-      WorkflowInstanceStatus workflowStatus = workflowClient.waitForInstanceCompletion(instanceId, null, true);
+      WorkflowInstanceStatus workflowStatus = workflowClient.waitForWorkflowCompletion(instanceId, null, true);
       assertNotNull(workflowStatus, "Workflow status should not be null");
       assertEquals(WorkflowRuntimeStatus.COMPLETED, workflowStatus.getRuntimeStatus(),
           "Workflow should complete successfully");
diff --git a/sdk-workflows/src/main/java/io/dapr/workflows/client/DaprWorkflowClient.java b/sdk-workflows/src/main/java/io/dapr/workflows/client/DaprWorkflowClient.java
diff --git a/sdk-workflows/src/test/java/io/dapr/workflows/client/DaprWorkflowClientTest.java b/sdk-workflows/src/test/java/io/dapr/workflows/client/DaprWorkflowClientTest.java
diff --git a/spring-boot-examples/workflows/src/main/java/io/dapr/springboot/examples/wfp/WorkflowPatternsRestController.java b/spring-boot-examples/workflows/src/main/java/io/dapr/springboot/examples/wfp/WorkflowPatternsRestController.java
