Package de.iip_ecosphere.platform.support

Class TimeUtils

java.lang.Object

de.iip_ecosphere.platform.support.TimeUtils

public class TimeUtils
extends Object

Test utilities.

Author:

Holger Eichelberger, SSE

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	TimeUtils.AbstractDateConverter<T>	An abstract basic date converter.
static interface	TimeUtils.DateConverter<T>	Plugin to extend the date time conversion.

Field Summary

Fields

Modifier and Type	Field	Description
private static final Map<Class<?>,TimeUtils.DateConverter<?>>	CONVERTERS
private static final Map<String,SimpleDateFormat>	DATE_FORMATTER
static final String	ISO8601_FORMAT	Pre-defined known format for ISO8601.

Constructor Summary

Constructors

Modifier	Constructor	Description
private	TimeUtils()	Preventing external creation.

Method Summary

Modifier and Type	Method	Description
private static <T> Date	convertToDate(Class<T> cls, Object data)	Uses one of the registered data converters to convert data.
static String	format(Date data, String format)	Formats a date object to a given format.
static SimpleDateFormat	getDateFormatter(String format)	Returns a (cached) simple date formatter.
static Date	parse(Object data, String format)	Parses a date from the given data for the specified format.
static void	registerConverter(TimeUtils.DateConverter<?> converter)	Registers an additional converter.
static void	registerFormat(String name, String pattern)	Registers a default format for SimpleDateFormat.
static void	sleep(int ms)	Just sleeps for the given amount of milliseconds.
static Date	toDate(LocalDateTime date)	Converts a LocalDateTime value to Date using instant and the system default time zone.
static LocalDateTime	toLocalDateTime(Date date)	Converts a Date value to LocalDateTime using instant and the system default time zone.
static boolean	waitFor(Supplier<Boolean> continueCondition, int timeoutMs, int sleepMs)	A generic function that waits either until the timeout is reached or the endCondition returns true.

Methods inherited from class java.lang.Object

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

Field Details

ISO8601_FORMAT

public static final String ISO8601_FORMAT

Pre-defined known format for ISO8601.

See Also:

• Constant Field Values

DATE_FORMATTER

private static final Map<String,SimpleDateFormat> DATE_FORMATTER

CONVERTERS

private static final Map<Class<?>,TimeUtils.DateConverter<?>> CONVERTERS

Constructor Details

TimeUtils

private TimeUtils()

Preventing external creation.

Method Details

registerConverter

public static void registerConverter(TimeUtils.DateConverter<?> converter)

Registers an additional converter.

Parameters:

converter - the converter

registerFormat

public static void registerFormat(String name,
 String pattern)

Registers a default format for SimpleDateFormat.

Parameters:

name - the symbolic name of the format

pattern - the pattern format to apply

Throws:

IllegalArgumentException - if pattern is illegal

format

public static String format(Date data,
 String format)
                     throws IOException

Formats a date object to a given format.

Parameters:

data - the data/date

format - the format, may be from SimpleDateFormat or ISO8601_FORMAT

Returns:

if no format can be constructed

Throws:

IOException - if formatting is not possible or the format is unknown

convertToDate

private static <T> Date convertToDate(Class<T> cls,
 Object data)

Uses one of the registered data converters to convert data.

Type Parameters:

T - the type of data

Parameters:

cls - the type of data

data - the data (must not be null)

Returns:

the converted instance, may be null if there is no conversion

parse

public static Date parse(Object data,
 String format)
                  throws IOException

Parses a date from the given data for the specified format.

Parameters:

data - the data (may be null, the the result will be null)

format - the format may be from SimpleDateFormat or ISO8601_FORMAT

Returns:

the parsed date

Throws:

IOException - if parsing is not possible or the format is unknown

getDateFormatter

public static SimpleDateFormat getDateFormatter(String format)
                                         throws IOException

Returns a (cached) simple date formatter.

Parameters:

format - the format for the requested formatter for a string for SimpleDateFormat

Returns:

the formatter instance

Throws:

IOException - if format is not valid

toLocalDateTime

public static LocalDateTime toLocalDateTime(Date date)

Converts a Date value to LocalDateTime using instant and the system default time zone.

Parameters:

date - the date to convert (may be null)

Returns:

the converted date (may be null)

toDate

public static Date toDate(LocalDateTime date)

Converts a LocalDateTime value to Date using instant and the system default time zone.

Parameters:

date - the date to convert (may be null)

Returns:

the converted date (may be null)

sleep

public static void sleep(int ms)

Just sleeps for the given amount of milliseconds.

Parameters:

ms - the milliseconds to wait for

waitFor

public static boolean waitFor(Supplier<Boolean> continueCondition,
 int timeoutMs,
 int sleepMs)

A generic function that waits either until the timeout is reached or the endCondition returns true.

Parameters:

continueCondition - function that returns true when waiting go on and false when waiting shall stop

timeoutMs - timeout from calling in ms, may be negative for endless waiting

sleepMs - time between two trials of timeoutMs and endCondition

Returns:

true if the continueCondition stopped waiting, false if the timeout caused the end of waiting