Package com.tnsai.agents.groups

Interface LeaderElectionStrategy

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface LeaderElectionStrategy

Strategy for electing a leader among group members.

Leader election strategies determine how a group selects a coordinator or primary agent when needed for coordination.

Built-in Strategies

• RANDOM - Random selection
• FIRST_JOINED - First member to join
• ROUND_ROBIN - Rotating leadership
• invalid reference

  #CAPABILITY_BASED

  - Best matching capabilities

Custom Strategy Example

 LeaderElectionStrategy custom = members ->
     members.stream()
         .max(Comparator.comparing(a -> a.getCapabilities().size()))
         .orElse(null);
 

Field Summary

Fields

Modifier and Type	Field	Description
static final LeaderElectionStrategy	FIRST_JOINED	First joined member becomes leader.
static final LeaderElectionStrategy	LAST_JOINED	Last joined member becomes leader.
static final LeaderElectionStrategy	NONE	No election - returns null.
static final LeaderElectionStrategy	RANDOM	Random selection strategy.
static final LeaderElectionStrategy	ROLE_BASED	Select leader with most roles (and thus most capabilities).
static final LeaderElectionStrategy	ROUND_ROBIN	Round-robin leadership rotation.

Method Summary

Modifier and Type	Method	Description
Agent	elect(List<Agent> members)	Selects a leader from the given members.
default Optional<Agent>	electOptional(List<Agent> members)	Selects a leader, returning Optional.

Field Details

RANDOM

static final LeaderElectionStrategy RANDOM

Random selection strategy.

FIRST_JOINED

static final LeaderElectionStrategy FIRST_JOINED

First joined member becomes leader.

LAST_JOINED

static final LeaderElectionStrategy LAST_JOINED

Last joined member becomes leader.

ROUND_ROBIN

static final LeaderElectionStrategy ROUND_ROBIN

Round-robin leadership rotation. State is managed externally by the group.

ROLE_BASED

static final LeaderElectionStrategy ROLE_BASED

Select leader with most roles (and thus most capabilities).

NONE

static final LeaderElectionStrategy NONE

No election - returns null.

Method Details

elect

Agent elect(List<Agent> members)

Selects a leader from the given members.

Parameters:

members - list of candidate members

Returns:

elected leader, or null if no suitable leader found

electOptional

default Optional<Agent> electOptional(List<Agent> members)

Selects a leader, returning Optional.

Parameters:

members - list of candidate members

Returns:

elected leader