genius.core.protocol

Class StackedAlternatingOffersProtocol

java.lang.Object

genius.core.protocol.DefaultMultilateralProtocol

genius.core.protocol.StackedAlternatingOffersProtocol

All Implemented Interfaces:

MultilateralProtocol

public class StackedAlternatingOffersProtocol
extends DefaultMultilateralProtocol

Implementation of an alternating offer protocol using offer/counter-offer.

Protocol:

 The first agent makes an offer
 Other agents can accept or make a counter-offer
 
 If no agent makes a counter-offer, the negotiation end with this offer.
 Otherwise, the process continues until reaching deadline or agreement.
 

Author:

David Festen, Reyhan Aydogan, Catholijn Jonker

Field Summary

Fields inherited from class genius.core.protocol.DefaultMultilateralProtocol

isAborted

Constructor Summary

Constructors

Constructor and Description
StackedAlternatingOffersProtocol()

Method Summary

Modifier and Type	Method and Description
java.util.Map<NegotiationParty,java.util.List<Action>>	beforeSession(Session session, java.util.List<NegotiationParty> parties) Returns a list of Actions to be sent to NegotiationParty.receiveMessage(AgentID, Action) .
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.
Bid	getCurrentAgreement(Session session, java.util.List<NegotiationParty> parties) Will return the current agreement.
int	getNumberOfAgreeingParties(Session session, java.util.List<NegotiationParty> parties) Gets the number of parties that currently agree to the offer.
Round	getRoundStructure(java.util.List<NegotiationParty> parties, Session session) Defines the round structure.
boolean	isFinished(Session session, java.util.List<NegotiationParty> parties) If all agents accept the most recent offer, then this negotiation ends.

Methods inherited from class genius.core.protocol.DefaultMultilateralProtocol

afterSession, applyAction, checkOffer, endNegotiation, endNegotiation, exclude, includeOnly, listenToAll, listenToNone

Methods inherited from class java.lang.Object

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

Constructor Detail

StackedAlternatingOffersProtocol

public StackedAlternatingOffersProtocol()

Method Detail

getRoundStructure

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

Defines the round structure.

 The first agent makes an offer
 Other agents can accept or make a counter-offer
 

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

getCurrentAgreement

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

Will return 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 agreed upon bid or null if no agreement

getNumberOfAgreeingParties

public int getNumberOfAgreeingParties(Session session,
                                      java.util.List<NegotiationParty> parties)

Description copied from class: DefaultMultilateralProtocol

Gets the number of parties that currently agree to the offer.

Default implementation returns 0 if no agreement or number of parties if agreement exists.

Specified by:

getNumberOfAgreeingParties in interface MultilateralProtocol

Overrides:

getNumberOfAgreeingParties in class DefaultMultilateralProtocol

Parameters:

session - the current state of this session

parties - The parties currently participating

Returns:

the number of parties agreeing to the current agreement

isFinished

public boolean isFinished(Session session,
                          java.util.List<NegotiationParty> parties)

If all agents accept the most recent offer, then this negotiation ends. Also, when any agent ends the negotiation (EndNegotiationAction) the negotiation ends

Specified by:

isFinished in interface MultilateralProtocol

Overrides:

isFinished in class DefaultMultilateralProtocol

Parameters:

session - the current state of this session

parties - all the parties involved in the negotiation

Returns:

true if the protocol is finished

getActionListeners

public 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.

Specified by:

getActionListeners in interface MultilateralProtocol

Overrides:

getActionListeners in class DefaultMultilateralProtocol

Parameters:

parties - The parties involved in the current negotiation

Returns:

who is listening to who

beforeSession

public java.util.Map<NegotiationParty,java.util.List<Action>> beforeSession(Session session,
                                                                            java.util.List<NegotiationParty> parties)
                                                                     throws java.lang.InterruptedException,
                                                                            java.util.concurrent.ExecutionException,
                                                                            NegotiationPartyTimeoutException

Description copied from interface: MultilateralProtocol

Returns a list of Actions to be sent to NegotiationParty.receiveMessage(AgentID, Action) . This will get called just before the session starts. If some initialization with needs to be done by the protocol, it can be done here.

Specified by:

beforeSession in interface MultilateralProtocol

Overrides:

beforeSession in class DefaultMultilateralProtocol

Parameters:

session - The upcoming Session

parties - The NegotiationPartys that will participate in the session

Throws:

java.lang.InterruptedException

java.util.concurrent.ExecutionException

NegotiationPartyTimeoutException