CommonHelper (Java Common Helper 0.0.11-SNAPSHOT API)

java.lang.Object
- com.blibli.oss.common.helper.CommonHelper

public class CommonHelper
extends Object

Author:: william.s.setiadi on 2/19/2018.

Constructor Summary

Constructors
Constructor and Description

CommonHelper()

Constructors
Constructor and Description
`CommonHelper()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static boolean`	`denullify(Boolean bool)` Returns default value of `Boolean` (i.e.
`static Date`	`denullify(Date date)` Returns new `Date` if the given `date` is null.
`static Double`	`denullify(Double num)` Returns default value of `Double` (i.e.
`static Integer`	`denullify(Integer num)` Returns default value of `Integer` (i.e.
`static <T> List<T>`	`denullify(List<T> list)` Returns new `ArrayList` if input is null.
`static Long`	`denullify(Long num)` Returns default value of `Long` (i.e.
`static <K,V> Map<K,V>`	`denullify(Map<K,V> map)` Returns empty `HashMap` if input is null.
`static <T> Set<T>`	`denullify(Set<T> set)` Returns empty `HashSet` if input is null.
`static String`	`denullify(String str)` Returns empty `String` if input is null.
`static <T,S extends T> T`	`denullify(T t, Class<S> clazz)` Returns new instance of `clazz` if the input `t` is null.
`static <T,S extends T> T`	`denullify(T t, S sub, S... subs)` Denullifies the given object by substituting it with the provided `sub` or `subs`.
`static <T> void`	`doIfNotNull(T t, java.util.function.Consumer<T> consumer)` Shortens null object validation before doing an operation on that object. Note that this does not validate null sub-objects.
`static String`	`generateUUID()` Generates new random UUID using `UUID.randomUUID()`
`static <T,R> R`	`getIfNotNull(T t, java.util.function.Function<T,R> func)` Shortens null object validation before doing a value-returning operation on that object. Note that this does not validate null sub-objects. Also note that the operation cannot return void.
`static String`	`toLowerCase(String str)` Shortens null validation on a String before invoking `String.toLowerCase()`.
`static String`	`toUpperCase(String str)` Shortens null validation on a String before invoking `String.toUpperCase()`.
`static <E extends Enum<E>> E`	`valueOf(String str, Class<E> clazz)` Returns Enum object of the given string `s`.

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

- Constructor Detail
  - CommonHelper
```
public CommonHelper()
```
- Method Detail
  - denullify
```
public static boolean denullify(Boolean bool)
```
    Returns default value of Boolean (i.e. false) if input is null.
    
    Parameters:
    
    bool - Boolean
    
    Returns:
    
    false if input is null, otherwise returns input
  - denullify
```
public static Date denullify(Date date)
```
    Returns new Date if the given date is null.
    
    Parameters:
    
    date - to be checked
    
    Returns:
    
    date if not null, new Date otherwise
  - denullify
```
public static <T,S extends T> T denullify(T t,
                                          Class<S> clazz)
                                   throws InstantiationException,
                                          IllegalAccessException
```
    Returns new instance of clazz if the input t is null.
    New instance is generated using Class.newInstance() and all exceptions thrown are propagated.
    
    Type Parameters:
    
    T - object type
    
    S - object type to be instantiated if t is null
    
    Parameters:
    
    t - object
    
    clazz - new instance of this class will be generated if input t is null
    
    Returns:
    
    null if t is null, otherwise returns new instance of clazz
    
    Throws:
    
    InstantiationException - propagated exception, see Class.newInstance()
    
    IllegalAccessException - propagated exception, see Class.newInstance()
    
    See Also:
    
    Class.newInstance()
  - denullify
```
public static <T,S extends T> T denullify(T t,
                                          S sub,
                                          S... subs)
```
    Denullifies the given object by substituting it with the provided sub or subs.
    
    Type Parameters:
    
    T - type of object
    
    S - type of substitutes. Must extend <T>
    
    Parameters:
    
    t - object
    
    sub - first substitute
    
    subs - other substitutes
    
    Returns:
    
    the object t itself if not null, otherwise returns the first non-null substitute from either sub or subs. May return null if all substitutes are null.
  - denullify
```
public static Double denullify(Double num)
```
    Returns default value of Double (i.e. 0.0) if input is null.
    
    Parameters:
    
    num - Double
    
    Returns:
    
    0.0 if input is null, otherwise returns input
  - denullify
```
public static Integer denullify(Integer num)
```
    Returns default value of Integer (i.e. 0) if input is null.
    
    Parameters:
    
    num - Integer
    
    Returns:
    
    0 if input is null, otherwise returns input
  - denullify
```
public static <T> List<T> denullify(List<T> list)
```
    Returns new ArrayList if input is null.
    
    Type Parameters:
    
    T - type of the given list
    
    Parameters:
    
    list - List
    
    Returns:
    
    new ArrayList if input is null, otherwise returns input
  - denullify
```
public static Long denullify(Long num)
```
    Returns default value of Long (i.e. 0L) if input is null.
    
    Parameters:
    
    num - Long
    
    Returns:
    
    0L if input is null, otherwise returns input
  - denullify
```
public static <K,V> Map<K,V> denullify(Map<K,V> map)
```
    Returns empty HashMap if input is null.
    
    Type Parameters:
    
    K - type of key
    
    V - type of value
    
    Parameters:
    
    map - map
    
    Returns:
    
    new HashMap if null, the map itself otherwise
  - denullify
```
public static <T> Set<T> denullify(Set<T> set)
```
    Returns empty HashSet if input is null.
    
    Type Parameters:
    
    T - type of the given set
    
    Parameters:
    
    set - Set
    
    Returns:
    
    new HashSet if input is null, otherwise returns set
  - denullify
```
public static String denullify(String str)
```
    Returns empty String if input is null.
    
    Parameters:
    
    str - String
    
    Returns:
    
    empty String if input is null, otherwise returns str
  - doIfNotNull
```
public static <T> void doIfNotNull(T t,
                                   java.util.function.Consumer<T> consumer)
```
    Shortens null object validation before doing an operation on that object.
    Note that this does not validate null sub-objects.
    
    Type Parameters:
    
    T - type of object t
    
    Parameters:
    
    t - object on which the given function will be invoked
    
    consumer - operation to be done on the object
  - generateUUID
```
public static String generateUUID()
```
    Generates new random UUID using UUID.randomUUID()
    
    Returns:
    
    random UUID
  - getIfNotNull
```
public static <T,R> R getIfNotNull(T t,
                                   java.util.function.Function<T,R> func)
```
    Shortens null object validation before doing a value-returning operation on that object.
    Note that this does not validate null sub-objects.
    
    Also note that the operation cannot return void. For this, use doIfNotNull(Object, Consumer).
    Avoid assigning the returned value to a primitive data type variable as this method may return null when the object t is null, regardless of the return value of func.
    
    Type Parameters:
    
    T - type of the object t
    
    R - type of return value of func
    
    Parameters:
    
    t - object
    
    func - operation to be done on the object
    
    Returns:
    
    null if object is null, otherwise returns the result of the operation
  - toLowerCase
```
public static String toLowerCase(String str)
```
    Shortens null validation on a String before invoking String.toLowerCase().
    
    Parameters:
    
    str - String
    
    Returns:
    
    null if input is null, otherwise returns lower-cased version of the input
  - toUpperCase
```
public static String toUpperCase(String str)
```
    Shortens null validation on a String before invoking String.toUpperCase().
    
    Parameters:
    
    str - String
    
    Returns:
    
    null if input is null, otherwise returns upper-cased version of the input
  - valueOf
```
public static <E extends Enum<E>> E valueOf(String str,
                                            Class<E> clazz)
```
    Returns Enum object of the given string s. Uses Enum.valueOf(Class, String) to match String and Enum object
    
    Type Parameters:
    
    E - type of enum
    
    Parameters:
    
    str - string to be converted to Enum object
    
    clazz - class to which the Enum object belongs
    
    Returns:
    
    null if str is blank, otherwise returns Enum object of str

Class CommonHelper

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

CommonHelper

Method Detail

denullify

denullify

denullify

denullify

denullify

denullify

denullify

denullify

denullify

denullify

denullify

doIfNotNull

generateUUID

getIfNotNull

toLowerCase

toUpperCase

valueOf