org.nuin.agent.service
Interface ServiceActionAdapter

All Known Implementing Classes:

BindActionAdapter

public interface ServiceActionAdapter

Interface that provides an adapter from an action name as a symbol in an agent script to the service method that performs the action

Version:

Release 0.4.0 (build 50) ($Id: ServiceActionAdapter.java,v 1.5 2004/11/01 22:01:26 ian_dickinson Exp $)

Author:

Ian Dickinson, HP Labs (email)

Method Summary

ActionResult

perform(AgentService service, KsAction action, Intention intention, KsVar output) Perform the named action, using the given arguments as parameters.

Method Detail

perform

ActionResult perform(AgentService service,
                     KsAction action,
                     Intention intention,
                     KsVar output)

Perform the named action, using the given arguments as parameters.

Parameters:

service - The service instance that will perform the action

action - Encapsulates the operation name, and fixed and open argument sets

intention - The intention in which the operation is being invoked (and which provides execution state, such as the current variable bindings).

output - An option variable that can be bound to the output result of the service, if any, or null if no output is expected. The output variable is only bound when the output status is ActionResult.SUCCESS or ActionResult.SUCCESS_NO_COMMIT.

Returns:

The action status, succeeded, failed or ongoing