Module swim.api

Package swim.api.agent

Interface AgentContext

All Superinterfaces:

DataFactory, DownlinkFactory, LaneFactory, swim.util.Log, SwimRef

public interface AgentContext
extends SwimRef, LaneFactory, DataFactory, swim.util.Log

Internal context that enables URI-based addressability, contextual Lane and Store creation mechanisms, logging, and scheduling to some Agent.

Method Summary

Modifier and Type	Method	Description
<A extends Agent> A	addTrait(String name, Class<A> agentClass)
<A extends Agent> A	addTrait(String name, AgentFactory<A> agentFactory)
<A extends Agent> A	addTrait(swim.structure.Value props, Class<A> agentClass)
<A extends Agent> A	addTrait(swim.structure.Value props, AgentFactory<A> agentFactory)
AgentType<?>	agentType()	The AgentType corresponding to the Java class of the Agent that this AgentContext manages.
Lane	getLane(swim.uri.Uri laneUri)	Returns the Lane belonging to the Agent managed by this AgentContext that is addressable by laneUri, or null if no such Lane exists.
swim.structure.Value	getProp(String name)	Returns the value of name in props().
swim.structure.Value	getProp(swim.structure.Value key)	Returns the value of key in props().
<A extends Agent> A	getTrait(Class<A> agentClass)
<A extends Agent> A	getTrait(String name)
<A extends Agent> A	getTrait(swim.structure.Value props)
swim.uri.Uri	hostUri()	The hostUri of the Agent managed by this AgentContext.
Lane	lane()	Returns the currently executing lane, or null if not currently executing a lane or link callback.
Link	link()	Returns the currently executing link, or null if not currently executing a link callback.
swim.uri.Uri	nodeUri()	The nodeUri of the Agent managed by this AgentContext.
Lane	openLane(swim.uri.Uri laneUri, Lane lane)	Registers lane with laneUri and returns lane.
swim.structure.Value	props()	A Record that maps every dynamic property in nodeUri(), as defined by {@code agentType().route()}, to its value.
void	removeTrait(String name)
void	removeTrait(swim.structure.Value props)
swim.concurrent.Schedule	schedule()	The Schedule that this AgentContext is bound to.
swim.concurrent.Stage	stage()	The Stage that this AgentContext is bound to.
swim.collections.FingerTrieSeq<Agent>	traits()

Methods inherited from interface swim.api.data.DataFactory

geospatialData, geospatialData, listData, listData, mapData, mapData, spatialData, spatialData, valueData, valueData

Methods inherited from interface swim.api.downlink.DownlinkFactory

downlink, downlinkHttp, downlinkList, downlinkMap, downlinkValue

Methods inherited from interface swim.api.lane.LaneFactory

commandLane, demandLane, demandMapLane, geospatialLane, joinMapLane, joinValueLane, listLane, mapLane, spatialLane, supplyLane, valueLane

Methods inherited from interface swim.util.Log

debug, error, info, trace, warn

Methods inherited from interface swim.api.ref.SwimRef

close, command, command, command, command, command, command, command, command, hostRef, hostRef, laneRef, laneRef, laneRef, laneRef, nodeRef, nodeRef, nodeRef, nodeRef

Method Detail

hostUri

swim.uri.Uri hostUri()

The hostUri of the Agent managed by this AgentContext.

nodeUri

swim.uri.Uri nodeUri()

The nodeUri of the Agent managed by this AgentContext.

agentType

AgentType<?> agentType()

The AgentType corresponding to the Java class of the Agent that this AgentContext manages.

props

swim.structure.Value props()

A Record that maps every dynamic property in nodeUri(), as defined by {@code agentType().route()}, to its value. An empty result indicates that nodeUri contains no dynamic components.

getProp

swim.structure.Value getProp(swim.structure.Value key)

Returns the value of key in props().

getProp

swim.structure.Value getProp(String name)

Returns the value of name in props().

schedule

swim.concurrent.Schedule schedule()

The Schedule that this AgentContext is bound to.

stage

swim.concurrent.Stage stage()

The Stage that this AgentContext is bound to.

lane

Lane lane()

Returns the currently executing lane, or null if not currently executing a lane or link callback.

link

Link link()

Returns the currently executing link, or null if not currently executing a link callback.

traits

swim.collections.FingerTrieSeq<Agent> traits()

getTrait

<A extends Agent> A getTrait(swim.structure.Value props)

getTrait

<A extends Agent> A getTrait(String name)

getTrait

<A extends Agent> A getTrait(Class<A> agentClass)

addTrait

<A extends Agent> A addTrait(swim.structure.Value props,
                             AgentFactory<A> agentFactory)

addTrait

<A extends Agent> A addTrait(String name,
                             AgentFactory<A> agentFactory)

addTrait

<A extends Agent> A addTrait(swim.structure.Value props,
                             Class<A> agentClass)

addTrait

<A extends Agent> A addTrait(String name,
                             Class<A> agentClass)

removeTrait

void removeTrait(swim.structure.Value props)

removeTrait

void removeTrait(String name)

getLane

Lane getLane(swim.uri.Uri laneUri)

Returns the Lane belonging to the Agent managed by this AgentContext that is addressable by laneUri, or null if no such Lane exists.

openLane

Lane openLane(swim.uri.Uri laneUri,
              Lane lane)

Registers lane with laneUri and returns lane.