org.refcodes.textual.utils

Class SeparatedValuesUtility

java.lang.Object

org.refcodes.textual.utils.SeparatedValuesUtility

public class SeparatedValuesUtility
extends Object

Author:

steiner

Method Summary

Modifier and Type	Method and Description
static List<String>	fromSeparatedValues(String aSeparatedValues) Takes the String and creates a List with String instances containing the elements as identified from the String by splitting the String at the delimiter positions and adding those chunks to the List with the according DelimeterConsts.CSV_DELIMETER separator..
static List<String>	fromSeparatedValues(String aSeparatedValues, char aDelimiter) Takes the String and creates a List with String instances containing the elements as identified from the String by splitting the String at the delimiter positions and adding those chunks to the List.
static List<String>	fromSplitValues(String aSplitValues) Takes the String and creates a List with String instances containing the elements as identified from the String by splitting the String at the delimiter positions and adding those chunks to the List with the according DelimeterConsts.CSV_DELIMETER separator..
static List<String>	fromSplitValues(String aSplitValues, char aDelimiter) Takes the String and creates a List with String instances containing the elements as identified from the String by splitting the String at the delimiter positions and adding those chunks to the List.
static List<String>	fromSplitValues(String aValues, String aDelimiters) Takes the String and creates a List with String instances containing the elements as identified from the String by splitting the String at the delimiter positions and adding those chunks to the List.
static String	toSeparatedValue(Object aValue) Escapes a single value according to the rules of CSV like separated values with the according DelimeterConsts.CSV_DELIMETER separator.
static String	toSeparatedValue(Object aValue, char aDelimiter) Escapes a single value according to the rules of CSV like separated values.
static String	toSeparatedValues(Collection<?> aCollection) Takes the collection and creates a single String with the according DelimeterConsts.CSV_DELIMETER separator.
static String	toSeparatedValues(Collection<?> aCollection, char aDelimiter) Takes the collection and creates a single String with the provided separator.
static String	toSeparatedValues(Object[] aArray) Takes the array's String representation and creates a single String with the according DelimeterConsts.CSV_DELIMETER separator.
static String	toSeparatedValues(Object[] aArray, char aDelimiter) Takes the array's String representation and creates a single String with the provided separator.
static String	toSplitValue(Object aValue, char aDelimiter) Creates the String representation of a single split value not applying any escaping.
static String	toSplitValues(Collection<?> aCollection) Takes the collection and creates a single String with the according DelimeterConsts.CSV_DELIMETER separator.
static String	toSplitValues(Collection<?> aCollection, char aDelimiter) Takes the collection and creates a single String with the provided separator.
static String	toSplitValues(Object[] aArray) Takes the array's String representation and creates a single String with the according DelimeterConsts.CSV_DELIMETER separator.
static String	toSplitValues(Object[] aArray, char aDelimiter) Takes the array's String representation and creates a single String with the provided separator.

Methods inherited from class java.lang.Object

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

Method Detail

toSeparatedValues

public static String toSeparatedValues(Collection<?> aCollection)

Takes the collection and creates a single String with the according DelimeterConsts.CSV_DELIMETER separator. Unescaping any escaped chars is taken care of by this method, for example an unescaped delimiter char is escaped in the result.

Parameters:

aCollection - The collection to be converted to a single CSV String.

Returns:

The single CSV String from the collection.

toSeparatedValues

public static String toSeparatedValues(Collection<?> aCollection,
                                       char aDelimiter)

Takes the collection and creates a single String with the provided separator. Unescaping any escaped chars is taken care of by this method, for example an unescaped delimiter char is escaped in the result.

Parameters:

aCollection - The collection to be converted to a single CSV String.

aDelimiter - The delimiter to use for creating the single CSV String.

Returns:

The single CSV String from the collection.

toSeparatedValue

public static String toSeparatedValue(Object aValue)

Escapes a single value according to the rules of CSV like separated values with the according DelimeterConsts.CSV_DELIMETER separator.

Parameters:

aValue - The value which's String representation is to be escaped accordingly.

Returns:

A single value escaped according to the rules of CSV like separated values.

toSeparatedValue

public static String toSeparatedValue(Object aValue,
                                      char aDelimiter)

Escapes a single value according to the rules of CSV like separated values.

Parameters:

aValue - The value which's String representation is to be escaped accordingly.

aDelimiter - The delimiter to use for creating the single CSV String.

Returns:

A single value escaped according to the rules of CSV like separated values.

fromSeparatedValues

public static List<String> fromSeparatedValues(String aSeparatedValues)

Takes the String and creates a List with String instances containing the elements as identified from the String by splitting the String at the delimiter positions and adding those chunks to the List with the according DelimeterConsts.CSV_DELIMETER separator.. Escaping any unescaped chars is taken care of by this method, for example an escaped delimiter char is unescaped in the result.

Parameters:

aSeparatedValues - The String representing the CSV String where contained elements are separated from each other by the given delimiter.

Returns:

The List containing the elements as identified from the given CSV String.

fromSeparatedValues

public static List<String> fromSeparatedValues(String aSeparatedValues,
                                               char aDelimiter)

Takes the String and creates a List with String instances containing the elements as identified from the String by splitting the String at the delimiter positions and adding those chunks to the List. Escaping any unescaped chars is taken care of by this method, for example an escaped delimiter char is unescaped in the result.

Parameters:

aSeparatedValues - The String representing the CSV String where contained elements are separated from each other by the given delimiter.

aDelimiter - The delimiter used for separating the elements if the single CSV String.

Returns:

The List containing the elements as identified from the given CSV String.

toSplitValues

public static String toSplitValues(Object[] aArray)

Takes the array's String representation and creates a single String with the according DelimeterConsts.CSV_DELIMETER separator. No escaping is taken of, for escaping either use the according toSeparatedValues(Object[]) method or do escaping manually via toSeparatedValue.

Parameters:

aArray - The array to be converted to a single CSV String.

Returns:

The single CSV String from the String array.

toSplitValues

public static String toSplitValues(Object[] aArray,
                                   char aDelimiter)

Takes the array's String representation and creates a single String with the provided separator. No escaping is taken of, for escaping either use the according toSeparatedValues(Object[], char) method or do escaping manually via toSeparatedValue.

Parameters:

aArray - The array to be converted to a single CSV String.

aDelimiter - The delimiter to use for creating the single CSV String.

Returns:

The single CSV String from the String array.

toSplitValues

public static String toSplitValues(Collection<?> aCollection)

Takes the collection and creates a single String with the according DelimeterConsts.CSV_DELIMETER separator. No escaping is taken of, for escaping either use the according toSeparatedValues method or do escaping manually via toSeparatedValue.

Parameters:

aCollection - The collection to be converted to a single CSV String.

Returns:

The single CSV String from the collection.

toSplitValues

public static String toSplitValues(Collection<?> aCollection,
                                   char aDelimiter)

Takes the collection and creates a single String with the provided separator. No escaping is taken of, for escaping either use the according toSeparatedValues method or do escaping manually via toSeparatedValue.

Parameters:

aCollection - The collection to be converted to a single CSV String.

aDelimiter - The delimiter to use for creating the single CSV String.

Returns:

The single CSV String from the collection.

toSplitValue

public static String toSplitValue(Object aValue,
                                  char aDelimiter)

Creates the String representation of a single split value not applying any escaping.

Parameters:

aValue - The value which's String representation is to be retrieved.

aDelimiter - The delimiter to use for creating the single CSV String.

Returns:

A single value not escaped as required by plain split values.

fromSplitValues

public static List<String> fromSplitValues(String aSplitValues)

Takes the String and creates a List with String instances containing the elements as identified from the String by splitting the String at the delimiter positions and adding those chunks to the List with the according DelimeterConsts.CSV_DELIMETER separator.. Escaping any unescaped chars is taken care of by this method, for example an escaped delimiter char is unescaped in the result.

Parameters:

aSplitValues - The String representing the CSV String where contained elements are split from each other by the given delimiter.

Returns:

The List containing the elements as identified from the given CSV String.

fromSplitValues

public static List<String> fromSplitValues(String aSplitValues,
                                           char aDelimiter)

Takes the String and creates a List with String instances containing the elements as identified from the String by splitting the String at the delimiter positions and adding those chunks to the List. Escaping any unescaped chars is taken care of by this method, for example an escaped delimiter char is unescaped in the result.

Parameters:

aSplitValues - The String representing the CSV String where contained elements are split from each other by the given delimiter.

aDelimiter - The delimiter used for separating the elements if the single CSV String.

Returns:

The List containing the elements as identified from the given CSV String.

fromSplitValues

public static List<String> fromSplitValues(String aValues,
                                           String aDelimiters)

Takes the String and creates a List with String instances containing the elements as identified from the String by splitting the String at the delimiter positions and adding those chunks to the List. Escaping any unescaped chars is taken care of by this method, for example an escaped delimiter char is unescaped in the result.

Parameters:

aValues - The String representing the CSV String where contained elements are separated from each other by the given delimiter.

aDelimiters - The delimiter characters used for separating the elements.

Returns:

The List containing the elements as identified from the given CSV String.

toSeparatedValues

public static String toSeparatedValues(Object[] aArray)

Takes the array's String representation and creates a single String with the according DelimeterConsts.CSV_DELIMETER separator. Unescaping any escaped chars is taken care of by this method, for example an unescaped delimiter char is escaped in the result.

Parameters:

aArray - The array to be converted to a single CSV String.

Returns:

The single CSV String from the String array.

toSeparatedValues

public static String toSeparatedValues(Object[] aArray,
                                       char aDelimiter)

Takes the array's String representation and creates a single String with the provided separator. Unescaping any escaped chars is taken care of by this method, for example an unescaped delimiter char is escaped in the result.

Parameters:

aArray - The array to be converted to a single CSV String.

aDelimiter - The delimiter to use for creating the single CSV String.

Returns:

The single CSV String from the String array.