jadex.commons.transformation.traverser

Class Traverser

java.lang.Object

jadex.commons.transformation.traverser.Traverser

public class Traverser
extends Object

The traverser allows to traverse an object graph deeply. Traversal processors can be used to perform specific actions on traversed object, e.g. object modifications. Does currently not allow transforming objects to other objects of another type (replacements), because objects have to be saved in the graph itself (no extra table for exchanged objects). The traverser can be used as a cloner when processors always return copies of the original objects. todo: introduce classloaders to allows for creating objects with other classloaders (e.g. convert a parameter from a sender to a receiver resource id).

Constructor Summary

Constructors

Constructor and Description
Traverser()

Method Summary

Methods

Modifier and Type	Method and Description
static List<ITraverseProcessor>	getDefaultProcessors() Get the default traversal processors.
static Traverser	getInstance() Get the default cloner instance.
void	handleDuplicate(Object object, Class<?> clazz, Object match, List<ITraverseProcessor> processors, boolean clone, Object context) Special handling for duplicate objects.
Object	handleNull(Class<?> clazz, List<ITraverseProcessor> processors, boolean clone, Object context) Special handling for null objects.
Object	traverse(Object object, Class<?> clazz, Map<Object,Object> traversed, List<ITraverseProcessor> processors, boolean clone, ClassLoader targetcl, Object context) Traverse an object.
static Object	traverseObject(Object object, List<ITraverseProcessor> processors, boolean clone, ClassLoader targetcl, Object context) Traverse an object.
static Object	traverseObject(Object object, List<ITraverseProcessor> processors, boolean clone, Object context) Traverse an object.

Methods inherited from class java.lang.Object

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

Constructor Detail

Traverser

public Traverser()

Method Detail

getDefaultProcessors

public static List<ITraverseProcessor> getDefaultProcessors()

Get the default traversal processors.

Returns:

The traversal processors.

getInstance

public static Traverser getInstance()

Get the default cloner instance.

traverseObject

public static Object traverseObject(Object object,
                    List<ITraverseProcessor> processors,
                    boolean clone,
                    Object context)

Traverse an object.

Parameters:

object - The object to traverse.

processors - The lists of processors.

Returns:

The traversed (or modified) object.

traverseObject

public static Object traverseObject(Object object,
                    List<ITraverseProcessor> processors,
                    boolean clone,
                    ClassLoader targetcl,
                    Object context)

Traverse an object.

Parameters:

object - The object to traverse.

processors - The lists of processors.

targetcl - If not null, the traverser should make sure that the result object is compatible with the class loader, e.g. by cloning the object using the class loaded from the target class loader.

Returns:

The traversed (or modified) object.

traverse

public Object traverse(Object object,
              Class<?> clazz,
              Map<Object,Object> traversed,
              List<ITraverseProcessor> processors,
              boolean clone,
              ClassLoader targetcl,
              Object context)

Traverse an object.

Parameters:

object - The object.

targetcl - If not null, the traverser should make sure that the result object is compatible with the class loader, e.g. by cloning the object using the class loaded from the target class loader.

Returns:

The processed object.

handleDuplicate

public void handleDuplicate(Object object,
                   Class<?> clazz,
                   Object match,
                   List<ITraverseProcessor> processors,
                   boolean clone,
                   Object context)

Special handling for duplicate objects.

handleNull

public Object handleNull(Class<?> clazz,
                List<ITraverseProcessor> processors,
                boolean clone,
                Object context)

Special handling for null objects.