aa.app.dm
Class DirectoryManager

java.lang.Object
  aa.core.Actor
      aa.app.dm.DirectoryManager

All Implemented Interfaces:

java.io.Serializable

public class DirectoryManager

extends Actor

This class provides three different types of middle man service: matchmaking, brokering, and active brokering service.

History:

• February 19, 2004 - version 0.0.4
  • move the active brokering service from this actor to aa.app.atspace.ATSpace.
  • add the 'update' method.
• January 26, 2003 - version 0.0.3
  • modify this file.
• May 9, 2003 - version 0.0.2
  • modify internal comments.
• April 5, 2001 - version 0.0.1
  • create this file.

Version:

$Date: 2008/01/01 00:23:55 $ $Revision: 1.1 $

Author:

Myeong-Wuk Jang

See Also:

Serialized Form

Field Summary

protected PublicTupleSpace

m_pubTSpace Tuple Space as a blackboard.

Fields inherited from class aa.core.Actor

m_athread

Constructor Summary

DirectoryManager()
Creates a Directory Manager.

Method Summary

boolean	deliver(ActorTuple p_atReceiver, java.lang.String p_strMethod)
protected boolean	deliver(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.lang.Object[] p_objaArgs) Delivers a message to a randomly selected actor whose information is matched with the given tuple pattern.
boolean	deliver(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.io.Serializable p_serArg1)
boolean	deliver(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.io.Serializable p_serArg1, java.io.Serializable p_serArg2)
boolean	deliver(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.io.Serializable p_serArg1, java.io.Serializable p_serArg2, java.io.Serializable p_serArg3)
boolean	deliver(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.io.Serializable p_serArg1, java.io.Serializable p_serArg2, java.io.Serializable p_serArg3, java.io.Serializable p_serArg4)
boolean	deliver(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.io.Serializable p_serArg1, java.io.Serializable p_serArg2, java.io.Serializable p_serArg3, java.io.Serializable p_serArg4, java.io.Serializable p_serArg5)
boolean	deliver(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.io.Serializable p_serArg1, java.io.Serializable p_serArg2, java.io.Serializable p_serArg3, java.io.Serializable p_serArg4, java.io.Serializable p_serArg5, java.io.Serializable p_serArg6)
boolean	deliver(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.io.Serializable p_serArg1, java.io.Serializable p_serArg2, java.io.Serializable p_serArg3, java.io.Serializable p_serArg4, java.io.Serializable p_serArg5, java.io.Serializable p_serArg6, java.io.Serializable p_serArg7)
boolean	deliver(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.io.Serializable p_serArg1, java.io.Serializable p_serArg2, java.io.Serializable p_serArg3, java.io.Serializable p_serArg4, java.io.Serializable p_serArg5, java.io.Serializable p_serArg6, java.io.Serializable p_serArg7, java.io.Serializable p_serArg8)
boolean	deliver(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.io.Serializable p_serArg1, java.io.Serializable p_serArg2, java.io.Serializable p_serArg3, java.io.Serializable p_serArg4, java.io.Serializable p_serArg5, java.io.Serializable p_serArg6, java.io.Serializable p_serArg7, java.io.Serializable p_serArg8, java.io.Serializable p_serArg9)
boolean	deliver(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.io.Serializable p_serArg1, java.io.Serializable p_serArg2, java.io.Serializable p_serArg3, java.io.Serializable p_serArg4, java.io.Serializable p_serArg5, java.io.Serializable p_serArg6, java.io.Serializable p_serArg7, java.io.Serializable p_serArg8, java.io.Serializable p_serArg9, java.io.Serializable p_serArg10)
boolean	deliverAll(ActorTuple p_atReceiver, java.lang.String p_strMethod)
protected boolean	deliverAll(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.lang.Object[] p_objaArgs) Broadcasts a message to all actors whose information is matched with the given tuple pattern.
boolean	deliverAll(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.io.Serializable p_serArg1)
boolean	deliverAll(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.io.Serializable p_serArg1, java.io.Serializable p_serArg2)
boolean	deliverAll(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.io.Serializable p_serArg1, java.io.Serializable p_serArg2, java.io.Serializable p_serArg3)
boolean	deliverAll(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.io.Serializable p_serArg1, java.io.Serializable p_serArg2, java.io.Serializable p_serArg3, java.io.Serializable p_serArg4)
boolean	deliverAll(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.io.Serializable p_serArg1, java.io.Serializable p_serArg2, java.io.Serializable p_serArg3, java.io.Serializable p_serArg4, java.io.Serializable p_serArg5)
boolean	deliverAll(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.io.Serializable p_serArg1, java.io.Serializable p_serArg2, java.io.Serializable p_serArg3, java.io.Serializable p_serArg4, java.io.Serializable p_serArg5, java.io.Serializable p_serArg6)
boolean	deliverAll(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.io.Serializable p_serArg1, java.io.Serializable p_serArg2, java.io.Serializable p_serArg3, java.io.Serializable p_serArg4, java.io.Serializable p_serArg5, java.io.Serializable p_serArg6, java.io.Serializable p_serArg7)
boolean	deliverAll(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.io.Serializable p_serArg1, java.io.Serializable p_serArg2, java.io.Serializable p_serArg3, java.io.Serializable p_serArg4, java.io.Serializable p_serArg5, java.io.Serializable p_serArg6, java.io.Serializable p_serArg7, java.io.Serializable p_serArg8)
boolean	deliverAll(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.io.Serializable p_serArg1, java.io.Serializable p_serArg2, java.io.Serializable p_serArg3, java.io.Serializable p_serArg4, java.io.Serializable p_serArg5, java.io.Serializable p_serArg6, java.io.Serializable p_serArg7, java.io.Serializable p_serArg8, java.io.Serializable p_serArg9)
boolean	deliverAll(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.io.Serializable p_serArg1, java.io.Serializable p_serArg2, java.io.Serializable p_serArg3, java.io.Serializable p_serArg4, java.io.Serializable p_serArg5, java.io.Serializable p_serArg6, java.io.Serializable p_serArg7, java.io.Serializable p_serArg8, java.io.Serializable p_serArg9, java.io.Serializable p_serArg10)
protected boolean	deliverAllImpl(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.lang.Object[] p_objaArgs) Broadcasts a message to all actors whose information is matched with the given tuple pattern.
protected boolean	deliverImpl(ActorTuple p_atReceiver, java.lang.String p_strMethod, java.lang.Object[] p_objaArgs) Delivers a message to a randomly selected actor whose information is matched with the given tuple pattern.
void	deregister(ActorTuple p_atTuple) Removes an actor tuple in this Directory Manager.
void	printAll() Prints all actor tuples in this Directory Manager.
void	register(ActorTuple p_atTuple) Registers an actor tuple to this Directory Manager.
ActorName	search(ActorTuple p_atTemplate) Retrieves any one of names of actors that support the specified tuple.
ActorName[]	searchAll(ActorTuple p_atTemplate) Retrieves names of all actors that support the specified attribute.
void	update(ActorTuple p_atTemplate, ActorTuple p_atTuple) Removes actor tuples matched with the given tuple template, and then inserts an actor tuple in this tuple space.

Methods inherited from class aa.core.Actor

become, become, become, become, become, become, become, become, become, become, become, becomeActor, call, call, call, call, call, call, call, call, call, call, call, callMessage, create, create, create, create, create, create, create, create, create, create, create, createActor, createRemote, createRemote, createRemote, createRemote, createRemote, createRemote, createRemote, createRemote, createRemote, createRemote, createRemote, createRemoteActor, destroy, echo, getActorName, getDefaultDirectoryManager, getDefaultDirectoryManager, getLastErrorMessage, migrate, print, printLastErrorMessage, println, send, send, send, send, send, send, send, send, send, send, send, sendMessage, setErrorMessage, uninit

Methods inherited from class java.lang.Object

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

Field Detail

m_pubTSpace

protected PublicTupleSpace m_pubTSpace

Tuple Space as a blackboard.

Constructor Detail

DirectoryManager

public DirectoryManager()

Creates a Directory Manager.

Method Detail

deliverImpl

protected boolean deliverImpl(ActorTuple p_atReceiver,
                              java.lang.String p_strMethod,
                              java.lang.Object[] p_objaArgs)
                       throws java.lang.Exception

Delivers a message to a randomly selected actor whose information is matched with the given tuple pattern.

Parameters:

p_atReceiver - the tuple pattern to find a receiver actor.

p_strMethod - the method name to be called.

p_objaArgs - arguments to be deliverd to the receiver actor.

Throws:

java.lang.Exception

deliverAllImpl

protected boolean deliverAllImpl(ActorTuple p_atReceiver,
                                 java.lang.String p_strMethod,
                                 java.lang.Object[] p_objaArgs)
                          throws java.lang.Exception

Broadcasts a message to all actors whose information is matched with the given tuple pattern.

Parameters:

p_atReceiver - the tuple pattern to find receiver actors.

p_strMethod - the method name to be called.

p_objaArgs - arguments to be deliverd to receiver actors.

Throws:

java.lang.Exception

deliver

protected boolean deliver(ActorTuple p_atReceiver,
                          java.lang.String p_strMethod,
                          java.lang.Object[] p_objaArgs)

Delivers a message to a randomly selected actor whose information is matched with the given tuple pattern.

Parameters:

p_atReceiver - the tuple pattern to find a receiver actor.

p_strMethod - the method name to be called.

p_objaArgs - arguments to be deliverd to the receiver actor.

deliverAll

protected boolean deliverAll(ActorTuple p_atReceiver,
                             java.lang.String p_strMethod,
                             java.lang.Object[] p_objaArgs)

Broadcasts a message to all actors whose information is matched with the given tuple pattern.

Parameters:

p_atReceiver - the tuple pattern to find receiver actors.

p_strMethod - the method name to be called.

p_objaArgs - arguments to be deliverd to receiver actors.

register

public void register(ActorTuple p_atTuple)

Registers an actor tuple to this Directory Manager.

Parameters:

p_atTuple - an actor tuple to be inserted in this Directory Manager.

deregister

public void deregister(ActorTuple p_atTuple)

Removes an actor tuple in this Directory Manager.

Parameters:

p_atTuple - a tuple data to be removed in this Directory Manager.

update

public void update(ActorTuple p_atTemplate,
                   ActorTuple p_atTuple)

Removes actor tuples matched with the given tuple template, and then inserts an actor tuple in this tuple space.

Parameters:

p_atTemplate - a tuple template to be used for matching with actor tuples in this tuple space.

p_atTuple - an actor tuple to be stored in this tuple space.

search

public ActorName search(ActorTuple p_atTemplate)
                 throws java.lang.Exception

Retrieves any one of names of actors that support the specified tuple.

Parameters:

p_atTemplate - a tuple template to find the name of the actor that supports the specified attributes.

Throws:

java.lang.Exception

searchAll

public ActorName[] searchAll(ActorTuple p_atTemplate)
                      throws java.lang.Exception

Retrieves names of all actors that support the specified attribute.

Parameters:

p_atTemplate - a tuple template to find the actor name of the actor that supports the specified attributes.

Throws:

java.lang.Exception

printAll

public void printAll()

Prints all actor tuples in this Directory Manager.

deliver

public boolean deliver(ActorTuple p_atReceiver,
                       java.lang.String p_strMethod)

deliver

public boolean deliver(ActorTuple p_atReceiver,
                       java.lang.String p_strMethod,
                       java.io.Serializable p_serArg1)

deliver

public boolean deliver(ActorTuple p_atReceiver,
                       java.lang.String p_strMethod,
                       java.io.Serializable p_serArg1,
                       java.io.Serializable p_serArg2)

deliver

public boolean deliver(ActorTuple p_atReceiver,
                       java.lang.String p_strMethod,
                       java.io.Serializable p_serArg1,
                       java.io.Serializable p_serArg2,
                       java.io.Serializable p_serArg3)

deliver

public boolean deliver(ActorTuple p_atReceiver,
                       java.lang.String p_strMethod,
                       java.io.Serializable p_serArg1,
                       java.io.Serializable p_serArg2,
                       java.io.Serializable p_serArg3,
                       java.io.Serializable p_serArg4)

deliver

public boolean deliver(ActorTuple p_atReceiver,
                       java.lang.String p_strMethod,
                       java.io.Serializable p_serArg1,
                       java.io.Serializable p_serArg2,
                       java.io.Serializable p_serArg3,
                       java.io.Serializable p_serArg4,
                       java.io.Serializable p_serArg5)

deliver

public boolean deliver(ActorTuple p_atReceiver,
                       java.lang.String p_strMethod,
                       java.io.Serializable p_serArg1,
                       java.io.Serializable p_serArg2,
                       java.io.Serializable p_serArg3,
                       java.io.Serializable p_serArg4,
                       java.io.Serializable p_serArg5,
                       java.io.Serializable p_serArg6)

deliver

public boolean deliver(ActorTuple p_atReceiver,
                       java.lang.String p_strMethod,
                       java.io.Serializable p_serArg1,
                       java.io.Serializable p_serArg2,
                       java.io.Serializable p_serArg3,
                       java.io.Serializable p_serArg4,
                       java.io.Serializable p_serArg5,
                       java.io.Serializable p_serArg6,
                       java.io.Serializable p_serArg7)

deliver

public boolean deliver(ActorTuple p_atReceiver,
                       java.lang.String p_strMethod,
                       java.io.Serializable p_serArg1,
                       java.io.Serializable p_serArg2,
                       java.io.Serializable p_serArg3,
                       java.io.Serializable p_serArg4,
                       java.io.Serializable p_serArg5,
                       java.io.Serializable p_serArg6,
                       java.io.Serializable p_serArg7,
                       java.io.Serializable p_serArg8)

deliver

public boolean deliver(ActorTuple p_atReceiver,
                       java.lang.String p_strMethod,
                       java.io.Serializable p_serArg1,
                       java.io.Serializable p_serArg2,
                       java.io.Serializable p_serArg3,
                       java.io.Serializable p_serArg4,
                       java.io.Serializable p_serArg5,
                       java.io.Serializable p_serArg6,
                       java.io.Serializable p_serArg7,
                       java.io.Serializable p_serArg8,
                       java.io.Serializable p_serArg9)

deliver

public boolean deliver(ActorTuple p_atReceiver,
                       java.lang.String p_strMethod,
                       java.io.Serializable p_serArg1,
                       java.io.Serializable p_serArg2,
                       java.io.Serializable p_serArg3,
                       java.io.Serializable p_serArg4,
                       java.io.Serializable p_serArg5,
                       java.io.Serializable p_serArg6,
                       java.io.Serializable p_serArg7,
                       java.io.Serializable p_serArg8,
                       java.io.Serializable p_serArg9,
                       java.io.Serializable p_serArg10)

deliverAll

public boolean deliverAll(ActorTuple p_atReceiver,
                          java.lang.String p_strMethod)

deliverAll

public boolean deliverAll(ActorTuple p_atReceiver,
                          java.lang.String p_strMethod,
                          java.io.Serializable p_serArg1)

deliverAll

public boolean deliverAll(ActorTuple p_atReceiver,
                          java.lang.String p_strMethod,
                          java.io.Serializable p_serArg1,
                          java.io.Serializable p_serArg2)

deliverAll

public boolean deliverAll(ActorTuple p_atReceiver,
                          java.lang.String p_strMethod,
                          java.io.Serializable p_serArg1,
                          java.io.Serializable p_serArg2,
                          java.io.Serializable p_serArg3)

deliverAll

public boolean deliverAll(ActorTuple p_atReceiver,
                          java.lang.String p_strMethod,
                          java.io.Serializable p_serArg1,
                          java.io.Serializable p_serArg2,
                          java.io.Serializable p_serArg3,
                          java.io.Serializable p_serArg4)

deliverAll

public boolean deliverAll(ActorTuple p_atReceiver,
                          java.lang.String p_strMethod,
                          java.io.Serializable p_serArg1,
                          java.io.Serializable p_serArg2,
                          java.io.Serializable p_serArg3,
                          java.io.Serializable p_serArg4,
                          java.io.Serializable p_serArg5)

deliverAll

public boolean deliverAll(ActorTuple p_atReceiver,
                          java.lang.String p_strMethod,
                          java.io.Serializable p_serArg1,
                          java.io.Serializable p_serArg2,
                          java.io.Serializable p_serArg3,
                          java.io.Serializable p_serArg4,
                          java.io.Serializable p_serArg5,
                          java.io.Serializable p_serArg6)

deliverAll

public boolean deliverAll(ActorTuple p_atReceiver,
                          java.lang.String p_strMethod,
                          java.io.Serializable p_serArg1,
                          java.io.Serializable p_serArg2,
                          java.io.Serializable p_serArg3,
                          java.io.Serializable p_serArg4,
                          java.io.Serializable p_serArg5,
                          java.io.Serializable p_serArg6,
                          java.io.Serializable p_serArg7)

deliverAll

public boolean deliverAll(ActorTuple p_atReceiver,
                          java.lang.String p_strMethod,
                          java.io.Serializable p_serArg1,
                          java.io.Serializable p_serArg2,
                          java.io.Serializable p_serArg3,
                          java.io.Serializable p_serArg4,
                          java.io.Serializable p_serArg5,
                          java.io.Serializable p_serArg6,
                          java.io.Serializable p_serArg7,
                          java.io.Serializable p_serArg8)

deliverAll

public boolean deliverAll(ActorTuple p_atReceiver,
                          java.lang.String p_strMethod,
                          java.io.Serializable p_serArg1,
                          java.io.Serializable p_serArg2,
                          java.io.Serializable p_serArg3,
                          java.io.Serializable p_serArg4,
                          java.io.Serializable p_serArg5,
                          java.io.Serializable p_serArg6,
                          java.io.Serializable p_serArg7,
                          java.io.Serializable p_serArg8,
                          java.io.Serializable p_serArg9)

deliverAll

public boolean deliverAll(ActorTuple p_atReceiver,
                          java.lang.String p_strMethod,
                          java.io.Serializable p_serArg1,
                          java.io.Serializable p_serArg2,
                          java.io.Serializable p_serArg3,
                          java.io.Serializable p_serArg4,
                          java.io.Serializable p_serArg5,
                          java.io.Serializable p_serArg6,
                          java.io.Serializable p_serArg7,
                          java.io.Serializable p_serArg8,
                          java.io.Serializable p_serArg9,
                          java.io.Serializable p_serArg10)