com.neurosys.ecom.orders.service

Interface PromotionService<T extends Promotion>

All Superinterfaces:

ChangeGenerator<Object>

All Known Implementing Classes:

DefaultPromotionService

public interface PromotionService<T extends Promotion>
extends ChangeGenerator<Object>

Service layer for Promotions and PromotionForUsers

Author:

Arjun Dhar

Method Summary

Modifier and Type	Method and Description
int	delete(PromotionForUser promotionForUser)
void	delete(T promotion)
int	deleteCoupons(List<String> userCouponIds, Promotion promotion, Object... context)
void	generateCoupons(List<String> userCouponIds, Promotion promotion, Object... context)
T	load(String promotionName) Load by Promotion Name
void	notifyAllListeners(List<String> userCouponIds, Promotion promotion, Object... context) Allow notifications using the coupon Id notation; notify all users of the Coupons about something.
PromotionForUser	save(PromotionForUser promotionForUser)
T	save(T promotion)
List<PromotionForUser>	search(List<String> codes) For provided list of Codes, get Promotions
List<PromotionForUser>	search(String userId) Fpr a given user Id get all the Active Promotions
List<PromotionForUser>	search(String userId, List<String> codes) For provided list of Codes, get Promotions for a given userId
PromotionForUser	search(String userId, String promotionName) Search for a PromotionForUser
Collection<PromotionForUser>	validate(Collection<PromotionForUser> promotionForUsers) Ensure the passed collection contains valid entities; returns back only valid entities.

Methods inherited from interface com.neurosys.events.ChangeGenerator

addChangeListener, getListeners, notifyAllListeners, setListeners

Method Detail

load

T load(String promotionName)

Load by Promotion Name

Parameters:

promotionName -

Returns:

save

T save(T promotion)

Parameters:

promotion - as Promotion

Returns:

delete

void delete(T promotion)

Parameters:

promotion - as Promotion

save

PromotionForUser save(PromotionForUser promotionForUser)

Parameters:

promotionForUser - as PromotionForUser

Returns:

delete

int delete(PromotionForUser promotionForUser)

Parameters:

promotionForUser - as PromotionForUser

search

PromotionForUser search(String userId,
                        String promotionName)

Search for a PromotionForUser

Parameters:

userId - as String

promotionName - as String

Returns:

PromotionForUser

Can be null:

true

search

List<PromotionForUser> search(String userId)

Fpr a given user Id get all the Active Promotions

Parameters:

userId -

Returns:

search

List<PromotionForUser> search(List<String> codes)

For provided list of Codes, get Promotions

Parameters:

codes - as List of String

Returns:

search

List<PromotionForUser> search(String userId,
                              List<String> codes)

For provided list of Codes, get Promotions for a given userId

Parameters:

codes - as List of String

userId - as String

Returns:

generateCoupons

void generateCoupons(List<String> userCouponIds,
                     Promotion promotion,
                     Object... context)

Parameters:

userCouponIds - as Lit of of Strings. if the String contains :code then it will consider that the Promotion#getCode() ; the part before ":" delimiter is considered as the user id

promotion -

context - as varargs, as context to pass to the ChangeListeners

deleteCoupons

int deleteCoupons(List<String> userCouponIds,
                  Promotion promotion,
                  Object... context)

Parameters:

userCouponIds - as Lit of of Strings. if the String contains :code then it will consider that the Promotion#getCode() ; the part before ":" delimiter is considered as the user id

promotion -

context - as varargs, as context to pass to the ChangeListeners

validate

Collection<PromotionForUser> validate(Collection<PromotionForUser> promotionForUsers)
                               throws javax.validation.ValidationException

Ensure the passed collection contains valid entities; returns back only valid entities. The order of elements is not guaranteed to be the same as passed in

Parameters:

promotionForUsers -

Returns:

Throws:

javax.validation.ValidationException

notifyAllListeners

void notifyAllListeners(List<String> userCouponIds,
                        Promotion promotion,
                        Object... context)
                 throws javax.validation.ValidationException,
                        PartialTransactionException

Allow notifications using the coupon Id notation; notify all users of the Coupons about something.

Parameters:

userCouponIds -

promotion -

context -

Throws:

javax.validation.ValidationException

PartialTransactionException