com.adobe.cq.commerce.api

Class PriceInfo

java.lang.Object

ValueMapDecorator

com.adobe.cq.commerce.api.PriceInfo

public class PriceInfo
extends ValueMapDecorator

PriceInfo provides information about prices for products, cart entries, and orders.

A product, cart entry, or order can have many prices associated with it. Each price is identified by a list of string classifiers. For instance, a product might have the following prices:

1. "UNIT", "PRE_TAX", "USD"
2. "UNIT", "PRE_TAX", "EUR"
3. "SHIPPING", "WEIGHT_SURCHARGE", "SURFACE", "EUR"
4. "SHIPPING", "WEIGHT_SURCHARGE", "AIR", "EUR"

A PriceFilter

is normally used when fetching prices. Price searches can return a list (generally getPriceInfo()) of all prices matching the filter, or can return only the first (generally getPrice()). Because of the second form, more common (or default) price infos should be stored in front of less common (more specific) price infos.

For instance, if a product had the following prices:

1. "TAX"
2. "TAX", "CALIFORNIA", "SANTA_CLARA"
3. "TAX", "CALIFORNIA", "SAN_DIEGO"

The first price would be returned from getPrice(new PriceFilter("TAX")), while the second would be returned from getPrice(new PriceFilter("TAX", "CALIFORNIA")).

In general, the set of price classifiers used by an e-commerce site are implementation-dependent. However, the out-of-the-box commerce components do make a few assumptions about the existence of the following classifiers:

• "UNIT" (for products & cart entries)
• "LINE" (for cart entries)
• "SHIPPING" (for orders)
• "ORDER" (for orders)

A PriceInfo also supports the retrieval of a formatted string for displaying the price, and a minimum quantity at which the price is valid.

Field Summary

Fields

Modifier and Type	Field and Description
static String	MIN_QUANTITY

Constructor Summary

Constructors

Constructor and Description
PriceInfo(BigDecimal amount, Currency currency) Deprecated. since 5.6.200; use PriceInfo(java.math.BigDecimal, java.util.Locale) instead.
PriceInfo(BigDecimal amount, Locale locale) Create price info with a minimum quantity of one, and the default currency for the given locale.
PriceInfo(BigDecimal amount, Locale locale, Currency currency) Create price info with a minimum quantity of one, and the given currency and locale.

Method Summary

Methods

Modifier and Type	Method and Description
BigDecimal	getAmount() Get the price's value.
Currency	getCurrency() Get the currency.
String	getFormattedString() Get the formatted string.
Locale	getLocale() Get the locale.
long	getQuantity() Convenience method for retrieving the minimum quantity property.
String	toString()

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

MIN_QUANTITY

public static final String MIN_QUANTITY

See Also:

Constant Field Values

Constructor Detail

PriceInfo

@Deprecated
public PriceInfo(BigDecimal amount,
                    Currency currency)

Deprecated. since 5.6.200; use PriceInfo(java.math.BigDecimal, java.util.Locale) instead.

Create price info with a minimum quantity of one.

Parameters:

amount - The actual price value.

currency - The currency.

PriceInfo

public PriceInfo(BigDecimal amount,
         Locale locale)

Create price info with a minimum quantity of one, and the default currency for the given locale.

Parameters:

amount - The actual price value.

locale - The locale.

PriceInfo

public PriceInfo(BigDecimal amount,
         Locale locale,
         Currency currency)

Create price info with a minimum quantity of one, and the given currency and locale.

Parameters:

amount - The actual price value.

locale - The locale.

Method Detail

getAmount

public BigDecimal getAmount()

Get the price's value.

getQuantity

public long getQuantity()

Convenience method for retrieving the minimum quantity property. If no quantity property is set, a minimum quantity of 1 is assumed.

getLocale

public Locale getLocale()

Get the locale.

getCurrency

public Currency getCurrency()

Get the currency.

getFormattedString

public String getFormattedString()

Get the formatted string.

toString

public String toString()