org.beigesoft.acc.srv

Class SrBlnc<RS>

java.lang.Object

org.beigesoft.acc.srv.SrBlnc<RS>

Type Parameters:

RS - platform dependent record set type

All Implemented Interfaces:

ISrBlnc, org.beigesoft.hnd.IHnTrRlBk

public class SrBlnc<RS>
extends Object
implements ISrBlnc

Service that maintenance Blnc and implements dirty check for all account. If balance for account at given date is NULL then it will be no record Blnc, this is cheap approach. All work include recalculation all balances is executed in single transaction. It works if there is any entry.

Author:

Yury Demidenko

Field Summary

Fields inherited from interface org.beigesoft.hnd.IHnTrRlBk

HNSTRRLBK

Constructor Summary

Constructors

Constructor and Description
SrBlnc()

Method Summary

Modifier and Type	Method and Description
int	chngSacsIfNd(Map<String,Object> pRvs) Changes if need entries Entr.sacNm, Entr.sadNm, Blnc.SaNm.
Date	evBlStDt(Map<String,Object> pRvs, Map<String,Object> pVs) Evaluate date start of stored balances according settings, this is the first month of the first accounting entry.
org.beigesoft.mdl.EPeriod	evBlStPer(Map<String,Object> pRvs, Map<String,Object> pVs) Evaluate period of stored balances according settings, if it's changed then it switch on "current balances are dirty".
Date	evDtNxtPerSt(Map<String,Object> pRvs, Map<String,Object> pVs, Date pDtFor) Evaluate date start of next balance store period.
Date	evDtPrvPerSt(Map<String,Object> pRvs, Map<String,Object> pVs, Date pDtFor) Evaluate date start of previous balance store period.
Date	evDtStPer(Map<String,Object> pRvs, Date pDtFor) Evaluate start of period nearest to pDtFor.
String	evQuBlnc(Map<String,Object> pRvs, Date pDt) Evaluate Trial Balance query.
boolean	getIsAndr() Getter for isAndr.
org.beigesoft.log.ILog	getLog() Geter for log.
org.beigesoft.rdb.IOrm	getOrm() Getter for orm.
String	getQuBlnc() Getter for quBlnc.
org.beigesoft.rdb.IRdb<RS>	getRdb() Geter for rdb.
ISrAcStg	getSrAcStg() Getter for srAcStg.
org.beigesoft.rdb.SrvClVl	getSrvClVl() Getter for srvClVl.
void	hndNewEntr(Map<String,Object> pRvs, Date pDtAt) Handle new accounting entry to check dirty of stored balances.
void	hndRlBk(Map<String,Object> pRvs) Handle rollback, e.g.
void	hndSacntCh(Map<String,Object> pRvs, ISacnt pSacnt) Handle subaccount has been changed.
BlnCh	lazBlnCh(Map<String,Object> pRvs, Map<String,Object> pVs) Lazy getter for blnCh.
String	loadStr(String pFlNm) Load string file (usually SQL query).
void	recalc(Map<String,Object> pRvs, Map<String,Object> pVs, Date pDtFor) Forced recalculation all balances for all dates less or equals maximum (pDtFor, max date entry, max date balance).
boolean	recalcIfNd(Map<String,Object> pRvs, Date pDtFor) Recalculate if need for all balances for all dates less or equals maximum (pDtFor, max date entry, max date balance), this method is always invoked by reports.
List<TrBlLn>	retBlnLnsToSv(String pQu) Retrieve Trial Balance lines with given query to save into DB.
List<TrBlLn>	retTrBlnc(Map<String,Object> pRvs, Date pDt) Retrieve Trial Balance report.
void	setIsAndr(boolean pIsAndr) Setter for isAndr.
void	setLog(org.beigesoft.log.ILog pLog) Setter for log.
void	setOrm(org.beigesoft.rdb.IOrm pOrm) Setter for orm.
void	setQuBlnc(String pQuBlnc) Setter for quBlnc.
void	setRdb(org.beigesoft.rdb.IRdb<RS> pRdb) Setter for rdb.
void	setSrAcStg(ISrAcStg pSrAcStg) Setter for srAcStg.
void	setSrvClVl(org.beigesoft.rdb.SrvClVl pSrvClVl) Setter for srvClVl.

Methods inherited from class java.lang.Object

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

Constructor Detail

SrBlnc

public SrBlnc()

Method Detail

retTrBlnc

public final List<TrBlLn> retTrBlnc(Map<String,Object> pRvs,
                                    Date pDt)
                             throws Exception

Retrieve Trial Balance report.

Specified by:

retTrBlnc in interface ISrBlnc

Parameters:

pRvs - Request scoped variables

pDt - date

Returns:

balance lines

Throws:

Exception - - an exception

recalcIfNd

public final boolean recalcIfNd(Map<String,Object> pRvs,
                                Date pDtFor)
                         throws Exception

Recalculate if need for all balances for all dates less or equals maximum (pDtFor, max date entry, max date balance), this method is always invoked by reports.

Specified by:

recalcIfNd in interface ISrBlnc

Parameters:

pRvs - Request scoped variables

pDtFor - date for

Returns:

if has been recalculation

Throws:

Exception - - an exception

hndNewEntr

public final void hndNewEntr(Map<String,Object> pRvs,
                             Date pDtAt)
                      throws Exception

Handle new accounting entry to check dirty of stored balances.

Specified by:

hndNewEntr in interface ISrBlnc

Parameters:

pRvs - Request scoped variables

pDtAt - date at

Throws:

Exception - - an exception

evDtStPer

public final Date evDtStPer(Map<String,Object> pRvs,
                            Date pDtFor)
                     throws Exception

Evaluate start of period nearest to pDtFor. Tested in blc org.beigesoft.test.CalendarTest.

Specified by:

evDtStPer in interface ISrBlnc

Parameters:

pRvs - Request scoped variables

pDtFor - date for

Returns:

Start of period nearest to pDtFor

Throws:

Exception - - an exception

chngSacsIfNd

public final int chngSacsIfNd(Map<String,Object> pRvs)
                       throws Exception

Changes if need entries Entr.sacNm, Entr.sadNm, Blnc.SaNm. It should be invoked together with recalcIfNd, and service must be locked (synchronized).

Specified by:

chngSacsIfNd in interface ISrBlnc

Parameters:

pRvs - Request scoped variables

Returns:

rows count updated

Throws:

Exception - - an exception

hndSacntCh

public final void hndSacntCh(Map<String,Object> pRvs,
                             ISacnt pSacnt)
                      throws Exception

Handle subaccount has been changed.

Specified by:

hndSacntCh in interface ISrBlnc

Parameters:

pRvs - Request scoped variables

pSacnt - subaccount

Throws:

Exception - - an exception

evDtNxtPerSt

public final Date evDtNxtPerSt(Map<String,Object> pRvs,
                               Map<String,Object> pVs,
                               Date pDtFor)
                        throws Exception

Evaluate date start of next balance store period. Tested in blc org.beigesoft.test.CalendarTest.

Specified by:

evDtNxtPerSt in interface ISrBlnc

Parameters:

pRvs - Request scoped variables

pVs - Invoker scoped variables

pDtFor - date for

Returns:

Start of next period nearest to pDtFor

Throws:

Exception - - an exception

evDtPrvPerSt

public final Date evDtPrvPerSt(Map<String,Object> pRvs,
                               Map<String,Object> pVs,
                               Date pDtFor)
                        throws Exception

Evaluate date start of previous balance store period. Tested in blc org.beigesoft.test.CalendarTest.

Specified by:

evDtPrvPerSt in interface ISrBlnc

Parameters:

pRvs - Request scoped variables

pVs - Invoker scoped variables

pDtFor - date for

Returns:

Start of next period nearest to pDtFor

Throws:

Exception - - an exception

hndRlBk

public final void hndRlBk(Map<String,Object> pRvs)
                   throws Exception

Handle rollback, e.g. clears cached data.

Specified by:

hndRlBk in interface org.beigesoft.hnd.IHnTrRlBk

Parameters:

pRvs - Request scoped variables

Throws:

Exception - - an exception

recalc

public final void recalc(Map<String,Object> pRvs,
                         Map<String,Object> pVs,
                         Date pDtFor)
                  throws Exception

Forced recalculation all balances for all dates less or equals maximum (pDtFor, max date entry, max date balance). If balance for account at given date is NULL then it will be no recorded into Blnc, this is cheap approach.

Parameters:

pRvs - Request scoped variables

pVs - Invoker scoped variables

pDtFor - date for

Throws:

Exception - - an exception

evBlStPer

public final org.beigesoft.mdl.EPeriod evBlStPer(Map<String,Object> pRvs,
                                                 Map<String,Object> pVs)
                                          throws Exception

Evaluate period of stored balances according settings, if it's changed then it switch on "current balances are dirty".

Parameters:

pRvs - Request scoped variables

pVs - Invoker scoped variables

Returns:

pPer EPeriod e.g. MONTHLY

Throws:

Exception - - an exception

evBlStDt

public final Date evBlStDt(Map<String,Object> pRvs,
                           Map<String,Object> pVs)
                    throws Exception

Evaluate date start of stored balances according settings, this is the first month of the first accounting entry. It also may change date start in BlnCh.

Parameters:

pRvs - Request scoped variables

pVs - Invoker scoped variables

Returns:

Date

Throws:

Exception - - an exception

evQuBlnc

public final String evQuBlnc(Map<String,Object> pRvs,
                             Date pDt)
                      throws Exception

Evaluate Trial Balance query.

Parameters:

pRvs - Request scoped variables

pDt - date of balance

Returns:

query of balance

Throws:

Exception - - an exception

retBlnLnsToSv

public final List<TrBlLn> retBlnLnsToSv(String pQu)
                                 throws Exception

Retrieve Trial Balance lines with given query to save into DB.

Parameters:

pQu - date

Returns:

balance lines

Throws:

Exception - - an exception

loadStr

public final String loadStr(String pFlNm)
                     throws IOException

Load string file (usually SQL query).

Parameters:

pFlNm - file name

Returns:

SQL query, not null

Throws:

IOException - - IO exception

lazBlnCh

public final BlnCh lazBlnCh(Map<String,Object> pRvs,
                            Map<String,Object> pVs)
                     throws Exception

Lazy getter for blnCh.

Parameters:

pRvs - Request scoped variables

pVs - Invoker scoped variables

Returns:

BlnCh

Throws:

Exception - - an exception

getOrm

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

Getter for orm.

Returns:

IOrm

setOrm

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

Setter for orm.

Parameters:

pOrm - reference

getRdb

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

Geter for rdb.

Returns:

IRdb

setRdb

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

Setter for rdb.

Parameters:

pRdb - reference

getQuBlnc

public final String getQuBlnc()

Getter for quBlnc.

Returns:

String

setQuBlnc

public final void setQuBlnc(String pQuBlnc)

Setter for quBlnc.

Parameters:

pQuBlnc - 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

getSrAcStg

public final ISrAcStg getSrAcStg()

Getter for srAcStg.

Returns:

ISrAcStg

setSrAcStg

public final void setSrAcStg(ISrAcStg pSrAcStg)

Setter for srAcStg.

Parameters:

pSrAcStg - reference

getSrvClVl

public final org.beigesoft.rdb.SrvClVl getSrvClVl()

Getter for srvClVl.

Returns:

SrvClVl

setSrvClVl

public final void setSrvClVl(org.beigesoft.rdb.SrvClVl pSrvClVl)

Setter for srvClVl.

Parameters:

pSrvClVl - reference

getIsAndr

public final boolean getIsAndr()

Getter for isAndr.

Returns:

boolean

setIsAndr

public final void setIsAndr(boolean pIsAndr)

Setter for isAndr.

Parameters:

pIsAndr - reference