jadex.bdi.planlib.protocols
Class Selector

java.lang.Object
  jadex.bdi.planlib.protocols.Selector

All Implemented Interfaces:

ISelector

public class Selector
extends java.lang.Object
implements ISelector

Default selector implementation for evaluating a set of proposals. The proposals will be first tested on acceptability. In the second (optional) step they will be sorted according to the specified comparator/comparable. In the third step a (sub)set will be filtered out according to the specified number chooseable of resuls (choose).

Field Summary

static int	ALL The constant for specifiying that all proposals should be chosen.
protected java.util.Comparator	comp The comparator for comparing proposals.
protected int	max_winners The max number of proposals to be chosen.
static int	ONE The constant for specifiying that one proposal should be chosen.

Constructor Summary

Selector()
Create a new selector.

Selector(java.util.Comparator comp)
Create a new selector.

Selector(java.util.Comparator comp, int max_winners)
Create a new selector.

Selector(int max_winners)
Create a new selector.

Method Summary

protected java.lang.Object[]	determineAcceptableProposals(java.lang.Object[] proposals) Get all acceptable proposals.
protected java.lang.Object[]	determineWinners(java.lang.Object[] proposals) Select proposals.
boolean	isAcceptable(java.lang.Object proposal) Test if a proposal is acceptable.
java.lang.Object[]	select(java.lang.Object[] proposals) Select proposals.
protected void	sortProposals(java.lang.Object[] proposals) Sort the proposals.

Methods inherited from class java.lang.Object

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

Field Detail

ALL

public static final int ALL

The constant for specifiying that all proposals should be chosen.

See Also:

Constant Field Values

ONE

public static final int ONE

The constant for specifiying that one proposal should be chosen.

See Also:

Constant Field Values

comp

protected java.util.Comparator comp

The comparator for comparing proposals.

max_winners

protected int max_winners

The max number of proposals to be chosen.

Constructor Detail

Selector

public Selector()

Create a new selector.

Selector

public Selector(java.util.Comparator comp)

Create a new selector.

Parameters:

comp - The optional comparator for sorting proposals.

Selector

public Selector(int max_winners)

Create a new selector.

Parameters:

max_winners - The number of proposals to be chosen at most.

Selector

public Selector(java.util.Comparator comp,
                int max_winners)

Create a new selector.

Parameters:

comp - The optional comparator for sorting proposals.

max_winners - The number of proposals to be chosen at most.

Method Detail

select

public java.lang.Object[] select(java.lang.Object[] proposals)

Select proposals.

Specified by:

select in interface ISelector

Parameters:

proposals - The proposals.

Returns:

The selected proposal(s) or none. todo: include information about negotiation history?

determineAcceptableProposals

protected java.lang.Object[] determineAcceptableProposals(java.lang.Object[] proposals)

Get all acceptable proposals.

Parameters:

proposals - The proposals.

Returns:

The acceptable proposals.

sortProposals

protected void sortProposals(java.lang.Object[] proposals)

Sort the proposals.

Parameters:

proposals - The proposals to sort.

determineWinners

protected java.lang.Object[] determineWinners(java.lang.Object[] proposals)

Select proposals.

Parameters:

proposals - The proposals.

Returns:

The selected proposals.

isAcceptable

public boolean isAcceptable(java.lang.Object proposal)

Test if a proposal is acceptable.

Parameters:

proposal - The proposal.

Returns:

True, if proposal is acceptable.