Skip to main content

Queries in Java

Workflow queries can be used to query a Workflow state by external processes at any time during its execution. Query methods can only be defined inside Workflows Interfaces and are methods annotated with the @QueryMethod annotation, for example:

public interface HelloWorld {
void sayHello(String name);
int getCount();

Notice that the getCount method is annotated with @QueryMethod. There can be multiple Query methods per Workflow interface.

The QueryMethod annotation has an optional name property which can be used to define the query type. If not specified it defaults to the method name.

Let's look at a Workflog implementation and its query method:

public static class HelloWorldImpl implements HelloWorld {
private String greeting = "Hello";
private int count = 0;
public void sayHello(String name) {
while (!"Bye".equals(greeting)) { + ": " + greeting + " " + name + "!");
String oldGreeting = greeting;
Workflow.await(() -> !Objects.equals(greeting, oldGreeting));
} + ": " + greeting + " " + name + "!");
public int getCount() {
return count;

The restrictions on the implementation of the Query method are the following:

  • It can not modify Workflow state in any way.
  • It is not allowed to block its thread in any way.

The Query method usually just returns a value derived from the fields of the Workflow object.

Query methods can take in any number of input parameters which can be used to limit the data that is returned for example.

Get notified of updates