genius.core.session

Class TournamentManager

java.lang.Object

java.lang.Thread

genius.core.session.TournamentManager

All Implemented Interfaces:

Listenable<NegotiationEvent>, java.lang.Runnable

public class TournamentManager
extends java.lang.Thread
implements Listenable<NegotiationEvent>

Manages a multi-lateral tournament and makes sure that the SessionManager are instantiated. It uses the configuration object which is created by the user interface and extracts individual session from configuration object which it wil pass on to the session manager.

Agents in a tournament must be of class NegotiationParty.

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Thread

java.lang.Thread.State, java.lang.Thread.UncaughtExceptionHandler

Field Summary

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
TournamentManager(MultilateralTournamentConfiguration config) Initializes a new instance of the TournamentManager class.

Method Summary

Modifier and Type	Method and Description
void	addListener(Listener<NegotiationEvent> listener) listener support
protected java.lang.Object	clone()
static java.util.List<NegotiationPartyInternal>	getPartyList(ExecutorWithTimeout executor, MultilateralSessionConfiguration config, SessionsInfo info, Session session) Generate the parties involved in the next round of the tournament generator.
static MultilateralProtocol	getProtocol(MultiPartyProtocolRepItem protocolRepItem) Create a new instance of the Protocol object from a MultiPartyProtocolRepItem
void	removeListener(Listener<NegotiationEvent> listener) Remove listener for this observable
void	run() Runnable implementation for thread

Methods inherited from class java.lang.Thread

activeCount, checkAccess, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Constructor Detail

TournamentManager

public TournamentManager(MultilateralTournamentConfiguration config)
                  throws java.io.IOException,
                         InstantiateException

Initializes a new instance of the TournamentManager class. The tournament manager uses the provided configuration to find which sessions to run and how many collections of these sessions (tournaments) to run.

Parameters:

config - The configuration to use for this Tournament

Throws:

InstantiateException

java.io.IOException

Method Detail

addListener

public void addListener(Listener<NegotiationEvent> listener)

listener support

Specified by:

addListener in interface Listenable<NegotiationEvent>

Parameters:

listener - the listener to add

removeListener

public void removeListener(Listener<NegotiationEvent> listener)

Description copied from interface: Listenable

Remove listener for this observable

Specified by:

removeListener in interface Listenable<NegotiationEvent>

Parameters:

listener - the listener to remove

run

public void run()

Runnable implementation for thread

Specified by:

run in interface java.lang.Runnable

Overrides:

run in class java.lang.Thread

getPartyList

public static java.util.List<NegotiationPartyInternal> getPartyList(ExecutorWithTimeout executor,
                                                                    MultilateralSessionConfiguration config,
                                                                    SessionsInfo info,
                                                                    Session session)
                                                             throws java.util.concurrent.TimeoutException,
                                                                    java.util.concurrent.ExecutionException

Generate the parties involved in the next round of the tournament generator. Assumes generator.hasNext().
Checks various error cases and reports accordingly. If repository fails completely, we call System.exit(). useConsoleOut is called to disable console output while running agent code.

Parameters:

executor - the executor to use

config - the MultilateralSessionConfiguration to use

info - the global SessionsInfo.

Returns:

list of parties for next round. May return null if one or more agents could not be created.

Throws:

java.util.concurrent.TimeoutException - if we run out of time during the construction.

java.util.concurrent.ExecutionException - if one of the agents does not construct properly

clone

protected java.lang.Object clone()
                          throws java.lang.CloneNotSupportedException

Overrides:

clone in class java.lang.Thread

Throws:

java.lang.CloneNotSupportedException

getProtocol

public static MultilateralProtocol getProtocol(MultiPartyProtocolRepItem protocolRepItem)
                                        throws InstantiateException

Create a new instance of the Protocol object from a MultiPartyProtocolRepItem

Returns:

the created protocol.

Throws:

InstantiateException - if failure occurs while constructing the rep item.