Class FilePersistenceStrategy

java.lang.Object

com.thoughtworks.xstream.persistence.AbstractFilePersistenceStrategy

com.thoughtworks.xstream.persistence.FilePersistenceStrategy

All Implemented Interfaces:

PersistenceStrategy

public class FilePersistenceStrategy
extends AbstractFilePersistenceStrategy

PersistenceStrategy to assign keys with single value to objects persisted in files. The default naming strategy is based on the key's type and its SingleValueConverter. It escapes all characters that are normally illegal in the most common file systems. Such a character is escaped with percent escaping as it is done by URL encoding. The XStream used to marshal the values is also requested for the key's SingleValueConverter. A ConversionException is thrown if no such converter is registered.

Since:

1.3.1

Nested Class Summary

Nested classes/interfaces inherited from class AbstractFilePersistenceStrategy

AbstractFilePersistenceStrategy.ValidFilenameFilter, AbstractFilePersistenceStrategy.XmlMapEntriesIterator

Field Summary

Fields

Modifier and Type	Field	Description
private final String	illegalChars

Constructor Summary

Constructors

Constructor	Description
FilePersistenceStrategy(File baseDirectory)	Create a new FilePersistenceStrategy.
FilePersistenceStrategy(File baseDirectory, XStream xstream)	Create a new FilePersistenceStrategy with a provided XStream instance.
FilePersistenceStrategy(File baseDirectory, XStream xstream, String encoding, String illegalChars)	Create a new FilePersistenceStrategy with a provided XStream instance and the characters to encode.

Method Summary

Modifier and Type	Method	Description
protected String	escape(String key)
protected Object	extractKey(String name)	Given a filename, the unescape method returns the key which originated it.
protected String	getName(Object key)	Given a key, the escape method returns the filename which shall be used.
protected boolean	isValid(File dir, String name)
protected String	unescape(String name)

Methods inherited from class AbstractFilePersistenceStrategy

containsKey, get, getConverterLookup, getMapper, iterator, put, remove, size

Methods inherited from class Object

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

Field Details

illegalChars

private final String illegalChars

Constructor Details

FilePersistenceStrategy

public FilePersistenceStrategy(File baseDirectory)

Create a new FilePersistenceStrategy. Use a standard XStream instance with a DomDriver.

Parameters:

baseDirectory - the directory for the serialized values

Since:

1.3.1

FilePersistenceStrategy

public FilePersistenceStrategy(File baseDirectory,
 XStream xstream)

Create a new FilePersistenceStrategy with a provided XStream instance.

Parameters:

baseDirectory - the directory for the serialized values

xstream - the XStream instance to use for (de)serialization

Since:

1.3.1

FilePersistenceStrategy

public FilePersistenceStrategy(File baseDirectory,
 XStream xstream,
 String encoding,
 String illegalChars)

Create a new FilePersistenceStrategy with a provided XStream instance and the characters to encode.

Parameters:

baseDirectory - the directory for the serialized values

xstream - the XStream instance to use for (de)serialization

encoding - encoding used to write the files

illegalChars - illegal characters for file names (should always include '%' as long as you do not overwrite the (un)escape methods)

Since:

1.3.1

Method Details

isValid

protected boolean isValid(File dir,
 String name)

Overrides:

isValid in class AbstractFilePersistenceStrategy

extractKey

protected Object extractKey(String name)

Given a filename, the unescape method returns the key which originated it.

Specified by:

extractKey in class AbstractFilePersistenceStrategy

Parameters:

name - the filename

Returns:

the original key

unescape

protected String unescape(String name)

getName

protected String getName(Object key)

Given a key, the escape method returns the filename which shall be used.

Specified by:

getName in class AbstractFilePersistenceStrategy

Parameters:

key - the key

Returns:

the desired and escaped filename

escape

protected String escape(String key)