VObjectPropertyValues (vinnie 1.0.0 API)

java.lang.Object
- com.github.mangstadt.vinnie.io.VObjectPropertyValues

```
public final class VObjectPropertyValues
extends Object
```
Contains utility methods for parsing and writing vobject property values.

Author:

Michael Angstadt

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`VObjectPropertyValues.SemiStructuredValueBuilder` Builds a "semi-structured" property value.
`static class`	`VObjectPropertyValues.SemiStructuredValueIterator` Iterates over the values in a "semi-structured" property value.
`static class`	`VObjectPropertyValues.StructuredValueBuilder` Builds "structured" property values.
`static class`	`VObjectPropertyValues.StructuredValueIterator` Iterates over the values in a "structured" property value.

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static String`	`escape(String value)` Escapes all special characters within a property value.
`static List<String>`	`parseList(String value)` Parses a "list" property value.
`static Map<String,List<String>>`	`parseMultimap(String value)` Parses a "multimap" property value.
`static List<String>`	`parseSemiStructured(String value)` Parses a "semi-structured" property value.
`static List<String>`	`parseSemiStructured(String value, int limit)` Parses a "semi-structured" property value.
`static List<List<String>>`	`parseStructured(String value)` Parses a "structured" property value.
`static String`	`unescape(String value)` Unescapes all escaped characters in a property value.
`static String`	`writeList(Collection<?> values)` Generates a "list" property value.
`static String`	`writeMultimap(Map<String,? extends List<?>> multimap)` Writes a "multimap" property value.
`static String`	`writeSemiStructured(List<?> values, boolean includeTrailingSemicolons)` Writes a "semi-structured" property value.
`static String`	`writeStructured(List<? extends List<?>> components, boolean includeTrailingSemicolons)` Writes a "structured" property value.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - unescape
```
public static String unescape(String value)
```
    Unescapes all escaped characters in a property value. Escaped newlines are replaced with the local system's newline character sequence.
    
    Example:
```
 String value = VObjectPropertyValues.unescape("one\\,two\\;three\\nfour");
 assertEquals("one,two;three\nfour", value);
 
```
    Parameters:
    
    value - the value to unescape
    
    Returns:
    
    the unescaped value
  - escape
```
public static String escape(String value)
```
    Escapes all special characters within a property value. These characters are:
    - backslashes (\)
    - commas (,)
    - semi-colons (;)
    Note: Newlines are not escaped by this method. They are escaped by VObjectWriter when the data is serialized.
    
    Example:
```
 String value = VObjectPropertyValues.escape("one,two;three\nfour");
 assertEquals("one\\,two\\;three\nfour", value);
 
```
    Parameters:
    
    value - the value to escape
    
    Returns:
    
    the escaped value
  - parseList
```
public static List<String> parseList(String value)
```
    Parses a "list" property value.
    
    List values contain multiple values separated by commas. The order that the values are in usually doesn't matter.
    
    Example:
```
 List<String> list = VObjectPropertyValues.parseList("one,two\\,three");
 assertEquals(Arrays.asList("one", "two,three"), list);
 
```
    Parameters:
    
    value - the value to parse
    
    Returns:
    
    the parsed list
  - writeList
```
public static String writeList(Collection<?> values)
```
    Generates a "list" property value.
    
    List values contain multiple values separated by commas. The order that the values are in usually doesn't matter.
    
    Example:
```
 String value = VObjectPropertyValues.writeList(Arrays.asList("one", null, 2, "three,four");
 assertEquals("one,null,2,three\\,four", value);
 
```
    Parameters:
    
    values - the values to write (the toString() method is invoked on each object)
    
    Returns:
    
    the list value string
  - parseSemiStructured
```
public static List<String> parseSemiStructured(String value)
```
    Parses a "semi-structured" property value.
    
    Semi-structured values contain multiple values separate by semicolons. Unlike structured values, each value cannot have their own comma separated list of sub-values. The order that the values are in matters.
    
    Example:
```
 List<String> values = VObjectPropertyValues.parseSemiStructured("one;two\\;three,four");
 assertEquals(Arrays.asList("one", "two;three,four"), values);
 
```
    Parameters:
    
    value - the value to parse
    
    Returns:
    
    the parsed values
  - parseSemiStructured
```
public static List<String> parseSemiStructured(String value,
                                               int limit)
```
    Parses a "semi-structured" property value.
    
    Semi-structured values contain multiple values separate by semicolons. Unlike structured values, each value cannot have their own comma separated list of sub-values. The order that the values are in matters.
    
    Example:
```
 List<String> values = VObjectPropertyValues.parseSemiStructured("one;two;three", 2);
 assertEquals(Arrays.asList("one", "two;three"), values);
 
```
    Parameters:
    
    value - the value to parse
    
    limit - the max number of items to parse
    
    Returns:
    
    the parsed values
  - writeSemiStructured
```
public static String writeSemiStructured(List<?> values,
                                         boolean includeTrailingSemicolons)
```
    Writes a "semi-structured" property value.
    
    Semi-structured values contain multiple values separate by semicolons. Unlike structured values, each value cannot have their own comma separated list of sub-values. The order that the values are in matters.
    Example:
```
 String value = VObjectPropertyValues.writeSemiStructured(Arrays.asList("one", null, 2, "three;four,five", ""), false);
 assertEquals("one;null;2;three\\;four\\,five", value);
 
```
    Parameters:
    
    values - the values to write
    
    includeTrailingSemicolons - true to include the semicolon delimiters for empty values at the end of the values list, false to trim them
    
    Returns:
    
    the semi-structured value string
  - parseStructured
```
public static List<List<String>> parseStructured(String value)
```
    Parses a "structured" property value.
    
    Structured values are essentially 2-D arrays. They contain multiple components separated by semicolons, and each component can have multiple values separated by commas. The order that the components are in matters, but the order that each component's list of values are in usually doesn't matter.
    
    Example:
```
 List<List<String>> values = VObjectPropertyValues.parseStructured("one;two,three;four\\,five\\;six");
 assertEquals(Arrays.asList(
   Arrays.asList("one"),
   Arrays.asList("two", "three"),
   Arrays.asList("four,five;six")
 ), values);
 
```
    Parameters:
    
    value - the value to parse
    
    Returns:
    
    the parsed values
  - writeStructured
```
public static String writeStructured(List<? extends List<?>> components,
                                     boolean includeTrailingSemicolons)
```
    Writes a "structured" property value.
    
    Structured values are essentially 2-D arrays. They contain multiple components separated by semicolons, and each component can have multiple values separated by commas. The order that the components are in matters, but the order that each component's list of values are in usually doesn't matter.
    
    Example:
```
 String value = VObjectPropertyValues.writeStructured(Arrays.asList(
   Arrays.asList("one"),
   Arrays.asList("two", 3),
   Arrays.asList(null),
   Arrays.asList("four,five;six"),
   Arrays.asList()
 ), false);
 assertEquals("one;two,3;null;four\\,five\\;six", value);
 
```
    Parameters:
    
    components - the components to write (each value's toString() method will be called)
    
    includeTrailingSemicolons - true to include the semicolon delimiters for empty components at the end of the written value, false to trim them
    
    Returns:
    
    the structured value string
  - parseMultimap
```
public static Map<String,List<String>> parseMultimap(String value)
```
    Parses a "multimap" property value.
    
    Multimap values are collections of key/value pairs whose keys can be multi-valued. Key/value pairs are separated by semicolons. Values are separated by commas. Keys are converted to uppercase.
    
    Example:
```
 Map<String, List<String>> multimap = VObjectPropertyValues.parseMultimap("one=two;THREE;FOUR=five,six\\,seven\\;eight");
 Map<String, List<String>> expected = new HashMap<String, List<String>>();
 expected.put("ONE", Arrays.asList("two"));
 expected.put("THREE", Arrays.<String> asList());
 expected.put("FOUR", Arrays.asList("five", "six,seven;eight"));
 assertEquals(expected, multimap);
 
```
    Parameters:
    
    value - the value to parse
    
    Returns:
    
    the parsed values
  - writeMultimap
```
public static String writeMultimap(Map<String,? extends List<?>> multimap)
```
    Writes a "multimap" property value.
    
    Multimap values are collections of key/value pairs whose keys can be multi-valued. Key/value pairs are separated by semicolons. Values are separated by commas. Keys are converted to uppercase.
    
    Example:
```
 Map<String, List<Object>> input = new LinkedHashMap<String, List<Object>>();
 input.put("one", Arrays.asList("two"));
 input.put("THREE", Arrays.<String> asList());
 input.put("FOUR", Arrays.asList(5, "six,seven;eight"));
 
 String value = VObjectPropertyValues.writeMultimap(input);
 assertEquals("ONE=two;THREE;FOUR=5,six\\,seven\\;eight", value);
 
```
    Parameters:
    
    multimap - the multimap to write (each value's toString() method will be called)
    
    Returns:
    
    the multimap value string

Class VObjectPropertyValues

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Method Detail

unescape

escape

parseList

writeList

parseSemiStructured

parseSemiStructured

writeSemiStructured

parseStructured

writeStructured

parseMultimap

writeMultimap