agent

Interface Agent

All Known Implementing Classes:

AgentImplementation, Contestant, Mole, RationalPlayer, SlyDog, SmartMole

public interface Agent

This interface contains all classes an Agent needs to function inside the Game Model

Method Summary

Methods

Modifier and Type	Method and Description
void	addCompetitor(Agent agent) Adds an competing Agent to this Agent's list of competitors
void	addCompetitors(java.util.Collection<Agent> others) Adds competitors to the current Agent class
boolean	doAssignment(Assignment ass) Asks the agent to decide whether to try or to fail in the current assignment.
void	eliminate() EliminationEvent tells the agent she is eliminated.
java.lang.String	getName() What is this agent's name?
void	informAssResult(boolean success, java.util.ArrayList<Agent> triedList, java.util.ArrayList<Agent> sabotagedList) AssignmentEvent tells the agent what she sees
void	informElimination(Agent loser) EliminationEvent tells Agent who is eliminated through this method.
void	informGameEnd(int nrOfLeftAgent) Round or EliminateEvent inform every player that the game is end.
boolean	isEliminated() Am I eliminated?
boolean	isMole() Is this agent the mole?
void	listenConversation(Agent speaker, Agent suspicion) ConversationEvent tells Agent who is the mole.
void	normalizeSuspicions() Normalizes the suspicions so they sum up to one.
Agent	tellConversation() This may do the same as vote
void	updateSuspicion(Agent a, double factor) Multiply this AgentImplementation's suspicion towards a specific Agent with some factor.
Agent	vote() This is the voting method, used in the final stage of every game round.

Method Detail

vote

Agent vote()

This is the voting method, used in the final stage of every game round.

Returns:

an Agent object, corresponding to the most suspicious agent

doAssignment

boolean doAssignment(Assignment ass)

Asks the agent to decide whether to try or to fail in the current assignment.

Returns:

false for sabotage or true for trying to succeed (true intention).

tellConversation

Agent tellConversation()

This may do the same as vote

Returns:

The currently suspected Agent object

See Also:

vote()

listenConversation

void listenConversation(Agent speaker,
                      Agent suspicion)

ConversationEvent tells Agent who is the mole. This is only one order belief

Parameters:

speaker - the agent who gives the information

suspicion - the suspicion which speaker tells listener

updateSuspicion

void updateSuspicion(Agent a,
                   double factor)

Multiply this AgentImplementation's suspicion towards a specific Agent with some factor.

Parameters:

a - the agent towards whom the suspicion should be changed

factor - the factor by which the suspicion should be changed. If the factor is not positive it will be changed to 1, leaving the suspicion unchanged.

normalizeSuspicions

void normalizeSuspicions()

Normalizes the suspicions so they sum up to one.

addCompetitors

void addCompetitors(java.util.Collection<Agent> others)

Adds competitors to the current Agent class

Parameters:

others - Collection with other Agents

addCompetitor

void addCompetitor(Agent agent)

Adds an competing Agent to this Agent's list of competitors

Parameters:

agent - an Agent instance

isMole

boolean isMole()

Is this agent the mole?

Returns:

true if this agent is the mole, false otherwise

getName

java.lang.String getName()

What is this agent's name?

Returns:

a String containing the name of this Agent

informElimination

void informElimination(Agent loser)

EliminationEvent tells Agent who is eliminated through this method.

Parameters:

loser - the agent who is eliminated from the game

isEliminated

boolean isEliminated()

Am I eliminated?

Returns:

true or false

eliminate

void eliminate()

EliminationEvent tells the agent she is eliminated.

informAssResult

void informAssResult(boolean success,
                   java.util.ArrayList<Agent> triedList,
                   java.util.ArrayList<Agent> sabotagedList)

AssignmentEvent tells the agent what she sees

Parameters:

success - The result of the assignment

triedList - The agents who try her's best

sabotagedList - The agents who sabotaged

informGameEnd

void informGameEnd(int nrOfLeftAgent)

Round or EliminateEvent inform every player that the game is end. The agents will talks some feeling about the result

Parameters:

nrOfLeftAgent - tell the agent how many agents left in the game