oracle.javatools.db.diff

Class DifferenceApplier

java.lang.Object

oracle.javatools.db.diff.DifferenceApplier

public class DifferenceApplier
extends java.lang.Object

Class that can apply the Difference of two objects recursively. The class assumes that "generic diffing" has happened. As with all the property support, the types of property supported are:

• ToStringManager compatible
• Java Bean
• an Array of either of the above
• java.util.Map

See Also:

GenericBeanDiffer

Constructor Summary

Constructors

Constructor and Description
DifferenceApplier(DBObjectProvider pro) Creates a DifferenceApplier that will apply differences in a ResultSet from b() to a().
DifferenceApplier(DBObjectProvider pro, boolean applyToB) Creates a DifferenceApplier specfiying which way to apply differences.

Method Summary

Methods

Modifier and Type	Method and Description
void	apply(Difference rs) Applys changes in the direction specified when this applier was constructed.
void	apply(SystemObject original, SystemObject updated) Applys changes in the direction specified when this applier was constructed.
DBObjectChange[]	fireEvents() Deprecated.
static DBObjectChange	fireLazyChangeEvent(SystemObject obj, SystemObject copyOfOriginal, DBObjectProvider pro) Creates and fires a DBObjectChange event for the given object.
SystemObject	getCopyOfOrigWithDiffApplied(Difference diff) Gets a new temporary copy of the original object in the given difference and applys all the changes in the difference to that object.
java.lang.Iterable<DBObjectChange>	getEvents() Gets the change events that the applied Differences have produced.

Methods inherited from class java.lang.Object

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

Constructor Detail

DifferenceApplier

public DifferenceApplier(DBObjectProvider pro)

Creates a DifferenceApplier that will apply differences in a ResultSet from b() to a().

DifferenceApplier

public DifferenceApplier(DBObjectProvider pro,
                 boolean applyToB)

Creates a DifferenceApplier specfiying which way to apply differences.

Parameters:

applyToB - if true, differences in a() will be applied to b(), otherwise b() is considered to hold the updates which will be applied to a().

Method Detail

apply

public final void apply(SystemObject original,
         SystemObject updated)

Applys changes in the direction specified when this applier was constructed. By default this means that changes in the "updated" object are applied to the "original" object.

apply

public final void apply(Difference rs)

Applys changes in the direction specified when this applier was constructed. By default this means that changes in the "updated" object are applied to the "original" object in the Difference.

getCopyOfOrigWithDiffApplied

public SystemObject getCopyOfOrigWithDiffApplied(Difference diff)

Gets a new temporary copy of the original object in the given difference and applys all the changes in the difference to that object. The Difference passed in must be a diff of two compatible SystemObjects or this will throw an Exception.

Note it is unlikely that you would want to call this method with an unfiltered Difference as it would be a waste of time.

fireEvents

@Deprecated
public DBObjectChange[] fireEvents()

Deprecated.

Events on the underlying DBObject are fired automatically when the properties are set. Call getEvents() to get a summary of the changes.

getEvents

public java.lang.Iterable<DBObjectChange> getEvents()

Gets the change events that the applied Differences have produced.

fireLazyChangeEvent

public static DBObjectChange fireLazyChangeEvent(SystemObject obj,
                                 SystemObject copyOfOriginal,
                                 DBObjectProvider pro)

Creates and fires a DBObjectChange event for the given object. A copy of its original state is given, on the understanding that the object itself is currently in an unbuilt state (having been "reset" as the result of an update or timestamp change). The event will lazily load the object if a diff is required.

Parameters:

obj - the object to fire the event on

updateCopy - a copy of the last know state of the object.