Simplest Money Amount

Advantages

No BigDecimal
No Floating point math
No Currency requirement. Just Money Amount
Internally use long as money amount in cents
Simple To use
Fast because of integer math operation. Even divide operation is integer math
Every method mimics every BigDecimal. If you know BigDecimal, You know how to use it.
Edge cases tested and compared with BigDecimal

Requirement

Money amounts are coded in cents precision
Expecting 100 cents are 1 unit of currency
Divide operation has 3 choices for rounding. HALF_DOWN, HALF_UP, and HALF_EVEN

How to use

Import Dependency

<dependency>
    <groupId>io.github.hurelhuyag</groupId>
    <artifactId>money</artifactId>
    <version>1.0-SNAPSHOT</version>
</dependency>

Ps: Currently, Not released yet. You can run mvn install locally until I release it on maven central.

Code

You can parse from string

var amount = MoneyAmount.parse("100.00");

or from raw value

var amount = MoneyAmount.valueOf(100_00);

or from same amount of long or double value

var amount = MoneyAmount.valueFrom(100L);
var amount = MoneyAmount.valueFrom(100D);

Using methods

var total = MoneyAmount.ZERO;
for (var item : orderItems) {
    total = total.add(item.price().multiply(MoneyAmount.valueFrom(item.count())));
}
var vat = total.divide(10, DivideMode.HALF_UP);

System.out.println("total: " + total);
System.out.println("VAT: " + vat);

Available operations

You can use those methods as you use with BigDecimal

MoneyAmount.add(MoneyAmount)
MoneyAmount.subtract(MoneyAmount)
MoneyAmount.multiply(MoneyAmount)
MoneyAmount.divide(MoneyAmount, DivideMode)
MoneyAmount.negate()
MoneyAmount.isNegative()
MoneyAmount.isPositive()
MoneyAmount.abs()
MoneyAmount.equals(MoneyAmount)
MoneyAmount.compareTo(MoneyAmount)
MoneyAmount.isGreaterThan(MoneyAmount)
MoneyAmount.isGreaterThanOrEqual(MoneyAmount)
MoneyAmount.isLowerThan(MoneyAmount)
MoneyAmount.isLowerThanOrEqual(MoneyAmount)
MoneyAmount.toString()

Contribution

If you have something in your mind feel free to open a pull request or create an issue.

To Do

More divide operation tests
Benchmark
Do we need this: 0.09 * 0.09 = 0.0081
Multi Operation Rounding. Reading material: http://www.sysmod.com/eurofaq.htm#ROUNDING, https://ec.europa.eu/economy_finance/publications/pages/publication1224_en.pdf

hurelhuyag / money