org.unitils.reflectionassert
Class ReflectionComparatorFactory

java.lang.Object
  org.unitils.reflectionassert.ReflectionComparatorFactory

public class ReflectionComparatorFactory
extends Object

A factory for creating a reflection comparator. This will assemble the apropriate comparator chain and constructs a reflection comparator.

By default, a strict comparison is performed, but if needed, some leniency can be configured by setting one or more comparator modes:

• ignore defaults: all fields that have a default java value for the left object will be ignored. Eg if the left object contains an int field with value 0 it will not be compared to the value of the right object.
• lenient dates: only check whether both Date objects contain a value or not, the value itself is not compared. Eg. if the left object contained a date with value 1-1-2006 and the right object contained a date with value 2-2-2006 they would still be considered equal.
• lenient order: only check whether both collections or arrays contain the same value, the actual order of the values is not compared. Eg. if the left object is int[]{ 1, 2} and the right value is int[]{2, 1} they would still be considered equal.

  Author:

  Tim Ducheyne, Filip Neven

  Field Summary

  protected static Comparator	COLLECTION_COMPARATOR The CollectionComparator singleton insance
  protected static Comparator	HIBERNATE_PROXY_COMPARATOR The HibernateProxyComparator singleton insance
  protected static Comparator	IGNORE_DEFAULTS_COMPARATOR The IgnoreDefaultsComparator singleton insance
  protected static Comparator	LENIENT_DATES_COMPARATOR The LenientDatesComparator singleton insance
  protected static Comparator	LENIENT_NUMBER_COMPARATOR The LenientNumberComparator singleton insance
  protected static Comparator	LENIENT_ORDER_COMPARATOR The LenientOrderCollectionComparator singleton insance
  protected static Comparator	MAP_COMPARATOR The MapComparator singleton insance
  protected static Comparator	OBJECT_COMPARATOR The ObjectComparator singleton insance
  protected static Comparator	SIMPLE_CASES_COMPARATOR The SimpleCasesComparatorsingleton insance

  Constructor Summary

  ReflectionComparatorFactory()
  

  Method Summary

  static ReflectionComparator	createRefectionComparator(ReflectionComparatorMode... modes) Creates a reflection comparator for the given modes.
  protected static List<Comparator>	getComparatorChain(Set<ReflectionComparatorMode> modes) Creates a comparator chain for the given modes.

  Methods inherited from class java.lang.Object

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

  Field Detail

  LENIENT_DATES_COMPARATOR

  protected static final Comparator LENIENT_DATES_COMPARATOR

  The LenientDatesComparator singleton insance

  IGNORE_DEFAULTS_COMPARATOR

  protected static final Comparator IGNORE_DEFAULTS_COMPARATOR

  The IgnoreDefaultsComparator singleton insance

  LENIENT_NUMBER_COMPARATOR

  protected static final Comparator LENIENT_NUMBER_COMPARATOR

  The LenientNumberComparator singleton insance

  SIMPLE_CASES_COMPARATOR

  protected static final Comparator SIMPLE_CASES_COMPARATOR

  The SimpleCasesComparatorsingleton insance

  LENIENT_ORDER_COMPARATOR

  protected static final Comparator LENIENT_ORDER_COMPARATOR

  The LenientOrderCollectionComparator singleton insance

  COLLECTION_COMPARATOR

  protected static final Comparator COLLECTION_COMPARATOR

  The CollectionComparator singleton insance

  MAP_COMPARATOR

  protected static final Comparator MAP_COMPARATOR

  The MapComparator singleton insance

  HIBERNATE_PROXY_COMPARATOR

  protected static final Comparator HIBERNATE_PROXY_COMPARATOR

  The HibernateProxyComparator singleton insance

  OBJECT_COMPARATOR

  protected static final Comparator OBJECT_COMPARATOR

  The ObjectComparator singleton insance

  Constructor Detail

  ReflectionComparatorFactory

  public ReflectionComparatorFactory()

  Method Detail

  createRefectionComparator

  public static ReflectionComparator createRefectionComparator(ReflectionComparatorMode... modes)

  Creates a reflection comparator for the given modes. If no mode is given, a strict comparator will be created.

  Parameters:

  modes - The modes, null for strict comparison

  Returns:

  The reflection comparator, not null

  getComparatorChain

  protected static List<Comparator> getComparatorChain(Set<ReflectionComparatorMode> modes)

  Creates a comparator chain for the given modes. If no mode is given, a strict comparator will be created.

  Parameters:

  modes - The modes, null for strict comparison

  Returns:

  The comparator chain, not null