genius.core.boaframework

Class BOA

java.lang.Object

genius.core.boaframework.BOA

Direct Known Subclasses:

AcceptanceStrategy, OfferingStrategy, OMStrategy, OpponentModel

public abstract class BOA
extends java.lang.Object

Abstract superclass for BOA components. This should have been called BOAcomponent but that class is already in use. Usually instances are created using BoaRepItem.getInstance() and then caling {#init(NegotiationSession)}

Author:

W.Pasman 25mar14 #867

Field Summary

Fields

Modifier and Type	Field and Description
protected NegotiationSession	negotiationSession Reference to the object which holds all information about the negotiation

Constructor Summary

Constructors

Constructor and Description
BOA()

Method Summary

Modifier and Type	Method and Description
void	endSession(NegotiationResult result) Method called at the end of the negotiation.
abstract java.lang.String	getName()
java.util.Map<java.lang.String,java.lang.Double>	getParameters()
java.util.Set<BOAparameter>	getParameterSpec()
protected void	init(NegotiationSession negotiationSession, java.util.Map<java.lang.String,java.lang.Double> parameters) Initializes the model.
abstract java.io.Serializable	loadData() Method used to load the saved object, possibly created in a previous negotiation session.
abstract 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 java.lang.Object

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

Field Detail

negotiationSession

protected NegotiationSession negotiationSession

Reference to the object which holds all information about the negotiation

Constructor Detail

BOA

public BOA()

Method Detail

init

protected void init(NegotiationSession negotiationSession,
                    java.util.Map<java.lang.String,java.lang.Double> parameters)

Initializes the model. The method must be called once, and only once, immediately after creating an opponent model.

Parameters:

negotiationSession - reference to the state of the negotiation

parameters - the init parameters used to configure this component

getParameters

public java.util.Map<java.lang.String,java.lang.Double> getParameters()

Returns:

* The actual parameters that are used by this instance, as set by call to init(NegotiationSession, Map).

getParameterSpec

public java.util.Set<BOAparameter> getParameterSpec()

Returns:

the parameter specifications of this BOA component. Default implementation returns empty set. If a BOA component has parameters, it should override this. This can be different from the actual parameters used at runtime, which is passed through #init(NegotiationSession) calls to the components.

endSession

public void endSession(NegotiationResult result)

Method called at the end of the negotiation. Ideal location to call the storeData method to receiveMessage the data to be saved.

Parameters:

result - of the negotiation.

storeData

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

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.

Parameters:

object - to be saved by this component.

loadData

public abstract java.io.Serializable loadData()

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.

Returns:

saved object or null when not available.

getName

public abstract java.lang.String getName()

Returns:

a short name for this component.