Package org.salespointframework.quantity
Class Quantity
- java.lang.Object
-
- org.salespointframework.quantity.Quantity
-
@Embeddable public final class Quantity extends Object
A value object to represent a quantity.- Author:
- Oliver Gierke, Martin Morgenstern
-
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description Quantityadd(Quantity other)Adds the givenQuantityto the current one.booleanequals(Object o)@NonNull BigDecimalgetAmount()The amount of the Quantity.@NonNull MetricgetMetric()The metric of the Quantity.inthashCode()booleanisCompatibleWith(Metric metric)booleanisEqualTo(Quantity other)Returns whether the currentQuantityis equal to the given one negelecting potential differences in precision of the underlying amount.booleanisGreaterThan(Quantity other)Returns whether the givenQuantityis greater than the current one.booleanisGreaterThanOrEqualTo(Quantity other)Returns whether the givenQuantityis greater than or equal to the current one.booleanisLessThan(Quantity other)Returns whether the givenQuantityis less than the current one.booleanisNegative()Returns whether the currentQuantityis negative.booleanisZeroOrNegative()Returns whether the currentQuantityis zero or negative.static Quantityof(double amount)Creates a newQuantityof the given amount.static Quantityof(double amount, Metric metric)static Quantityof(long amount)Creates a newQuantityof the given amount.static Quantityof(long amount, Metric metric)Quantitysubtract(Quantity other)Subtracts the given Quantity from the current one.Quantitytimes(int multiplier)Creates a newQuantityof the current one multiplied with the given int.Quantitytimes(long multiplier)Creates a newQuantityof the current one multiplied with the given long.StringtoString()QuantitytoZero()
-
-
-
Field Detail
-
NONE
public static final Quantity NONE
-
-
Method Detail
-
of
public static Quantity of(long amount)
Creates a newQuantityof the given amount. Defaults the metric to .- Parameters:
amount- must not be null.- Returns:
-
of
public static Quantity of(double amount)
Creates a newQuantityof the given amount. Defaults the metric to .- Parameters:
amount- must not be null.- Returns:
-
of
public static Quantity of(long amount, Metric metric)
- Parameters:
amount- must not be null.metric- must not be null.- Returns:
-
of
public static Quantity of(double amount, Metric metric)
- Parameters:
amount- must not be null.metric- must not be null.- Returns:
-
isCompatibleWith
public boolean isCompatibleWith(Metric metric)
- Parameters:
metric- must not be null.- Returns:
-
add
public Quantity add(Quantity other)
Adds the givenQuantityto the current one.- Parameters:
other- theQuantityto add. The givenQuantity'sMetricmust be compatible with the current one.- Returns:
- See Also:
isCompatibleWith(Metric)
-
subtract
public Quantity subtract(Quantity other)
Subtracts the given Quantity from the current one.- Parameters:
other- theQuantityto add. The givenQuantity'sMetricmust be compatible with the current one.- Returns:
- See Also:
isCompatibleWith(Metric)
-
isLessThan
public boolean isLessThan(Quantity other)
Returns whether the givenQuantityis less than the current one.- Parameters:
other- must not be null. The givenQuantity'sMetricmust be compatible with the current one.- Returns:
- See Also:
isCompatibleWith(Metric)
-
times
public Quantity times(int multiplier)
Creates a newQuantityof the current one multiplied with the given int.- Parameters:
multiplier-- Returns:
- will never be null.
-
times
public Quantity times(long multiplier)
Creates a newQuantityof the current one multiplied with the given long.- Parameters:
multiplier-- Returns:
- will never be null.
-
isEqualTo
public boolean isEqualTo(Quantity other)
Returns whether the currentQuantityis equal to the given one negelecting potential differences in precision of the underlying amount. I.e. an amount of 1 is considered equal to an amount of 1.0.- Parameters:
other- must not be null.- Returns:
- Since:
- 7.2.2
-
isGreaterThan
public boolean isGreaterThan(Quantity other)
Returns whether the givenQuantityis greater than the current one.- Parameters:
other- must not be null. The givenQuantity'sMetricmust be compatible with the current one.- Returns:
- See Also:
isCompatibleWith(Metric)
-
isGreaterThanOrEqualTo
public boolean isGreaterThanOrEqualTo(Quantity other)
Returns whether the givenQuantityis greater than or equal to the current one.- Parameters:
other- must not be null. The givenQuantity'sMetricmust be compatible with the current one.- Returns:
- See Also:
isCompatibleWith(Metric)
-
isNegative
public boolean isNegative()
Returns whether the currentQuantityis negative.- Returns:
-
isZeroOrNegative
public boolean isZeroOrNegative()
Returns whether the currentQuantityis zero or negative.- Returns:
-
toZero
public Quantity toZero()
- Returns:
- will never be null.
-
getAmount
@NonNull public @NonNull BigDecimal getAmount()
The amount of the Quantity. Explicitly set a prefixed column name to avoid name conflicts.
-
getMetric
@NonNull public @NonNull Metric getMetric()
The metric of the Quantity. Explicitly set a prefixed column name to avoid name conflicts.
-
-