RationalConverter (Units of Measurement Implementation for Java SE 1.0.8 API)

java.lang.Object
- tec.uom.se.AbstractConverter
- - tec.uom.se.function.RationalConverter

All Implemented Interfaces:

Serializable, DoubleSupplier, Supplier<Double>, javax.measure.UnitConverter, tec.uom.lib.common.function.ValueSupplier<Double>, Converter<Number,Number>
```
public final class RationalConverter
extends AbstractConverter
implements tec.uom.lib.common.function.ValueSupplier<Double>, Supplier<Double>, DoubleSupplier
```
This class represents a converter multiplying numeric values by an exact scaling factor (represented as the quotient of two BigInteger numbers).

Since:

1.0

Version:

1.0, Oct 11, 2016

Author:

Jean-Marie Dautelle, Werner Keil

See Also:

Serialized Form

Nested Class Summary
- Nested classes/interfaces inherited from class tec.uom.se.AbstractConverter
  AbstractConverter.Pair

Field Summary
- Fields inherited from class tec.uom.se.AbstractConverter
  IDENTITY, PI

Constructor Summary

Constructors
Constructor and Description
`RationalConverter(BigInteger dividend, BigInteger divisor)` Creates a rational converter with the specified dividend and divisor.
`RationalConverter(long dividend, long divisor)` Convenience method equivalent to `new RationalConverter(BigInteger.valueOf(dividend), BigInteger.valueOf(divisor))`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`javax.measure.UnitConverter`	`concatenate(javax.measure.UnitConverter converter)`
`BigDecimal`	`convert(BigDecimal value, MathContext ctx)`
`double`	`convert(double value)`
`boolean`	`equals(Object obj)`
`Double`	`get()`
`double`	`getAsDouble()`
`BigInteger`	`getDividend()` Returns the integer dividend for this rational converter.
`BigInteger`	`getDivisor()` Returns the integer (positive) divisor for this rational converter.
`Double`	`getValue()`
`int`	`hashCode()`
`RationalConverter`	`inverse()`
`boolean`	`isLinear()`
`static RationalConverter`	`of(BigInteger dividend, BigInteger divisor)` Convenience method equivalent to `new RationalConverter(dividend, divisor)`
`static RationalConverter`	`of(double dividend, double divisor)` Convenience method equivalent to `new RationalConverter(BigDecimal.valueOf(dividend).toBigInteger(), BigDecimal.valueOf(divisor).toBigInteger())`
`static RationalConverter`	`of(long dividend, long divisor)` Convenience method equivalent to `new RationalConverter(dividend, divisor)`
`String`	`toString()`

Methods inherited from class tec.uom.se.AbstractConverter
concatenate, convert, getConversionSteps, isIdentity

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - RationalConverter
```
public RationalConverter(BigInteger dividend,
                         BigInteger divisor)
```
    Creates a rational converter with the specified dividend and divisor.
    
    Parameters:
    
    dividend - the dividend.
    
    divisor - the positive divisor.
    
    Throws:
    
    IllegalArgumentException - if divisor <= 0
    
    IllegalArgumentException - if dividend == divisor
  - RationalConverter
```
public RationalConverter(long dividend,
                         long divisor)
```
    Convenience method equivalent to new RationalConverter(BigInteger.valueOf(dividend), BigInteger.valueOf(divisor))
    
    Parameters:
    
    dividend - the dividend.
    
    divisor - the positive divisor.
    
    Throws:
    
    IllegalArgumentException - if divisor <= 0
    
    IllegalArgumentException - if dividend == divisor
- Method Detail
  - of
```
public static RationalConverter of(BigInteger dividend,
                                   BigInteger divisor)
```
    Convenience method equivalent to new RationalConverter(dividend, divisor)
    
    Parameters:
    
    dividend - the dividend.
    
    divisor - the positive divisor.
    
    Throws:
    
    IllegalArgumentException - if divisor <= 0
    
    IllegalArgumentException - if dividend == divisor
  - of
```
public static RationalConverter of(long dividend,
                                   long divisor)
```
    Convenience method equivalent to new RationalConverter(dividend, divisor)
    
    Parameters:
    
    dividend - the dividend.
    
    divisor - the positive divisor.
    
    Throws:
    
    IllegalArgumentException - if divisor <= 0
    
    IllegalArgumentException - if dividend == divisor
  - of
```
public static RationalConverter of(double dividend,
                                   double divisor)
```
    Convenience method equivalent to new RationalConverter(BigDecimal.valueOf(dividend).toBigInteger(), BigDecimal.valueOf(divisor).toBigInteger())
    
    Parameters:
    
    dividend - the dividend.
    
    divisor - the positive divisor.
    
    Throws:
    
    IllegalArgumentException - if divisor <= 0
    
    IllegalArgumentException - if dividend == divisor
  - getDividend
```
public BigInteger getDividend()
```
    Returns the integer dividend for this rational converter.
    
    Returns:
    
    this converter dividend.
  - getDivisor
```
public BigInteger getDivisor()
```
    Returns the integer (positive) divisor for this rational converter.
    
    Returns:
    
    this converter divisor.
  - convert
```
public double convert(double value)
```
    Specified by:
    
    convert in interface javax.measure.UnitConverter
    
    Specified by:
    
    convert in class AbstractConverter
  - convert
```
public BigDecimal convert(BigDecimal value,
                          MathContext ctx)
                   throws ArithmeticException
```
    Specified by:
    
    convert in class AbstractConverter
    
    Throws:
    
    ArithmeticException
  - concatenate
```
public javax.measure.UnitConverter concatenate(javax.measure.UnitConverter converter)
```
    Specified by:
    
    concatenate in interface javax.measure.UnitConverter
    
    Overrides:
    
    concatenate in class AbstractConverter
  - inverse
```
public RationalConverter inverse()
```
    Specified by:
    
    inverse in interface javax.measure.UnitConverter
    
    Specified by:
    
    inverse in class AbstractConverter
  - toString
```
public final String toString()
```
    Overrides:
    
    toString in class Object
  - equals
```
public boolean equals(Object obj)
```
    Specified by:
    
    equals in class AbstractConverter
  - hashCode
```
public int hashCode()
```
    Specified by:
    
    hashCode in class AbstractConverter
  - isLinear
```
public boolean isLinear()
```
    Specified by:
    
    isLinear in interface javax.measure.UnitConverter
  - getValue
```
public Double getValue()
```
    Specified by:
    
    getValue in interface tec.uom.lib.common.function.ValueSupplier<Double>
  - getAsDouble
```
public double getAsDouble()
```
    Specified by:
    
    getAsDouble in interface DoubleSupplier
  - get
```
public Double get()
```
    Specified by:
    
    get in interface Supplier<Double>

Class RationalConverter

Nested Class Summary

Nested classes/interfaces inherited from class tec.uom.se.AbstractConverter

Field Summary

Fields inherited from class tec.uom.se.AbstractConverter

Constructor Summary

Method Summary

Methods inherited from class tec.uom.se.AbstractConverter

Methods inherited from class java.lang.Object

Constructor Detail

RationalConverter

RationalConverter

Method Detail

of

of

of

getDividend

getDivisor

convert

convert

concatenate

inverse

toString

equals

hashCode

isLinear

getValue

getAsDouble

get