Class ExecutionRecorder

java.lang.Object

com.soulfiremc.server.script.ExecutionRecorder

All Implemented Interfaces:

ScriptEventListener

public final class ExecutionRecorder
extends Object
implements ScriptEventListener

Records script execution events for replay in the editor. Implements ScriptEventListener to capture all events during execution.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	ExecutionRecorder.EventType	Type of recorded event.
static final record	ExecutionRecorder.RecordedEvent	A single recorded execution event with timestamp and data.

Field Summary

Fields inherited from interface ScriptEventListener

NOOP

Constructor Summary

Constructors

Constructor	Description
ExecutionRecorder()	Creates a standalone recorder with no delegation.
ExecutionRecorder(ScriptEventListener delegate)	Creates a recorder that also delegates events to another listener.

Method Summary

Modifier and Type	Method	Description
List<ExecutionRecorder.RecordedEvent>	getEvents()	Returns the recorded events as an unmodifiable list.
void	onExecutionStats(long nodeCount, long maxCount)	Called when a trigger chain completes with execution statistics.
void	onLog(String level, String message)	Called when a script logs a message (via Print node).
void	onNodeCompleted(String nodeId, Map<String, NodeValue> outputs)	Called when a node completes execution successfully.
void	onNodeCompleted(String nodeId, Map<String, NodeValue> outputs, long executionTimeNanos)	Called when a node completes with execution time for profiling.
void	onNodeError(String nodeId, String error)	Called when a node encounters an error during execution.
void	onNodeStarted(String nodeId)	Called when a node starts executing.
void	onScriptCancelled()	Called when the script execution is cancelled.
void	onScriptCompleted(boolean success)	Called when the entire script completes execution.
int	size()	Returns the number of recorded events.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ExecutionRecorder

public ExecutionRecorder(ScriptEventListener delegate)

Creates a recorder that also delegates events to another listener.

ExecutionRecorder

public ExecutionRecorder()

Creates a standalone recorder with no delegation.

Method Details

onNodeStarted

public void onNodeStarted(String nodeId)

Description copied from interface: ScriptEventListener

Called when a node starts executing.

Specified by:

onNodeStarted in interface ScriptEventListener

Parameters:

nodeId - the unique identifier of the node

onNodeCompleted

public void onNodeCompleted(String nodeId,
 Map<String, NodeValue> outputs)

Description copied from interface: ScriptEventListener

Called when a node completes execution successfully.

Specified by:

onNodeCompleted in interface ScriptEventListener

Parameters:

nodeId - the unique identifier of the node

outputs - the output values produced by the node

onNodeCompleted

public void onNodeCompleted(String nodeId,
 Map<String, NodeValue> outputs,
 long executionTimeNanos)

Description copied from interface: ScriptEventListener

Called when a node completes with execution time for profiling.

Specified by:

onNodeCompleted in interface ScriptEventListener

Parameters:

nodeId - the node identifier

outputs - the output values produced

executionTimeNanos - execution time in nanoseconds

onNodeError

public void onNodeError(String nodeId,
 String error)

Description copied from interface: ScriptEventListener

Called when a node encounters an error during execution.

Specified by:

onNodeError in interface ScriptEventListener

Parameters:

nodeId - the unique identifier of the node

error - description of the error that occurred

onLog

public void onLog(String level,
 String message)

Description copied from interface: ScriptEventListener

Called when a script logs a message (via Print node).

Specified by:

onLog in interface ScriptEventListener

Parameters:

level - the log level (debug, info, warn, error)

message - the log message

onExecutionStats

public void onExecutionStats(long nodeCount,
 long maxCount)

Description copied from interface: ScriptEventListener

Called when a trigger chain completes with execution statistics.

Specified by:

onExecutionStats in interface ScriptEventListener

Parameters:

nodeCount - the total number of node executions

maxCount - the maximum allowed node executions

onScriptCompleted

public void onScriptCompleted(boolean success)

Description copied from interface: ScriptEventListener

Called when the entire script completes execution.

Specified by:

onScriptCompleted in interface ScriptEventListener

Parameters:

success - true if the script completed without errors

onScriptCancelled

public void onScriptCancelled()

Description copied from interface: ScriptEventListener

Called when the script execution is cancelled.

Specified by:

onScriptCancelled in interface ScriptEventListener

getEvents

public List<ExecutionRecorder.RecordedEvent> getEvents()

Returns the recorded events as an unmodifiable list.

size

public int size()

Returns the number of recorded events.