io.rapidpro.expressions.utils

Class ExpressionUtils

java.lang.Object

io.rapidpro.expressions.utils.ExpressionUtils

public final class ExpressionUtils
extends Object

Utility methods

Field Summary

Fields

Modifier and Type	Field and Description
protected static org.threeten.bp.format.DateTimeFormatter	ISO_DATETIME_FORMAT
protected static org.threeten.bp.format.DateTimeFormatter	ISO_DATETIME_FORMAT_NO_SECOND_FRACTION
protected static org.threeten.bp.format.DateTimeFormatter	JSON_DATETIME_FORMAT
static MathContext	MATH A math context which match the defaults of Python's Decimal

Method Summary

Modifier and Type	Method and Description
static BigDecimal	decimalPow(BigDecimal number, BigDecimal power) Pow for two decimals
static BigDecimal	decimalRound(BigDecimal number, int numDigits, RoundingMode rounding) Rounding for decimals with support for negative digits
static String	formatIsoDate(org.threeten.bp.ZonedDateTime value) Formats a date time as ISO8601 with microsecond precision and offset, e.g. "2014-10-03T09:41:12.790123+02:00"
static String	formatJsonDate(org.threeten.bp.Instant value) Formats a time instant as ISO8601 in UTC with millisecond precision, e.g. "2014-10-03T09:41:12.790Z"
static org.threeten.bp.format.DateTimeFormatter	getDateFormatter(DateStyle dateStyle, boolean incTime) Gets a formatter for dates or datetimes
static <K,V> V	getOrDefault(Map<K,V> map, K key, V defaultValue) Replacement for Java 8's Map#getOrDefault(String, Object)
static org.threeten.bp.Instant	parseJsonDate(String value) Parses an ISO8601 formatted time instant from a string value
static <T> List<T>	slice(List<T> list, Integer start, Integer stop) Slices a list, Python style
static String[]	tokenize(String text) Tokenizes a string by splitting on non-word characters.
static <T> Map<String,T>	toLowerCaseKeys(Map<String,T> map) Returns a copy of the given map with lowercase keys
static String	urlquote(String text) Encodes text for inclusion in a URL query string.

Methods inherited from class java.lang.Object

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

Field Detail

ISO_DATETIME_FORMAT

protected static org.threeten.bp.format.DateTimeFormatter ISO_DATETIME_FORMAT

ISO_DATETIME_FORMAT_NO_SECOND_FRACTION

protected static org.threeten.bp.format.DateTimeFormatter ISO_DATETIME_FORMAT_NO_SECOND_FRACTION

JSON_DATETIME_FORMAT

protected static org.threeten.bp.format.DateTimeFormatter JSON_DATETIME_FORMAT

MATH

public static MathContext MATH

A math context which match the defaults of Python's Decimal

Method Detail

slice

public static <T> List<T> slice(List<T> list,
                                Integer start,
                                Integer stop)

Slices a list, Python style

Parameters:

list - the list

start - the start index (null means the beginning of the list)

stop - the stop index (null means the end of the list)

Returns:

the slice

decimalPow

public static BigDecimal decimalPow(BigDecimal number,
                                    BigDecimal power)

Pow for two decimals

decimalRound

public static BigDecimal decimalRound(BigDecimal number,
                                      int numDigits,
                                      RoundingMode rounding)

Rounding for decimals with support for negative digits

urlquote

public static String urlquote(String text)

Encodes text for inclusion in a URL query string. Should be equivalent to Django's urlquote function.

Parameters:

text - the text to encode

Returns:

the encoded text

getDateFormatter

public static org.threeten.bp.format.DateTimeFormatter getDateFormatter(DateStyle dateStyle,
                                                                        boolean incTime)

Gets a formatter for dates or datetimes

Parameters:

dateStyle - whether parsing should be day-first or month-first

incTime - whether to include time

Returns:

the formatter

getOrDefault

public static <K,V> V getOrDefault(Map<K,V> map,
                                   K key,
                                   V defaultValue)

Replacement for Java 8's Map#getOrDefault(String, Object)

tokenize

public static String[] tokenize(String text)

Tokenizes a string by splitting on non-word characters. This should be equivalent to splitting on \W+ in Python. The meaning of \W is different in Android, Java 7, Java 8 hence the non-use of regular expressions.

Parameters:

text - the input text

Returns:

the string tokens

formatIsoDate

public static String formatIsoDate(org.threeten.bp.ZonedDateTime value)

Formats a date time as ISO8601 with microsecond precision and offset, e.g. "2014-10-03T09:41:12.790123+02:00"

formatJsonDate

public static String formatJsonDate(org.threeten.bp.Instant value)

Formats a time instant as ISO8601 in UTC with millisecond precision, e.g. "2014-10-03T09:41:12.790Z"

parseJsonDate

public static org.threeten.bp.Instant parseJsonDate(String value)

Parses an ISO8601 formatted time instant from a string value

toLowerCaseKeys

public static <T> Map<String,T> toLowerCaseKeys(Map<String,T> map)

Returns a copy of the given map with lowercase keys

Parameters:

map - the map to convert

Returns:

copy of map with lowercase keys