Converter (com.github.alexheretic:dynamics 4.0 API)

java.lang.Object
- alexh.weak.Converter

```
public class Converter
extends Object
```
Logic container for converting weakly typed objects into core types, ie convert(1234.5678d).intoDecimal() returns a BigDecimal of 1234.5678 convert(1234.5678d).intoInteger() returns a rounded int of 1235 convert("2015-03").intoLocalDateTime() returns a LocalDateTime of 2015-03-01T00:00:00.000 convert(Optional.of("8484")).intoDouble() returns a double of 8484.0 Supports conversions from most basic types, in addition to java.util.Date & java.time instances, object arrays, Iterables, Maps & Optionals + more from #toString conversions

Author:

Alex Butler

Field Summary

Fields
Modifier and Type Field and Description

protected Object o
wrapped inner value, the conversion target

Fields
Modifier and Type	Field and Description
`protected Object`	`o` wrapped inner value, the conversion target

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static Converter`	`convert(Object value)`
`BigDecimal`	`intoDecimal()`
`boolean`	`intoDecimalWorks()`
`double`	`intoDouble()`
`boolean`	`intoDoubleWorks()`
`int`	`intoInteger()`
`boolean`	`intoIntegerWorks()`
`List`	`intoList()` Converts the inner value into a List will convert a Map into a value list will convert simple types into a size 1 list [?] as such this should always work
`boolean`	`intoListWorks()`
`LocalDateTime`	`intoLocalDateTime()` Converts to string & permissively parses as a date, ignoring time zone defaults day->1, month->1, hour->0, minute->0, second->0, nanoseconds->0
`boolean`	`intoLocalDateTimeWorks()`
`long`	`intoLong()`
`boolean`	`intoLongWorks()`
`Map`	`intoMap()` Converts the inner value into a Map will convert an Iterable into an index -> value map will convert simple types into a size 1 map of {"value": ?} as such this should always work
`boolean`	`intoMapWorks()`
`String`	`intoString()` Converts the inner value into a String, should always work
`boolean`	`intoStringWorks()`
`ZonedDateTime`	`intoZonedDateTime()` Converts to string & permissively parses as a date, requiring a time zone to be parsed defaults day->1, month->1, hour->0, minute->0, second->0, nanoseconds->0
`ZonedDateTime`	`intoZonedDateTimeOrUse(ZoneId fallback)` Converts to string & permissively parses as a date, uses parsed time zone or falls back on input defaults day->1, month->1, hour->0, minute->0, second->0, nanoseconds->0, time-zone->input
`boolean`	`intoZonedDateTimeWorks()`
`ConverterMaybe`	`maybe()`

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

- Field Detail
  - o
```
protected final Object o
```
    wrapped inner value, the conversion target
- Method Detail
  - convert
```
public static Converter convert(Object value)
```
    Parameters:
    
    value - some object to convert
    
    Returns:
    
    new Converter instance wrapper for the input value
  - intoString
```
public String intoString()
```
    Converts the inner value into a String, should always work
    
    Returns:
    
    conversion
  - intoStringWorks
```
public boolean intoStringWorks()
```
    Returns:
    
    intoString() will not throw an exception
  - intoInteger
```
public int intoInteger()
```
    Returns:
    
    conversion
    
    Throws:
    
    RuntimeException - cannot be converted
  - intoIntegerWorks
```
public boolean intoIntegerWorks()
```
    Returns:
    
    intoInteger() will not throw an exception
  - intoLong
```
public long intoLong()
```
    Returns:
    
    conversion
    
    Throws:
    
    RuntimeException - cannot be converted
  - intoLongWorks
```
public boolean intoLongWorks()
```
    Returns:
    
    intoLong() will not throw an exception
  - intoDouble
```
public double intoDouble()
```
    Returns:
    
    conversion
    
    Throws:
    
    RuntimeException - cannot be converted
  - intoDoubleWorks
```
public boolean intoDoubleWorks()
```
    Returns:
    
    intoDouble() will not throw an exception
  - intoDecimal
```
public BigDecimal intoDecimal()
```
    Returns:
    
    conversion
    
    Throws:
    
    RuntimeException - cannot be converted
  - intoDecimalWorks
```
public boolean intoDecimalWorks()
```
    Returns:
    
    intoDecimal() will not throw an exception
  - intoMap
```
public Map intoMap()
```
    Converts the inner value into a Map will convert an Iterable into an index -> value map will convert simple types into a size 1 map of {"value": ?} as such this should always work
    
    Returns:
    
    conversion
  - intoMapWorks
```
public boolean intoMapWorks()
```
    Returns:
    
    intoMap() will not throw an exception
  - intoList
```
public List intoList()
```
    Converts the inner value into a List will convert a Map into a value list will convert simple types into a size 1 list [?] as such this should always work
    
    Returns:
    
    conversion
  - intoListWorks
```
public boolean intoListWorks()
```
    Returns:
    
    intoList() will not throw an exception
  - intoLocalDateTime
```
public LocalDateTime intoLocalDateTime()
```
    Converts to string & permissively parses as a date, ignoring time zone defaults day->1, month->1, hour->0, minute->0, second->0, nanoseconds->0
    
    Throws:
    
    DateTimeParseException - converted string is in an invalid format
  - intoLocalDateTimeWorks
```
public boolean intoLocalDateTimeWorks()
```
    Returns:
    
    intoLocalDateTime() will not throw an exception
  - intoZonedDateTime
```
public ZonedDateTime intoZonedDateTime()
```
    Converts to string & permissively parses as a date, requiring a time zone to be parsed defaults day->1, month->1, hour->0, minute->0, second->0, nanoseconds->0
    
    Throws:
    
    DateTimeParseException - converted string is in an invalid format
  - intoZonedDateTimeWorks
```
public boolean intoZonedDateTimeWorks()
```
    Returns:
    
    intoZonedDateTime() will not throw an exception
  - intoZonedDateTimeOrUse
```
public ZonedDateTime intoZonedDateTimeOrUse(ZoneId fallback)
```
    Converts to string & permissively parses as a date, uses parsed time zone or falls back on input defaults day->1, month->1, hour->0, minute->0, second->0, nanoseconds->0, time-zone->input
    
    Parameters:
    
    fallback - time zone to use if value has none
    
    Throws:
    
    DateTimeParseException - converted string is in an invalid format
  - maybe
```
public ConverterMaybe maybe()
```
    Returns:
    
    ConverterMaybe instance, for fluent handling of non-convertibles

Class Converter

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

o

Method Detail

convert

intoString

intoStringWorks

intoInteger

intoIntegerWorks

intoLong

intoLongWorks

intoDouble

intoDoubleWorks

intoDecimal

intoDecimalWorks

intoMap

intoMapWorks

intoList

intoListWorks

intoLocalDateTime

intoLocalDateTimeWorks

intoZonedDateTime

intoZonedDateTimeWorks

intoZonedDateTimeOrUse

maybe