java.lang.Object
- tech.units.indriya.AbstractConverter
- - tech.units.indriya.function.RationalConverter

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<javax.measure.UnitConverter>, java.util.function.DoubleSupplier, java.util.function.Supplier<java.lang.Double>, javax.measure.UnitConverter, tech.uom.lib.common.function.ValueSupplier<java.lang.Double>
```
public final class RationalConverter
extends AbstractConverter
implements tech.uom.lib.common.function.ValueSupplier<java.lang.Double>, java.util.function.Supplier<java.lang.Double>, java.util.function.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

See Also:

Serialized Form

Nested Class Summary
- Nested classes/interfaces inherited from class tech.units.indriya.AbstractConverter
  AbstractConverter.Pair

Field Summary

Fields
Modifier and Type	Field	Description
`private java.math.BigInteger`	`dividend`	Holds the converter dividend.
`private java.math.BigInteger`	`divisor`	Holds the converter divisor (always positive).
`private static long`	`serialVersionUID`

Fields inherited from class tech.units.indriya.AbstractConverter
conversionSteps, IDENTITY

Constructor Summary

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

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`int`	`compareTo(javax.measure.UnitConverter o)`
`private AbstractConverter`	`composeSameType(RationalConverter that)`
`double`	`convertWhenNotIdentity(double value)`	Non-API
`java.math.BigDecimal`	`convertWhenNotIdentity(java.math.BigDecimal value, java.math.MathContext ctx)`	Non-API
`protected java.lang.Number`	`convertWhenNotIdentity(java.math.BigInteger value, java.math.MathContext ctx)`	Non-API
`boolean`	`equals(java.lang.Object obj)`
`java.lang.Double`	`get()`
`double`	`getAsDouble()`
`java.math.BigInteger`	`getDividend()`	Returns the integer dividend for this rational converter.
`java.math.BigInteger`	`getDivisor()`	Returns the integer (positive) divisor for this rational converter.
`java.lang.Double`	`getValue()`
`int`	`hashCode()`
`RationalConverter`	`inverseWhenNotIdentity()`	Non-API
`boolean`	`isIdentity()`
`boolean`	`isLinear()`
`protected boolean`	`isSimpleCompositionWith(AbstractConverter that)`	Non-API Guard for `AbstractConverter.simpleCompose(AbstractConverter)`
`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)`
`static RationalConverter`	`of(java.math.BigInteger dividend, java.math.BigInteger divisor)`	Convenience method equivalent to `new RationalConverter(dividend, divisor)`
`protected AbstractConverter`	`simpleCompose(AbstractConverter that)`	Non-API Guarded by `AbstractConverter.isSimpleCompositionWith(AbstractConverter)`
`private static double`	`toDouble(java.math.BigInteger integer)`
`java.lang.String`	`transformationLiteral()`	Non-API

Methods inherited from class tech.units.indriya.AbstractConverter
concatenate, convert, convert, getConversionSteps, inverse, of, toString

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

- Field Detail
  - serialVersionUID
```
private static final long serialVersionUID
```
    See Also:
    
    Constant Field Values
  - dividend
```
private final java.math.BigInteger dividend
```
    Holds the converter dividend.
  - divisor
```
private final java.math.BigInteger divisor
```
    Holds the converter divisor (always positive).
- Constructor Detail
  - RationalConverter
```
public RationalConverter(java.math.BigInteger dividend,
                         java.math.BigInteger divisor)
```
    Creates a rational converter with the specified dividend and divisor.
    
    Parameters:
    
    dividend - the dividend.
    
    divisor - the positive divisor.
    
    Throws:
    
    java.lang.IllegalArgumentException - if divisor <= 0
  - 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:
    
    java.lang.IllegalArgumentException - if divisor <= 0
    
    java.lang.IllegalArgumentException - if dividend == divisor
- Method Detail
  - of
```
public static RationalConverter of(java.math.BigInteger dividend,
                                   java.math.BigInteger divisor)
```
    Convenience method equivalent to new RationalConverter(dividend, divisor)
    
    Parameters:
    
    dividend - the dividend.
    
    divisor - the positive divisor.
    
    Throws:
    
    java.lang.IllegalArgumentException - if divisor <= 0
    
    java.lang.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:
    
    java.lang.IllegalArgumentException - if divisor <= 0
    
    java.lang.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:
    
    java.lang.IllegalArgumentException - if divisor <= 0
    
    java.lang.IllegalArgumentException - if dividend == divisor
  - getDividend
```
public java.math.BigInteger getDividend()
```
    Returns the integer dividend for this rational converter.
    
    Returns:
    
    this converter dividend.
  - getDivisor
```
public java.math.BigInteger getDivisor()
```
    Returns the integer (positive) divisor for this rational converter.
    
    Returns:
    
    this converter divisor.
  - convertWhenNotIdentity
```
public double convertWhenNotIdentity(double value)
```
    Description copied from class: AbstractConverter
    
    Non-API
    
    Specified by:
    
    convertWhenNotIdentity in class AbstractConverter
    
    Returns:
    
    transformed value
  - toDouble
```
private static double toDouble(java.math.BigInteger integer)
```
  - convertWhenNotIdentity
```
protected java.lang.Number convertWhenNotIdentity(java.math.BigInteger value,
                                                  java.math.MathContext ctx)
```
    Description copied from class: AbstractConverter
    
    Non-API
    
    Overrides:
    
    convertWhenNotIdentity in class AbstractConverter
    
    Returns:
    
    transformed value (most likely a BigInteger or BigDecimal)
  - convertWhenNotIdentity
```
public java.math.BigDecimal convertWhenNotIdentity(java.math.BigDecimal value,
                                                   java.math.MathContext ctx)
                                            throws java.lang.ArithmeticException
```
    Description copied from class: AbstractConverter
    
    Non-API
    
    Specified by:
    
    convertWhenNotIdentity in class AbstractConverter
    
    Returns:
    
    transformed value
    
    Throws:
    
    java.lang.ArithmeticException
  - isIdentity
```
public boolean isIdentity()
```
    Specified by:
    
    isIdentity in interface javax.measure.UnitConverter
  - isSimpleCompositionWith
```
protected boolean isSimpleCompositionWith(AbstractConverter that)
```
    Description copied from class: AbstractConverter
    
    Non-API Guard for AbstractConverter.simpleCompose(AbstractConverter)
    
    Specified by:
    
    isSimpleCompositionWith in class AbstractConverter
    
    Returns:
    
    whether or not a 'simple' composition of transformations is possible
  - simpleCompose
```
protected AbstractConverter simpleCompose(AbstractConverter that)
```
    Description copied from class: AbstractConverter
    
    Non-API Guarded by AbstractConverter.isSimpleCompositionWith(AbstractConverter)
    
    Overrides:
    
    simpleCompose in class AbstractConverter
    
    Returns:
    
    a new AbstractConverter that adds no additional conversion step
  - inverseWhenNotIdentity
```
public RationalConverter inverseWhenNotIdentity()
```
    Description copied from class: AbstractConverter
    
    Non-API
    Returns an AbstractConverter that represents the inverse transformation of this converter, for cases where the transformation is not the identity transformation.
    
    Specified by:
    
    inverseWhenNotIdentity in class AbstractConverter
    
    Returns:
  - transformationLiteral
```
public final java.lang.String transformationLiteral()
```
    Description copied from class: AbstractConverter
    
    Non-API
    Returns a String describing the transformation that is represented by this converter. Contributes to converter's toString method. If null or empty toString output becomes simplified.
    
    Specified by:
    
    transformationLiteral in class AbstractConverter
    
    Returns:
  - equals
```
public boolean equals(java.lang.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 java.lang.Double getValue()
```
    Specified by:
    
    getValue in interface tech.uom.lib.common.function.ValueSupplier<java.lang.Double>
  - getAsDouble
```
public double getAsDouble()
```
    Specified by:
    
    getAsDouble in interface java.util.function.DoubleSupplier
  - get
```
public java.lang.Double get()
```
    Specified by:
    
    get in interface java.util.function.Supplier<java.lang.Double>
  - compareTo
```
public int compareTo(javax.measure.UnitConverter o)
```
    Specified by:
    
    compareTo in interface java.lang.Comparable<javax.measure.UnitConverter>
  - composeSameType
```
private AbstractConverter composeSameType(RationalConverter that)
```

Class RationalConverter

Nested Class Summary

Nested classes/interfaces inherited from class tech.units.indriya.AbstractConverter

Field Summary

Fields inherited from class tech.units.indriya.AbstractConverter

Constructor Summary

Method Summary

Methods inherited from class tech.units.indriya.AbstractConverter

Methods inherited from class java.lang.Object

Field Detail

serialVersionUID

dividend

divisor

Constructor Detail

RationalConverter

RationalConverter

Method Detail

of

of

of

getDividend

getDivisor

convertWhenNotIdentity

toDouble

convertWhenNotIdentity

convertWhenNotIdentity

isIdentity

isSimpleCompositionWith

simpleCompose

inverseWhenNotIdentity

transformationLiteral

equals

hashCode

isLinear

getValue

getAsDouble

get

compareTo

composeSameType