genius.core.boaframework

Class OfferingStrategy

java.lang.Object

genius.core.boaframework.BOA

genius.core.boaframework.OfferingStrategy

public abstract class OfferingStrategy
extends BOA

Describes a bidding strategy of an agent of the BOA framework. Tim Baarslag, Koen Hindriks, Mark Hendrikx, Alex Dirkzwager and Catholijn M. Jonker. Decoupling Negotiating Agents to Explore the Space of Negotiation Strategies

Version:

15-12-11

Author:

Alex Dirkzwager, Mark Hendrikx, W.Pasman: this now extends BOA to unite all BOA components.

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	endNegotiation Boolean to see if endNegotiation is called
protected SharedAgentState	helper Reference to helper class used if there are dependencies between the acceptance condition an offering strategy
protected BidDetails	nextBid The next bid the agent plans to present
protected OMStrategy	omStrategy Reference to the opponent model strategy
protected OpponentModel	opponentModel Reference to the opponent model

Fields inherited from class genius.core.boaframework.BOA

negotiationSession

Constructor Summary

Constructors

Constructor and Description
OfferingStrategy()

Method Summary

Modifier and Type	Method and Description
abstract BidDetails	determineNextBid() Determines the next bid the agent will offer to the opponent
abstract BidDetails	determineOpeningBid() Determines the first bid to be offered by the agent
SharedAgentState	getHelper() Return the Helper-object.
BidDetails	getNextBid()
void	init(NegotiationSession negotiationSession, OpponentModel opponentModel, OMStrategy omStrategy, java.util.Map<java.lang.String,java.lang.Double> parameters) Initializes the offering strategy.
boolean	isEndNegotiation()
java.io.Serializable	loadData() Method used to load the saved object, possibly created in a previous negotiation session.
void	setNextBid(BidDetails nextBid) Set the next bid of the agent.
void	storeData(java.io.Serializable object) Method used to store data that should be accessible in the next negotiation session on the same scenario.

Methods inherited from class genius.core.boaframework.BOA

endSession, getName, getParameters, getParameterSpec, init

Methods inherited from class java.lang.Object

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

Field Detail

nextBid

protected BidDetails nextBid

The next bid the agent plans to present

opponentModel

protected OpponentModel opponentModel

Reference to the opponent model

omStrategy

protected OMStrategy omStrategy

Reference to the opponent model strategy

helper

protected SharedAgentState helper

Reference to helper class used if there are dependencies between the acceptance condition an offering strategy

endNegotiation

protected boolean endNegotiation

Boolean to see if endNegotiation is called

Constructor Detail

OfferingStrategy

public OfferingStrategy()

Method Detail

init

public void init(NegotiationSession negotiationSession,
                 OpponentModel opponentModel,
                 OMStrategy omStrategy,
                 java.util.Map<java.lang.String,java.lang.Double> parameters)
          throws java.lang.Exception

Initializes the offering strategy. If parameters are used, this method should be overridden.

Parameters:

negotiationSession - state of the negotiation.

opponentModel - opponent model which may be used.

omStrategy - opponent model strategy which may be used.

parameters - optional parameters for the offering strategy.

Throws:

java.lang.Exception - if the offering strategy fails to initialize.

determineOpeningBid

public abstract BidDetails determineOpeningBid()

Determines the first bid to be offered by the agent

Returns:

the opening bid of the agent.

determineNextBid

public abstract BidDetails determineNextBid()

Determines the next bid the agent will offer to the opponent

Returns:

bid to offer to the opponent.

getNextBid

public BidDetails getNextBid()

Returns:

next bid to be offered to the opponent.

setNextBid

public void setNextBid(BidDetails nextBid)

Set the next bid of the agent. This method is automatically called by the BOA framework.

Parameters:

nextBid - to offer to the opponent.

getHelper

public SharedAgentState getHelper()

Return the Helper-object. A helper is used to hold the code shared between the offering strategy and acceptance strategy. A good design does not require a helper.

Returns:

helper with shared code.

isEndNegotiation

public boolean isEndNegotiation()

Returns:

true if the negotiation should be ended.

storeData

public final void storeData(java.io.Serializable object)

Description copied from class: BOA

Method used to store data that should be accessible in the next negotiation session on the same scenario. This method can be called during the negotiation, but it makes more sense to call it in the endSession method.

Specified by:

storeData in class BOA

Parameters:

object - to be saved by this component.

loadData

public final java.io.Serializable loadData()

Description copied from class: BOA

Method used to load the saved object, possibly created in a previous negotiation session. The method returns null when such an object does not exist yet.

Specified by:

loadData in class BOA

Returns:

saved object or null when not available.