com.blibli.oss.common.helper

Class NumberHelper

java.lang.Object

com.blibli.oss.common.helper.NumberHelper

public class NumberHelper
extends Object

Author:

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

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NumberHelper.ParseMode

Constructor Summary

Constructors

Constructor and Description
NumberHelper()

Method Summary

Modifier and Type	Method and Description
static boolean	is(BigDecimal num1, Comparator cmp, BigDecimal num2) Evaluates num1 to num2 according to the operand cmp.
static boolean	is(Double num1, Comparator cmp, Double num2) see ref
static boolean	is(Long num1, Comparator cmp, Long num2) see ref
static double	parseDouble(String str, NumberHelper.ParseMode parseMode) Parses the given str as double.
static int	parseInt(String str, NumberHelper.ParseMode parseMode) Parses the given str as int.
static long	parseLong(String str, NumberHelper.ParseMode parseMode) Parses the given str as long.

Methods inherited from class java.lang.Object

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

Constructor Detail

NumberHelper

public NumberHelper()

Method Detail

is

public static boolean is(BigDecimal num1,
                         Comparator cmp,
                         BigDecimal num2)

Evaluates num1 to num2 according to the operand cmp.
For example:

• is(5, Comparator.LTE, 5) = true
• is(4, Comparator.LTE, 5) = true
• is(5, Comparator.LTE, 4) = false
• is(null, Comparator.LTE, 5) = false
• is(null, Comparator.EQ, null) = true
• is(null, Comparator.LTE, null) = false

Parameters:

num1 - first number

cmp - Comparator

num2 - second number

Returns:

true if num1 satisfies the operand cmp when evaluated to num2
false if either of the following is true:

• Both num1 and num2 are null and Comparator.EQ is not used
• Both num1 and num2 are null and Comparator.NEQ is used
• Both num1 and num2 are not null and Comparator.NEQ is used
• Either one of num1 or num2 is null
• num1 does not satisfy the operand cmp when evaluated to num2

is

public static boolean is(Double num1,
                         Comparator cmp,
                         Double num2)

see ref

Parameters:

num1 - first number

cmp - of type Comparator

num2 - second number

Returns:

see ref

See Also:

is(BigDecimal, Comparator, BigDecimal)

is

public static boolean is(Long num1,
                         Comparator cmp,
                         Long num2)

see ref

Parameters:

num1 - first number

cmp - of type Comparator

num2 - second number

Returns:

see ref

See Also:

is(BigDecimal, Comparator, BigDecimal)

parseDouble

public static double parseDouble(String str,
                                 NumberHelper.ParseMode parseMode)

Parses the given str as double.

Parameters:

str - to be parsed to double

parseMode - to specify whether to suppress parsing exceptions or not

Returns:

parsed double. If an exception occurs and parseMode is NumberHelper.ParseMode.SUPPRESS_EXCEPTION, returns 0d

Throws:

NumberFormatException - if parseMode is NumberHelper.ParseMode.STRICT

parseInt

public static int parseInt(String str,
                           NumberHelper.ParseMode parseMode)

Parses the given str as int.

Parameters:

str - to be parsed to int

parseMode - to specify whether to suppress parsing exceptions or not

Returns:

parsed int. If an exception occurs and parseMode is NumberHelper.ParseMode.SUPPRESS_EXCEPTION, returns 0

Throws:

NumberFormatException - if parseMode is NumberHelper.ParseMode.STRICT

parseLong

public static long parseLong(String str,
                             NumberHelper.ParseMode parseMode)

Parses the given str as long.

Parameters:

str - to be parsed to long

parseMode - to specify whether to suppress parsing exceptions or not

Returns:

parsed long. If exception occurs and parseMode is NumberHelper.ParseMode.SUPPRESS_EXCEPTION, returns 0L

Throws:

NumberFormatException - if parseMode is NumberHelper.ParseMode.STRICT