com.neurosys.ecom.strategy.service

Interface OrderStrategy<P extends Product,U extends IGenericEcomUser,O extends Order<? extends I>,I extends OrderItem>

Type Parameters:

P - as Product

U - as GenericEcomUser

All Superinterfaces:

ChargeStrategy<P,U>, Strategy

All Known Implementing Classes:

DefaultOrderStrategy, DefaultSubOrderStrategy

public interface OrderStrategy<P extends Product,U extends IGenericEcomUser,O extends Order<? extends I>,I extends OrderItem>
extends ChargeStrategy<P,U>

Strategy for Order

Author:

Arjun Dhar

Method Summary

Modifier and Type	Method and Description
<CONTEXT> O	createOrder(Map<P,Number> productQtyMap, U user, String currency, List<PromotionForUser> promotions, Map<String,Object> itemProperties, boolean persist, CONTEXT context)
<CONTEXT> O	createOrder(Map<P,Number> productQtyMap, U user, String currency, List<PromotionForUser> promotions, Map<String,Object> itemProperties, boolean persist, org.apache.commons.collections.Transformer transformer, CONTEXT context) Create an Order Note: A helper method that directly accepts Cart could be convenient, however most order creation data are also contextual and it would additionally require other services to be part ofthe OrderStrategy which would not make it clean.
OrderService<O,I>	getOrderService() Access to the underlying OrderService
void	onOrderComplete(O order, String sessionId) When an Order is successfully Completed; then some actions should be taken.

Methods inherited from interface com.neurosys.ecom.strategy.service.ChargeStrategy

calculate

Methods inherited from interface com.neurosys.ecom.strategy.service.Strategy

getVersion

Method Detail

createOrder

<CONTEXT> O createOrder(Map<P,Number> productQtyMap,
                        U user,
                        String currency,
                        List<PromotionForUser> promotions,
                        Map<String,Object> itemProperties,
                        boolean persist,
                        org.apache.commons.collections.Transformer transformer,
                        CONTEXT context)
                 throws OrderPlacementException

Create an Order

Note: A helper method that directly accepts Cart could be convenient, however most order creation data are also contextual and it would additionally require other services to be part ofthe OrderStrategy which would not make it clean. For these reasons there is no direct method to accept Cart. One can use the following code to support the transition, for example:

                                Map productQuantityMap = cartService.convertToProductQuantityMap(cart); 
                                order = orderStrategy.createOrder(productQuantityMap, user, null Default Currency, null  No promotions, false    , orderProcessHelper.deriveContext(user, getRequestCycle()));
 

or one can use OrderProcessHelper#deriveOrder(Map, IGenericEcomUser, String, Class, Order, String, org.apache.wicket.RequestCycle, org.apache.wicket.Response)

Parameters:

productQtyMap - as Map of Product to Number (Quantity)

user - as User @nullable true (In case of GuestUser, optional)

currency - as String @nullable true. A null implies default currency

promotions - as List of Promotions

itemProperties - as Map of additional properties for each product (OrderItem)

persist - as boolean; if true will persist the Order instance and return an Order with Order.getId() that is also persisted

transformer - as Transformer (Optional), to perform any additional transformation over the in process Order Object before its persisted @nullable true

context - as varargs

Returns:

Order

Throws:

OrderPlacementException

createOrder

<CONTEXT> O createOrder(Map<P,Number> productQtyMap,
                        U user,
                        String currency,
                        List<PromotionForUser> promotions,
                        Map<String,Object> itemProperties,
                        boolean persist,
                        CONTEXT context)
                 throws OrderPlacementException

Throws:

OrderPlacementException

See Also:

#createOrder(Map, IGenericEcomUser, String, List, Map, boolean, Transformer, Object...)

onOrderComplete

void onOrderComplete(O order,
                     String sessionId)

When an Order is successfully Completed; then some actions should be taken. Like (Note these are examples and implementation dependent):

• Notifications & Invoices - Note; one may choose to send those via a ChangeListener hooked into OrderService or TransactionService also
• Reduce Stock Count of products
• UnLock existing locks for Products that were in Order that completed
• Commit any coupons / PromotionForUsers

Parameters:

order - as O

String - sessionId @nullable true; if null release or all products

See Also:

ChangeGenerator, {@link ChangeListener}, {@link PostOrderProcessStrategy} as possible implementation aids.

getOrderService

OrderService<O,I> getOrderService()

Access to the underlying OrderService

Returns: