Package dev.restate.sdk

Interface ServiceHandle<SVC>

Type Parameters:
SVC - the service interface type
@Experimental public interface ServiceHandle<SVC>
EXPERIMENTAL API: This interface is part of the new reflection-based API and may change in future releases.

Advanced API handle for invoking Restate services, virtual objects, or workflows with full control. This handle provides advanced invocation capabilities including:

  • Composable futures for asynchronous request handling
  • Invocation options such as idempotency keys
  • Fire-and-forget requests via send()
  • Deferred response handling

Use this handle to perform requests with method references: 


 // 1. Use call() with method reference and await the result
 GreetingResponse response = Restate.serviceHandle(Greeter.class)
   .call(Greeter::greet, new Greeting("Alice"))
   .await();

 // 2. Use send() for one-way invocation without waiting
 InvocationHandle<GreetingResponse> handle = Restate.serviceHandle(Greeter.class)
   .send(Greeter::greet, new Greeting("Alice"));

Create instances using Restate.serviceHandle(Class), Restate.virtualObjectHandle(Class, String), or Restate.workflowHandle(Class, String).

For simple synchronous request-response interactions, consider using the simple proxy API instead: Restate.service(Class), Restate.virtualObject(Class, String), or Restate.workflow(Class, String).