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
  • 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