org.yarnandtail.andhow.valuetype

Class BigDecType

java.lang.Object

org.yarnandtail.andhow.valuetype.BaseValueType<BigDecimal>

org.yarnandtail.andhow.valuetype.BigDecType

All Implemented Interfaces:

ValueType<BigDecimal>

public class BigDecType
extends BaseValueType<BigDecimal>

Type representation of Java BigDecimal objects. This class is threadsafe and uses a singleton pattern to prevent multiple instances, since all users can safely use the same instance.

Author:

chace86

Field Summary

Fields inherited from class org.yarnandtail.andhow.valuetype.BaseValueType

clazzType

Method Summary

Modifier and Type	Method and Description
BigDecimal	cast(Object o) Attempt to cast the passed object to the generic type T.
static BigDecType	instance() Construct an instance of BigDecType
BigDecimal	parse(String sourceValue) Attempts to parse the passed String into the destinationType.

Methods inherited from class org.yarnandtail.andhow.valuetype.BaseValueType

getDestinationType, isParsable, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

instance

public static BigDecType instance()

Construct an instance of BigDecType

parse

public BigDecimal parse(String sourceValue)
                 throws ParsingException

Attempts to parse the passed String into the destinationType. All trimming (removing whitespace from around a value) should be assumed to already have happened for the incoming sourceValue by a Trimmer. Implementations should be careful to ONLY throw a ParsingException - Integers and other types may throw other unchecked exceptions when trying to convert values, which should be handled in this method and rethrown as a ParsingException. This method and toString(T) should be reversible: The object generated here should be toString-able to a String equal to the one passed this method. For more information on how the sourceValue is parsed, see BigDecimal String constructor.

Returns:

null if null, or a value of type T

Throws:

ParsingException - for any type of failure.

cast

public BigDecimal cast(Object o)
                throws RuntimeException

Description copied from interface: ValueType

Attempt to cast the passed object to the generic type T. AndHow uses this internally to cast values known to already be of type T, but were stored in a generic way. If used for unknown types that are not castable to T, it will throw a RuntimeException, though this should never happen unless used by application code.

Returns:

Throws:

RuntimeException