genius.core.protocol

Class SimpleMediatorBasedProtocol

java.lang.Object

genius.core.protocol.DefaultMultilateralProtocol

genius.core.protocol.MediatorProtocol

genius.core.protocol.SimpleMediatorBasedProtocol

All Implemented Interfaces:

MultilateralProtocol

public class SimpleMediatorBasedProtocol
extends MediatorProtocol

Basic implementation of a mediator based protocol.

Protocol:

1. Mediator proposes an OfferForVoting
2. Agents VoteForOfferAcceptance to accept/reject
3. Mediator sends parties a InformVotingResult

This protocol takes the last InformVotingResult that contains a Vote.ACCEPT as the current agreement. If no such vote exists, it is assumed no agreement has been reached yet.

Field Summary

Fields inherited from class genius.core.protocol.DefaultMultilateralProtocol

isAborted

Constructor Summary

Constructors

Constructor and Description
SimpleMediatorBasedProtocol()

Method Summary

Modifier and Type	Method and Description
java.util.Map<NegotiationParty,java.util.List<NegotiationParty>>	getActionListeners(java.util.List<NegotiationParty> parties) Get a map of parties that are listening to each other's response
Bid	getCurrentAgreement(Session session, java.util.List<NegotiationParty> parties) Returns the last offer for voting as the current agreement.
Round	getRoundStructure(java.util.List<NegotiationParty> parties, Session session) Get the structure of the current round.

Methods inherited from class genius.core.protocol.MediatorProtocol

getMediator, getNonMediators

Methods inherited from class genius.core.protocol.DefaultMultilateralProtocol

afterSession, applyAction, beforeSession, checkOffer, endNegotiation, endNegotiation, exclude, getNumberOfAgreeingParties, includeOnly, isFinished, listenToAll, listenToNone

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleMediatorBasedProtocol

public SimpleMediatorBasedProtocol()

Method Detail

getRoundStructure

public Round getRoundStructure(java.util.List<NegotiationParty> parties,
                               Session session)

Description copied from interface: MultilateralProtocol

Get the structure of the current round. Each round, this method receives a list of all the NegotiationParty and the complete Session which can be used to diversify the round structure at some point during the session.

Specified by:

getRoundStructure in interface MultilateralProtocol

Overrides:

getRoundStructure in class DefaultMultilateralProtocol

Parameters:

parties - The parties currently participating

session - The complete session history

Returns:

A list of possible actions

getActionListeners

public java.util.Map<NegotiationParty,java.util.List<NegotiationParty>> getActionListeners(java.util.List<NegotiationParty> parties)

Description copied from class: DefaultMultilateralProtocol

Get a map of parties that are listening to each other's response

Specified by:

getActionListeners in interface MultilateralProtocol

Overrides:

getActionListeners in class DefaultMultilateralProtocol

Parameters:

parties - The parties involved in the current negotiation

Returns:

A map where the key is a NegotiationParty that is responding to a NegotiationParty.chooseAction(java.util.List) event, and the value is a list of NegotiationParty that are listening to that key party's response.

getCurrentAgreement

public Bid getCurrentAgreement(Session session,
                               java.util.List<NegotiationParty> parties)

Returns the last offer for voting as the current agreement.

Specified by:

getCurrentAgreement in interface MultilateralProtocol

Overrides:

getCurrentAgreement in class DefaultMultilateralProtocol

Parameters:

session - The complete session history up to this point

parties - The parties involved in the current negotiation

Returns:

The current agreement (the bid from the last action from the mediator that was Vote.ACCEPT), or null if no agreement yet.