Sample code for Nexus Standalone by Evanthx · Pull Request #782 · temporalio/samples-java

Evanthx · 2026-06-08T18:04:43Z

Sample code for Standalone Nexus operations. This cannot be checked in before the matching SDK changes - temporalio/sdk-java#2872

Quinn-With-Two-Ns · 2026-06-08T23:05:06Z

Make sure to link this in the README https://github.com/temporalio/samples-java/blob/main/README.md

Quinn-With-Two-Ns · 2026-06-08T23:05:28Z

+5. **Client options and interceptors** — set the identity and data converter, and register two
+   logging interceptors.
+
+> [!WARNING]


NIT: I would put this at the top

Quinn-With-Two-Ns · 2026-06-08T23:05:59Z

+
+### Running
+
+Start a Temporal server with the standalone-Nexus dynamic configs enabled:


We should call out the version of the dev server users need

Quinn-With-Two-Ns · 2026-06-08T23:06:22Z

+package io.temporal.samples.nexusstandalone.service;
+
+// A helper method to generate workflow IDs.
+public final class GreetingIds {


We don't need this helper, just inline this

Quinn-With-Two-Ns · 2026-06-08T23:06:40Z

+ * environment variables) to point at a different server or namespace — for example a Temporal Cloud
+ * namespace with an API key.
+ */
+public class ClientOptions {


I'd just inline this like all the other samples

Quinn-With-Two-Ns · 2026-06-08T23:07:41Z

+  public static WorkflowClient getWorkflowClient() {
+    ClientConfigProfile profile;
+    try {
+      String configFilePath =


Why do we have special client config loading code? Other samples just do

ClientConfigProfile profile; try { profile = ClientConfigProfile.load(); } catch (IOException e) { throw new RuntimeException("Failed to load client configuration", e); }

Quinn-With-Two-Ns · 2026-06-08T23:09:11Z

+    NexusServiceClient<GreetingNexusService> greetingClient =
+        nexusClient.newNexusServiceClient(GreetingNexusService.class, ENDPOINT_NAME);
+
+    demonstrateExecute(greetingClient);


Please inline all these functions, they only have one caller and make the code harder to follow

Quinn-With-Two-Ns · 2026-06-08T23:09:47Z

+
+    // executeAsync(...) is the same but returns a CompletableFuture instead of blocking.
+    CompletableFuture<GreetingOutput> future =
+        nexusClient.executeAsync(


I would show execute here to keep it simpler

Quinn-With-Two-Ns · 2026-06-08T23:11:12Z

+        nexusClient.newNexusServiceClient(GreetingNexusService.class, ENDPOINT_NAME);
+
+    demonstrateExecute(greetingClient);
+    demonstrateCancel(greetingClient);


I don't think we demonstrated cancel or terminate in other SDK language samples. Not strongly opposed, but it is a lot? Whatever we decided to do we should be consistent

Quinn-With-Two-Ns · 2026-06-08T23:11:56Z

+    NexusServiceClient<GreetingNexusService> greetingClient =
+        nexusClient.newNexusServiceClient(GreetingNexusService.class, ENDPOINT_NAME);
+
+    demonstrateExecute(greetingClient);


Another thing we discussed with Product we want to show is getting a handle to an operation that has already been started, would be good to show that when we show execute

Quinn-With-Two-Ns · 2026-06-08T23:12:09Z

+
+    demonstrateExecute(greetingClient);
+    demonstrateCancel(greetingClient);
+    demonstrateTerminate(greetingClient, client);


I'd also demonstrate start

using the workflow operation specifically. I would show starting and then getting the result in two steps. That is by far the most common use of Nexus so we should show that IMO

Quinn-With-Two-Ns · 2026-06-08T23:12:43Z

+    demonstrateCancel(greetingClient);
+    demonstrateTerminate(greetingClient, client);
+    demonstrateVisibility(nexusClient);
+    demonstrateClientOptionsAndInterceptors(stubs, namespace);


Interceptors are a very advanced option I would leave them off this sample

Quinn-With-Two-Ns · 2026-06-08T23:14:07Z

+    logger.info(
+        "Operation id={} final status: {}",
+        handle.getNexusOperationId(),
+        awaitTerminalStatus(handle, Duration.ofSeconds(10)));


We should not be encouraging users to manually poll describe, users can just get the result of the operation through the handle

Quinn-With-Two-Ns · 2026-06-08T23:14:52Z

+  private static final Logger logger = LoggerFactory.getLogger(StandaloneClientStarter.class);
+
+  // Must match the Nexus endpoint configured on the server (see README).
+  public static final String ENDPOINT_NAME = "nexusstandalone-endpoint";


nit

Suggested change

public static final String ENDPOINT_NAME = "nexusstandalone-endpoint";

public static final String ENDPOINT_NAME = "nexus-standalone-operation-endpoint";

Quinn-With-Two-Ns · 2026-06-08T23:15:38Z

+  // A per-run suffix appended to workflow-backed operation names so their backing workflow IDs are
+  // unique on each run. Without this, re-running against the same server (no restart) would reuse
+  // deterministic workflow IDs from the previous run and collide.
+  private static final String RUN_ID = UUID.randomUUID().toString().substring(0, 8);


Run ID already has a meaning in Temporal as a server generated UUID I wouldn't overload the term here. No strong opinion on the term other then not using an existing term

Quinn-With-Two-Ns · 2026-06-08T23:22:24Z

+Create the namespace and the Nexus endpoint:
+
+```bash
+temporal operator namespace create --namespace default


with the dev server

Sample code for Nexus Standalone

656e254

Evanthx requested review from a team, antmendoza and tsurdilo as code owners June 8, 2026 18:04

This was referenced Jun 8, 2026

Documentation for Nexus Standalone operations temporalio/documentation#4677

Closed

Documentation for Java Nexus Standalone operations temporalio/documentation#4678

Closed

Changed the SDK interface a bit, this changed to match

e5a7d50

This was referenced Jun 8, 2026

Documentation for Java Nexus Standalone operations temporalio/documentation#4680

Closed

Documentation for Java Nexus Standalone operations temporalio/documentation#4681

Open

Quinn-With-Two-Ns reviewed Jun 8, 2026

View reviewed changes


		### Running

		Start a Temporal server with the standalone-Nexus dynamic configs enabled:

	public static final String ENDPOINT_NAME = "nexusstandalone-endpoint";
	public static final String ENDPOINT_NAME = "nexus-standalone-operation-endpoint";

Conversation

Evanthx commented Jun 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Quinn-With-Two-Ns commented Jun 8, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Evanthx commented Jun 8, 2026 •

edited

Loading