[JAVAMONEY-18] Managed Precision Created: 01/Feb/13  Updated: 05/Feb/15  Resolved: 30/Aug/13

Status: Closed
Project: javamoney
Component/s: API
Affects Version/s: 0.4-EDR1
Fix Version/s: 0.5

Type: New Feature Priority: Critical
Reporter: atsticks Assignee: atsticks
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


Several aspects of arithmetic precision were identified:

  • internal precision defines the precision used for performing arithmetical operations. By default a MonetaryAmount will always represented/rounded to this internal precision internally. This allows to separate concrete rounding requirements from the types numeric representation.
  • When MonetaryAmount with different precision are used for a caclulation:
    • then the higher of both precisions is used for the result. This is also the case if the system's internal precision is less.
    • If the higher of both precisions is less than the internal precision, the result has the internal precision.
  • external precision is the precision applied, when a MonetaryAmount is externalized, e.g. by calling one of the int toInteger(), double toDoubple(), float toFloat() etc. methods, or by calling <T> T asType(Class<T>). Hereby the precision basically should be the same as the internal precision, but the representation of the externalized value may require to reduce the precision. In case of the toInteger() method this is quite obvious.
  • formatting precision this is the precision (or rounding) applied, when a monetary amount should be formatted for print out or display.

All these must be clearly separated, especially external and formatting precision are not part of the monetary amount's value type. Nevertheless the internal precision also must be serialized somehow, since different VMs may operate with different internal precisions. Therefore it is important that the precisoin information is also available on the target VM, so different precisions can be managed.

So the following points must be considered:

  • internal precition must be defined (by default)
  • internal precision must be accessible
    • the default precision
    • the effective precision on an instance
  • precision must be adaptable based on the use case
  • precision must be serialized
  • mechanisms must be defined and implemented that ensure correct precision handling.

Comment by chrispheby [ 05/Feb/13 ]

Two important use cases for precision are performing calculations (especially division) and pricing, i.e. ticks. There's a list of some common ones here: http://en.wikipedia.org/wiki/Commodity_tick.

Exchange rates are a specialised case of pricing, and we might also need to consider whether that has any impact on the user view of an exchange rate (thats for another issue I guess).

Generated at Sat Jul 04 02:38:48 UTC 2015 using JIRA 6.2.3#6260-sha1:63ef1d6dac3f4f4d7db4c1effd405ba38ccdc558.