uk.ac.liv.auction.core
Interface Auctioneer

All Superinterfaces:

QuoteProvider

All Known Implementing Classes:

AbstractAuctioneer

public interface Auctioneer

extends QuoteProvider

Classes implementing this interface can serve the role of auctioneer in a round-robin auction.

Version:

$Revision: 1.14 $

Author:

Steve Phelps

Method Summary

java.util.Iterator	askIterator()
java.util.Iterator	bidIterator()
void	clear() Perform the clearing operation for the auction; match buyers with sellers and inform the auction of any deals.
void	endOfAuctionProcessing()
void	endOfDayProcessing()
void	endOfRoundProcessing()
Auction	getAuction() Find out which auction we are the auctioneer for.
void	newShout(Shout shout) Code for handling a new shout in the auction.
void	printState() Log the current state of the auction.
void	removeShout(Shout shout) Handle a request to retract a shout.
void	setAuction(Auction auction) Specify which auction we are the auctioneer for.
boolean	shoutsVisible() Return true if the shouts of others are visible.

Methods inherited from interface uk.ac.liv.auction.core.QuoteProvider

getQuote

Method Detail

clear

public void clear()

Perform the clearing operation for the auction; match buyers with sellers and inform the auction of any deals.

newShout

public void newShout(Shout shout)
              throws IllegalShoutException

Code for handling a new shout in the auction. Subclasses should override this method if they wish to provide different handling for different auction rules.

Parameters:

shout - The new shout to be processed

Throws:

IllegalShoutException - Thrown if the shout is invalid in some way.

removeShout

public void removeShout(Shout shout)

Handle a request to retract a shout.

printState

public void printState()

Log the current state of the auction.

setAuction

public void setAuction(Auction auction)

Specify which auction we are the auctioneer for.

getAuction

public Auction getAuction()

Find out which auction we are the auctioneer for.

askIterator

public java.util.Iterator askIterator()

bidIterator

public java.util.Iterator bidIterator()

shoutsVisible

public boolean shoutsVisible()

Return true if the shouts of others are visible.

endOfRoundProcessing

public void endOfRoundProcessing()

endOfAuctionProcessing

public void endOfAuctionProcessing()

endOfDayProcessing

public void endOfDayProcessing()