net.sf.plist.io

Class PropertyListWriter

java.lang.Object

net.sf.plist.io.PropertyListWriter

Direct Known Subclasses:

BinaryWriter, DOMXMLWriter

public abstract class PropertyListWriter
extends java.lang.Object

Serializes a tree consisting of NSObjects to a property list.

Field Summary

Fields

Modifier and Type	Field and Description
static PropertyListFormat	DEFAULTFORMAT The default format used when write(NSObject, File) is called.

Constructor Summary

Constructors

Constructor and Description
PropertyListWriter(NSObject root) Construct a new PropertyListWriter

Method Summary

Methods

Modifier and Type	Method and Description
static void	write(NSObject root, java.io.File file) Convert a tree to a property list and write it to a stream
static void	write(NSObject root, java.io.File file, PropertyListFormat format) Convert a tree to a property list and write it to a file
static void	write(NSObject root, java.io.OutputStream stream, PropertyListFormat format) Convert a tree to a property list and write it to a stream
abstract void	write(java.io.OutputStream stream) Write the property list to a stream

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULTFORMAT

public static PropertyListFormat DEFAULTFORMAT

The default format used when write(NSObject, File) is called. This usually is PropertyListFormat.BINARY on Mac OS X or PropertyListFormat.XML on other operating systems, but might differ since this field is not final. If you need a specific format you should not rely on the contents of this field to stay the same. Instead you should specify the format as an argument in the write(NSObject, File, PropertyListFormat) method. If you do not need a specific format then it is safe to use the write(OutputStream) method without PropertyListFormat argument.

Constructor Detail

PropertyListWriter

public PropertyListWriter(NSObject root)

Construct a new PropertyListWriter

Parameters:

root - the root of the tree

Method Detail

write

public abstract void write(java.io.OutputStream stream)
                    throws PropertyListException,
                           java.io.IOException

Write the property list to a stream

Parameters:

stream - the stream to write the property list to

Throws:

PropertyListException - when generating the property list fails

java.io.IOException - when writing to the stream fails

write

public static void write(NSObject root,
         java.io.OutputStream stream,
         PropertyListFormat format)
                  throws PropertyListException,
                         java.io.IOException

Convert a tree to a property list and write it to a stream

Parameters:

root - the root of the tree

stream - the stream to write the property list to

format - the format to use when writing

Throws:

PropertyListException - when generating the property list fails

ParserConfigurationException - when unable to create an XML document

java.io.IOException - when writing to the stream fails

write

public static void write(NSObject root,
         java.io.File file)
                  throws PropertyListException,
                         java.io.IOException

Convert a tree to a property list and write it to a stream

Throws:

PropertyListException

java.io.IOException

See Also:

write(NSObject, OutputStream, PropertyListFormat)

write

public static void write(NSObject root,
         java.io.File file,
         PropertyListFormat format)
                  throws PropertyListException,
                         java.io.IOException

Convert a tree to a property list and write it to a file

Parameters:

root - the root of the tree

file - the file to write to

format - the format to use when writing

Throws:

PropertyListException - when generating the property list fails

ParserConfigurationException - when unable to create an XML document

java.io.IOException - when writing to the stream fails