Class TransitionHistorySection

java.lang.Object

com.scivicslab.actoriac.report.sections.basic.TransitionHistorySection

All Implemented Interfaces:

SectionBuilder

public class TransitionHistorySection
extends Object
implements SectionBuilder

POJO section builder that outputs workflow transition history.

Pure business logic - no CallableByActionName. Use TransitionHistorySectionIIAR to expose as an actor.

Retrieves transition logs from the database and displays them in a human-readable format with success/failure status.

Output example:

[Transition History: nodeGroup]
o [2026-01-30 10:15:23] 0 -> 1 [Initialize]
o [2026-01-30 10:15:24] 1 -> 2 [Collect data]
x [2026-01-30 10:15:25] 2 -> 3 [Process] Connection refused

Summary: 3 transitions, 2 succeeded, 1 failed

Since:

2.16.0

Author:

devteam@scivicslab.com

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static class	TransitionHistorySection.TransitionEntry	Internal class to hold transition entry data.

Field Summary

Fields

Modifier and Type	Field	Description
private Connection	connection
private boolean	includeChildren
private static final Logger	logger
private long	sessionId
private String	targetActorName
private static final DateTimeFormatter	TIME_FORMAT

Constructor Summary

Constructors

Constructor	Description
TransitionHistorySection()

Method Summary

Modifier and Type	Method	Description
private String	buildAggregatedOutput()	Builds aggregated output for nodeGroup and all children.
private String	buildSingleActorOutput()	Builds output for a single actor.
private String[]	extractTransitionAndNote(String message)	Extracts transition and note from message.
String	generate()	Generates the section content.
String	getTitle()	Returns the section title.
private List<String>	queryDistinctSources()	Queries distinct actor sources that have transition logs.
private List<TransitionHistorySection.TransitionEntry>	queryTransitions(String source)	Queries transition logs for a specific actor.
void	setConnection(Connection connection)	Sets the database connection for log queries.
void	setIncludeChildren(boolean includeChildren)	Sets whether to include child nodes in the output.
void	setSessionId(long sessionId)	Sets the session ID to query logs from.
void	setTargetActorName(String targetActorName)	Sets the target actor name to display transitions for.

Methods inherited from class Object

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

Field Details

logger

private static final Logger logger

TIME_FORMAT

private static final DateTimeFormatter TIME_FORMAT

connection

private Connection connection

sessionId

private long sessionId

targetActorName

private String targetActorName

includeChildren

private boolean includeChildren

Constructor Details

TransitionHistorySection

public TransitionHistorySection()

Method Details

setConnection

public void setConnection(Connection connection)

Sets the database connection for log queries.

Parameters:

connection - the JDBC connection to the H2 log database

setSessionId

public void setSessionId(long sessionId)

Sets the session ID to query logs from.

Parameters:

sessionId - the session ID

setTargetActorName

public void setTargetActorName(String targetActorName)

Sets the target actor name to display transitions for.

Parameters:

targetActorName - the target actor name (e.g., "nodeGroup", "node-server1")

setIncludeChildren

public void setIncludeChildren(boolean includeChildren)

Sets whether to include child nodes in the output.

When true and target is "nodeGroup", transitions from all child nodes are also included in the output.

Parameters:

includeChildren - true to include children

generate

public String generate()

Description copied from interface: SectionBuilder

Generates the section content.

Specified by:

generate in interface SectionBuilder

Returns:

the section content as a string

buildSingleActorOutput

private String buildSingleActorOutput()
                               throws Exception

Builds output for a single actor.

Throws:

Exception

buildAggregatedOutput

private String buildAggregatedOutput()
                              throws Exception

Builds aggregated output for nodeGroup and all children.

Throws:

Exception

queryTransitions

private List<TransitionHistorySection.TransitionEntry> queryTransitions(String source)
                                                                 throws Exception

Queries transition logs for a specific actor.

Throws:

Exception

queryDistinctSources

private List<String> queryDistinctSources()
                                   throws Exception

Queries distinct actor sources that have transition logs.

Throws:

Exception

extractTransitionAndNote

private String[] extractTransitionAndNote(String message)

Extracts transition and note from message.

Returns:

String[2] where [0]=transition, [1]=note

getTitle

public String getTitle()

Description copied from interface: SectionBuilder

Returns the section title.

If null or empty, the section content is output without a title line.

Specified by:

getTitle in interface SectionBuilder

Returns:

the section title, or null for no title