org.broadleafcommerce.inventory.basic.service

Interface BasicInventoryService

All Known Implementing Classes:

BasicInventoryServiceImpl

public interface BasicInventoryService

This basic inventory service checks and adjusts the current inventory of a sku. All Skus will be considered generally unavailable from an inventory perspective if Sku.isAvaliable() returns false or if Sku.isActive() returns false. Skus with an InventoryType of null or 'NONE' will be considered undefined from an inventory perspective, and will generally be considered available. However, a request for available quantities of Skus with a null or 'NONE' inventory type will return null (as the sku is available but no inventory strategy is defined).

Author:

Kelly Tisdell

Method Summary

Methods

Modifier and Type	Method and Description
void	decrementInventory(Long skuId, int quantity) Attempts to decrement inventory if it is available.
void	decrementInventory(Map<Long,Integer> skuQuantities) Attempts to decrement inventory for a map of Sku ids and quantities.
void	incrementInventory(Long skuId, int quantity) Attempts to increment inventory.
void	incrementInventory(Map<Long,Integer> skuQuantities) Attempts to increment inventory for a map of Sku ids and quantities.
boolean	isAvailable(Long skuId, int quantity) Indicates whether the given quantity is available for the particular skuId.
Map<Long,Integer>	retrieveQuantitiesAvailable(Set<Long> skuIds) Retrieves the quantities available for a set of sku ids.
Integer	retrieveQuantityAvailable(Long skuId) Retrieves the quantity available for a particular sku.

Method Detail

retrieveQuantityAvailable

Integer retrieveQuantityAvailable(Long skuId)

Retrieves the quantity available for a particular sku. May return null if no inventory is maintained for the given sku. This is the case when Sku.getInventoryType() == null or not Sku.getInventoryType().equals(InventoryType.BASIC). Effectively, if the quantity returned is null, inventory is undefined, which most likely means it is available. However, rather than returning an arbitrary integer values (like Integer.MAX_VALUE), which has specific meaning, we return null as this can be interpreted by the client to mean whatever they define it as (including infinitely available), which is the most likely scenario.

Parameters:

skuId -

Returns:

retrieveQuantitiesAvailable

Map<Long,Integer> retrieveQuantitiesAvailable(Set<Long> skuIds)

Retrieves the quantities available for a set of sku ids. The values in the map returned may be null if no inventory is maintained for the given sku. This is the case when Sku.getInventoryType() == null or not Sku.getInventoryType().equals(InventoryType.BASIC). Effectively, if a quantity returned is null, inventory is undefined, which most likely means it is available. However, rather than returning an arbitrary integer values (like Integer.MAX_VALUE), which has specific meaning, we return null as this can be interpreted by the client to mean whatever they define it as (including infinitely available), which is the most likely scenario.

Parameters:

skuIds -

Returns:

isAvailable

boolean isAvailable(Long skuId,
                  int quantity)

Indicates whether the given quantity is available for the particular skuId. The result will be true if Sku.getInventoryType() == null or not Sku.getInventoryType().equals(InventoryType.BASIC). The result will be false if the Sku is inactive, if the Sku.getAvaialbe() == false, if the quantity field is null, or if the quantity requested exceeds the quantity available.

Parameters:

skuId -

quantity -

Returns:

decrementInventory

void decrementInventory(Long skuId,
                      int quantity)
                        throws BasicInventoryUnavailableException

Attempts to decrement inventory if it is available.

Parameters:

skuId -

quantity -

Throws:

BasicInventoryUnavailableException

decrementInventory

void decrementInventory(Map<Long,Integer> skuQuantities)
                        throws BasicInventoryUnavailableException

Attempts to decrement inventory for a map of Sku ids and quantities. Quantities must be greater than zero or an IllegalArgumentException will be thrown.

Parameters:

skuQuantities -

Throws:

BasicInventoryUnavailableException

incrementInventory

void incrementInventory(Long skuId,
                      int quantity)

Attempts to increment inventory. Quantity must be greater than zero or an IllegalArgumentException will be thrown.

Parameters:

skuId -

quantity -

incrementInventory

void incrementInventory(Map<Long,Integer> skuQuantities)

Attempts to increment inventory for a map of Sku ids and quantities. Quantities must not be null and must be greater than zero or an IllegalArgumentException will be thrown.

Parameters:

skuQuantities -