tryllian.afc.task.standard
Class CheckpointTask

java.lang.Object
  tryllian.afc.task.AbstractTask
      tryllian.afc.task.DefaultTask
          tryllian.afc.task.standard.CheckpointTask

All Implemented Interfaces:

AREMessaging, java.util.EventListener, FIPA, LanguageSubjects, LanguageTokens, MessageHandler, java.io.Serializable, Task

public class CheckpointTask

extends DefaultTask

implements FIPA, LanguageSubjects

Checkpoints the agent.

With 'checkpointing' is meant that the current state of the agent is stored in the persistence database of the habitat. In principle, the ADK takes care of this automatically whenever needed. Explicit checkpointing may be useful in case the agent reached a 'milestone' state worth saving just in case the habitat might get stopped and restarted.

Note: Checkpointing is not supported for all agents. If an agent is transient, that is, when it implements TransientAgent, the agent cannot be checkpointed.

Succeeds

• If the agent was checkpointed succesfully.

Fails

• If checkpointing fails for some regular reason, for example if the agent is transient. Finish value: a String message starting with 'Checkpointing failed' and ending with the reason of failure.
• Some unforseen exception occurred. Finish value: the exception.

Since:

1.3.9

See Also:

Serialized Form

Field Summary

Fields inherited from class tryllian.afc.task.AbstractTask

NL

Fields inherited from interface tryllian.are.fipa.constants.FIPA

FIELD_CONTENT_LANGUAGE, FIELD_CONVERSATION_ID, FIELD_IN_REPLY_TO, FIELD_PERFORMATIVE, FIELD_REPLY_WITH, PERF_AGREE, PERF_CANCEL, PERF_FAILURE, PERF_INFORM, PERF_NOT_UNDERSTOOD, PERF_QUERY_REF, PERF_REFUSE, PERF_REQUEST, PERF_SUBSCRIBE, VALUE_CONTENT_TYPE_FIPA

Fields inherited from interface tryllian.are.fipa.constants.AREMessaging

DELIVERY_REPORT_ALWAYS, DELIVERY_REPORT_FAILURE_ONLY, DELIVERY_REPORT_NEVER, DELIVERY_REPORT_SUCCESS_ONLY, FIELD_CONTENT_TYPE, FIELD_DELIVERY_REPORT, FIELD_REPLY_INFO, FIELD_UNIVERSAL_MEANING, VALUE_REPLY_NEVER, VALUE_REPLY_NORMAL, VALUE_UNIVERSAL_GO_AWAY, VALUE_UNIVERSAL_NOT_UNDERSTOOD, VALUE_UNIVERSAL_SLOW_DOWN

Fields inherited from interface tryllian.are.fipa.constants.LanguageSubjects

ACCEPT_FILE_TRANSFER, ACCEPT_INTER_HABITAT_TRANSFER, AGENT_CREATION_RESULT, AGENT_MOVEMENT, AGENT_REGISTRATION, AGENT_STATISTICS, AGENTS_IN_GROUP, CERTIFICATE_AGENT, CHECK_PERMISSION, CHECKPOINT_RESPONSE, CHECKPOINT_SENDER, CLONE_AGENT, CREATE_AGENT, CREATE_GROUP, CURRENT_AGENT_ADDRESSES, DELETE_GROUP, DELIVERY_REPORT, ECHO_REQUEST, FILE_TRANSFER_DROPBOX, FILE_TRANSFER_STATUS, GROUPS, INTER_HABITAT_TRANSFER, JNDI_RESOLVE, JOIN_GROUP, KILL_AGENT, KILL_SENDER, LEAVE_GROUP, MISSING_DEPENDENCIES, MOVE_SENDER, REGISTER_SENDER_AS_SERVICE, RELOAD_PERMISSIONPOLICY, RESTORE, RESTORE_ALL, SEND_AGENT, SERVICE_ADDRESS, SETTINGS, SHUTDOWN_HABITAT, STATISTICS, SUSPEND_SENDER, TRANSFER_FILE, UNREGISTER_SENDER_AS_SERVICE, UPGRADE_AGENT, WAKEUP, YOU_ARE_A_CLONE, YOU_HAVE_BEEN_CLONED, YOU_HAVE_BEEN_UPGRADED

Fields inherited from interface tryllian.afc.task.Task

EMPTY_FINISH_VALUE, FORCED_FINISH_FAILURE, NO_TIME_OUT, TASK_TIMED_OUT

Constructor Summary

CheckpointTask()

Method Summary

void	handleMessage(IncomingMessage message) Handle reply messages; expecting agree + inform or failure.
void	taskEnded() Cleanup.
void	taskStarted() Start the task by sending the request in a new conversation.

Methods inherited from class tryllian.afc.task.DefaultTask

addFinishingTask, addTask, getSubtasks, handleHeartbeat, propagateHeartbeat

Methods inherited from class tryllian.afc.task.AbstractTask

addTaskListener, fail, fail, finish, finish, finish, forceFinish, forceFinish, getAgentContext, getFinishValue, getState, getSupertask, getTimeOut, heartbeatReceived, logException, messageReceived, removeTaskListener, setAgentContext, setFinishValue, setTimeOut, succeed, succeed, taskAdded, taskRemoved

Methods inherited from class java.lang.Object

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

Constructor Detail

CheckpointTask

public CheckpointTask()

Method Detail

taskStarted

public void taskStarted()

Start the task by sending the request in a new conversation.

Overrides:

taskStarted in class AbstractTask

taskEnded

public void taskEnded()

Cleanup.

Overrides:

taskEnded in class AbstractTask

handleMessage

public void handleMessage(IncomingMessage message)

Handle reply messages; expecting agree + inform or failure.

Overrides:

handleMessage in class AbstractTask