com.neurosys.ecom.orders.service

Class DefaultOrderService<O extends Order<I>,I extends OrderItem>

java.lang.Object

com.neurosys.ecom.orders.service.DefaultOrderService<O,I>

Type Parameters:

O - as Order

I - as OrderItem

All Implemented Interfaces:

OrderService<O,I>, ChangeGenerator<Object>

Direct Known Subclasses:

DefaultSubOrderService

public class DefaultOrderService<O extends Order<I>,I extends OrderItem>
extends Object
implements OrderService<O,I>

Default Order service
SENSITIVE SERVICE. SECURITY MUST BE KEPT IN MIND WHEN DEALING WILL ALL CALLS MADE TO AND FROM THIS SERVICE
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 Order - new Object[]{T, String causeOfSource}
• Update Order Item - new Object[]{I, String causeOfSource}
• Update DeliveryDetails - new Object[]{DeliveryDetails, String causeOfSource}
• Update Product Inventory of Item - new Object[]{Product, Number updateCnt, String causeOfSource}

Author:

Arjun Dhar

Constructor Summary

Constructors

Constructor and Description
DefaultOrderService()

Method Summary

Modifier and Type	Method and Description
void	addChangeListener(ChangeListener changeListener) Allow Notify all ChangeListeners about a change
void	adjustInventory(I item, Number updateCnt, String causeSource) Using a + or a - value for countUpdate we can change the Stock position from its current position.
void	checkItemProductsStillLocked(O order) For some operations like sending invoice etc it may be necessary for the order to have a lock on all its products; Warn by throwing PartialTransactionException.getFailed() of all Products that are not locked.
OrderDao<O>	getDao() The Actions on the service layer can trigger events. Useful if we want to easily create intermediate save points without having to worry about triggering events.
List	getListeners() Get list directly.
OrderDao<O>	getOrderDao()
PostOrderProcessStrategy<O,I>	getPostOrderStrategy()
PreOrderProcessStrategy<O,I>	getPreOrderStrategy()
boolean	isExists(Long orderId) Check to see if an Order exists or not
O	load(Long orderId) Load an existing Order
void	lockProductsForOrder(O order, String causeSource) Orders maintain referential integrity over Products that are used by them.
void	notifyAllListeners(Object object) Whenever a node is selected/updated, it also notifies its listeners.
<D extends DeliveryDetails> D	save(D deliveryDetails, String causeSource) Explicitly update the Delivery Details only
<T extends O> T	save(T order, String causeSource, Object... context) Save the Order and process any Strategy @ an Order level
void	setListeners(List listeners) Set list directly.
void	setOrderDao(OrderDao<O> orderDao)
void	setPostOrderStrategy(PostOrderProcessStrategy<O,I> postOrderStrategy)
void	setPreOrderStrategy(PreOrderProcessStrategy<O,I> preOrderStrategy)
void	unlockProductsForOrder(O order, String causeSource) Orders maintain referential integrity over Products that are used by them.
I	update(I item, String causeSource) Save the OrderItem and process any Strategy @ an OrderItem level

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultOrderService

public DefaultOrderService()

Method Detail

save

@Transactional(readOnly=false)
public <T extends O> T save(T order,
                                                           String causeSource,
                                                           Object... context)
                                                    throws OrderPlacementException

Description copied from interface: OrderService

Save the Order and process any Strategy @ an Order level

Specified by:

save in interface OrderService<O extends Order<I>,I extends OrderItem>

Parameters:

order - as Order

causeSource - as Source of Change @nullable true will cause no subsequent event firing

context - as Object varags; typically sent to the ChangeGenerator.getListeners()

Returns:

same or new Order object

Throws:

OrderPlacementException

load

@Transactional(readOnly=true)
public O load(Long orderId)

Description copied from interface: OrderService

Load an existing Order

Specified by:

load in interface OrderService<O extends Order<I>,I extends OrderItem>

Parameters:

orderId - as Long

Returns:

update

@Transactional(readOnly=false)
public I update(I item,
                                               String causeSource)
                                        throws OrderPlacementException

Description copied from interface: OrderService

Save the OrderItem and process any Strategy @ an OrderItem level

Specified by:

update in interface OrderService<O extends Order<I>,I extends OrderItem>

Parameters:

item - as OrderItem

causeSource - as Source of Change @nullable true will cause no subsequent event firing

Returns:

same or new OrderItem object

Throws:

OrderPlacementException

save

@Transactional(readOnly=false)
public <D extends DeliveryDetails> D save(D deliveryDetails,
                                                                         String causeSource)

Description copied from interface: OrderService

Explicitly update the Delivery Details only

Specified by:

save in interface OrderService<O extends Order<I>,I extends OrderItem>

Parameters:

deliveryDetails - as DeliveryDetails

causeSource - as Source of Change @nullable true will cause no subsequent event firing

Returns:

lockProductsForOrder

@Transactional(readOnly=false,
               noRollbackFor=PartialTransactionException.class)
public void lockProductsForOrder(O order,
                                                                                                                                String causeSource)
                                                                                                                         throws PartialTransactionException,
                                                                                                                                OrderPlacementException

Description copied from interface: OrderService

Orders maintain referential integrity over Products that are used by them.
Lock the Products that belong to the OrderItems in the Order

Specified by:

lockProductsForOrder in interface OrderService<O extends Order<I>,I extends OrderItem>

Parameters:

order - as Order

causeSource - as String @nullable true will cause no subsequent event firing

Throws:

PartialTransactionException

OrderPlacementException

adjustInventory

@Transactional(readOnly=false)
public void adjustInventory(I item,
                                                           Number updateCnt,
                                                           String causeSource)

Description copied from interface: OrderService

Using a + or a - value for countUpdate we can change the Stock position from its current position.

When calling multiple OrderService.adjustInventory(OrderItem, Number, String) for an Order ensure they are called within one Transaction.
Note: This method may throw RuntimeExceptions if Products don't exist, difficulty in modifying count on underlying DB etc; so any calling API Post Order placement should ideally account for RuntimeException use cases

Specified by:

adjustInventory in interface OrderService<O extends Order<I>,I extends OrderItem>

Parameters:

item - as OrderItem

updateCnt - as Number (Integer) that will be adjusted from the current stock position. A position # will ADD to current position, Negative will deduct from current position. Note: The update count is not an absolute position; this is to ensure in high volume cases the Adjustments dont overwrite each other and each transaction is responsible for its own adjustment.

causeSource - as String @nullable true will cause no subsequent event firing

unlockProductsForOrder

@Transactional(readOnly=false)
public void unlockProductsForOrder(O order,
                                                                  String causeSource)
                                                           throws OrderPlacementException

Description copied from interface: OrderService

Orders maintain referential integrity over Products that are used by them.
Un-Lock the Products that belong to the OrderItems in the Order

Specified by:

unlockProductsForOrder in interface OrderService<O extends Order<I>,I extends OrderItem>

Parameters:

order - as Order

causeSource - @nullable true will cause no subsequent event firing

Throws:

OrderPlacementException

checkItemProductsStillLocked

public void checkItemProductsStillLocked(O order)
                                  throws PartialTransactionException

For some operations like sending invoice etc it may be necessary for the order to have a lock on all its products; Warn by throwing PartialTransactionException.getFailed() of all Products that are not locked.

Specified by:

checkItemProductsStillLocked in interface OrderService<O extends Order<I>,I extends OrderItem>

Parameters:

order -

Throws:

PartialTransactionException

isExists

public boolean isExists(Long orderId)

Description copied from interface: OrderService

Check to see if an Order exists or not

Specified by:

isExists in interface OrderService<O extends Order<I>,I extends OrderItem>

Returns:

getOrderDao

public OrderDao<O> getOrderDao()

setOrderDao

public void setOrderDao(OrderDao<O> orderDao)

getPreOrderStrategy

public PreOrderProcessStrategy<O,I> getPreOrderStrategy()

setPreOrderStrategy

public void setPreOrderStrategy(PreOrderProcessStrategy<O,I> preOrderStrategy)

getPostOrderStrategy

public PostOrderProcessStrategy<O,I> getPostOrderStrategy()

setPostOrderStrategy

public void setPostOrderStrategy(PostOrderProcessStrategy<O,I> postOrderStrategy)

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>

getDao

public OrderDao<O> getDao()

Description copied from interface: OrderService

The Actions on the service layer can trigger events.
Useful if we want to easily create intermediate save points without having to worry about triggering events.

Specified by:

getDao in interface OrderService<O extends Order<I>,I extends OrderItem>

Returns: