jidefx.utils.converter

Class ValuesConverter<T,S>

java.lang.Object

javafx.util.StringConverter<T>

jidefx.utils.converter.DefaultObjectConverter<T>

jidefx.utils.converter.ValuesConverter<T,S>

Type Parameters:

T - the type of the object

S - the type of the value in the list.

All Implemented Interfaces:

ObjectConverter<T>, RequiringConverterManager

Direct Known Subclasses:

BoundingBoxConverter, DefaultValuesConverter, Dimension2DConverter, InsetsConverter, Point2DConverter, Point3DConverter, Rectangle2DConverter

public abstract class ValuesConverter<T,S>
extends DefaultObjectConverter<T>
implements RequiringConverterManager

ArrayConverter is an abstract converter that converts between a list of values to a String with a specified separator. The subclass of it will take care of the conversion between an object and a list of values. Together it will convert between an object and a String with a specified separator. Typical use cases for this converter is to convert Rectangle(0, 0, 100, 100) to "0, 0, 100, 100", or Color(255,255,255) to "255, 255, 255".

Constructor Summary

Constructors

Constructor and Description
ValuesConverter(java.lang.String separator, java.lang.Class<?> elementClass) Creates an ArrayConverter.
ValuesConverter(java.lang.String separator, java.lang.Class<?>[] elementClasses) Creates an ArrayConverter.

Method Summary

Modifier and Type	Method and Description
protected S	fromString(int i, java.lang.String s, ConverterContext context) Converts the String to a value using the ObjectConverterManager.
java.lang.Class<?>	getElementClass(int index) Gets the element class for the value at the specified index.
static void	main(java.lang.String[] args)
protected java.lang.String	toString(int i, S o, ConverterContext context) Converts the value to String using the ObjectConverterManager.
java.util.List<S>	valuesFromString(java.lang.String string, ConverterContext context) Converts from string to a list of values, using separator to separate the string.
java.lang.String	valuesToString(java.util.List<S> objects, ConverterContext context) Converts from a list of values to string by concatenating them with separators.

Methods inherited from class jidefx.utils.converter.DefaultObjectConverter

fromString, fromString, getObjectConverterManager, toString, toString, toStringConverter

Methods inherited from class java.lang.Object

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

Constructor Detail

ValuesConverter

public ValuesConverter(java.lang.String separator,
                       java.lang.Class<?> elementClass)

Creates an ArrayConverter.

Parameters:

separator - separator to separate values. It should contain at least non-empty character.

elementClass - class of the array element if all elements have the same class type.

ValuesConverter

public ValuesConverter(java.lang.String separator,
                       java.lang.Class<?>[] elementClasses)

Creates an ArrayConverter.

Parameters:

separator - separator to separate values. It should contain at least non-empty character.

elementClasses - classes of the elements, if the elements in the list have different types. In this case, you may have to a common super class as the generic type S. If there is no common super class, use Object.

Method Detail

valuesToString

public java.lang.String valuesToString(java.util.List<S> objects,
                                       ConverterContext context)

Converts from a list of values to string by concatenating them with separators.

Parameters:

objects - a list of values

context - converter context

Returns:

string all objects concatenated with separators

toString

protected java.lang.String toString(int i,
                                    S o,
                                    ConverterContext context)

Converts the value to String using the ObjectConverterManager.

Parameters:

i - the index of the value in the list.

o - the value

context - the context.

Returns:

the String representation of the value.

valuesFromString

public java.util.List<S> valuesFromString(java.lang.String string,
                                          ConverterContext context)

Converts from string to a list of values, using separator to separate the string.

Parameters:

string - string to be converted

context - the converter context

Returns:

the list of values.

fromString

protected S fromString(int i,
                       java.lang.String s,
                       ConverterContext context)

Converts the String to a value using the ObjectConverterManager.

Parameters:

i - the index of the value in the list.

s - the string

context - the context.

Returns:

the value that is represented as the string.

getElementClass

public java.lang.Class<?> getElementClass(int index)

Gets the element class for the value at the specified index.

Parameters:

index - the index of the value in the values array.

Returns:

the element class for the value at the specified index.

main

public static void main(java.lang.String[] args)