javax.money

Class MonetaryContext

java.lang.Object

javax.money.AbstractContext

javax.money.MonetaryContext

All Implemented Interfaces:

Serializable

public final class MonetaryContext
extends AbstractContext
implements Serializable

This class models the meta data (mostly the numeric capabilities) of a MonetaryAmount in a platform independent way. It provides information about

• the maximal precision supported (0, for unlimited precision).
• the minimum scale (>=0)
• the maximal scale (>= -1, -1 for unlimited scale).
• the numeric representation class.
• any other attributes, identified by the attribute type, e.g. RoundingMode.

This class is immutable, serializable and thread-safe.

Author:

Anatole Tresch

See Also:

Serialized Form

Field Summary

Fields inherited from class javax.money.AbstractContext

KEY_PROVIDER

Method Summary

Modifier and Type	Method and Description
static MonetaryContext	from(MonetaryAmountFactoryQuery monetaryAmountFactoryQuery, Class<? extends MonetaryAmount> amountClass) This method allows to easily of a new MonetaryContext instance from a given .MonetaryAmountFactoryQuery.
static MonetaryContext	from(MonetaryContext monetaryContext, Class<? extends MonetaryAmount> amountClass) Creates a new MonetaryContext).
Class<? extends MonetaryAmount>	getAmountType() Get the MonetaryAmount implementation class.
int	getMaxScale() Get the maximal scale supported, always >= -1.
int	getPrecision() Returns the precision setting.
boolean	isFixedScale() Allows to check if minScale == maxScale.
MonetaryContextBuilder	toBuilder() Creates a new builder instances, initialized with the data from this one.

Methods inherited from class javax.money.AbstractContext

equals, get, get, getBoolean, getDouble, getFloat, getInt, getKeys, getLong, getProviderName, getText, getType, hashCode, isEmpty, toString

Methods inherited from class java.lang.Object

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

Method Detail

getPrecision

public int getPrecision()

Returns the precision setting. This value is always non-negative.

Returns:

an int which is the value of the precision setting

isFixedScale

public boolean isFixedScale()

Allows to check if minScale == maxScale.

Returns:

true if minScale == maxScale.

getMaxScale

public int getMaxScale()

Get the maximal scale supported, always >= -1. Fixed scaled numbers will have scale==maxScale for all values. -1 declares the maximal scale to be unlimited.

Returns:

the maximal scale supported, always >= -1

getAmountType

public Class<? extends MonetaryAmount> getAmountType()

Get the MonetaryAmount implementation class.

Returns:

the implementation class of the containing amount instance, never null.

See Also:

MonetaryAmount.getContext()

from

public static MonetaryContext from(MonetaryAmountFactoryQuery monetaryAmountFactoryQuery,
                                   Class<? extends MonetaryAmount> amountClass)

This method allows to easily of a new MonetaryContext instance from a given .MonetaryAmountFactoryQuery.

Parameters:

monetaryAmountFactoryQuery - the monetary amount factory query, not null.

amountClass - the targeted implementation type.

Returns:

a new corresponding MonetaryContext instance.

from

public static MonetaryContext from(MonetaryContext monetaryContext,
                                   Class<? extends MonetaryAmount> amountClass)

Creates a new MonetaryContext).

Parameters:

monetaryContext - the base context, not null.

amountClass - the target amount class.

Returns:

a new corresponding MonetaryContext instance.

toBuilder

public MonetaryContextBuilder toBuilder()

Creates a new builder instances, initialized with the data from this one.

Returns:

a new MonetaryContextBuilder instance, never null.