org.beigesoft.ws.srv

Class SrCart<RS>

java.lang.Object

org.beigesoft.ws.srv.SrCart<RS>

Type Parameters:

RS - platform dependent record set type

All Implemented Interfaces:

ISrCart

public class SrCart<RS>
extends Object
implements ISrCart

Service that retrieve/create buyer's shopping cart, make cart totals after any line action, etc. This is shared non-transactional service.

Author:

Yury Demidenko

Constructor Summary

Constructors

Constructor and Description
SrCart()

Method Summary

Modifier and Type	Method and Description
Buyer	createBuyer(Map<String,Object> pRvs, org.beigesoft.mdl.IReqDt pRqDt) Create Buyer.
void	delLine(Map<String,Object> pRvs, CartLn pCaLn, TxDst pTxRls) Deletes cart line.
void	emptyCart(Map<String,Object> pRvs, Buyer pBuyr) Empties Cart.
void	emptyCart(Map<String,Object> pRvs, Cart pCart) Empties Cart.
CartTxLn	fndCreTxLn(Map<String,Object> pRvs, Cart pCart, Tax pTax, SeSel pSeller, boolean pNeedFind) Finds (if need) enabled line with same tax and seller or any disabled tax line or creates one.
IBuySr	getBuySr() Getter for buySr.
Cart	getCart(Map<String,Object> pRvs, org.beigesoft.mdl.IReqDt pRqDt, boolean pIsNeedToCreate, boolean pIsBuAuth) Get/Create Cart.
org.beigesoft.log.ILog	getLog() Geter for log.
org.beigesoft.srv.INumStr	getNumStr() Getter for numStr.
org.beigesoft.rdb.IOrm	getOrm() Geter for orm.
Class<?>	getPplCl() Getter for pplCl.
org.beigesoft.rdb.IRdb<RS>	getRdb() Getter for rdb.
ISrTrStg	getSrTrStg() Getter for srTrStg.
void	hndCartChg(Map<String,Object> pRvs, Cart pCart, TxDst pTxRls) Handle event cart delivering or line changed and redone forced service if need.
void	hndCurrChg(Map<String,Object> pRvs, Cart pCart, AcStg pAs, TrdStg pTs) Handle event cart currency changed.
String	lazQuItemPrice() Lazy Getter for quItemPrice.
String	lazQuItemPriceCat() Lazy Getter for quItemPriceCat.
String	lazQuItemSePrice() Lazy Getter for quItemSePrice.
String	lazQuItemSePriceCat() Lazy Getter for quItemSePriceCat.
String	lazQuTxInvBas() Lazy Getter for quTxInvBas.
String	lazQuTxInvBasAggr() Lazy Getter for quTxInvBasAggr.
String	lazQuTxItBas() Lazy Getter for quTxItBas.
String	lazQuTxItBasAggr() Lazy Getter for quTxItBasAggr.
String	loadString(String pFiNm) Load string file (usually SQL query).
void	mkCartTots(Map<String,Object> pRvs, TrdStg pTs, CartLn pCaLn, AcStg pAs, TxDst pTxRls) Refresh cart totals by seller cause line inserted/changed/deleted.
void	mkLine(Map<String,Object> pRvs, CartLn pCaLn, AcStg pAs, TrdStg pTs, TxDst pTxRls, boolean pRedoPr, boolean pRedoTxc) Makes cart line.
CartLn	mkTxdLn(List<CartLn> pTxdLns, Long pTdlId, Long pCatId, Tax pTax, Double pRate, AcStg pAs) Make cart line that stores taxes data in lines set for invoice basis or item basis aggregate rate.
String	prn(AcStg pAs, org.beigesoft.mdl.CmnPrf pCpf, org.beigesoft.mdlp.UsPrf pUpf, BigDecimal pVal) Simple delegator to print number.
Cart	retrCart(Map<String,Object> pRvs, Buyer pBuyr, boolean pForEmpty) Retrieves Cart from DB.
AItmPri<?,?>	revItmPri(Map<String,Object> pRvs, TrdStg pTs, Buyer pBuyr, EItmTy pItType, Long pItId) Reveals item's price descriptor.
TxDst	revTxRules(Map<String,Object> pRvs, Cart pCart, AcStg pAs) Reveal shared tax rules for cart.
void	setBuySr(IBuySr pBuySr) Setter for buySr.
void	setLog(org.beigesoft.log.ILog pLog) Setter for log.
void	setNumStr(org.beigesoft.srv.INumStr pNumStr) Setter for numStr.
void	setOrm(org.beigesoft.rdb.IOrm pOrm) Setter for orm.
void	setPplCl(Class<?> pPplCl) Setter for pplCl.
void	setRdb(org.beigesoft.rdb.IRdb<RS> pRdb) Setter for rdb.
void	setSrTrStg(ISrTrStg pSrTrStg) Setter for srTrStg.

Methods inherited from class java.lang.Object

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

Constructor Detail

SrCart

public SrCart()

Method Detail

getCart

public final Cart getCart(Map<String,Object> pRvs,
                          org.beigesoft.mdl.IReqDt pRqDt,
                          boolean pIsNeedToCreate,
                          boolean pIsBuAuth)
                   throws Exception

Get/Create Cart.

Specified by:

getCart in interface ISrCart

Parameters:

pRvs - additional param

pRqDt - Request Data

pIsNeedToCreate - if need to create, e.g. "NO" for deleting item from cart, "YES" for adding one.

pIsBuAuth - buyer must be authorized

Returns:

shopping cart or null

Throws:

Exception - - an exception

mkCartTots

public final void mkCartTots(Map<String,Object> pRvs,
                             TrdStg pTs,
                             CartLn pCaLn,
                             AcStg pAs,
                             TxDst pTxRls)
                      throws Exception

Refresh cart totals by seller cause line inserted/changed/deleted.

Specified by:

mkCartTots in interface ISrCart

Parameters:

pRvs - request scoped vars

pTs - TrdStg

pCaLn - affected cart line

pAs - Accounting Settings

pTxRls - NULL if not taxable

Throws:

Exception - - an exception.

revTxRules

public final TxDst revTxRules(Map<String,Object> pRvs,
                              Cart pCart,
                              AcStg pAs)
                       throws Exception

Reveal shared tax rules for cart. It also makes buyer-regCustomer.

Specified by:

revTxRules in interface ISrCart

Parameters:

pRvs - request scoped vars

pCart - cart

pAs - Accounting Settings

Returns:

tax rules, NULL if not taxable

Throws:

Exception - - an exception.

hndCurrChg

public final void hndCurrChg(Map<String,Object> pRvs,
                             Cart pCart,
                             AcStg pAs,
                             TrdStg pTs)
                      throws Exception

Handle event cart currency changed.

Specified by:

hndCurrChg in interface ISrCart

Parameters:

pRvs - request scoped vars

pCart - cart

pAs - Accounting Settings

pTs - TrdStg

Throws:

Exception - - an exception.

delLine

public final void delLine(Map<String,Object> pRvs,
                          CartLn pCaLn,
                          TxDst pTxRls)
                   throws Exception

Deletes cart line.

Specified by:

delLine in interface ISrCart

Parameters:

pRvs - request scoped vars

pCaLn - cart line

pTxRls - Tax Rules

Throws:

Exception - - an exception.

hndCartChg

public final void hndCartChg(Map<String,Object> pRvs,
                             Cart pCart,
                             TxDst pTxRls)
                      throws Exception

Handle event cart delivering or line changed and redone forced service if need.

Specified by:

hndCartChg in interface ISrCart

Parameters:

pRvs - request scoped vars

pCart - cart

pTxRls - Tax Rules

Throws:

Exception - - an exception.

mkLine

public final void mkLine(Map<String,Object> pRvs,
                         CartLn pCaLn,
                         AcStg pAs,
                         TrdStg pTs,
                         TxDst pTxRls,
                         boolean pRedoPr,
                         boolean pRedoTxc)
                  throws Exception

Makes cart line.

Specified by:

mkLine in interface ISrCart

Parameters:

pRvs - request scoped vars

pCaLn - cart line

pAs - Accounting Settings

pTs - TrdStg

pTxRls - NULL if not taxable

pRedoPr - redo price

pRedoTxc - redo tax category

Throws:

Exception - - an exception.

revItmPri

public final AItmPri<?,?> revItmPri(Map<String,Object> pRvs,
                                    TrdStg pTs,
                                    Buyer pBuyr,
                                    EItmTy pItType,
                                    Long pItId)
                             throws Exception

Reveals item's price descriptor.

Specified by:

revItmPri in interface ISrCart

Parameters:

pRvs - request scoped vars

pTs - TrdStg

pBuyr - Buyer

pItType - Item Type

pItId - Item ID

Returns:

item's price descriptor or exception

Throws:

Exception - - an exception

emptyCart

public final void emptyCart(Map<String,Object> pRvs,
                            Buyer pBuyr)
                     throws Exception

Empties Cart.

Specified by:

emptyCart in interface ISrCart

Parameters:

pRvs - request scoped vars

pBuyr - buyer

Throws:

Exception - - an exception

emptyCart

public final void emptyCart(Map<String,Object> pRvs,
                            Cart pCart)
                     throws Exception

Empties Cart.

Parameters:

pRvs - request scoped vars

pCart - cart

Throws:

Exception - - an exception

retrCart

public final Cart retrCart(Map<String,Object> pRvs,
                           Buyer pBuyr,
                           boolean pForEmpty)
                    throws Exception

Retrieves Cart from DB.

Parameters:

pRvs - additional param

pBuyr - buyer

pForEmpty - for emptying

Returns:

shopping cart or null

Throws:

Exception - - an exception

mkTxdLn

public final CartLn mkTxdLn(List<CartLn> pTxdLns,
                            Long pTdlId,
                            Long pCatId,
                            Tax pTax,
                            Double pRate,
                            AcStg pAs)

Make cart line that stores taxes data in lines set for invoice basis or item basis aggregate rate.

Parameters:

pTxdLns - TD lines

pTdlId - line ID

pCatId - tax category ID

pTax - tax

pRate - tax rate

pAs - AS

Returns:

line

fndCreTxLn

public final CartTxLn fndCreTxLn(Map<String,Object> pRvs,
                                 Cart pCart,
                                 Tax pTax,
                                 SeSel pSeller,
                                 boolean pNeedFind)
                          throws Exception

Finds (if need) enabled line with same tax and seller or any disabled tax line or creates one.

Parameters:

pRvs - additional param

pCart - cart

pTax - tax

pSeller - seller

pNeedFind - if need to find enabled

Returns:

line

Throws:

Exception - if no need to find but line is found

createBuyer

public final Buyer createBuyer(Map<String,Object> pRvs,
                               org.beigesoft.mdl.IReqDt pRqDt)
                        throws Exception

Create Buyer.

Parameters:

pRvs - additional param

pRqDt - Request Data

Returns:

buyer

Throws:

Exception - - an exception

lazQuTxInvBas

public final String lazQuTxInvBas()
                           throws IOException

Lazy Getter for quTxInvBas.

Returns:

String

Throws:

IOException - - IO exception

lazQuTxInvBasAggr

public final String lazQuTxInvBasAggr()
                               throws IOException

Lazy Getter for quTxInvBasAggr.

Returns:

String

Throws:

IOException - - IO exception

lazQuTxItBas

public final String lazQuTxItBas()
                          throws IOException

Lazy Getter for quTxItBas.

Returns:

String

Throws:

IOException - - IO exception

lazQuTxItBasAggr

public final String lazQuTxItBasAggr()
                              throws IOException

Lazy Getter for quTxItBasAggr.

Returns:

String

Throws:

IOException - - IO exception

lazQuItemPrice

public final String lazQuItemPrice()
                            throws IOException

Lazy Getter for quItemPrice.

Returns:

String

Throws:

IOException - - IO exception

lazQuItemSePrice

public final String lazQuItemSePrice()
                              throws IOException

Lazy Getter for quItemSePrice.

Returns:

String

Throws:

IOException - - IO exception

lazQuItemPriceCat

public final String lazQuItemPriceCat()
                               throws IOException

Lazy Getter for quItemPriceCat.

Returns:

String

Throws:

IOException - - IO exception

lazQuItemSePriceCat

public final String lazQuItemSePriceCat()
                                 throws IOException

Lazy Getter for quItemSePriceCat.

Returns:

String

Throws:

IOException - - IO exception

loadString

public final String loadString(String pFiNm)
                        throws IOException

Load string file (usually SQL query).

Parameters:

pFiNm - file name

Returns:

String usually SQL query

Throws:

IOException - - IO exception

prn

public final String prn(AcStg pAs,
                        org.beigesoft.mdl.CmnPrf pCpf,
                        org.beigesoft.mdlp.UsPrf pUpf,
                        BigDecimal pVal)

Simple delegator to print number.

Parameters:

pAs - ACC stg

pCpf - common prefs

pUpf - user prefs

pVal - value

Returns:

String

getNumStr

public final org.beigesoft.srv.INumStr getNumStr()

Getter for numStr.

Returns:

INumStr

setNumStr

public final void setNumStr(org.beigesoft.srv.INumStr pNumStr)

Setter for numStr.

Parameters:

pNumStr - reference

getLog

public final org.beigesoft.log.ILog getLog()

Geter for log.

Returns:

ILog

setLog

public final void setLog(org.beigesoft.log.ILog pLog)

Setter for log.

Parameters:

pLog - reference

getRdb

public final org.beigesoft.rdb.IRdb<RS> getRdb()

Getter for rdb.

Returns:

IRdb

setRdb

public final void setRdb(org.beigesoft.rdb.IRdb<RS> pRdb)

Setter for rdb.

Parameters:

pRdb - reference

getOrm

public final org.beigesoft.rdb.IOrm getOrm()

Geter for orm.

Returns:

IOrm

setOrm

public final void setOrm(org.beigesoft.rdb.IOrm pOrm)

Setter for orm.

Parameters:

pOrm - reference

getSrTrStg

public final ISrTrStg getSrTrStg()

Getter for srTrStg.

Returns:

ISrTrStg

setSrTrStg

public final void setSrTrStg(ISrTrStg pSrTrStg)

Setter for srTrStg.

Parameters:

pSrTrStg - reference

getPplCl

public final Class<?> getPplCl()

Getter for pplCl.

Returns:

Class

setPplCl

public final void setPplCl(Class<?> pPplCl)

Setter for pplCl.

Parameters:

pPplCl - reference

getBuySr

public final IBuySr getBuySr()

Getter for buySr.

Returns:

IBuySr

setBuySr

public final void setBuySr(IBuySr pBuySr)

Setter for buySr.

Parameters:

pBuySr - reference