com.aoindustries.util.i18n

Class Money

java.lang.Object

com.aoindustries.util.i18n.Money

All Implemented Interfaces:

FastExternalizable, Externalizable, ObjectInputValidation, Serializable, Comparable<Money>

public final class Money
extends Object
implements FastExternalizable, ObjectInputValidation, Comparable<Money>

Stores a monetary value as a combination of currency and amount. It supports many of the basic operators from BigDecimal, and more will be added as needed. An ArithmeticException on any attempt to perform operations on monetary values of different currencies.

Author:

AO Industries, Inc.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
Money()
Money(Currency currency, BigDecimal value) Will change the scale of the value to match the currency, but will not round.
Money(Currency currency, long value, int scale)

Method Summary

Modifier and Type	Method and Description
Money	add(Money augend)
int	compareTo(Money other) Sorts by currency code and then value.
boolean	equals(Object o) Equal when has same currency, value, and scale.
Currency	getCurrency()
int	getScale() Gets the scale of this currency.
long	getSerialVersionUID() Gets the serialVersionUID for this object.
long	getUnscaledValue() Gets the unscaled value of this currency.
BigDecimal	getValue()
int	hashCode()
Money	multiply(BigDecimal multiplicand) Multiplies without rounding.
Money	multiply(BigDecimal multiplicand, RoundingMode roundingMode) Multiplies with rounding.
Money	negate() Returns a monetary amount that is the negative of this amount.
void	readExternal(ObjectInput in)
String	toString() Displays the monetary value as currency symbol (in Locale-specific display) followed by value, such as $100.00 or $-100.50.
void	validateObject()
void	writeExternal(ObjectOutput out)

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Money

public Money(Currency currency,
             BigDecimal value)
      throws NumberFormatException

Will change the scale of the value to match the currency, but will not round.

Throws:

NumberFormatException - if unable to scale the value.

Money

public Money(Currency currency,
             long value,
             int scale)
      throws NumberFormatException

Throws:

NumberFormatException

Money

public Money()

Method Detail

equals

public boolean equals(Object o)

Equal when has same currency, value, and scale.

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

compareTo

public int compareTo(Money other)

Sorts by currency code and then value.

Specified by:

compareTo in interface Comparable<Money>

See Also:

CurrencyComparator

getCurrency

public Currency getCurrency()

getValue

public BigDecimal getValue()

getUnscaledValue

public long getUnscaledValue()

Gets the unscaled value of this currency.

getScale

public int getScale()

Gets the scale of this currency.

toString

public String toString()

Displays the monetary value as currency symbol (in Locale-specific display) followed by value, such as $100.00 or $-100.50.

Overrides:

toString in class Object

add

public Money add(Money augend)
          throws ArithmeticException

Throws:

ArithmeticException

multiply

public Money multiply(BigDecimal multiplicand)
               throws ArithmeticException

Multiplies without rounding.

Throws:

ArithmeticException

multiply

public Money multiply(BigDecimal multiplicand,
                      RoundingMode roundingMode)
               throws ArithmeticException

Multiplies with rounding.

Throws:

ArithmeticException

negate

public Money negate()

Returns a monetary amount that is the negative of this amount.

getSerialVersionUID

public long getSerialVersionUID()

Description copied from interface: FastExternalizable

Gets the serialVersionUID for this object. Since FastExternalizable-aware containers are not special JVM constructs, they do not have access to the private and protected fields. It is assumed that two separate instances of the same class will always return the same serialVersionUID.

Specified by:

getSerialVersionUID in interface FastExternalizable

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException

Specified by:

writeExternal in interface Externalizable

Throws:

IOException

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
                         ClassNotFoundException

Specified by:

readExternal in interface Externalizable

Throws:

IOException

ClassNotFoundException

validateObject

public void validateObject()
                    throws InvalidObjectException

Specified by:

validateObject in interface ObjectInputValidation

Throws:

InvalidObjectException