org.eclipse.emfforms.bazaar.internal

Class ThreadSafeBazaar<T>

java.lang.Object

org.eclipse.emfforms.bazaar.internal.BazaarImpl<T>

org.eclipse.emfforms.bazaar.internal.ThreadSafeBazaar<T>

Type Parameters:

T - the type of product produced by this Bazaar

All Implemented Interfaces:

Bazaar<T>

public final class ThreadSafeBazaar<T>
extends BazaarImpl<T>

A thread-safe implementation of the Bazaar. It supports any number of threads concurrently creating products, to the exclusion of at most one thread changing the bazaar's configuration (adding/removing vendors, context functions, and so on).

Author:

Christian W. Damus

Nested Class Summary

Nested classes/interfaces inherited from interface org.eclipse.emfforms.bazaar.Bazaar

Bazaar.Builder<T>, Bazaar.PriorityOverlapCallBack<T>

Constructor Summary

Constructors

Constructor and Description
ThreadSafeBazaar() Initializes me.
ThreadSafeBazaar(Collection<? extends Vendor<? extends T>> vendors, Map<String,? extends BazaarContextFunction> contextFunctions, Bazaar.PriorityOverlapCallBack<? super T> priorityOverlapCallBack) Initializes me with an initial configuration.

Method Summary

Modifier and Type	Method and Description
void	addContextFunction(String key, BazaarContextFunction contextFunction) Adds a BazaarContextFunction to this Bazaar to exchange existing parameters to a parameter requested by a Vendor.
void	addVendor(Vendor<? extends T> vendor) Adds a Vendor to the bazaar.
T	createProduct(BazaarContext bazaarContext) Creates a product of type T, provided by the Vendor with the highest Bid and which is statisfied by the parameters in the BazaarContext.
List<T>	createProducts(BazaarContext bazaarContext) Creates a list of products of type T, provided by Vendors which are statisfied by the parameters in the BazaarContext, ordered by their Bid.
void	removeVendor(Vendor<? extends T> vendor) Removes a Vendor from the bazaar.
void	setPriorityOverlapCallBack(Bazaar.PriorityOverlapCallBack<? super T> priorityOverlapCallBack) Adds a Bazaar.PriorityOverlapCallBack, see Bazaar.PriorityOverlapCallBack.

Methods inherited from class org.eclipse.emfforms.bazaar.internal.BazaarImpl

addContextFunctions, checkPreConditions, createEclipseContext, createProduct, getBestVendor

Methods inherited from class java.lang.Object

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

Constructor Detail

ThreadSafeBazaar

public ThreadSafeBazaar()

Initializes me.

ThreadSafeBazaar

public ThreadSafeBazaar(Collection<? extends Vendor<? extends T>> vendors,
                        Map<String,? extends BazaarContextFunction> contextFunctions,
                        Bazaar.PriorityOverlapCallBack<? super T> priorityOverlapCallBack)

Initializes me with an initial configuration.

Parameters:

vendors - optional vendors to add (may be null if not needed)

contextFunctions - optional context functions to add (may be null if not needed)

priorityOverlapCallBack - optional overlap call-back to set (may be null if not needed)

Method Detail

createProduct

public T createProduct(BazaarContext bazaarContext)

Description copied from interface: Bazaar

Creates a product of type T, provided by the Vendor with the highest Bid and which is statisfied by the parameters in the BazaarContext. In case of tied bids, the Bazaar.PriorityOverlapCallBack if one is set will be notified of which vendor is chosen to break the tie. Note that during the bidding process, ties may have to be broken in this way that are later defeated by a higher bid.

Specified by:

createProduct in interface Bazaar<T>

Overrides:

createProduct in class BazaarImpl<T>

Parameters:

bazaarContext - the BazaarContext, which is used to provide requested parameters for Vendor

Returns:

the product provided by the best Vendor

See Also:

Bazaar.createProduct(org.eclipse.emfforms.bazaar.BazaarContext)

createProducts

public List<T> createProducts(BazaarContext bazaarContext)

Description copied from interface: Bazaar

Creates a list of products of type T, provided by Vendors which are statisfied by the parameters in the BazaarContext, ordered by their Bid. Ties are not broken as all bids are successful and are used only for ordering.

Specified by:

createProducts in interface Bazaar<T>

Overrides:

createProducts in class BazaarImpl<T>

Parameters:

bazaarContext - the BazaarContext, which is used to provide requested parameters for Vendor

Returns:

a list of products ordered by the highest Bid

See Also:

Bazaar.createProducts(org.eclipse.emfforms.bazaar.BazaarContext)

addVendor

public void addVendor(Vendor<? extends T> vendor)

Description copied from interface: Bazaar

Adds a Vendor to the bazaar. Will be queried if a product is requested, the best fitting will create the product. Has no effect if the vendor is already present in this bazaar.

Specified by:

addVendor in interface Bazaar<T>

Overrides:

addVendor in class BazaarImpl<T>

Parameters:

vendor - the Vendor

removeVendor

public void removeVendor(Vendor<? extends T> vendor)

Description copied from interface: Bazaar

Removes a Vendor from the bazaar. Has no effect if the vendor is not present in this bazaar.

Specified by:

removeVendor in interface Bazaar<T>

Overrides:

removeVendor in class BazaarImpl<T>

Parameters:

vendor - the Vendor to remove

addContextFunction

public void addContextFunction(String key,
                               BazaarContextFunction contextFunction)

Description copied from interface: Bazaar

Adds a BazaarContextFunction to this Bazaar to exchange existing parameters to a parameter requested by a Vendor.

Specified by:

addContextFunction in interface Bazaar<T>

Overrides:

addContextFunction in class BazaarImpl<T>

Parameters:

key - the key of a requested parameter, which can be exchanged from other available parameters in the BazaarContext by this BazaarContextFunction

contextFunction - the BazaarContextFunction being able to exchange to the requested parameter

setPriorityOverlapCallBack

public void setPriorityOverlapCallBack(Bazaar.PriorityOverlapCallBack<? super T> priorityOverlapCallBack)

Description copied from interface: Bazaar

Adds a Bazaar.PriorityOverlapCallBack, see Bazaar.PriorityOverlapCallBack.

Specified by:

setPriorityOverlapCallBack in interface Bazaar<T>

Overrides:

setPriorityOverlapCallBack in class BazaarImpl<T>

Parameters:

priorityOverlapCallBack - a PriorityOverlapCallBack