DefaultPromotionService (stumps 1.0-SNAPSHOT API)

java.lang.Object
- com.neurosys.ecom.orders.service.DefaultPromotionService<T>

Type Parameters:

T - as Promotion

All Implemented Interfaces:

PromotionService<T>, ChangeGenerator<Object>
```
public class DefaultPromotionService<T extends Promotion>
extends Object
implements PromotionService<T>
```
Default impl for PromotionService
This class will also generate Events of Type T or Object[]{I, causeSource as String} (after saving the Order)

Since this implements ChangeGenerator; it will also generate Events of Type
- Update Promotion - new Object[]{StandardOperation.#EDIT, Promotion}
- Delete Promotion - new Object[]{StandardOperation.#DELETE, Promotion}
- Update PromotionForUser - new Object[]{StandardOperation.#EDIT, PromotionForUser}
- Delete PromotionForUser - new Object[]{StandardOperation.#DELETE, PromotionForUser}
- Generate Coupons for Users - new Object[]{StandardOperation.#ADD, List of PromotionForUser, Object ...context}
- Delete Coupons for Users - new Object[]{StandardOperation.#DELETE, List of PromotionForUser, Object ...context}
- Notify Users - new Object[]{StandardOperation.#NOTIFY, List of PromotionForUser, Object ...context}
Author:

Arjun Dhar

Constructor Summary

Constructors
Constructor and Description

DefaultPromotionService()

Constructors
Constructor and Description
`DefaultPromotionService()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addChangeListener(ChangeListener changeListener)` Allow Notify all `ChangeListener`s about a change
`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)`
`List`	`getListeners()` Get list directly.
`PromotionDaoImpl<T>`	`getPromotionDao()`
`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.
`void`	`notifyAllListeners(Object object)` Whenever a node is selected/updated, it also notifies its listeners.
`PromotionForUser`	`save(PromotionForUser promotionForUser)`
`T`	`save(T promotion)`
`List<PromotionForUser>`	`search(List<String> codes)` For provided list of Codes, get `Promotion`s
`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 `Promotion`s for a given userId
`PromotionForUser`	`search(String userId, String promotionName)` Search for a `PromotionForUser`
`void`	`setListeners(List listeners)` Set list directly.
`void`	`setPromotionDao(PromotionDaoImpl<T> promotionDao)`
`protected PromotionForUser`	`stringToPromotionUser(String userCouponId, boolean generateCoupon)` Takes in a list of Strings.
`Collection<PromotionForUser>`	`validate(Collection<PromotionForUser> promotionForUsers)` Ensure the passed collection contains valid entities; returns back only valid entities.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - DefaultPromotionService
```
public DefaultPromotionService()
```
- Method Detail
  - load
```
public T load(String promotionName)
```
    Description copied from interface: PromotionService
    
    Load by Promotion Name
    
    Specified by:
    
    load in interface PromotionService<T extends Promotion>
    
    Returns:
  - save
```
public T save(T promotion)
```
    Specified by:
    
    save in interface PromotionService<T extends Promotion>
    
    Parameters:
    
    promotion - as Promotion
    
    Returns:
  - delete
```
public void delete(T promotion)
```
    Specified by:
    
    delete in interface PromotionService<T extends Promotion>
    
    Parameters:
    
    promotion - as Promotion
  - save
```
public PromotionForUser save(PromotionForUser promotionForUser)
```
    Specified by:
    
    save in interface PromotionService<T extends Promotion>
    
    Parameters:
    
    promotionForUser - as PromotionForUser
    
    Returns:
  - delete
```
public int delete(PromotionForUser promotionForUser)
```
    Specified by:
    
    delete in interface PromotionService<T extends Promotion>
    
    Parameters:
    
    promotionForUser - as PromotionForUser
  - search
```
public PromotionForUser search(String userId,
                               String promotionName)
```
    Description copied from interface: PromotionService
    
    Search for a PromotionForUser
    
    Specified by:
    
    search in interface PromotionService<T extends Promotion>
    
    Parameters:
    
    userId - as String
    
    promotionName - as String
    
    Returns:
    
    PromotionForUser
  - search
```
public List<PromotionForUser> search(String userId)
```
    Description copied from interface: PromotionService
    
    Fpr a given user Id get all the Active Promotions
    
    Specified by:
    
    search in interface PromotionService<T extends Promotion>
    
    Returns:
  - search
```
public List<PromotionForUser> search(List<String> codes)
```
    Description copied from interface: PromotionService
    
    For provided list of Codes, get Promotions
    
    Specified by:
    
    search in interface PromotionService<T extends Promotion>
    
    Parameters:
    
    codes - as List of String
    
    Returns:
  - search
```
public List<PromotionForUser> search(String userId,
                                     List<String> codes)
```
    Description copied from interface: PromotionService
    
    For provided list of Codes, get Promotions for a given userId
    
    Specified by:
    
    search in interface PromotionService<T extends Promotion>
    
    Parameters:
    
    userId - as String
    
    codes - as List of String
    
    Returns:
  - stringToPromotionUser
```
protected PromotionForUser stringToPromotionUser(String userCouponId,
                                                 boolean generateCoupon)
```
    Takes in a list 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
    
    Parameters:
    
    userCouponId -
    
    generateCoupon - boolean; if true will Generate a COUPON code if none found
  - generateCoupons
```
@Transactional(readOnly=false)
public void generateCoupons(List<String> userCouponIds,
                                                           Promotion promotion,
                                                           Object... context)
```
    Specified by:
    
    generateCoupons in interface PromotionService<T extends Promotion>
    
    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
    
    context - as varargs, as context to pass to the ChangeListeners
  - deleteCoupons
```
@Transactional(readOnly=false)
public int deleteCoupons(List<String> userCouponIds,
                                                        Promotion promotion,
                                                        Object... context)
```
    Specified by:
    
    deleteCoupons in interface PromotionService<T extends Promotion>
    
    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
    
    context - as varargs, as context to pass to the ChangeListeners
  - validate
```
@Transactional(readOnly=true)
public Collection<PromotionForUser> validate(Collection<PromotionForUser> promotionForUsers)
                                                                    throws javax.validation.ValidationException
```
    Description copied from interface: PromotionService
    
    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
    
    Specified by:
    
    validate in interface PromotionService<T extends Promotion>
    
    Returns:
    
    Throws:
    
    javax.validation.ValidationException
  - notifyAllListeners
```
public void notifyAllListeners(List<String> userCouponIds,
                               Promotion promotion,
                               Object... context)
                        throws javax.validation.ValidationException,
                               PartialTransactionException
```
    Description copied from interface: PromotionService
    
    Allow notifications using the coupon Id notation; notify all users of the Coupons about something.
    
    Specified by:
    
    notifyAllListeners in interface PromotionService<T extends Promotion>
    
    Throws:
    
    javax.validation.ValidationException
    
    PartialTransactionException
  - getPromotionDao
```
public PromotionDaoImpl<T> getPromotionDao()
```
  - setPromotionDao
```
public void setPromotionDao(PromotionDaoImpl<T> promotionDao)
```
  - addChangeListener
```
public void addChangeListener(ChangeListener changeListener)
```
    Description copied from interface: ChangeGenerator
    
    Allow Notify all ChangeListeners about a change
    
    Specified by:
    
    addChangeListener in interface ChangeGenerator<Object>
  - notifyAllListeners
```
public void notifyAllListeners(Object object)
```
    Description copied from interface: ChangeGenerator
    
    Whenever a node is selected/updated, it also notifies its listeners.
    
    Specified by:
    
    notifyAllListeners in interface ChangeGenerator<Object>
  - getListeners
```
public List getListeners()
```
    Description copied from interface: ChangeGenerator
    
    Get list directly. Support DI; like Spring IOC
    
    Specified by:
    
    getListeners in interface ChangeGenerator<Object>
  - setListeners
```
public void setListeners(List listeners)
```
    Description copied from interface: ChangeGenerator
    
    Set list directly. Support DI; like Spring IOC
    
    Specified by:
    
    setListeners in interface ChangeGenerator<Object>

Class DefaultPromotionService<T extends Promotion>

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

DefaultPromotionService

Method Detail

load

save

delete

save

delete

search

search

search

search

stringToPromotionUser

generateCoupons

deleteCoupons

validate

notifyAllListeners

getPromotionDao

setPromotionDao

addChangeListener

notifyAllListeners

getListeners

setListeners