org.directwebremoting.convert
Class MapConverter

java.lang.Object
  extended by org.directwebremoting.convert.MapConverter
All Implemented Interfaces:
Converter

public class MapConverter
extends java.lang.Object
implements Converter

An implementation of Converter for Maps.

Version:
$Id: StringConverter.java,v 1.2 2004/11/04 15:54:07 joe_walker Exp $
Author:
Joe Walker [joe at eireneh dot com]

Constructor Summary
MapConverter()
           
 
Method Summary
 java.lang.Object convertInbound(java.lang.Class paramType, InboundVariable iv, InboundContext inctx)
          Attempt to coerce the data from a string to an Object.
 OutboundVariable convertOutbound(java.lang.Object data, OutboundContext outctx)
          Return a javascript string that defines the variable named varName to have the contents of the converted object data.
 void setConverterManager(ConverterManager newConfig)
          If we are a compound converter that farms out part of the conversion to other converters then you farm the conversion out via a configuration.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

MapConverter

public MapConverter()
Method Detail

setConverterManager

public void setConverterManager(ConverterManager newConfig)
Description copied from interface: Converter
If we are a compound converter that farms out part of the conversion to other converters then you farm the conversion out via a configuration.

Specified by:
setConverterManager in interface Converter
Parameters:
newConfig - The confiuration object

convertInbound

public java.lang.Object convertInbound(java.lang.Class paramType,
                                       InboundVariable iv,
                                       InboundContext inctx)
                                throws MarshallException
Description copied from interface: Converter
Attempt to coerce the data from a string to an Object. If anything goes wrong with inbound conversion then we generally throw an exception because we are converting data from the untrusted internet so we take the assumption that anything wrong is someone hacking.

Specified by:
convertInbound in interface Converter
Parameters:
paramType - The type to convert to
iv - The data to convert
inctx - The map of data that we are working on
Returns:
The convered data, or null if the conversion was not possible
Throws:
MarshallException - If the conversion failed for some reason

convertOutbound

public OutboundVariable convertOutbound(java.lang.Object data,
                                        OutboundContext outctx)
                                 throws MarshallException
Description copied from interface: Converter
Return a javascript string that defines the variable named varName to have the contents of the converted object data.

In contrast to convertInbound() failures in converting data on the way out should not stop processing, and we should carry on if we can. Failures are probably down to some misconfiguration so as much information about the error as can be safely generated to console logs is good. In other words if you need to loop in outbound conversion then it might be a good idea to catch issues inside the loop, log, and carry on.

Specified by:
convertOutbound in interface Converter
Parameters:
data - The data to convert
outctx - A collection of objects already converted and the results
Returns:
The OutboundVariable that represents the data to convert
Throws:
MarshallException - If the conversion failed for some reason

Copyright ? 2005