UnetAgent (unet-framework 7.0.0 API)

org.arl.unet.UnetAgent

Underwater networking stack framework API agent. This class provides an agent superclass for all agents in UnetStack.

Field Summary

Fields
Modifiers	Name	Description
`protected org.arl.fjage.AgentID`	`paramChangeTopic`
`protected long`	`timeout`	Timeout used in request messages.

Inherited fields
Fields inherited from class	Fields
`class org.arl.fjage.Agent`	`NON_BLOCKING, BLOCKING`

Properties Summary

Properties
Type	Name and description
`java.util.logging.Level`	`logLevel`

Methods Summary

Methods
Type Params	Return Type	Name and description
	`protected void`	`addCapability(Capability cap)` Adds capability the agent is capable of.
	`protected java.util.List<java.lang.reflect.Parameter>`	`allOf(java.lang.Class... paramEnumClasses)` Generate a list of parameters from a parameter enumeration.
	`boolean`	`deregister(java.lang.String service)`
	`boolean`	`deregister(java.lang.Enum<?> service)`
	`protected void`	`die(java.lang.Throwable ex)`
	`protected java.lang.Object`	`get(org.arl.fjage.AgentID aid, org.arl.fjage.param.Parameter param)` Requests value of parameter from another agent.
	`protected java.lang.Object`	`get(org.arl.fjage.AgentID aid, int index, org.arl.fjage.param.Parameter param)` Requests value of indexed parameter from another agent.
	`protected java.lang.String`	`getBuildInfo()` Gets the build string for a given class.
	`java.util.logging.Level`	`getLogLevel()` Gets the current log level for the agent.
	`protected java.lang.Object`	`getParam(org.arl.fjage.param.Parameter p, int ndx)` Agents providing dynamic parameters may override this method to provide a value for a given parameter.
	`java.util.List<java.lang.Class<java.lang.reflect.Parameter>>`	`getParameterClasses()` Gets a list of parameter classes supported by this agent.
	`java.util.List<java.lang.Class<java.lang.reflect.Parameter>>`	`getParameterClasses(int index)` Gets a list of indexed parameter classes supported by this agent.
	`protected java.util.List<java.lang.reflect.Parameter>`	`getParameterList()` An agent supporting parameters should return a list of parameters by overriding this method.
	`protected java.util.List<java.lang.reflect.Parameter>`	`getParameterList(int index)` An agent supporting indexed parameters should return a list of indexed parameters by overriding this method.
	`java.lang.String[]`	`getServices()` Gets a list of services provided by the agent.
	`java.lang.String`	`getTitle()` Gets a descriptive name for the agent.
	`java.lang.String`	`getVersion()` Gets a version string for the agent.
	`protected void`	`init()` Initialize the unet agent and its behaviors.
	`protected java.lang.Boolean`	`isReadOnly(org.arl.fjage.param.Parameter p, int ndx)` Agents providing dynamic parameters may override this method to specify whether a parameter is read-only or read-write.
	`protected java.lang.Long`	`longValue(java.lang.Object v)` Returns the value of any given object as a Long. null objects have a null value.
	`protected boolean`	`notifyChange(org.arl.fjage.param.Parameter param, java.lang.Object value)` Helper to generate a parameter change notification.
	`protected boolean`	`notifyChange(org.arl.fjage.param.Parameter param, java.lang.Object value, int index)` Helper to generate a parameter change notification.
	`protected boolean`	`notifyChanges(java.util.List<java.lang.reflect.Parameter> param, java.util.List<java.lang.Object> values)` Helper to generate a parameter changes notification.
	`protected boolean`	`notifyChanges(java.util.List<java.lang.reflect.Parameter> param, java.util.List<java.lang.Object> values, int index)` Helper to generate a parameter changes notification.
	`protected void`	`processMessage(org.arl.fjage.Message msg)` An agent wishing to process all messages other than requests and queries may override this method to handle incoming messages.
	`protected org.arl.fjage.Message`	`processQuery(org.arl.fjage.Message msg)` An agent supporting queries should override this method to handle incoming queries.
	`protected org.arl.fjage.Message`	`processRequest(org.arl.fjage.Message msg)` An agent supporting requests should override this method to handle incoming requests.
	`boolean`	`register(java.lang.String service)`
	`boolean`	`register(java.lang.Enum<?> service)`
	`protected java.lang.Object`	`set(org.arl.fjage.AgentID aid, org.arl.fjage.param.Parameter param, java.lang.Object value)` Requests value of parameter to be changed in another agent.
	`protected java.lang.Object`	`set(org.arl.fjage.AgentID aid, int index, org.arl.fjage.param.Parameter param, java.lang.Object value)` Requests value of indexed parameter to be changed in another agent.
	`void`	`setLogLevel(java.util.logging.Level lvl)` Sets the current log level for the agent.
	`protected java.lang.Object`	`setParam(org.arl.fjage.param.Parameter p, int ndx, java.lang.Object v)` Agents providing dynamic parameters may override this method to set a value for a given parameter.
	`protected void`	`setup()` Called by UnetAgent when the agent is being initialized.
	`protected void`	`shutdown()`
	`protected void`	`startup()` Called by UnetAgent after all agents are fully initialized.
	`protected void`	`subscribeForService(java.lang.String service)` Subscribe to all agents providing a specified service.
	`protected void`	`subscribeForService(java.lang.Enum<?> service)` Subscribe to all agents providing a specified service.
	`protected org.arl.fjage.Message`	`trace(org.arl.fjage.Message msg)` Log event trace.
	`protected org.arl.fjage.Message`	`trace(org.arl.fjage.Message stimulus, org.arl.fjage.Message response)` Log event trace.
	`protected org.arl.fjage.Message`	`trace(org.arl.fjage.Message stimulus, org.arl.fjage.Message response, java.lang.Object info)` Log event trace.
	`protected void`	`unsubscribeForService(java.lang.String service)` Unsubscribe from all agents providing a specified service.
	`protected void`	`unsubscribeForService(java.lang.Enum<?> service)` Unsubscribe from all agents providing a specified service.

Inherited Methods Summary

Inherited Methods
Methods inherited from class	Name
`class org.arl.fjage.Agent`	org.arl.fjage.Agent#deregister(java.lang.String), org.arl.fjage.Agent#deregister(java.lang.Enum), org.arl.fjage.Agent#println(java.lang.Object), org.arl.fjage.Agent#run(), org.arl.fjage.Agent#add(org.arl.fjage.Behavior), org.arl.fjage.Agent#toString(), org.arl.fjage.Agent#register(java.lang.String), org.arl.fjage.Agent#register(java.lang.Enum), org.arl.fjage.Agent#clone(java.io.Serializable), org.arl.fjage.Agent#currentTimeMillis(), org.arl.fjage.Agent#nanoTime(), org.arl.fjage.Agent#getName(), org.arl.fjage.Agent#stop(), org.arl.fjage.Agent#getState(), org.arl.fjage.Agent#getType(), org.arl.fjage.Agent#getAgentID(), org.arl.fjage.Agent#prepareRequest(org.arl.fjage.Message), org.arl.fjage.Agent#platformSend(org.arl.fjage.Message), org.arl.fjage.Agent#setQueueSize(int), org.arl.fjage.Agent#unsubscribe(org.arl.fjage.AgentID), org.arl.fjage.Agent#agentForService(java.lang.Enum), org.arl.fjage.Agent#agentForService(java.lang.String), org.arl.fjage.Agent#agentsForService(java.lang.String), org.arl.fjage.Agent#agentsForService(java.lang.Enum), org.arl.fjage.Agent#getStore(), org.arl.fjage.Agent#receive(org.arl.fjage.Message, long), org.arl.fjage.Agent#receive(org.arl.fjage.MessageFilter, long), org.arl.fjage.Agent#receive(java.lang.Class), org.arl.fjage.Agent#receive(long), org.arl.fjage.Agent#receive(), org.arl.fjage.Agent#receive(java.lang.Class, long), org.arl.fjage.Agent#receive(org.arl.fjage.Message), org.arl.fjage.Agent#receive(org.arl.fjage.MessageFilter), org.arl.fjage.Agent#send(org.arl.fjage.Message), org.arl.fjage.Agent#wake(), org.arl.fjage.Agent#agent(java.lang.String), org.arl.fjage.Agent#topic(java.lang.Enum), org.arl.fjage.Agent#topic(java.lang.String), org.arl.fjage.Agent#topic(org.arl.fjage.AgentID, java.lang.String), org.arl.fjage.Agent#topic(org.arl.fjage.AgentID), org.arl.fjage.Agent#topic(org.arl.fjage.AgentID, java.lang.Enum), org.arl.fjage.Agent#topic(), org.arl.fjage.Agent#request(org.arl.fjage.Message, long), org.arl.fjage.Agent#request(org.arl.fjage.Message), org.arl.fjage.Agent#getContainer(), org.arl.fjage.Agent#getPlatform(), org.arl.fjage.Agent#setLogLevel(java.util.logging.Level), org.arl.fjage.Agent#subscribe(org.arl.fjage.AgentID), org.arl.fjage.Agent#wait(long, int), org.arl.fjage.Agent#wait(long), org.arl.fjage.Agent#wait(), org.arl.fjage.Agent#equals(java.lang.Object), org.arl.fjage.Agent#hashCode(), org.arl.fjage.Agent#getClass(), org.arl.fjage.Agent#notify(), org.arl.fjage.Agent#notifyAll()

- Field Detail
  - protected org.arl.fjage.AgentID paramChangeTopic
  - protected long timeout
    
    Timeout used in request messages.
- Property Detail
  - java.util.logging.Level logLevel
- Method Detail
  - protected void addCapability(Capability cap)
    
    Adds capability the agent is capable of.
    Parameters:
    cap - capability
  - @java.lang.SuppressWarnings({ "unchecked", "rawtypes" }) protected java.util.List<java.lang.reflect.Parameter> allOf(java.lang.Class... paramEnumClasses)
    
    Generate a list of parameters from a parameter enumeration. This method is designed for agents to use in the getParameterList() method.
    Parameters:
    paramEnumClasses - enums representing the parameters.
    Returns:
    list of parameters.
  - @java.lang.Override public boolean deregister(java.lang.String service)
  - @java.lang.Override public boolean deregister(java.lang.Enum<?> service)
  - @java.lang.Override protected void die(java.lang.Throwable ex)
  - protected java.lang.Object get(org.arl.fjage.AgentID aid, org.arl.fjage.param.Parameter param)
    
    Requests value of parameter from another agent.
    Parameters:
    aid - agent to request parameter from
    param - parameter to request
    Returns:
    value of parameter, null on error
  - protected java.lang.Object get(org.arl.fjage.AgentID aid, int index, org.arl.fjage.param.Parameter param)
    
    Requests value of indexed parameter from another agent.
    Parameters:
    aid - agent to request parameter from
    index - index of parameter set
    param - parameter to request
    Returns:
    value of parameter, null on error
  - protected java.lang.String getBuildInfo()
    
    Gets the build string for a given class. The build information is extracted from the jar is available.
    Returns:
    build information string if available, null otherwise.
  - public java.util.logging.Level getLogLevel()
    
    Gets the current log level for the agent.
    Returns:
    log level.
  - protected java.lang.Object getParam(org.arl.fjage.param.Parameter p, int ndx)
    
    Agents providing dynamic parameters may override this method to provide a value for a given parameter.
    Parameters:
    p - parameter to get value.
    ndx - index for indexed parameters, -1 if non-indexed.
    Returns:
    value of the parameter.
  - @java.lang.SuppressWarnings("unchecked") public java.util.List<java.lang.Class<java.lang.reflect.Parameter>> getParameterClasses()
    
    Gets a list of parameter classes supported by this agent.
    Returns:
    list of parameter classes, null if none supported.
  - @java.lang.SuppressWarnings("unchecked") public java.util.List<java.lang.Class<java.lang.reflect.Parameter>> getParameterClasses(int index)
    
    Gets a list of indexed parameter classes supported by this agent.
    Parameters:
    index - index to list parameter classes.
    Returns:
    list of parameter classes, null if none supported.
  - protected java.util.List<java.lang.reflect.Parameter> getParameterList()
    
    An agent supporting parameters should return a list of parameters by overriding this method.
    Returns:
    list of supported parameters, null if none supported.
  - protected java.util.List<java.lang.reflect.Parameter> getParameterList(int index)
    
    An agent supporting indexed parameters should return a list of indexed parameters by overriding this method.
    Parameters:
    index - index to list parameters.
    Returns:
    list of supported indexed parameters, null if none supported.
  - public java.lang.String[] getServices()
    
    Gets a list of services provided by the agent.
    Returns:
    array of services
  - public java.lang.String getTitle()
    
    Gets a descriptive name for the agent.
    Returns:
    descriptive name
  - public java.lang.String getVersion()
    
    Gets a version string for the agent.
    Returns:
    version information
  - @java.lang.Override protected void init()
    
    Initialize the unet agent and its behaviors.
  - protected java.lang.Boolean isReadOnly(org.arl.fjage.param.Parameter p, int ndx)
    
    Agents providing dynamic parameters may override this method to specify whether a parameter is read-only or read-write.
    Parameters:
    p - parameter to get value.
    ndx - index for indexed parameters, -1 if non-indexed.
    Returns:
    true if parameter is read-only, false if read-write, null if not a dynamic parameter.
  - protected java.lang.Long longValue(java.lang.Object v)
    
    Returns the value of any given object as a Long. null objects have a null value. Numeric values are converted to the closest Long value. String values are parsed into Long. Booleans have a value of 1 if true, and 0 if false. Any other type of input value results in a null.
    Parameters:
    v - object to convert to Long.
    Returns:
    Long value.
  - protected boolean notifyChange(org.arl.fjage.param.Parameter param, java.lang.Object value)
    
    Helper to generate a parameter change notification.
    Parameters:
    param - parameter that changed.
    value - new value of parameter.
  - protected boolean notifyChange(org.arl.fjage.param.Parameter param, java.lang.Object value, int index)
    
    Helper to generate a parameter change notification.
    index:
    index of parameter set.
    
    Parameters:
    param - parameter that changed.
    value - new value of parameter.
  - protected boolean notifyChanges(java.util.List<java.lang.reflect.Parameter> param, java.util.List<java.lang.Object> values)
    
    Helper to generate a parameter changes notification.
    Parameters:
    param - parameter that changed.
  - protected boolean notifyChanges(java.util.List<java.lang.reflect.Parameter> param, java.util.List<java.lang.Object> values, int index)
    
    Helper to generate a parameter changes notification.
    index:
    index of parameter set.
    
    Parameters:
    param - parameter that changed.
  - protected void processMessage(org.arl.fjage.Message msg)
    
    An agent wishing to process all messages other than requests and queries may override this method to handle incoming messages.
    Parameters:
    msg - incoming message.
  - protected org.arl.fjage.Message processQuery(org.arl.fjage.Message msg)
    
    An agent supporting queries should override this method to handle incoming queries.
    Parameters:
    msg - incoming query.
    Returns:
    response message to send back.
  - protected org.arl.fjage.Message processRequest(org.arl.fjage.Message msg)
    
    An agent supporting requests should override this method to handle incoming requests.
    Parameters:
    msg - incoming request.
    Returns:
    response message to send back.
  - @java.lang.Override public boolean register(java.lang.String service)
  - @java.lang.Override public boolean register(java.lang.Enum<?> service)
  - protected java.lang.Object set(org.arl.fjage.AgentID aid, org.arl.fjage.param.Parameter param, java.lang.Object value)
    
    Requests value of parameter to be changed in another agent.
    Parameters:
    aid - agent to request parameter change
    param - parameter to request to be changed
    value - new value of parameter
    Returns:
    newly set value of parameter, null on error
  - protected java.lang.Object set(org.arl.fjage.AgentID aid, int index, org.arl.fjage.param.Parameter param, java.lang.Object value)
    
    Requests value of indexed parameter to be changed in another agent.
    Parameters:
    aid - agent to request parameter change
    index - index of parameter set
    param - parameter to request to be changed
    value - new value of parameter
    Returns:
    newly set value of parameter, null on error
  - public void setLogLevel(java.util.logging.Level lvl)
    
    Sets the current log level for the agent.
    Parameters:
    lvl - log level
  - protected java.lang.Object setParam(org.arl.fjage.param.Parameter p, int ndx, java.lang.Object v)
    
    Agents providing dynamic parameters may override this method to set a value for a given parameter.
    Parameters:
    p - parameter to set value.
    ndx - index for indexed parameters, -1 if non-indexed.
    v - value of the parameter.
    Returns:
    new value of the parameter.
  - protected void setup()
    
    Called by UnetAgent when the agent is being initialized.
  - @java.lang.Override protected void shutdown()
  - protected void startup()
    
    Called by UnetAgent after all agents are fully initialized.
  - protected void subscribeForService(java.lang.String service)
    
    Subscribe to all agents providing a specified service.
    Parameters:
    service - name of the service
  - protected void subscribeForService(java.lang.Enum<?> service)
    
    Subscribe to all agents providing a specified service.
    Parameters:
    service - name of the service
  - protected org.arl.fjage.Message trace(org.arl.fjage.Message msg)
    
    Log event trace.
    Parameters:
    msg - unsolicited message or a message with an inReplyTo field.
    Returns:
    message
  - protected org.arl.fjage.Message trace(org.arl.fjage.Message stimulus, org.arl.fjage.Message response)
    
    Log event trace.
    Parameters:
    stimulus - message that resulted in this event.
    response - message that was generated as part of this event.
    Returns:
    response message
  - protected org.arl.fjage.Message trace(org.arl.fjage.Message stimulus, org.arl.fjage.Message response, java.lang.Object info)
    
    Log event trace.
    Parameters:
    stimulus - message that resulted in this event.
    response - message that was generated as part of this event.
    info - event-specific information.
    Returns:
    response message
  - protected void unsubscribeForService(java.lang.String service)
    
    Unsubscribe from all agents providing a specified service.
    Parameters:
    service - name of the service
  - protected void unsubscribeForService(java.lang.Enum<?> service)
    
    Unsubscribe from all agents providing a specified service.
    Parameters:
    service - name of the service

Summary:
Field
Property
Method

| Detail:
Field
Property
Method

Groovy Documentation

[Java] Class UnetAgent

Field Summary

Properties Summary

Methods Summary

Inherited Methods Summary

Field Detail

protected org.arl.fjage.AgentID paramChangeTopic

protected long timeout

Property Detail

java.util.logging.Level logLevel

Method Detail

protected void addCapability(Capability cap)

@java.lang.SuppressWarnings({ "unchecked", "rawtypes" }) protected java.util.List<java.lang.reflect.Parameter> allOf(java.lang.Class... paramEnumClasses)

@java.lang.Override public boolean deregister(java.lang.String service)

@java.lang.Override public boolean deregister(java.lang.Enum<?> service)

@java.lang.Override protected void die(java.lang.Throwable ex)

protected java.lang.Object get(org.arl.fjage.AgentID aid, org.arl.fjage.param.Parameter param)

protected java.lang.Object get(org.arl.fjage.AgentID aid, int index, org.arl.fjage.param.Parameter param)

protected java.lang.String getBuildInfo()

public java.util.logging.Level getLogLevel()

protected java.lang.Object getParam(org.arl.fjage.param.Parameter p, int ndx)

@java.lang.SuppressWarnings("unchecked") public java.util.List<java.lang.Class<java.lang.reflect.Parameter>> getParameterClasses()

@java.lang.SuppressWarnings("unchecked") public java.util.List<java.lang.Class<java.lang.reflect.Parameter>> getParameterClasses(int index)

protected java.util.List<java.lang.reflect.Parameter> getParameterList()

protected java.util.List<java.lang.reflect.Parameter> getParameterList(int index)

public java.lang.String[] getServices()

public java.lang.String getTitle()

public java.lang.String getVersion()

@java.lang.Override protected void init()

protected java.lang.Boolean isReadOnly(org.arl.fjage.param.Parameter p, int ndx)

protected java.lang.Long longValue(java.lang.Object v)

protected boolean notifyChange(org.arl.fjage.param.Parameter param, java.lang.Object value)

protected boolean notifyChange(org.arl.fjage.param.Parameter param, java.lang.Object value, int index)

protected boolean notifyChanges(java.util.List<java.lang.reflect.Parameter> param, java.util.List<java.lang.Object> values)

protected boolean notifyChanges(java.util.List<java.lang.reflect.Parameter> param, java.util.List<java.lang.Object> values, int index)

protected void processMessage(org.arl.fjage.Message msg)

protected org.arl.fjage.Message processQuery(org.arl.fjage.Message msg)

protected org.arl.fjage.Message processRequest(org.arl.fjage.Message msg)

@java.lang.Override public boolean register(java.lang.String service)

@java.lang.Override public boolean register(java.lang.Enum<?> service)

protected java.lang.Object set(org.arl.fjage.AgentID aid, org.arl.fjage.param.Parameter param, java.lang.Object value)

protected java.lang.Object set(org.arl.fjage.AgentID aid, int index, org.arl.fjage.param.Parameter param, java.lang.Object value)

public void setLogLevel(java.util.logging.Level lvl)

protected java.lang.Object setParam(org.arl.fjage.param.Parameter p, int ndx, java.lang.Object v)

protected void setup()

@java.lang.Override protected void shutdown()

protected void startup()

protected void subscribeForService(java.lang.String service)

protected void subscribeForService(java.lang.Enum<?> service)

protected org.arl.fjage.Message trace(org.arl.fjage.Message msg)

protected org.arl.fjage.Message trace(org.arl.fjage.Message stimulus, org.arl.fjage.Message response)

protected org.arl.fjage.Message trace(org.arl.fjage.Message stimulus, org.arl.fjage.Message response, java.lang.Object info)

protected void unsubscribeForService(java.lang.String service)

protected void unsubscribeForService(java.lang.Enum<?> service)