zeus.actors
Class OrganisationDb

java.lang.Object
  java.util.Dictionary
      java.util.Hashtable
          zeus.actors.AbilityDb
              zeus.actors.OrganisationDb

All Implemented Interfaces:

java.lang.Cloneable, java.util.Map, java.io.Serializable

public class OrganisationDb

extends AbilityDb

The Organisation Database stores the agent's beliefs about its organisational relationships with other agents. Each relationship will be of one of the following types:

• Peer - which is the default relationship which entails no restrictions or assumptions about agent interaction
• Superior - here the acquaintance is believed to possess higher authority than this agent, and can issue orders that this agent must obey
• Subordinate - the acquaintance is believed to have less authority than this agent, and can be issued orders that it must obey
• Co-worker - the acquaintance belongs to the same 'community' as this agent, and will be asked before peers when any resources are required

See Also:

Serialized Form

Nested Class Summary

Nested classes inherited from class java.util.Hashtable

Field Summary

private static int	ACCESS
private static int	ADD
protected java.lang.String	agentName
private static int	DELETE
protected HSet[]	eventMonitor
private static int	MODIFY
protected java.util.Hashtable	relations

Fields inherited from class zeus.actors.AbilityDb

context, gensym, knownAgents

Fields inherited from class java.util.Hashtable

Constructor Summary

OrganisationDb()

OrganisationDb(AgentContext context)

Method Summary

protected java.util.Vector	_anyAgent(java.util.Vector agents, Goal goal)
void	addRelation(java.lang.String agent, java.lang.String relation)
void	addRelation(java.util.Vector List)
void	addRelationMonitor(RelationMonitor monitor, long type)
void	addRelationMonitor(RelationMonitor monitor, long event_type, boolean notify_previous) If your code needs to react to changes in the agent's organisational beliefs use this method to add a RelationMonitor to this component.
java.util.Vector	allRelations()
java.util.Vector	anyAgent(Goal goal, java.util.Vector ignore)
private java.util.Vector	getPeers()
boolean	hasRelation(java.lang.String relation)
boolean	hasRelation(java.lang.String agent, java.lang.String relation)
void	modifyAgentRelation(java.lang.String agent, java.lang.String oldRelation, java.lang.String newRelation)
private void	notifyMonitors(java.lang.String agent, java.lang.String relation, int type)
void	removeRelation(java.lang.String agent, java.lang.String relation)
void	removeRelationMonitor(RelationMonitor monitor, long type)

Methods inherited from class zeus.actors.AbilityDb

abilitiesOf, add, add, add, add, add, addAbilityMonitor, addAbilityMonitor, addItem, del, del, del, findAll, findOne, getAgentContext, modify, reduce, removeAbilityMonitor

Methods inherited from class java.util.Hashtable

clear, clone, contains, containsKey, containsValue, elements, entrySet, equals, get, hashCode, isEmpty, keys, keySet, put, putAll, rehash, remove, size, toString, values

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

eventMonitor

protected HSet[] eventMonitor

ADD

private static final int ADD

See Also:

Constant Field Values

MODIFY

private static final int MODIFY

See Also:

Constant Field Values

DELETE

private static final int DELETE

See Also:

Constant Field Values

ACCESS

private static final int ACCESS

See Also:

Constant Field Values

relations

protected java.util.Hashtable relations

agentName

protected java.lang.String agentName

Constructor Detail

OrganisationDb

public OrganisationDb()

OrganisationDb

public OrganisationDb(AgentContext context)

Method Detail

addRelation

public void addRelation(java.util.Vector List)

modifyAgentRelation

public void modifyAgentRelation(java.lang.String agent,
                                java.lang.String oldRelation,
                                java.lang.String newRelation)

allRelations

public java.util.Vector allRelations()

addRelation

public void addRelation(java.lang.String agent,
                        java.lang.String relation)

removeRelation

public void removeRelation(java.lang.String agent,
                           java.lang.String relation)

hasRelation

public boolean hasRelation(java.lang.String agent,
                           java.lang.String relation)

hasRelation

public boolean hasRelation(java.lang.String relation)

anyAgent

public java.util.Vector anyAgent(Goal goal,
                                 java.util.Vector ignore)

getPeers

private java.util.Vector getPeers()

_anyAgent

protected java.util.Vector _anyAgent(java.util.Vector agents,
                                     Goal goal)

addRelationMonitor

public void addRelationMonitor(RelationMonitor monitor,
                               long event_type,
                               boolean notify_previous)

If your code needs to react to changes in the agent's organisational beliefs use this method to add a RelationMonitor to this component.

addRelationMonitor

public void addRelationMonitor(RelationMonitor monitor,
                               long type)

removeRelationMonitor

public void removeRelationMonitor(RelationMonitor monitor,
                                  long type)

notifyMonitors

private void notifyMonitors(java.lang.String agent,
                            java.lang.String relation,
                            int type)