Package com.univocity.parsers.conversions

Class ObjectConversion<T>

java.lang.Object
com.univocity.parsers.conversions.NullConversion<String,T>
com.univocity.parsers.conversions.ObjectConversion<T>
Type Parameters:
T - The object type resulting from conversions of String values.
All Implemented Interfaces:
Conversion<String,T>
Direct Known Subclasses:
BigDecimalConversion, BigIntegerConversion, BooleanConversion, ByteConversion, CalendarConversion, CharacterConversion, DateConversion, DoubleConversion, EnumConversion, FloatConversion, IntegerConversion, LongConversion, NumericConversion, ShortConversion
public abstract class ObjectConversion<T> extends NullConversion<String,T>
Default implementation for conversions from an input String to Objects of a given type T

Extending classes must implement a proper String to T conversion in fromString(String)

This abstract class provides default results for conversions when the input is null.

It also provides a default implementation of revert(Object) that returns the result of input.toString()

  • Constructor Details

    • ObjectConversion

      public ObjectConversion()
      Creates a Conversion from String to an Object with default values to return when the input is null. The default constructor assumes the output of a conversion should be null when input is null

    • ObjectConversion

      public ObjectConversion(T valueIfStringIsNull, String valueIfObjectIsNull)
      Creates a Conversion from String to an Object with default values to return when the input is null.
      Parameters:
      valueIfStringIsNull - default value of type T to be returned when the input String is null. Used when execute(String) is invoked.
      valueIfObjectIsNull - default String value to be returned when an input of type T is null. Used when revert(Object) is invoked.

  • Method Details

    • execute

      public T execute(String input)
      Converts the given String to an instance of T
      Specified by:
      execute in interface Conversion<String,T>
      Overrides:
      execute in class NullConversion<String,T>
      Parameters:
      input - the input String to be converted to an object of type T
      Returns:
      the conversion result, or the value of getValueIfStringIsNull() if the input String is null.

    • fromInput

      protected final T fromInput(String input)
      Creates an instance of T from a String representation.
      Specified by:
      fromInput in class NullConversion<String,T>
      Parameters:
      input - The String to be converted to T
      Returns:
      an instance of T, converted from the String input.

    • fromString

      protected abstract T fromString(String input)
      Creates an instance of T from a String representation.
      Parameters:
      input - The String to be converted to T
      Returns:
      an instance of T, converted from the String input.

    • revert

      public String revert(T input)
      Converts a value of type T back to a String

      This is a general implementation that simply returns the result of input.toString()

      Specified by:
      revert in interface Conversion<String,T>
      Overrides:
      revert in class NullConversion<String,T>
      Parameters:
      input - the input of type T to be converted to a String
      Returns:
      the conversion result, or the value of getValueIfObjectIsNull() if the input object is null.

    • undo

      protected final String undo(T input)
      Description copied from class: NullConversion
      Converts a value of type O back to I.
      Specified by:
      undo in class NullConversion<String,T>
      Parameters:
      input - the input object to be converted to I
      Returns:
      the conversion result

    • getValueIfStringIsNull

      public T getValueIfStringIsNull()
      returns a default value of type T to be returned when the input String is null. Used when execute(String) is invoked.
      Returns:
      the default value of type T used when converting from a null input

    • getValueIfObjectIsNull

      public String getValueIfObjectIsNull()
      returns default String value to be returned when an input of type T is null. Used when revert(Object) is invoked.
      Returns:
      the default String value used when converting from a null input

    • setValueIfStringIsNull

      public void setValueIfStringIsNull(T valueIfStringIsNull)
      defines a default value of type T which should be returned when the input String is null. Used when execute(String) is invoked.
      Parameters:
      valueIfStringIsNull - the default value of type T when converting from a null input

    • setValueIfObjectIsNull

      public void setValueIfObjectIsNull(String valueIfObjectIsNull)
      returns default value of type T which should be returned when the input String is null. Used when revert(Object) is invoked.
      Parameters:
      valueIfObjectIsNull - a default value of type T when converting from a null input