ilog.views.util.convert

Class IlvConvert

java.lang.Object

ilog.views.util.convert.IlvConvert

All Implemented Interfaces:

Serializable

public class IlvConvert
extends Object
implements Serializable

The class IlvConvert is used to convert a value from one type to another. All methods are static.

Conversions are handled by a table of IlvConverter objects. Each converter handles one or several "from" types and one or several "to" types. The conversion is actually performed by the convert() method of IlvConverter.

A number of predefined filters are provided:

• String to/from localized Number, Byte, Short, Integer, Long, Float, Double, BigDecimal, BigInteger, and Boolean
• String to/from Color
• String to/from Font
• number to number (for example, float to int)
• String to Date, using one of two localized formats, or two locale-independent formats:
  • The default or short SimpleDateFormat pattern for the locale.
  • An explicit SimpleDateFormat string is prepended to the date, separated by a comma. For example: "mm/dd/yy,02/21/03".
  • A subset of ISO8601 syntax is used as specified by XML Schema Part 2: dateTime Datatype. For example: "2004-02-25T10:21:00Z" or "2012-10-13T19:40:00-05:00".
• String to/from localized Currency/Percent (use IlvLocalizedConverter.CURRENCY_AS_NUMBER_CLASS and IlvLocalizedConverter.PERCENT_AS_NUMBER_CLASS as type.

More filters supplied by other packages or by the application can be added.

It is also possible to register a PropertyEditor which converts value from/to String through its get/setAsText() methods.

This is a bit different from IlvConvertForSetters, which converts a value from a PropertyDescriptor.

The code comes mainly from BGO (IlvValueConverter)

Since:

JViews 6.0

See Also:

IlvConverter, IlvLocalizedConverter, IlvConvertForSetters, Serialized Form

Method Summary

Modifier and Type	Method and Description
static void	addConverter(IlvConverter converter) Adds a converter to the global list of converters used to convert values.
static void	addConverter(IlvLocalizedPropertyEditorFactory factory, Class<?> type) Adds a converter to the global list of converters used to convert values.
static void	addConverter(PropertyEditor pe, Class<?> type) Adds a converter to the global list of converters used to convert values.
static Object	convert(Object value, Class<?> toType) Converts the type of a value to a new type.
static Object	convert(Object value, Class<?> toType, Locale locale) Deprecated. This method ignores the numbers and calendar specifications in the ULocale. Better use convert(Object, Class, ULocale) instead.
static Object	convert(Object value, Class<?> toType, com.ibm.icu.util.ULocale locale) Converts the type of a value to a new type.
static boolean	convertToBoolean(Object value) Converts a value from its current type to a boolean value.
static byte	convertToByte(Object value) Converts a value from its current type to a byte.
static double	convertToDouble(Object value) Converts a value from its current type to a double.
static float	convertToFloat(Object value) Converts a value from its current type to a float.
static int	convertToInt(Object value) Converts a value from its current type to an integer.
static long	convertToLong(Object value) Converts a value from its current type to a long integer.
static short	convertToShort(Object value) Converts a value from its current type to a short.
static String	convertToString(Object value) Converts a value from its current type to a string.
static IlvConverter	getConverter(Class<?> from, Class<?> to) Returns the converter which can handle given parameters
static boolean	isConverterLocalized(Class<?> from, Class<?> to) Returns true whether the converter which can handle given parameters is localized.
static boolean	isConvertible(Class<?> fromType, Class<?> toType) Returns true if a values from type fromType can be converted to a value of type toType.
static void	removeConverter(Class<?> from, Class<?> to) Removes the converter between given types.

Methods inherited from class java.lang.Object

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

Method Detail

addConverter

public static final void addConverter(IlvConverter converter)

Adds a converter to the global list of converters used to convert values.

Parameters:

converter - the new value converter. The source and target types handled by the converter are determined by the result of the methods fromTypes and toTypes of the converter.

addConverter

public static final void addConverter(PropertyEditor pe,
                                      Class<?> type)

Adds a converter to the global list of converters used to convert values. A PropertyEditor converts from/to String to/from its property value.

Parameters:

pe - the new value converter which must implement its getAsTex() and setAsText() methods.

type - the type of the property associated to the given property editor.

addConverter

public static final void addConverter(IlvLocalizedPropertyEditorFactory factory,
                                      Class<?> type)

Adds a converter to the global list of converters used to convert values. This converter can also be used for localized value conversion. The property editor factory must deliver localized property editors to converts from/to String to/from its property value.

Parameters:

factory - The property editor factory that must produce property editors for given locales.

type - the type of the property associated to the given property editor.

Since:

JViews 8.7

getConverter

public static IlvConverter getConverter(Class<?> from,
                                        Class<?> to)

Returns the converter which can handle given parameters

Parameters:

from - the source type

to - the target type

isConverterLocalized

public static boolean isConverterLocalized(Class<?> from,
                                           Class<?> to)

Returns true whether the converter which can handle given parameters is localized. Returns false also if the converter doesn't exist.

Parameters:

from - the source type

to - the target type

removeConverter

public static void removeConverter(Class<?> from,
                                   Class<?> to)

Removes the converter between given types.

Parameters:

from - the source type

to - the target type

convert

public static final Object convert(Object value,
                                   Class<?> toType)
                            throws IlvConvertException

Converts the type of a value to a new type.

Parameters:

value - the value to be converted.

toType - the type to which the value must be converted.

Returns:

the converted value, which is an instance of the class toType.

Throws:

IlvConvertException - if no converter was registered for the requested conversion or if the value could not be converted to the requested type.

isConvertible

public static boolean isConvertible(Class<?> fromType,
                                    Class<?> toType)

Returns true if a values from type fromType can be converted to a value of type toType.

Parameters:

fromType - the source type

toType - the destination type

convert

@Deprecated
public static final Object convert(Object value,
                                               Class<?> toType,
                                               Locale locale)
                                        throws IlvConvertException

Deprecated. This method ignores the numbers and calendar specifications in the ULocale. Better use convert(Object, Class, ULocale) instead.

Converts the type of a value to a new type.

Parameters:

value - the value to be converted.

toType - the type to which the value must be converted.

locale - the locale used for the conversion

Returns:

the converted value, which is an instance of the class toType.

Throws:

IlvConvertException - if no converter was registered for the requested conversion or if the value could not be converted to the requested type.

convert

public static final Object convert(Object value,
                                   Class<?> toType,
                                   com.ibm.icu.util.ULocale locale)
                            throws IlvConvertException

Converts the type of a value to a new type.

Parameters:

value - the value to be converted.

toType - the type to which the value must be converted.

locale - the locale used for the conversion

Returns:

the converted value, which is an instance of the class toType.

Throws:

IlvConvertException - if no converter was registered for the requested conversion or if the value could not be converted to the requested type.

Since:

JViews 8.8

convertToString

public static final String convertToString(Object value)
                                    throws IlvConvertException

Converts a value from its current type to a string. This method is a shortcut for:

 (String) convert(value, String.class)
 

Parameters:

value - the value to be converted.

Throws:

IlvConvertException - if no converter was registered for the requested conversion or if the value could not be converted to the requested type.

See Also:

convert(java.lang.Object, java.lang.Class<?>)

convertToInt

public static final int convertToInt(Object value)
                              throws IlvConvertException

Converts a value from its current type to an integer. This method is a shortcut for:

 ((Integer) convert(value, Integer.class)).intValue()
 

Parameters:

value - the value to be converted.

Throws:

IlvConvertException - if no converter was registered for the requested conversion or if the value could not be converted to the requested type.

See Also:

convert(java.lang.Object, java.lang.Class<?>)

convertToLong

public static final long convertToLong(Object value)
                                throws IlvConvertException

Converts a value from its current type to a long integer. This method is a shortcut for:

 ((Long) convert(value, Long.class)).longValue()
 

Parameters:

value - the value to be converted.

Throws:

IlvConvertException - if no converter was registered for the requested conversion or if the value could not be converted to the requested type.

See Also:

convert(java.lang.Object, java.lang.Class<?>)

convertToBoolean

public static final boolean convertToBoolean(Object value)
                                      throws IlvConvertException

Converts a value from its current type to a boolean value. This method is a shortcut for:

 ((Boolean) convert(value, Boolean.class)).booleanValue()
 

Parameters:

value - the value to convert

Throws:

IlvConvertException - if not converter was registered for the requested conversion or if the value could not be converted to the requested type.

See Also:

convert(java.lang.Object, java.lang.Class<?>)

convertToFloat

public static final float convertToFloat(Object value)
                                  throws IlvConvertException

Converts a value from its current type to a float. This method is a shortcut for:

 ((Float) convert(value, Float.class)).floatValue()
 

Parameters:

value - the value to be converted.

Throws:

IlvConvertException - if no converter was registered for the requested conversion or if the value could not be converted to the requested type.

See Also:

convert(java.lang.Object, java.lang.Class<?>)

convertToDouble

public static final double convertToDouble(Object value)
                                    throws IlvConvertException

Converts a value from its current type to a double. This method is a shortcut for:

 ((Double) convert(value, Double.class)).doubleValue()
 

Parameters:

value - the value to be converted.

Throws:

IlvConvertException - if no converter was registered for the requested conversion or if the value could not be converted to the requested type.

See Also:

convert(java.lang.Object, java.lang.Class<?>)

convertToShort

public static final short convertToShort(Object value)
                                  throws IlvConvertException

Converts a value from its current type to a short. This method is a shortcut for:

 ((Short) convert(value, Short.class)).shortValue()
 

Parameters:

value - the value to be converted.

Throws:

IlvConvertException - if no converter was registered for the requested conversion or if the value could not be converted to the requested type.

See Also:

convert(java.lang.Object, java.lang.Class<?>)

convertToByte

public static final byte convertToByte(Object value)
                                throws IlvConvertException

Converts a value from its current type to a byte.

Parameters:

value - the value to be converted.

Throws:

IlvConvertException - if no converter was registered for the requested conversion or if the value could not be converted to the requested type.

See Also:

convert(java.lang.Object, java.lang.Class<?>)