Package dev.restate.sdk.common.syscalls

Interface Syscalls

public interface Syscalls

Internal interface to access Restate functionalities. Users can use the ad-hoc RestateContext interfaces provided by the various implementations.

When using executor switching wrappers, the method's callback will be executed in the state machine executor.

Method Summary

Modifier and Type	Method	Description
void	awakeable(SyscallCallback<java.util.Map.Entry<java.lang.String,Deferred<com.google.protobuf.ByteString>>> callback)
void	call(Target target, com.google.protobuf.ByteString parameter, SyscallCallback<Deferred<com.google.protobuf.ByteString>> callback)
void	clear(java.lang.String name, SyscallCallback<java.lang.Void> callback)
void	clearAll(SyscallCallback<java.lang.Void> callback)
Deferred<java.lang.Void>	createAllDeferred(java.util.List<Deferred<?>> children)
Deferred<java.lang.Integer>	createAnyDeferred(java.util.List<Deferred<?>> children)
void	enterSideEffectBlock(@Nullable java.lang.String name, EnterSideEffectSyscallCallback callback)
void	exitSideEffectBlock(com.google.protobuf.ByteString toWrite, ExitSideEffectSyscallCallback callback)
void	exitSideEffectBlockWithTerminalException(TerminalException toWrite, ExitSideEffectSyscallCallback callback)
void	fail(java.lang.Throwable cause)
void	get(java.lang.String name, SyscallCallback<Deferred<com.google.protobuf.ByteString>> callback)
void	getKeys(SyscallCallback<Deferred<java.util.Collection<java.lang.String>>> callback)
boolean	isInsideSideEffect()
java.lang.String	objectKey()
void	rejectAwakeable(java.lang.String id, java.lang.String reason, SyscallCallback<java.lang.Void> requestCallback)
Request	request()
void	resolveAwakeable(java.lang.String id, com.google.protobuf.ByteString payload, SyscallCallback<java.lang.Void> requestCallback)
<T> void	resolveDeferred(Deferred<T> deferredToResolve, SyscallCallback<java.lang.Void> callback)
void	send(Target target, com.google.protobuf.ByteString parameter, @Nullable java.time.Duration delay, SyscallCallback<java.lang.Void> requestCallback)
void	set(java.lang.String name, com.google.protobuf.ByteString value, SyscallCallback<java.lang.Void> callback)
void	sleep(java.time.Duration duration, SyscallCallback<Deferred<java.lang.Void>> callback)
void	writeOutput(com.google.protobuf.ByteString value, SyscallCallback<java.lang.Void> callback)
void	writeOutput(TerminalException exception, SyscallCallback<java.lang.Void> callback)

Method Detail

objectKey

java.lang.String objectKey()

request

Request request()

isInsideSideEffect

boolean isInsideSideEffect()

Returns:

true if it's inside a side effect block.

writeOutput

void writeOutput(com.google.protobuf.ByteString value,
                 SyscallCallback<java.lang.Void> callback)

writeOutput

void writeOutput(TerminalException exception,
                 SyscallCallback<java.lang.Void> callback)

get

void get(java.lang.String name,
         SyscallCallback<Deferred<com.google.protobuf.ByteString>> callback)

getKeys

void getKeys(SyscallCallback<Deferred<java.util.Collection<java.lang.String>>> callback)

clear

void clear(java.lang.String name,
           SyscallCallback<java.lang.Void> callback)

clearAll

void clearAll(SyscallCallback<java.lang.Void> callback)

set

void set(java.lang.String name,
         com.google.protobuf.ByteString value,
         SyscallCallback<java.lang.Void> callback)

sleep

void sleep(java.time.Duration duration,
           SyscallCallback<Deferred<java.lang.Void>> callback)

call

void call(Target target,
          com.google.protobuf.ByteString parameter,
          SyscallCallback<Deferred<com.google.protobuf.ByteString>> callback)

send

void send(Target target,
          com.google.protobuf.ByteString parameter,
          @Nullable java.time.Duration delay,
          SyscallCallback<java.lang.Void> requestCallback)

enterSideEffectBlock

void enterSideEffectBlock(@Nullable java.lang.String name,
                          EnterSideEffectSyscallCallback callback)

exitSideEffectBlock

void exitSideEffectBlock(com.google.protobuf.ByteString toWrite,
                         ExitSideEffectSyscallCallback callback)

exitSideEffectBlockWithTerminalException

void exitSideEffectBlockWithTerminalException(TerminalException toWrite,
                                              ExitSideEffectSyscallCallback callback)

awakeable

void awakeable(SyscallCallback<java.util.Map.Entry<java.lang.String,Deferred<com.google.protobuf.ByteString>>> callback)

resolveAwakeable

void resolveAwakeable(java.lang.String id,
                      com.google.protobuf.ByteString payload,
                      SyscallCallback<java.lang.Void> requestCallback)

rejectAwakeable

void rejectAwakeable(java.lang.String id,
                     java.lang.String reason,
                     SyscallCallback<java.lang.Void> requestCallback)

fail

void fail(java.lang.Throwable cause)

resolveDeferred

<T> void resolveDeferred(Deferred<T> deferredToResolve,
                         SyscallCallback<java.lang.Void> callback)

createAnyDeferred

Deferred<java.lang.Integer> createAnyDeferred(java.util.List<Deferred<?>> children)

createAllDeferred

Deferred<java.lang.Void> createAllDeferred(java.util.List<Deferred<?>> children)