ERXPropertyListSerialization (Project Wonder Reference Documentation)

java.lang.Object
- er.extensions.foundation.ERXPropertyListSerialization

```
public class ERXPropertyListSerialization
extends Object
```
This class provides static methods that convert between property lists and their string representations, which can be either strings or NSData objects. A property list is a structure that represents organized data. It can be built from a combination of NSArray, NSDictionary, String, and NSData objects.
The string representation can be in XML or the ASCII plist format. To distinguish between the two formats, the parser that converts strings to property lists finds out whether the string starts with <?xml. A discussion of the ASCII plist format, A Primer on ASCII Property Lists, is available in the Mac OS X section of the Apple Developer Connection website. A discussion of XML property lists, Property List Services, is also available in the same area of the Apple Developer Connection website.
Some methods do not support XML property list representations, specifically booleanForString and intForString. Also note that XML property lists de-serialize 'integer' value types to java.math.BigInteger and 'real' value types ot java.math.BigDecimal.
The ERXPropertyListSerialization class cannot be instantiated. There is an alternative Binary plist format.
JSON Serialization Example:
```
 NSDictionary dict<String,Object> = new NSDictionary<>(new String[] { "one", "two" }, new Object[] {Integer.valueOf(1), Integer.valueOf(2)});
 String jsonString = ERXPropertyListSerialization.jsonStringFromPropertyList(dict);
 
```
JSON Deserialization Example:
```
 NSDictionary<String, Object>     result  = ERXPropertyListSerialization.<String, Object> dictionaryForJSONString(jsonString);
 
```
If you know that you are receiving a JSON array, you can use the convenience API:
```
 NSArray        result  = ERXPropertyListSerialization.arrayForJSONString(jsonString);
 
```
Binary PList Example:
```
 try {
        URLConnection conn = url.openConnection();
        InputStream is = conn.getInputStream();
        NSDictionary plist = ERXPropertyListSerialization.dictionaryForBinaryStream(is);
 } catch (RuntimeException e) {
        e.printStackTrace();
 } catch (IOException e) {
        e.printStackTrace();
 }
 
```
Serialization to an OutputStream:
```
 File tempFile = File.createTempFile("myPlist", "plist");
 try (FileOutputStream out = new FileOutputStream(tempFile)) {
   ERXPropertyListSerialization.propertyListWriteToStream(plist, out, ERXPropertyListSerialization.PListFormat.NSPropertyListXMLFormat_v1_0);
 } catch (Exception e) {
   e.printStackTrace();
 }
 
```
See Also:

booleanForString(java.lang.String), intForString(java.lang.String), ERXPropertyListSerialization.PListFormat.NSPropertyListBinaryFormat_v1_0, ERXPropertyListSerialization.PListFormat.NSPropertyListXMLFormat_v1_0

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`ERXPropertyListSerialization._ApplePList`
`static class`	`ERXPropertyListSerialization._BinaryPListParser` Description of the binary plist format derived from http://cvs.opendarwin.org/cgi-bin/cvsweb.cgi/~checkout~/src/CoreFoundation/Parsing.subproj/CFBinaryPList.c?rev=1.1.1.3&content-type=text/plain EBNF description of the file format:
`static class`	`ERXPropertyListSerialization._JSONPList`
`static class`	`ERXPropertyListSerialization._PListParser` This class is intentionally undocumented
`static class`	`ERXPropertyListSerialization._XML` This class is intentionally undocumented
`static class`	`ERXPropertyListSerialization.PListFormat` Types of property lists (as specified in CoreFoundation)
`static class`	`ERXPropertyListSerialization.PListType` Data types found in property lists (as specified in CoreFoundation)

Field Summary

Fields
Modifier and Type	Field and Description
`static Class<?>`	`_CLASS`
`protected static String`	`DefaultSimpleDateFormatPattern` yyyy-MM-dd'T'HH:mm:ss'Z'
`static boolean`	`ForceXML` Convenience for methods to convert to xml plist.
`static boolean`	`Indents` Convenience for methods to convert to plist.
`protected static double`	`kCFAbsoluteTimeIntervalSince1970`
`static boolean`	`NoIndents` Convenience for methods to convert to plist.
`static String`	`NULL` Null value

Constructor Summary

Constructors
Modifier Constructor and Description

protected ERXPropertyListSerialization()

Constructors
Modifier	Constructor and Description
`protected`	`ERXPropertyListSerialization()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static NSArray<?>`	`arrayForBinaryStream(InputStream is)`
`static <E> NSArray<E>`	`arrayForJSONString(String value)` Parses the JSON formatted `string` and returns the resulting property list as an NSArray.
`static <E> NSArray<E>`	`arrayForString(String value)` Parses the property list representation `string` and returns the resulting property list as an NSArray.
`static <E> NSArray<E>`	`arrayForString(String value, boolean forceXML)` Parses the property list representation `string` and returns the resulting property list as an NSArray.
`static <E> NSArray<E>`	`arrayWithPathURL(URL url)` Converts a java.net.URL into a property list and returns the resulting property list as an NSArray.
`static <E> NSArray<E>`	`arrayWithPathURL(URL url, boolean forceXML)` Converts a java.net.URL into a property list and returns the resulting property list as an NSArray.
`static boolean`	`booleanForString(String value)` Parses a given string for boolean value according to the table below.
`static NSData`	`dataFromPropertyList(Object plist, ERXPropertyListSerialization.PListFormat type, String encoding)` For a specified property list format, create an NSData from an object.
`static NSData`	`dataFromPropertyList(Object plist, String encoding)` Converts the property list `object` into a string using a character encoding and returns it as an NSData object.
`static <K,V> NSDictionary<K,V>`	`dictionaryForJSONString(String value)` Parses the JSON formatted `string` and returns the resulting property list as an NSDictionary.
`static <K,V> NSDictionary<K,V>`	`dictionaryForString(String value)` Parses the property list representation `string` and returns the resulting property list as an NSDictionary.
`static <K,V> NSDictionary<K,V>`	`dictionaryForString(String value, boolean forceXML)` Parses the property list representation `string` and returns the resulting property list as an NSDictionary.
`static <K,V> NSDictionary<K,V>`	`dictionaryWithBinaryPropertyListPathURL(URL url)` Return NSDictionary for a valid plist.
`static <K,V> NSDictionary<K,V>`	`dictionaryWithBinaryStream(InputStream is)` Return NSDictionary for a valid plist when passed a binary plist stream.
`static <K,V> NSDictionary<K,V>`	`dictionaryWithInputStream(InputStream is, String encoding)` Read a plist from an InputStream and return NSDictionary of values.
`static <K,V> NSDictionary<K,V>`	`dictionaryWithPathURL(URL url)` Converts a java.net.URL into a property list and returns the resulting property list as an NSDictionary.
`static <K,V> NSDictionary<K,V>`	`dictionaryWithPathURL(URL url, boolean forceXML)` Converts a java.net.URL into a property list and returns the resulting property list as an NSDictionary.
`static Document`	`documentWithBinaryPropertyListURL(URL url)` Parse binary plist to XML Document
`static int`	`intForString(String value)` Parses a given string and returns the corresponding integer value.
`static String`	`jsonStringFromPropertyList(Object plist)` Converts the property list `object` into a JSON formatted string.
`static String`	`jsonStringFromPropertyList(Object plist, boolean suppressWhiteSpace)` Converts the property list `object` into a JSON formatted string.
`static Object`	`propertyListFromData(NSData data, ERXPropertyListSerialization.PListFormat type, String encoding)` Converts an NSData into a property list and returns it.
`static Object`	`propertyListFromData(NSData data, String encoding)` Converts an NSData into a property list using a character encoding and returns it.
`static Object`	`propertyListFromJSONString(String string)` Convert JSON formatted string to a property list
`static Object`	`propertyListFromString(String string)` Converts a string into a property list and returns it.
`static Object`	`propertyListFromString(String string, boolean forceXML)` Converts a string into a property list and returns it.
`static Object`	`propertyListWithData(NSData data, ERXPropertyListSerialization.PListFormat type, String encoding)` Reads a plist from the given NSData using the specified format.
`static Object`	`propertyListWithPathURL(URL url)` Converts a java.net.URL into a property list and returns it.
`static Object`	`propertyListWithPathURL(URL url, boolean forceXML)` Converts a java.net.URL into a property list and returns it.
`static Object`	`propertyListWithStream(InputStream is, ERXPropertyListSerialization.PListFormat type, String encoding)` Reads a plist from the given inputstream using the specified format.
`static Object`	`propertyListWithURL(URL url, ERXPropertyListSerialization.PListFormat type, String encoding)` Reads a plist from the given URL using the specified format.
`static String`	`stringFromPropertyList(Object plist)` Converts a property list object into a string (old style plist) and returns it.
`static String`	`stringFromPropertyList(Object plist, boolean indents)` Converts a property list object into a string (old style plist) and returns it.
`static void`	`writePropertyListToStream(Object plist, OutputStream out, ERXPropertyListSerialization.PListFormat type, String encoding)` For a specified property list format, write a plist to the provided outputstream.
`static String`	`xmlStringFromPropertyList(Object plist)` Converts a property list object into an XML string and returns it.
`static String`	`xmlStringFromPropertyList(Object plist, boolean indents)` Converts a property list object into an XML string and returns it.
`static String`	`xmlStringWithBinaryPropertyListURL(URL url)` Parse binary plist to XML Document

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

- Field Detail
  - _CLASS
```
public static final Class<?> _CLASS
```
  - Indents
```
public static final boolean Indents
```
    Convenience for methods to convert to plist. Returns true..
    
    See Also:
    
    Constant Field Values
  - NoIndents
```
public static final boolean NoIndents
```
    Convenience for methods to convert to plist. Returns false.
    
    See Also:
    
    Constant Field Values
  - ForceXML
```
public static final boolean ForceXML
```
    Convenience for methods to convert to xml plist. Returns true..
    
    See Also:
    
    Constant Field Values
  - NULL
```
public static final String NULL
```
    Null value
    
    See Also:
    
    Constant Field Values
  - DefaultSimpleDateFormatPattern
```
protected static final String DefaultSimpleDateFormatPattern
```
    yyyy-MM-dd'T'HH:mm:ss'Z'
    
    See Also:
    
    Constant Field Values
  - kCFAbsoluteTimeIntervalSince1970
```
protected static final double kCFAbsoluteTimeIntervalSince1970
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - ERXPropertyListSerialization
```
protected ERXPropertyListSerialization()
```
- Method Detail
  - stringFromPropertyList
```
public static String stringFromPropertyList(Object plist)
```
    Converts a property list object into a string (old style plist) and returns it. All entries are indented.
    
    Parameters:
    
    plist - the property list to convert
    
    Returns:
    
    plist as a string
    
    See Also:
    
    propertyListFromString(String)
  - stringFromPropertyList
```
public static String stringFromPropertyList(Object plist,
                                            boolean indents)
```
    Converts a property list object into a string (old style plist) and returns it.
    
    Parameters:
    
    plist - the property list to convert
    
    indents - if true the resulting plist is indented (tabs and CR) if false no tabs anc CR are inserted in the result
    
    Returns:
    
    plist as a string
    
    Since:
    
    5.4
    
    See Also:
    
    propertyListFromString(String, boolean)
  - xmlStringFromPropertyList
```
public static String xmlStringFromPropertyList(Object plist)
```
    Converts a property list object into an XML string and returns it. All entries are indented.
    
    Parameters:
    
    plist - the property list to convert
    
    Returns:
    
    plist as a string
    
    Since:
    
    5.4
    
    See Also:
    
    propertyListFromString(String)
  - xmlStringFromPropertyList
```
public static String xmlStringFromPropertyList(Object plist,
                                               boolean indents)
```
    Converts a property list object into an XML string and returns it.
    
    Parameters:
    
    plist - the property list to convert
    
    indents - if true the resulting plist is indented (tabs and CR) if false no tabs anc CR are inserted in the result
    
    Returns:
    
    plist as a string
    
    Since:
    
    5.4
    
    See Also:
    
    propertyListFromString(String, boolean)
  - propertyListFromString
```
public static Object propertyListFromString(String string)
```
    Converts a string into a property list and returns it.
    
    Parameters:
    
    string - the string to convert to a property list
    
    Returns:
    
    string as a property list
    
    See Also:
    
    stringFromPropertyList(Object)
  - propertyListFromString
```
public static Object propertyListFromString(String string,
                                            boolean forceXML)
```
    Converts a string into a property list and returns it.
    
    Parameters:
    
    string - the string to convert to a property list
    
    forceXML - force xml decoding
    
    Returns:
    
    string as a property list
    
    Since:
    
    5.4
    
    See Also:
    
    stringFromPropertyList(Object, boolean)
  - propertyListWithPathURL
```
public static Object propertyListWithPathURL(URL url)
```
    Converts a java.net.URL into a property list and returns it.
    
    Parameters:
    
    url - the java.net.URL to convert to a property list
    
    Returns:
    
    the content at url as a property list
    
    Since:
    
    5.2.2
    
    See Also:
    
    stringFromPropertyList(Object)
  - propertyListWithPathURL
```
public static Object propertyListWithPathURL(URL url,
                                             boolean forceXML)
```
    Converts a java.net.URL into a property list and returns it.
    
    Parameters:
    
    url - the java.net.URL to convert to a property list
    
    forceXML - force xml decoding
    
    Returns:
    
    the content at url as a property list
    
    Since:
    
    5.4
    
    See Also:
    
    (Object, boolean)
  - propertyListFromJSONString
```
public static Object propertyListFromJSONString(String string)
```
    Convert JSON formatted string to a property list
    
    Parameters:
    
    string -
    
    Returns:
    
    content of string as a property list
    
    Since:
    
    5.5
    
    See Also:
    
    "http://www.json.org"
  - jsonStringFromPropertyList
```
public static String jsonStringFromPropertyList(Object plist)
```
    Converts the property list object into a JSON formatted string. By default, it will not append whitespace to JSON string.
    
    Parameters:
    
    plist -
    
    Returns:
    
    string for a given plist
    
    Since:
    
    5.5
  - jsonStringFromPropertyList
```
public static String jsonStringFromPropertyList(Object plist,
                                                boolean suppressWhiteSpace)
```
    Converts the property list object into a JSON formatted string.
    
    Parameters:
    
    plist -
    
    suppressWhiteSpace - - will not format string with whitespace
    
    Returns:
    
    JSON formatted string for a given plist
    
    Since:
    
    5.5
  - dataFromPropertyList
```
public static NSData dataFromPropertyList(Object plist,
                                          String encoding)
```
    Converts the property list object into a string using a character encoding and returns it as an NSData object.
    
    Parameters:
    
    plist - the property list object to convert
    
    encoding - encoding used to convert the characters in the result string to byte
    
    Returns:
    
    object converted to an NSData
    
    See Also:
    
    propertyListFromData(NSData, java.lang.String)
  - dataFromPropertyList
```
public static NSData dataFromPropertyList(Object plist,
                                          ERXPropertyListSerialization.PListFormat type,
                                          String encoding)
```
    For a specified property list format, create an NSData from an object.
    
    Parameters:
    
    plist - the object to write
    
    type - type of plist to generate
    
    encoding - the string encoding of the bytes in the stream (ignored for binary plist format)
    
    Returns:
    
    an NSData containing the property list output
    
    Since:
    
    5.5.3
    
    See Also:
    
    ERXPropertyListSerialization.PListFormat.NSPropertyListJsonFormat_v1_0, ERXPropertyListSerialization.PListFormat.NSPropertyListBinaryFormat_v1_0, ERXPropertyListSerialization.PListFormat.NSPropertyListXMLFormat_v1_0, ERXPropertyListSerialization.PListFormat.NSPropertyListOpenStepFormat
  - propertyListFromData
```
public static Object propertyListFromData(NSData data,
                                          String encoding)
```
    Converts an NSData into a property list using a character encoding and returns it.
    
    Parameters:
    
    data - the byte array to be converted to a property list
    
    encoding - encoding to use to convert the bytes in the data byte array to characters in a string representation
    
    Returns:
    
    data as a property list
    
    See Also:
    
    dataFromPropertyList(Object, java.lang.String)
  - propertyListFromData
```
public static Object propertyListFromData(NSData data,
                                          ERXPropertyListSerialization.PListFormat type,
                                          String encoding)
```
    Converts an NSData into a property list and returns it.
    
    Parameters:
    
    data - the byte array to be converted to a property list
    
    type - type of plist to generate
    
    encoding - the string encoding of the bytes in the stream (ignored for binary plist format)
    
    Returns:
    
    data as a property list
    
    Since:
    
    5.5.3
    
    See Also:
    
    ERXPropertyListSerialization.PListFormat.NSPropertyListJsonFormat_v1_0, ERXPropertyListSerialization.PListFormat.NSPropertyListBinaryFormat_v1_0, ERXPropertyListSerialization.PListFormat.NSPropertyListXMLFormat_v1_0, ERXPropertyListSerialization.PListFormat.NSPropertyListOpenStepFormat
  - booleanForString
```
public static boolean booleanForString(String value)
```
    Parses a given string for boolean value according to the table below.
    
    String Result
    
    "YES" true
    
    "true" true
    
    any other value false
    
    The tests for "YES" and "true" are case insensitive.
    
    Parameters:
    
    value - the string to be parsed for boolean value
    
    Returns:
    
    the parsed boolean value
  - intForString
```
public static int intForString(String value)
```
    Parses a given string and returns the corresponding integer value.
    
    Parameters:
    
    value - the string to be parsed for integer value
    
    Returns:
    
    integer value of string; 0 if it is null
  - arrayWithPathURL
```
public static <E> NSArray<E> arrayWithPathURL(URL url)
```
    Converts a java.net.URL into a property list and returns the resulting property list as an NSArray.
    
    Type Parameters:
    
    E -
    
    Parameters:
    
    url - the java.net.URL to convert to a property list
    
    Returns:
    
    Returns resulting property list as an NSArray
    
    Since:
    
    5.4
    
    See Also:
    
    stringFromPropertyList
  - arrayWithPathURL
```
public static <E> NSArray<E> arrayWithPathURL(URL url,
                                              boolean forceXML)
```
    Converts a java.net.URL into a property list and returns the resulting property list as an NSArray.
    
    Type Parameters:
    
    E -
    
    Parameters:
    
    url - the java.net.URL to convert to a property list
    
    forceXML - force xml decoding
    
    Returns:
    
    Returns resulting property list as an NSArray
    
    Since:
    
    5.4
    
    See Also:
    
    stringFromPropertyList
  - arrayForString
```
public static <E> NSArray<E> arrayForString(String value)
```
    Parses the property list representation string and returns the resulting property list as an NSArray.
    
    Type Parameters:
    
    E -
    
    Parameters:
    
    value - input property list representation string
    
    Returns:
    
    Returns resulting property list as an NSArray
    
    See Also:
    
    dictionaryForString(String)
  - arrayForString
```
public static <E> NSArray<E> arrayForString(String value,
                                            boolean forceXML)
```
    Parses the property list representation string and returns the resulting property list as an NSArray.
    
    Type Parameters:
    
    E -
    
    Parameters:
    
    value - input property list representation string
    
    forceXML - force xml decoding
    
    Returns:
    
    Returns resulting property list as an NSArray
    
    Since:
    
    5.4
    
    See Also:
    
    dictionaryForString(String)
  - arrayForJSONString
```
public static <E> NSArray<E> arrayForJSONString(String value)
```
    Parses the JSON formatted string and returns the resulting property list as an NSArray. NOTE: any JSON 'null' values will be tranlated to a String placeholder value (See ERXPropertyListSerialization.NULL).
    
    Type Parameters:
    
    E -
    
    Parameters:
    
    value - input property list representation string
    
    Returns:
    
    Returns resulting property list as an NSArray
    
    Since:
    
    5.6
    
    See Also:
    
    NULL, dictionaryForJSONString(String)
  - dictionaryWithPathURL
```
public static <K,V> NSDictionary<K,V> dictionaryWithPathURL(URL url)
```
    Converts a java.net.URL into a property list and returns the resulting property list as an NSDictionary.
    
    Type Parameters:
    
    K -
    
    V -
    
    Parameters:
    
    url - the java.net.URL to convert to a property list
    
    Returns:
    
    string as an NSDictionary
    
    Since:
    
    5.4
    
    See Also:
    
    (Object)
  - dictionaryWithPathURL
```
public static <K,V> NSDictionary<K,V> dictionaryWithPathURL(URL url,
                                                            boolean forceXML)
```
    Converts a java.net.URL into a property list and returns the resulting property list as an NSDictionary.
    
    Type Parameters:
    
    K -
    
    V -
    
    Parameters:
    
    url - the java.net.URL to convert to a property list
    
    forceXML - force xml decoding
    
    Returns:
    
    string as an NSDictionary
    
    Since:
    
    5.4
    
    See Also:
    
    (Object, boolean)
  - dictionaryForString
```
public static <K,V> NSDictionary<K,V> dictionaryForString(String value)
```
    Parses the property list representation string and returns the resulting property list as an NSDictionary.
    
    Type Parameters:
    
    K -
    
    V -
    
    Parameters:
    
    value - property list represented as a string
    
    Returns:
    
    string as an NSDictionary
    
    See Also:
    
    arrayForString(String)
  - dictionaryWithBinaryPropertyListPathURL
```
public static <K,V> NSDictionary<K,V> dictionaryWithBinaryPropertyListPathURL(URL url)
```
    Return NSDictionary for a valid plist.
    
    Type Parameters:
    
    K -
    
    V -
    
    Parameters:
    
    url -
    
    Returns:
    
    binary plists dictionary decoded as an NSDictionary or empty dictionary if invalid.
    
    Since:
    
    5.5
  - dictionaryWithBinaryStream
```
public static <K,V> NSDictionary<K,V> dictionaryWithBinaryStream(InputStream is)
```
    Return NSDictionary for a valid plist when passed a binary plist stream.
    
    Type Parameters:
    
    K -
    
    V -
    
    Parameters:
    
    is -
    
    Returns:
    
    binary plists dictionary decoded as an NSDictionary or empty dictionary if invalid.
    
    Since:
    
    5.5.3
  - documentWithBinaryPropertyListURL
```
public static Document documentWithBinaryPropertyListURL(URL url)
```
    Parse binary plist to XML Document
    
    Parameters:
    
    url - the url to read from
    
    Returns:
    
    Document for binary plist
    
    Since:
    
    5.5.3
    
    See Also:
    
    Document
  - arrayForBinaryStream
```
public static NSArray<?> arrayForBinaryStream(InputStream is)
```
    Parameters:
    
    is -
    
    Returns:
    
    NSArray or empty array if null
    
    Since:
    
    5.5.3-SNAPSHOT
  - xmlStringWithBinaryPropertyListURL
```
public static String xmlStringWithBinaryPropertyListURL(URL url)
```
    Parse binary plist to XML Document
    
    Parameters:
    
    url - the url to read from
    
    Returns:
    
    Document for binary plist
    
    Since:
    
    5.5.3
    
    See Also:
    
    Document
  - propertyListWithURL
```
public static Object propertyListWithURL(URL url,
                                         ERXPropertyListSerialization.PListFormat type,
                                         String encoding)
```
    Reads a plist from the given URL using the specified format.
    
    Parameters:
    
    url - the URL to read from
    
    type - type of plist to generate
    
    encoding - the string encoding of the bytes in the stream (ignored for binary plist format)
    
    Since:
    
    5.5.3
    
    See Also:
    
    ERXPropertyListSerialization.PListFormat.NSPropertyListJsonFormat_v1_0, ERXPropertyListSerialization.PListFormat.NSPropertyListBinaryFormat_v1_0, ERXPropertyListSerialization.PListFormat.NSPropertyListXMLFormat_v1_0, ERXPropertyListSerialization.PListFormat.NSPropertyListOpenStepFormat
  - propertyListWithStream
```
public static Object propertyListWithStream(InputStream is,
                                            ERXPropertyListSerialization.PListFormat type,
                                            String encoding)
```
    Reads a plist from the given inputstream using the specified format.
    
    Parameters:
    
    is - the InputStream to read from
    
    type - type of plist to generate
    
    encoding - the string encoding of the bytes in the stream (ignored for binary plist format)
    
    Since:
    
    5.5.3
    
    See Also:
    
    ERXPropertyListSerialization.PListFormat.NSPropertyListJsonFormat_v1_0, ERXPropertyListSerialization.PListFormat.NSPropertyListBinaryFormat_v1_0, ERXPropertyListSerialization.PListFormat.NSPropertyListXMLFormat_v1_0, ERXPropertyListSerialization.PListFormat.NSPropertyListOpenStepFormat
  - propertyListWithData
```
public static Object propertyListWithData(NSData data,
                                          ERXPropertyListSerialization.PListFormat type,
                                          String encoding)
```
    Reads a plist from the given NSData using the specified format.
    
    Parameters:
    
    data - the NSData to read from
    
    type - type of plist to generate
    
    encoding - the string encoding of the bytes in the stream (ignored for binary plist format)
    
    Since:
    
    5.5.3
    
    See Also:
    
    ERXPropertyListSerialization.PListFormat.NSPropertyListJsonFormat_v1_0, ERXPropertyListSerialization.PListFormat.NSPropertyListBinaryFormat_v1_0, ERXPropertyListSerialization.PListFormat.NSPropertyListXMLFormat_v1_0, ERXPropertyListSerialization.PListFormat.NSPropertyListOpenStepFormat
  - writePropertyListToStream
```
public static void writePropertyListToStream(Object plist,
                                             OutputStream out,
                                             ERXPropertyListSerialization.PListFormat type,
                                             String encoding)
```
    For a specified property list format, write a plist to the provided outputstream.
    
    Parameters:
    
    plist - the object to write
    
    out - output stream for plist
    
    type - type of plist to generate
    
    encoding - the string encoding of the bytes in the stream (ignored for binary plist format)
    
    Since:
    
    5.5.3
    
    See Also:
    
    ERXPropertyListSerialization.PListFormat.NSPropertyListJsonFormat_v1_0, ERXPropertyListSerialization.PListFormat.NSPropertyListBinaryFormat_v1_0, ERXPropertyListSerialization.PListFormat.NSPropertyListXMLFormat_v1_0, ERXPropertyListSerialization.PListFormat.NSPropertyListOpenStepFormat
  - dictionaryWithInputStream
```
public static <K,V> NSDictionary<K,V> dictionaryWithInputStream(InputStream is,
                                                                String encoding)
```
    Read a plist from an InputStream and return NSDictionary of values.
    
    Type Parameters:
    
    K -
    
    V -
    
    Parameters:
    
    is - the input stream to read from
    
    encoding - the string encoding of the bytes in the stream (ignored for binary plist format)
    
    Returns:
    
    dictionary or null if there is an error with parsing
    
    Since:
    
    5.5.3
  - dictionaryForString
```
public static <K,V> NSDictionary<K,V> dictionaryForString(String value,
                                                          boolean forceXML)
```
    Parses the property list representation string and returns the resulting property list as an NSDictionary.
    
    Type Parameters:
    
    K -
    
    V -
    
    Parameters:
    
    value - property list represented as a string
    
    forceXML - force xml decoding
    
    Returns:
    
    string as an NSDictionary
    
    Since:
    
    5.4
    
    See Also:
    
    arrayForString(String)
  - dictionaryForJSONString
```
public static <K,V> NSDictionary<K,V> dictionaryForJSONString(String value)
```
    Parses the JSON formatted string and returns the resulting property list as an NSDictionary. NOTE: any JSON 'null' values will be tranlated to a String placeholder value (See ERXPropertyListSerialization.NULL).
    
    Type Parameters:
    
    K -
    
    V -
    
    Parameters:
    
    value - property list represented as a string
    
    Returns:
    
    string as an NSDictionary
    
    Since:
    
    5.5.1
    
    See Also:
    
    NULL, arrayForJSONString(String)

String		Result
`"YES"`		`true`
`"true"`		`true`
any other value		`false`

Class ERXPropertyListSerialization

JSON Serialization Example:

JSON Deserialization Example:

Binary PList Example:

Serialization to an OutputStream:

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

_CLASS

Indents

NoIndents

ForceXML

NULL

DefaultSimpleDateFormatPattern

kCFAbsoluteTimeIntervalSince1970

Constructor Detail

ERXPropertyListSerialization

Method Detail

stringFromPropertyList

stringFromPropertyList

xmlStringFromPropertyList

xmlStringFromPropertyList

propertyListFromString

propertyListFromString

propertyListWithPathURL

propertyListWithPathURL

propertyListFromJSONString

jsonStringFromPropertyList

jsonStringFromPropertyList

dataFromPropertyList

dataFromPropertyList

propertyListFromData

propertyListFromData

booleanForString

intForString

arrayWithPathURL

arrayWithPathURL

arrayForString

arrayForString

arrayForJSONString

dictionaryWithPathURL

dictionaryWithPathURL

dictionaryForString

dictionaryWithBinaryPropertyListPathURL

dictionaryWithBinaryStream

documentWithBinaryPropertyListURL

arrayForBinaryStream

xmlStringWithBinaryPropertyListURL

propertyListWithURL

propertyListWithStream

propertyListWithData

writePropertyListToStream

dictionaryWithInputStream

dictionaryForString

dictionaryForJSONString