org.salespointframework.order

Interface OrderManager<T extends Order>

All Known Implementing Classes:

PersistentOrderManager

public interface OrderManager<T extends Order>

A service to manage Orders.

Author:

Thomas Dedek, Paul Henke, Oliver Gierke

Method Summary

Modifier and Type	Method and Description
boolean	cancelOrder(T order) Cancels an Order, it can only be cancelled is OrderStatus is OrderStatus.OPEN.
void	completeOrder(T order) Tries to complete this order, the OrderStatus has to be OrderStatus.PAID.
boolean	contains(OrderIdentifier orderIdentifier) Checks if this OrderManager contains an order.
Streamable<T>	findBy(Interval interval) Returns all Orders in between the Interval.
Streamable<T>	findBy(OrderStatus orderStatus) Returns all Orders having the OrderStatus status.
Streamable<T>	findBy(UserAccount userAccount) Returns all Orders of the given UserAccount.
Streamable<T>	findBy(UserAccount userAccount, Interval interval) Returns all Orders from the given UserAccount in between the dates from and to, including from and to.
Optional<T>	get(OrderIdentifier orderIdentifier) Returns the order identified by an OrderIdentifier
boolean	payOrder(T order) Pays the Order, OrderStatus must be OrderStatus.OPEN and PaymentMethod must be set.
T	save(T order) Saves the given Order or persists changes to it.

Method Detail

save

T save(T order)

Saves the given Order or persists changes to it.

Parameters:

order - the order to be saved, must not be null.

Returns:

get

Optional<T> get(OrderIdentifier orderIdentifier)

Returns the order identified by an OrderIdentifier

Parameters:

orderIdentifier - identifier of the Order to be returned, must not be null.

Returns:

the order if the orderIdentifier matches, otherwise Optional.empty().

contains

boolean contains(OrderIdentifier orderIdentifier)

Checks if this OrderManager contains an order.

Parameters:

orderIdentifier - the OrderIdentifier of the Order, must not be null.

Returns:

true if the OrderManager contains the order, false otherwise.

findBy

Streamable<T> findBy(OrderStatus orderStatus)

Returns all Orders having the OrderStatus status. If no orders with the specified status exist, an empty Iterable is returned.

Parameters:

orderStatus - Denoting the OrderStatus on which the Orders will be requested.

Returns:

a Streamable containing all Orders with the specified OrderStatus

findBy

Streamable<T> findBy(Interval interval)

Returns all Orders in between the Interval. So every entry with an time stamp <= to and >= from is returned. If no Orders within the specified time span exist, an empty Iterable is returned.

Parameters:

interval - The time interval to find Orders in, must not be null.

Returns:

a Streamable containing all Orders in the given Interval.

findBy

Streamable<T> findBy(UserAccount userAccount)

Returns all Orders of the given UserAccount. If this user has no orders, an empty Iterable is returned.

Parameters:

userAccount - Denoting the UserAccount on which the orders will be requested, must not be null.

Returns:

a Streamable containing all orders of the specified user.

findBy

Streamable<T> findBy(UserAccount userAccount,
                     Interval interval)

Returns all Orders from the given UserAccount in between the dates from and to, including from and to. So every entry with an time stamp <= to and >= from is returned. If this user has no Orders in this period, an empty Iterable is returned.

Parameters:

userAccount - The UserAccount whose Orders shall be returned, must not be null.

interval - The time interval to find Orders in, must not be null.

Returns:

a Streamable containing all orders from the specified user in the specified period.

completeOrder

void completeOrder(T order)
            throws OrderCompletionFailure

Tries to complete this order, the OrderStatus has to be OrderStatus.PAID.

Parameters:

order - the order to complete, must not be null.

Throws:

OrderCompletionFailure - in case the order can't be completed.

payOrder

boolean payOrder(T order)

Pays the Order, OrderStatus must be OrderStatus.OPEN and PaymentMethod must be set.

Parameters:

order - the order to be payed, must not be null.

Returns:

true if the order could be payed

cancelOrder

boolean cancelOrder(T order)

Cancels an Order, it can only be cancelled is OrderStatus is OrderStatus.OPEN.

Parameters:

order - the order to be canceled, must not be null.

Returns:

true if the order could be canceled