Package com.tnsai.coordination.choreography

Class ChoreographySpec

java.lang.Object

com.tnsai.coordination.choreography.ChoreographySpec

public final class ChoreographySpec
extends Object

Declarative specification of agent interactions for choreography-based coordination. Unlike orchestration (centralized control), choreography defines decentralized rules where each agent reacts to events autonomously.

Example usage:

 ChoreographySpec spec = ChoreographySpec.builder("order-processing")
     .initialEvent("order.placed")
     .interaction("validate", "system", "validator", "order.placed", "order.validated", "Validate order")
     .interaction("charge", "validator", "billing", "order.validated", "payment.done", "Charge payment")
     .interaction("ship", "billing", "shipper", "payment.done", "order.shipped", "Ship order")
     .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ChoreographySpec.Builder
static final record	ChoreographySpec.Interaction	A single interaction rule in the choreography.

Method Summary

Modifier and Type	Method	Description
Set<String>	agents()	Returns all agent IDs participating in this choreography.
Set<String>	allEvents()	Returns all distinct event names in this spec.
static ChoreographySpec.Builder	builder(String name)
List<ChoreographySpec.Interaction>	forAgent(String agentId)	Returns interactions targeting a specific agent.
Set<String>	initialEvents()
List<ChoreographySpec.Interaction>	interactions()
String	name()
List<ChoreographySpec.Interaction>	triggeredBy(String event)	Returns interactions triggered by a specific event.

Methods inherited from class java.lang.Object

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

Method Details

name

public String name()

interactions

public List<ChoreographySpec.Interaction> interactions()

initialEvents

public Set<String> initialEvents()

agents

public Set<String> agents()

Returns all agent IDs participating in this choreography.

triggeredBy

public List<ChoreographySpec.Interaction> triggeredBy(String event)

Returns interactions triggered by a specific event.

forAgent

public List<ChoreographySpec.Interaction> forAgent(String agentId)

Returns interactions targeting a specific agent.

allEvents

public Set<String> allEvents()

Returns all distinct event names in this spec.

builder

public static ChoreographySpec.Builder builder(String name)