org.salespointframework.accountancy

Class PersistentAccountancy<T extends AccountancyEntry>

java.lang.Object

org.salespointframework.accountancy.PersistentAccountancy<T>

All Implemented Interfaces:

Accountancy<T>

@Service
 @Transactional
class PersistentAccountancy<T extends AccountancyEntry>
extends Object
implements Accountancy<T>

This class represents an accountancy. An accountancy aggregates of AccountancyEntrys.

Author:

Hannes Weisbach, Thomas Dedek, Oliver Gierke

Constructor Summary

Constructors

Constructor and Description
PersistentAccountancy(BusinessTime businessTime, AccountancyEntryRepository<T> repository) Creates a new PersistentAccountancy with the given BusinessTime and AccountancyEntryRepository.

Method Summary

Modifier and Type	Method and Description
T	add(T accountancyEntry) Adds a new AccountancyEntry to this Accountancy.
Iterable<T>	find(LocalDateTime from, LocalDateTime to) Returns all AccountancyEntrys in between the dates from and to of the specified class type clazz and all sub-types, including from and to.
Map<Interval,Iterable<T>>	find(LocalDateTime from, LocalDateTime to, Duration duration) Returns all AccountancyEntrys of type clazz and all sub-types, which have their date within (including) from and to.
Iterable<T>	findAll() Returns all AccountancyEntrys of the specified type clazz and all sub-types, previously added to the accountancy.
Optional<T>	get(AccountancyEntryIdentifier accountancyEntryIdentifier) Returns the AccountancyEntry of type clazz and all sub-types, identified by AccountancyEntryIdentifier.
Map<Interval,org.joda.money.Money>	salesVolume(LocalDateTime from, LocalDateTime to, Duration period) Returns the sum of the field amount of all AccountancyEntrys of type clazz and its sub-types, which have their date within (including) from and to.

Methods inherited from class java.lang.Object

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

Constructor Detail

PersistentAccountancy

@Autowired
public PersistentAccountancy(BusinessTime businessTime,
                                        AccountancyEntryRepository<T> repository)

Creates a new PersistentAccountancy with the given BusinessTime and AccountancyEntryRepository.

Parameters:

businessTime - must not be null.

repository - must not be null.

Method Detail

add

public final T add(T accountancyEntry)

Description copied from interface: Accountancy

Adds a new AccountancyEntry to this Accountancy.

Specified by:

add in interface Accountancy<T extends AccountancyEntry>

Parameters:

accountancyEntry - entry to be added to the accountancy

get

public final Optional<T> get(AccountancyEntryIdentifier accountancyEntryIdentifier)

Description copied from interface: Accountancy

Returns the AccountancyEntry of type clazz and all sub-types, identified by AccountancyEntryIdentifier. null is returned, if no entry with the given identifier exists.

Specified by:

get in interface Accountancy<T extends AccountancyEntry>

Parameters:

accountancyEntryIdentifier - the AccountancyEntryIdentifier of the entry to be returned

Returns:

the AccountancyEntry or sub type thereof of type clazz which has the identifier AccountancyEntryIdentifier

findAll

public final Iterable<T> findAll()

Description copied from interface: Accountancy

Returns all AccountancyEntrys of the specified type clazz and all sub-types, previously added to the accountancy. If no entries of the specified type exist, an empty Iterable is returned.

Specified by:

findAll in interface Accountancy<T extends AccountancyEntry>

Returns:

an Iterable containing all entries of type clazz

find

public final Iterable<T> find(LocalDateTime from,
                              LocalDateTime to)

Description copied from interface: Accountancy

Returns all AccountancyEntrys in between the dates from and to of the specified class type clazz and all sub-types, including from and to. So every entry with an time stamp <= to and >= from is returned. If no entries within the specified time span exist, or no entries of the specified class type exist, an empty Iterable is returned.

Specified by:

find in interface Accountancy<T extends AccountancyEntry>

Parameters:

from - LocalDateTime denoting the start of the requested time period

to - LocalDateTime denoting the end of the requested time period

Returns:

an Iterable containing all entries between from and to of type E

find

public final Map<Interval,Iterable<T>> find(LocalDateTime from,
                                            LocalDateTime to,
                                            Duration duration)

Description copied from interface: Accountancy

Returns all AccountancyEntrys of type clazz and all sub-types, which have their date within (including) from and to.
The time between from and to is divided into parts of period length. According to their respective date, entries are sorted in exactly one of the time intervals. The last time interval may be shorter than period.
Returned is a map, having a Interval objects as its key, and an Iterable as value. The Iterable contains all entries of the specific type with its date in the interval specified by the key.
If no entries for an interval exist, the Iterable.

Specified by:

find in interface Accountancy<T extends AccountancyEntry>

Parameters:

from - all returned entries will have a time stamp after from

to - all returned entries will have a time stamp before to

duration - length of the time intervals, the period between from and to is divided

Returns:

a map, with intervals of period length between from and to as keys, and as value an Iterable containing all entries within the key- Interval

salesVolume

public final Map<Interval,org.joda.money.Money> salesVolume(LocalDateTime from,
                                                            LocalDateTime to,
                                                            Duration period)

Description copied from interface: Accountancy

Returns the sum of the field amount of all AccountancyEntrys of type clazz and its sub-types, which have their date within (including) from and to.
The time between from and to is divided into parts of period length. According to their time stamp, entries are sorted in exactly one of the time intervals. The last time interval may be shorter than period.
Returned is a map, having a Interval objects as its key, and an Money as value. The Money object's value is equal to the sum of all entries' amount-field, with a date within the key- Interval. If within an interval no entries of the specified type exist, a Money object with a value of zero is added as value for that interval.

Specified by:

salesVolume in interface Accountancy<T extends AccountancyEntry>

Parameters:

from - all returned entries will have a time stamp after from.

to - all returned entries will have a time stamp before to.

period - length of the time intervals, the period between from and to is divided.

Returns:

a Map, with intervals of period length between from and to as keys, and as value a Money object, equal to the sum of the amount fields of all entries within the key- Interval.