Package de.iip_ecosphere.platform.connectors.formatter

Class FormatCache

java.lang.Object

de.iip_ecosphere.platform.connectors.formatter.FormatCache

public class FormatCache
extends Object

Caches formatter instances.

Author:

Holger Eichelberger, SSE

Nested Class Summary

Nested Classes

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

Field Summary

Fields

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

Constructor Summary

Constructors

Constructor	Description
FormatCache()

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(FormatCache.DateConverter<?> converter)	Registers an additional converter.
static void	registerFormat(String name, String pattern)	Registers a default format for SimpleDateFormat.
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.

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<?>,FormatCache.DateConverter<?>> CONVERTERS

Constructor Details

FormatCache

public FormatCache()

Method Details

registerConverter

public static void registerConverter(FormatCache.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)