Package dev.agenor.adapters.persistence.directory

Class JdbcAgentDiscovery

java.lang.Object

dev.agenor.adapters.persistence.directory.JdbcAgentDiscovery

All Implemented Interfaces:

AgentDiscovery

public class JdbcAgentDiscovery
extends Object
implements AgentDiscovery

JDBC implementation of AgentDiscovery.

Since:

0.22.0

Constructor Summary

Constructors

Constructor	Description
JdbcAgentDiscovery(JdbcHelper helper)
JdbcAgentDiscovery(JdbcHelper helper, AgenorTelemetry telemetry)

Method Summary

Modifier and Type	Method	Description
CompletableFuture<Page<AgentDescriptor>>	findAgents(AgentQuery query, PageRequest request)	Finds agents matching the given query, returning a bounded page of results.
CompletableFuture<List<AgentDescriptor>>	findByCapability(String capability)	Finds all agents that declare the given capability.
CompletableFuture<Optional<AgentDescriptor>>	findById(String agentId)	Finds an agent by its unique identifier.
CompletableFuture<List<AgentDescriptor>>	findByType(String agentType)	Finds all agents of the given type.

Methods inherited from class java.lang.Object

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

Constructor Details

JdbcAgentDiscovery

public JdbcAgentDiscovery(JdbcHelper helper)

JdbcAgentDiscovery

public JdbcAgentDiscovery(JdbcHelper helper,
 AgenorTelemetry telemetry)

Parameters:

helper - JDBC helper; must not be null

telemetry - telemetry for directory.find spans; null treated as noop

Method Details

findById

public CompletableFuture<Optional<AgentDescriptor>> findById(String agentId)

Description copied from interface: AgentDiscovery

Finds an agent by its unique identifier.

Specified by:

findById in interface AgentDiscovery

Parameters:

agentId - the unique identifier, must not be null

Returns:

a future containing the descriptor if found, or empty if not registered

findByCapability

public CompletableFuture<List<AgentDescriptor>> findByCapability(String capability)

Description copied from interface: AgentDiscovery

Finds all agents that declare the given capability.

Specified by:

findByCapability in interface AgentDiscovery

Parameters:

capability - the capability tag, must not be null

Returns:

a future containing a (possibly empty) list of matching descriptors

findByType

public CompletableFuture<List<AgentDescriptor>> findByType(String agentType)

Description copied from interface: AgentDiscovery

Finds all agents of the given type.

Specified by:

findByType in interface AgentDiscovery

Parameters:

agentType - the agent type string, must not be null

Returns:

a future containing a (possibly empty) list of matching descriptors

findAgents

public CompletableFuture<Page<AgentDescriptor>> findAgents(AgentQuery query,
 PageRequest request)

Description copied from interface: AgentDiscovery

Finds agents matching the given query, returning a bounded page of results.

Use AgentQuery.all() to retrieve all agents with pagination.

Specified by:

findAgents in interface AgentDiscovery

Parameters:

query - the search criteria, must not be null

request - pagination parameters, must not be null

Returns:

a future containing the page of matching descriptors