Class StringConverter

java.lang.Object
com.thoughtworks.xstream.converters.basic.AbstractSingleValueConverter
com.thoughtworks.xstream.converters.basic.StringConverter
All Implemented Interfaces:
ConverterMatcher, SingleValueConverter
public class StringConverter extends AbstractSingleValueConverter
Converts a String to a String ;).

Well ok, it doesn't actually do any conversion. The converter uses by default a map with weak references to reuse instances of strings that do not exceed a length limit. This limit is by default 38 characters to cache typical strings containing UUIDs. Only shorter strings are typically repeated more often in XML values.

Author:
Joe Walnes, Rene Schwietzke, Jörg Schaible

  • Constructor Details

    • StringConverter

      public StringConverter(Map map, int lengthLimit)
      Construct a StringConverter using a map-based cache for strings not exceeding the length limit.
      Parameters:
      map - the map to use for the instances to reuse (may be null to not cache at all)
      lengthLimit - maximum string length of a cached string, -1 to cache all, 0 to turn off the cache
      Since:
      1.4.2

    • StringConverter

      public StringConverter(Map map)
      Construct a StringConverter using a map-based cache for strings not exceeding 38 characters.
      Parameters:
      map - the map to use for the instances to reuse (may be null to not cache at all)

    • StringConverter

      public StringConverter(int lengthLimit)
      Construct a StringConverter using a cache with weak references for strings not exceeding the length limit.
      Parameters:
      lengthLimit - maximum string length of a cached string, -1 to cache all, 0 to turn off the cache
      Since:
      1.4.2

    • StringConverter

      public StringConverter()
      Construct a StringConverter using a cache with weak references for strings not exceeding 38 characters.

  • Method Details