Package org.apache.juneau.objecttools

Class ObjectMerger

java.lang.Object

org.apache.juneau.objecttools.ObjectMerger

public class ObjectMerger
extends Object

POJO merger.

Useful in cases where you want to define beans with 'default' values.

For example, given the following bean classes...

public interface IA { String getX(); void setX(String x); } public class A implements IA { private String x; public A(String x) { this.x = x; } public String getX() { return x; } public void setX(String x) { this.x = x; } }

The getters will be called in order until the first non-null value is returned...

merge = ObjectMerger.merger(IA.class, new A("1"), new A("2")); assertEquals("1", merge.getX()); merge = ObjectMerger.merger(IA.class, new A(null), new A("2")); assertEquals("2", merge.getX()); merge = ObjectMerger.merger(IA.class, new A(null), new A(null)); assertEquals(null, merge.getX());

Notes:

• Null POJOs are ignored.
• Non-getter methods are either invoked on the first POJO or all POJOs depending on the callAllNonGetters flag passed into the constructor.
• For purposes of this interface, a getter is any method with zero arguments and a non-void return type.

See Also:

Constructor Summary

Constructors

Constructor	Description
ObjectMerger()

Method Summary

Modifier and Type	Method	Description
static <T> T	merge(Class<T> interfaceClass, boolean callAllNonGetters, T... pojos)	Create a proxy interface on top of zero or more POJOs.
static <T> T	merge(Class<T> interfaceClass, T... pojos)	Create a proxy interface on top of zero or more POJOs.

Methods inherited from class java.lang.Object

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

Constructor Details

ObjectMerger

public ObjectMerger()

Method Details

merge

public static <T> T merge(Class<T> interfaceClass,
 T... pojos)

Create a proxy interface on top of zero or more POJOs.

This is a shortcut to calling merge(interfaceClass, false, pojos);

Type Parameters:

T - The pojo types.

Parameters:

interfaceClass - The common interface class.

pojos - Zero or more POJOs to merge.
Can contain nulls.

Returns:

A proxy interface over the merged POJOs.

merge

public static <T> T merge(Class<T> interfaceClass,
 boolean callAllNonGetters,
 T... pojos)

Create a proxy interface on top of zero or more POJOs.

Type Parameters:

T - The pojo types.

Parameters:

interfaceClass - The common interface class.

callAllNonGetters - If true, when calling a method that's not a getter, the method will be invoked on all POJOs.
Otherwise, the method will only be called on the first POJO.

pojos - Zero or more POJOs to merge.
Can contain nulls.

Returns:

A proxy interface over the merged POJOs.