de.danielbechler.diff.introspection

Interface IntrospectionConfigurer

All Known Implementing Classes:

IntrospectionService

public interface IntrospectionConfigurer

Allows to replace the default bean introspector with a custom implementation. The default introspector internally uses the `java.beans.Introspector` which has some limitations. The most important one being that it only operates on getters and setters. In case field introspection is needed a custom introspector must be used. An introspector can be set as global default or on a per-property basis. It is also possible to turn off introspection for specific properties in which case they will simply be compared via `equals` method.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	IntrospectionConfigurer.Of

Method Summary

Modifier and Type	Method and Description
ObjectDifferBuilder	and()
IntrospectionConfigurer	handlePropertyAccessExceptionsUsing(PropertyAccessExceptionHandler exceptionHandler)
IntrospectionConfigurer.Of	ofNode(NodePath path)
IntrospectionConfigurer.Of	ofType(java.lang.Class<?> type)
IntrospectionConfigurer	setDefaultIntrospector(Introspector introspector)
IntrospectionConfigurer	setInstanceFactory(InstanceFactory instanceFactory) When assigning new values via DiffNode (e.g.

Method Detail

setInstanceFactory

IntrospectionConfigurer setInstanceFactory(InstanceFactory instanceFactory)

When assigning new values via DiffNode (e.g. during merging) it will implicitly create missing instances of its parent objects along the path to the root object. By default those instances will be created via public non-arg constructor. If that fails a TypeInstantiationException will be thrown.

To add support for types that need to be instantiated differently you can overide the default behavior via custom InstanceFactory. When doing so, don't worry about types actually that are suitable for the default behavior, as it will automatically kick in, whenever the custom factroy returns null.

Parameters:

instanceFactory - A custom instance factory

Throws:

java.lang.IllegalArgumentException - when the instanceFactory is null

setDefaultIntrospector

IntrospectionConfigurer setDefaultIntrospector(Introspector introspector)

handlePropertyAccessExceptionsUsing

IntrospectionConfigurer handlePropertyAccessExceptionsUsing(PropertyAccessExceptionHandler exceptionHandler)

ofType

IntrospectionConfigurer.Of ofType(java.lang.Class<?> type)

ofNode

IntrospectionConfigurer.Of ofNode(NodePath path)

and

ObjectDifferBuilder and()