org.jibx.binding.def
Class PrimitiveStringConversion

java.lang.Object
  org.jibx.binding.def.StringConversion
      org.jibx.binding.def.PrimitiveStringConversion

public class PrimitiveStringConversion
extends StringConversion

Primitive string conversion handling. Class for handling serialization converting a primitive type to and from String values.

Author:

Dennis M. Sosnoski

Field Summary

Fields inherited from class org.jibx.binding.def.StringConversion

COMPARE_OBJECTS_METHOD, COMPARE_OBJECTS_SIGNATURE, DESERIALIZER_SIGNATURES, m_converter, m_default, m_deserializer, m_serializer, m_typeName, m_typeSignature, MARSHAL_ATTRIBUTE, MARSHAL_ELEMENT, MARSHAL_NAME_VALUES, MARSHAL_SIGNATURE, UNMARSHAL_OPT_ATTRIBUTE, UNMARSHAL_OPT_ELEMENT, UNMARSHAL_OPT_SIGNATURE, UNMARSHAL_REQ_ATTRIBUTE, UNMARSHAL_REQ_ELEMENT, UNMARSHAL_REQ_SIGNATURE, WHITESPACE_CONVERT_SIGNATURES

Constructor Summary

	PrimitiveStringConversion(Class cls, Object dflt, String code, String ts, String fs, String uattr, String uelem) Constructor.
protected	PrimitiveStringConversion(String type, PrimitiveStringConversion inherit) Constructor.

Method Summary

protected Object	convertDefault(String text) Convert text representation into default value object.
StringConversion	derive(String type, String ser, String conv, String dser, String dflt) Derive from existing formatting information.
void	genFromText(ContextMethodBuilder mb) Generate code to convert String representation.
void	genParseOptional(boolean attr, ContextMethodBuilder mb) Generate code to parse and convert optional attribute or element.
void	genParseRequired(boolean attr, ContextMethodBuilder mb) Generate code to parse and convert required attribute or element.
protected BranchWrapper	genToOptionalText(String type, ContextMethodBuilder mb, int extra) Generate code to check if an optional value is not equal to the default.
boolean	isPrimitive() Check if the type handled by this conversion is of a primitive type.
protected void	pushDefault(ContextMethodBuilder mb) Push default value on stack.
protected void	setDeserializer(String deser) Set deserializer for conversion.
protected void	setSerializer(String ser) Set serializer for conversion.
protected void	setWhitespaceConverter(String wsconv) Set whitespace converter for conversion.

Methods inherited from class org.jibx.binding.def.StringConversion

genPopValues, genToText, genWriteOptional, genWriteRequired, genWriteText, getTypeName, setSerializer

Methods inherited from class java.lang.Object

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

Constructor Detail

PrimitiveStringConversion

protected PrimitiveStringConversion(String type,
                                    PrimitiveStringConversion inherit)

Constructor. Initializes conversion handling based on the supplied inherited handling.

Parameters:

type - name of primitive type handled by conversion

inherit - conversion information inherited by this conversion

PrimitiveStringConversion

public PrimitiveStringConversion(Class cls,
                                 Object dflt,
                                 String code,
                                 String ts,
                                 String fs,
                                 String uattr,
                                 String uelem)

Constructor. Initializes conversion handling based on argument values. This form is only used for constructing the default set of conversions.

Parameters:

cls - class of primitive type handled by conversion

dflt - default value object (wrapped value, or String or null with special deserializer)

code - primitive type code

ts - name of utility class static method for converting value to String

fs - name of utility class static method for converting String to value

uattr - unmarshalling context method name for attribute value

uelem - unmarshalling context method name for element value

Method Detail

genFromText

public void genFromText(ContextMethodBuilder mb)

Generate code to convert String representation. The code generated by this method assumes that the String value has already been pushed on the stack. It consumes this and leaves the converted value on the stack.

Specified by:

genFromText in class StringConversion

Parameters:

mb - method builder

pushDefault

protected void pushDefault(ContextMethodBuilder mb)

Push default value on stack. Just adds the appropriate instruction to the list for the method.

Parameters:

mb - method builder

genParseOptional

public void genParseOptional(boolean attr,
                             ContextMethodBuilder mb)
                      throws JiBXException

Generate code to parse and convert optional attribute or element. The code generated by this method assumes that the unmarshalling context and name information for the attribute or element have already been pushed on the stack. It consumes these and leaves the converted value (or default value, if the item itself is missing) on the stack.

Specified by:

genParseOptional in class StringConversion

Parameters:

attr - item is an attribute (vs element) flag

mb - method builder

Throws:

JiBXException - if error in configuration

genParseRequired

public void genParseRequired(boolean attr,
                             ContextMethodBuilder mb)
                      throws JiBXException

Generate code to parse and convert required attribute or element. The code generated by this method assumes that the unmarshalling context and name information for the attribute or element have already been pushed on the stack. It consumes these and leaves the converted value on the stack.

Specified by:

genParseRequired in class StringConversion

Parameters:

attr - item is an attribute (vs element) flag

mb - method builder

Throws:

JiBXException - if error in configuration

genToOptionalText

protected BranchWrapper genToOptionalText(String type,
                                          ContextMethodBuilder mb,
                                          int extra)
                                   throws JiBXException

Generate code to check if an optional value is not equal to the default. The code generated by this method assumes that the actual value to be converted has already been pushed on the stack. It consumes this, leaving the converted text reference on the stack if it's not equal to the default value.

Specified by:

genToOptionalText in class StringConversion

Parameters:

type - fully qualified class name for value on stack

mb - method builder

extra - count of extra values to be popped from stack if missing

Returns:

handle for branch taken when value is equal to the default (target must be set by caller)

Throws:

JiBXException - if error in configuration

convertDefault

protected Object convertDefault(String text)
                         throws JiBXException

Convert text representation into default value object. This override of the base class method uses reflection to call the actual deserialization method, returning the wrapped result value. If a custom deserializer is defined this just returns the String value directly.

Specified by:

convertDefault in class StringConversion

Parameters:

text - value representation to be converted

Returns:

converted default value object

Throws:

JiBXException - on conversion error

isPrimitive

public boolean isPrimitive()

Check if the type handled by this conversion is of a primitive type.

Specified by:

isPrimitive in class StringConversion

Returns:

true to indicate primitive type

setSerializer

protected void setSerializer(String ser)
                      throws JiBXException

Set serializer for conversion. This override of the base class method sets a flag to indicate that values must be converted to text before they are written to a document after executing the base class processing.

Parameters:

ser - fully qualified class and method name of serializer

Throws:

JiBXException - if serializer not found or not usable

setWhitespaceConverter

protected void setWhitespaceConverter(String wsconv)
                               throws JiBXException

Set whitespace converter for conversion. This override of the base class method sets a flag to indicate that values must be read from a document as text and converted as a separate step after executing the base class processing.

Overrides:

setWhitespaceConverter in class StringConversion

Parameters:

wsconv - fully qualified class and method name of whitespace converter

Throws:

JiBXException - if whitespace converter not found or not usable

setDeserializer

protected void setDeserializer(String deser)
                        throws JiBXException

Set deserializer for conversion. This override of the base class method sets a flag to indicate that values must be read from a document as text and converted as a separate step after executing the base class processing.

Overrides:

setDeserializer in class StringConversion

Parameters:

deser - fully qualified class and method name of deserializer

Throws:

JiBXException - if deserializer not found or not usable

derive

public StringConversion derive(String type,
                               String ser,
                               String conv,
                               String dser,
                               String dflt)
                        throws JiBXException

Derive from existing formatting information. This allows constructing a new instance from an existing format of the same or an ancestor type, with the properties of the existing format copied to the new instance except where overridden by the supplied values.

Specified by:

derive in class StringConversion

Parameters:

type - fully qualified name of class handled by conversion (null if inherited)

ser - fully qualified name of serialization method (null if inherited)

conv - fully qualified name of whitespace conversion method (null if inherited)

dser - fully qualified name of deserialization method (null if inherited)

dflt - default value text (null if inherited)

Returns:

new instance initialized from existing one

Throws:

JiBXException - if error in configuration information