net.sf.practicalxml.converter.internal

Class JavaStringConversions

java.lang.Object

net.sf.practicalxml.converter.internal.JavaStringConversions

public class JavaStringConversions
extends Object

Handles conversion of objects that have a simple string representation. This includes primitives, and primitive wrappers, but also some complex types such as java.lang.Class and java.io.File.

A single instance of this object will be associated with each converter.

Constructor Summary

Constructors

Constructor and Description
JavaStringConversions(boolean useXsdFormat)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	isConvertableToString(Class<?> klass) Determines whether the objects of the specified class have a simple string representation.
boolean	isConvertableToString(Object obj) Determines whether the passed object has a simple string representation.
Object	parse(String value, Class<?> klass) Parses the passed string as a Java primitive object of the specified type.
String	stringify(Object value) Converts a Java primitive object to a string representation.

Methods inherited from class java.lang.Object

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

Constructor Detail

JavaStringConversions

public JavaStringConversions(boolean useXsdFormat)

Parameters:

useXsdFormat - If true, conversions will use the format defined in the XML Schema specification (if any). If false, or there is no specification, will use toString() for stringification, and parse appropriately.

Method Detail

isConvertableToString

public boolean isConvertableToString(Object obj)

Determines whether the passed object has a simple string representation.

isConvertableToString

public boolean isConvertableToString(Class<?> klass)

Determines whether the objects of the specified class have a simple string representation.

stringify

public String stringify(Object value)

Converts a Java primitive object to a string representation. Returns null if passed null.

Parameters:

value - The object to convert.

Throws:

ConversionException - if the passed object does not have a string representation (ie, is not a primitive value).

parse

public Object parse(String value,
           Class<?> klass)

Parses the passed string as a Java primitive object of the specified type. Will attempt to use the built-in parsing functions for the type, or a format defined by XML Schema for the type that would be returned by TypeUtils.class2type(java.lang.Class<?>) for the passed class. Returns null if passed null.

Parameters:

value - String representation.

klass - Desired class for resulting object.

Throws:

ConversionException - if unable to parse.