com.mortbay.Util
Class PropertyTreeConverter
java.lang.Object
|
+--com.mortbay.Util.ConverterBase
|
+--com.mortbay.Util.PropertyTreeConverter
- public class PropertyTreeConverter
- extends ConverterBase
Class to convert Objects into PropertyTrees.
This class is a Converter that handles converting of arbitrary
Objects into PropertyTrees. This will work well with objects that have
public fields or have well-formed get/set pairs enabling their
deconstruction/reconstruction. The resultant PropertyTree can then be
output to a file and re-read in then converted back to an Object using the
ObjectConverter.
The conversion continues recursively until object are resolved down to
primitive types.
(@see com.mortbay.Util.ConverterSet.PrimitiveConverter).
Note
Note that since this Converter handles ALL types, if asked to convert
to a PropertyTree, it will convert everything it is given. Arrays don't
convert too well, unless they are arrays of primitive types.
Usage
Converter cnv = new PropertyTreeConverter();
cnv.convert(object, PropertyTree.class, cnv);
- Version:
- 1.0 Fri Jun 9 2000
- Author:
- Matthew Watson (mattw)
Method Summary |
protected java.lang.Object |
doConvert(java.lang.Object toConvert,
java.lang.Class convertTo,
Converter context,
boolean safe)
Convert an Object to another type. |
protected java.lang.Object |
doConvert(PropertyTree to,
java.lang.String prefix,
java.lang.Object toConvert)
|
Methods inherited from class java.lang.Object |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait |
PropertyTreeConverter
public PropertyTreeConverter()
doConvert
protected java.lang.Object doConvert(java.lang.Object toConvert,
java.lang.Class convertTo,
Converter context,
boolean safe)
- Description copied from class: ConverterBase
- Convert an Object to another type.
- Overrides:
- doConvert in class ConverterBase
- Tags copied from class: ConverterBase
- Parameters:
toConvert
- Value to convertconvertTo
- Type to convert tocontext
- The context within which the converter was called.
If Converters use other Converters, this is passed as
the outermost Converter so that recursive calls have
access to all available Converters. Converter
implementations should pass this if passed null.safe
- If false, errors should be returned.- Returns:
- null if this converter doesn't handle this type to convertTo,
or a ConvertFail exception if there was an error and safe is false.
doConvert
protected java.lang.Object doConvert(PropertyTree to,
java.lang.String prefix,
java.lang.Object toConvert)