Package jade.core.messaging

Class MomMessagingService

java.lang.Object

jade.core.BaseService

jade.core.messaging.MessagingService

jade.core.messaging.MomMessagingService

All Implemented Interfaces:

jade.core.messaging.MessageManager.Channel, Service

public abstract class MomMessagingService
extends MessagingService

Nested Class Summary

Nested classes/interfaces inherited from class jade.core.messaging.MessagingService

MessagingService.UnknownACLEncodingException

Nested classes/interfaces inherited from interface jade.core.Service

Service.Slice, Service.SliceProxy

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	active
protected String	myLocation
static String	SEPARATOR

Fields inherited from class jade.core.messaging.MessagingService

ATTACH_PLATFORM_INFO, CACHE_SIZE, CACHE_SIZE_DEFAULT, cachedSlices, DELIVERY_TIME_MEASUREMENT_RATE, DELIVERY_TIME_MEASUREMENT_RATE_DEFAULT, ENABLE_MESSAGE_MANAGER_METRICS, ENABLE_POSTED_MESSAGE_COUNT, MAX_DELIVERY_RETRY_ATTEMPTS, MAX_DELIVERY_RETRY_ATTEMPTS_DEFAULT, maxDeliveryRetryAttempts, MTP_IDENTIFIER, myContainer, myProfile, NAME, PLATFORM_IDENTIFIER

Fields inherited from class jade.core.BaseService

ALL_DUMP_KEY, MAIN_SLICE, myFinder, myLogger, THIS_SLICE

Fields inherited from interface jade.core.Service

ADOPTED_NODE, DEAD_NODE, DEAD_PLATFORM_MANAGER, DEAD_REPLICA, DEAD_SLICE, NEW_NODE, NEW_REPLICA, NEW_SLICE, REATTACHED, RECONNECTED

Constructor Summary

Constructors

Constructor	Description
MomMessagingService()

Method Summary

Modifier and Type	Method	Description
void	boot(Profile myProfile)	Performs the active initialization step of a kernel-level service: Activates the ACL codecs and MTPs as specified in the given Profile instance.
protected void	deliverInLocalPlatfrom(GenericMessage msg, AID receiverID)
protected String	extractSource(String deliveryID)
protected String	generateDeliveryID(AID senderID, GenericMessage msg, AID receiverID)
Sink	getCommandSink(boolean side)	Access the command sink this service uses to handle its own vertical commands.
protected void	handleDeliveryResult(String deliveryID, Throwable t)
protected void	handleMessageFromMom(String deliveryID, AID senderID, GenericMessage msg, AID receiverID, String senderLocation)
protected void	handleReceiptFromMom(String deliveryID, Throwable t)
protected void	initMom()
protected abstract void	sendMessageViaMom(String deliveryID, AID senderID, GenericMessage msg, AID receiverID, String receiverLocation)
protected abstract void	sendReceiptViaMom(String deliveryID, String messageSenderLocation, Throwable failure)
void	shutdown()	Performs the shutdown step of a kernel-level service.
protected void	shutdownMom()

Methods inherited from class jade.core.messaging.MessagingService

checkTracing, clearCachedSlice, deadAlias, deliverNow, dump, getAgentLocation, getCommandFilter, getFreshSlice, getHelper, getHorizontalInterface, getLocalSlice, getMessageManagerGlobalInfo, getMessageManagerQueueStatus, getMessageManagerThreadPool, getMessageManagerThreadPoolStatus, getName, getOwnedCommands, init, newAlias, notifyFailureToSender, removeGlobalAliases

Methods inherited from class jade.core.BaseService

addAlias, broadcast, createInvokator, getAllSlices, getAMSBehaviour, getIMTPManager, getLocalNode, getNumberOfSlices, getSlice, isLocal, lookupAlias, stringifySlice, submit

Methods inherited from class java.lang.Object

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

Field Detail

SEPARATOR

public static final String SEPARATOR

See Also:

Constant Field Values

myLocation

protected String myLocation

active

protected boolean active

Constructor Detail

MomMessagingService

public MomMessagingService()

Method Detail

boot

public void boot(Profile myProfile)
          throws ServiceException

Description copied from class: MessagingService

Performs the active initialization step of a kernel-level service: Activates the ACL codecs and MTPs as specified in the given Profile instance.

Specified by:

boot in interface Service

Overrides:

boot in class MessagingService

Parameters:

myProfile - The Profile instance containing the list of ACL codecs and MTPs to activate on this node.

Throws:

ServiceException - If a problem occurs during service initialization.

shutdown

public void shutdown()

Description copied from interface: Service

Performs the shutdown step of a kernel-level service. The JADE kernel calls this method just before uninstalling this service

Specified by:

shutdown in interface Service

Overrides:

shutdown in class MessagingService

getCommandSink

public Sink getCommandSink(boolean side)

Description copied from class: MessagingService

Access the command sink this service uses to handle its own vertical commands.

Specified by:

getCommandSink in interface Service

Overrides:

getCommandSink in class MessagingService

Parameters:

side - One of the two constants Sink.COMMAND_SOURCE or Sink.COMMAND_TARGET, to state whether this sink will handle locally issued commands or commands incoming from remote nodes.

Returns:

Concrete services must return their own implementation of the Sink interface, that will be invoked by the kernel in order to consume any incoming vertical command owned by this service. If the service does not wish to install a command sink, it can just return null.

See Also:

Service.getOwnedCommands()

initMom

protected void initMom()

shutdownMom

protected void shutdownMom()

generateDeliveryID

protected String generateDeliveryID(AID senderID,
                                    GenericMessage msg,
                                    AID receiverID)

extractSource

protected String extractSource(String deliveryID)

deliverInLocalPlatfrom

protected void deliverInLocalPlatfrom(GenericMessage msg,
                                      AID receiverID)
                               throws IMTPException,
                                      ServiceException,
                                      NotFoundException,
                                      JADESecurityException

Overrides:

deliverInLocalPlatfrom in class MessagingService

Throws:

IMTPException

ServiceException

NotFoundException

JADESecurityException

handleDeliveryResult

protected void handleDeliveryResult(String deliveryID,
                                    Throwable t)

sendMessageViaMom

protected abstract void sendMessageViaMom(String deliveryID,
                                          AID senderID,
                                          GenericMessage msg,
                                          AID receiverID,
                                          String receiverLocation)
                                   throws IMTPException

Throws:

IMTPException

sendReceiptViaMom

protected abstract void sendReceiptViaMom(String deliveryID,
                                          String messageSenderLocation,
                                          Throwable failure)

handleMessageFromMom

protected void handleMessageFromMom(String deliveryID,
                                    AID senderID,
                                    GenericMessage msg,
                                    AID receiverID,
                                    String senderLocation)

handleReceiptFromMom

protected void handleReceiptFromMom(String deliveryID,
                                    Throwable t)