Package com.tnsai.coordination.negotiation.adapter

Class ContractNetAdapter

java.lang.Object

com.tnsai.coordination.negotiation.adapter.ContractNetAdapter

All Implemented Interfaces:

NegotiationProtocol

public final class ContractNetAdapter
extends Object
implements NegotiationProtocol

Adapter that wraps the existing MultiRoundContractNet as a NegotiationProtocol.

Uses the first party as the manager and the rest as contractors.

Since:

0.0.2

Constructor Summary

Constructors

Constructor	Description
ContractNetAdapter()	Default adapter with no proposal source.
ContractNetAdapter(MultiRoundContractNet.ProposalRequester proposalRequester)	Adapter wired to a real proposal source.

Method Summary

Modifier and Type	Method	Description
com.tnsai.annotations.Coordination.NegotiationType	getType()	Returns the negotiation type this protocol handles.
NegotiationOutcome	negotiate(List<com.tnsai.agents.Agent> parties, NegotiationConfig config)	Executes the negotiation between the given parties.

Methods inherited from class java.lang.Object

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

Constructor Details

ContractNetAdapter

public ContractNetAdapter()

Default adapter with no proposal source. NegotiationExecutor registers this so the CONTRACT_NET type resolves, but negotiate(java.util.List<com.tnsai.agents.Agent>, com.tnsai.coordination.negotiation.NegotiationConfig) fails fast with a reason naming the missing input — contract-net cannot contact contractors on its own (TAN-5893). Wire a real source via ContractNetAdapter(MultiRoundContractNet.ProposalRequester).

The fail-fast behaviour of this registration is new in 0.15.0: previously negotiate(java.util.List<com.tnsai.agents.Agent>, com.tnsai.coordination.negotiation.NegotiationConfig) returned a fabricated contract.

ContractNetAdapter

public ContractNetAdapter(MultiRoundContractNet.ProposalRequester proposalRequester)

Adapter wired to a real proposal source.

Since:

0.15.0

Method Details

negotiate

public NegotiationOutcome negotiate(List<com.tnsai.agents.Agent> parties,
 NegotiationConfig config)

Description copied from interface: NegotiationProtocol

Executes the negotiation between the given parties.

Specified by:

negotiate in interface NegotiationProtocol

Parameters:

parties - the agents participating in negotiation

config - negotiation configuration

Returns:

the negotiation outcome

getType

public com.tnsai.annotations.Coordination.NegotiationType getType()

Description copied from interface: NegotiationProtocol

Returns the negotiation type this protocol handles.

Specified by:

getType in interface NegotiationProtocol

Returns:

the supported negotiation type