things.thinger.service.command
Interface Commander

All Known Implementing Classes:
LocalCommander

public interface Commander

Interface to a commander.

Version:
1.0

Version History

EPG - Initial - 22 MAY 06
 
Author:
Erich P. Gatejen

Method Summary
 void disposal()
          Allow the disposal procecure to run.
 Receipt issueCommand(Command commandToIssue)
          This will issue a command.
 CommandResponse queryResponse(Receipt commandReceipt)
          Query the reponse progress a command.
 

Method Detail

issueCommand

Receipt issueCommand(Command commandToIssue)
                     throws SystemException
This will issue a command. It returns a receipt for the issuance, not for the other all interaction.

Parameters:
commandToIssue - The command to issue.
Throws:
SystemException

queryResponse

CommandResponse queryResponse(Receipt commandReceipt)
                              throws SystemException
Query the reponse progress a command. It is up to the implementation as to when responses are handled. If they are not handled in a separate thread, it is possible this call with take time to handle responses. The implementation will make a best-effort to keep InterruptedExceptions from fouling the process. If it successful, the interruption will propagate as a simple WARNING level SystemException. If not, you could see anything up to a PANIC.

Parameters:
commandReceipt - The issuance receipt.
Returns:
A response object.
Throws:
SystemException

disposal

void disposal()
              throws SystemException
Allow the disposal procecure to run. It is safe to call this any time. It will sweep any DISPOSED responses from the system, which may build up over time. The CommandResponse implementations may or may not call it.

Throws:
SystemException


Things.