Package org.apache.jackrabbit.oak.spi.commit

Class CompositeConflictHandler

java.lang.Object

org.apache.jackrabbit.oak.spi.commit.CompositeConflictHandler

All Implemented Interfaces:

ThreeWayConflictHandler

public class CompositeConflictHandler
extends Object
implements ThreeWayConflictHandler

A CompositeConflictHandler delegates conflict handling to multiple backing handlers. The backing handlers are invoked in the inverse order they have been installed until a handler returning a valid resolution (i.e. not IGNORED) is found. If for a certain conflict none of the backing handlers returns a valid resolution this implementation throws an IllegalStateException.

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.jackrabbit.oak.spi.commit.ThreeWayConflictHandler

ThreeWayConflictHandler.Resolution

Constructor Summary

Constructors

Constructor	Description
CompositeConflictHandler()	Create a new CompositeConflictHandler with no backing handlers.
CompositeConflictHandler(@NotNull Iterable<ThreeWayConflictHandler> handlers)	Create a new CompositeConflictHandler with an initial set of backing handler.

Method Summary

Modifier and Type	Method	Description
@NotNull ThreeWayConflictHandler.Resolution	addExistingNode(@NotNull NodeBuilder parent, @NotNull String name, @NotNull NodeState ours, @NotNull NodeState theirs)	The node ours has been added to parent which conflicts with node theirs which has been added in the persistence store.
@NotNull ThreeWayConflictHandler.Resolution	addExistingProperty(@NotNull NodeBuilder parent, @NotNull PropertyState ours, @NotNull PropertyState theirs)	The property ours has been added to parent which conflicts with property theirs which has been added in the persistence store.
CompositeConflictHandler	addHandler(@NotNull ThreeWayConflictHandler handler)	Add a new backing conflict handler.
@NotNull ThreeWayConflictHandler.Resolution	changeChangedProperty(@NotNull NodeBuilder parent, @NotNull PropertyState ours, @NotNull PropertyState theirs, @NotNull PropertyState base)	The property ours has been changed in parent while it was also changed to a different value (theirs) in the persistence store.
@NotNull ThreeWayConflictHandler.Resolution	changeDeletedNode(@NotNull NodeBuilder parent, @NotNull String name, @NotNull NodeState ours, @NotNull NodeState base)	The node ours has been changed in parent while it was removed in the persistence store.
@NotNull ThreeWayConflictHandler.Resolution	changeDeletedProperty(@NotNull NodeBuilder parent, @NotNull PropertyState ours, @NotNull PropertyState base)	The property ours has been changed in parent while it was removed in the persistence store.
@NotNull ThreeWayConflictHandler.Resolution	deleteChangedNode(@NotNull NodeBuilder parent, @NotNull String name, @NotNull NodeState theirs, @NotNull NodeState base)	The node theirs changed in the persistence store while it has been deleted locally.
@NotNull ThreeWayConflictHandler.Resolution	deleteChangedProperty(@NotNull NodeBuilder parent, @NotNull PropertyState theirs, @NotNull PropertyState base)	The property theirs changed in the persistence store while it has been deleted locally.
@NotNull ThreeWayConflictHandler.Resolution	deleteDeletedNode(@NotNull NodeBuilder parent, @NotNull String name, @NotNull NodeState base)	The node name has been removed in parent while it was also removed in the persistence store.
@NotNull ThreeWayConflictHandler.Resolution	deleteDeletedProperty(@NotNull NodeBuilder parent, @NotNull PropertyState base)	The property ours has been removed in parent while it was also removed in the persistence store.

Methods inherited from class java.lang.Object

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

Constructor Details

CompositeConflictHandler

public CompositeConflictHandler(@NotNull
 @NotNull Iterable<ThreeWayConflictHandler> handlers)

Create a new CompositeConflictHandler with an initial set of backing handler. Use addHandler(ThreeWayConflictHandler) to add additional handlers.

Parameters:

handlers - the backing handlers

CompositeConflictHandler

public CompositeConflictHandler()

Create a new CompositeConflictHandler with no backing handlers. backing handler. Use addHandler(ThreeWayConflictHandler) to add handlers.

Method Details

addHandler

public CompositeConflictHandler addHandler(@NotNull
 @NotNull ThreeWayConflictHandler handler)

Add a new backing conflict handler. The new handler takes precedence over all currently installed handlers.

Parameters:

handler -

Returns:

this

addExistingProperty

@NotNull
public @NotNull ThreeWayConflictHandler.Resolution addExistingProperty(@NotNull
 @NotNull NodeBuilder parent,
 @NotNull
 @NotNull PropertyState ours,
 @NotNull
 @NotNull PropertyState theirs)

Description copied from interface: ThreeWayConflictHandler

The property ours has been added to parent which conflicts with property theirs which has been added in the persistence store.

Specified by:

addExistingProperty in interface ThreeWayConflictHandler

Parameters:

parent - root of the conflict

ours - our version of the property

theirs - their version of the property

Returns:

ThreeWayConflictHandler.Resolution of the conflict

changeDeletedProperty

@NotNull
public @NotNull ThreeWayConflictHandler.Resolution changeDeletedProperty(@NotNull
 @NotNull NodeBuilder parent,
 @NotNull
 @NotNull PropertyState ours,
 @NotNull
 @NotNull PropertyState base)

Description copied from interface: ThreeWayConflictHandler

The property ours has been changed in parent while it was removed in the persistence store.

Specified by:

changeDeletedProperty in interface ThreeWayConflictHandler

Parameters:

parent - root of the conflict

ours - our version of the property

base - the base version of the property

Returns:

ThreeWayConflictHandler.Resolution of the conflict

changeChangedProperty

@NotNull
public @NotNull ThreeWayConflictHandler.Resolution changeChangedProperty(@NotNull
 @NotNull NodeBuilder parent,
 @NotNull
 @NotNull PropertyState ours,
 @NotNull
 @NotNull PropertyState theirs,
 @NotNull
 @NotNull PropertyState base)

Description copied from interface: ThreeWayConflictHandler

The property ours has been changed in parent while it was also changed to a different value (theirs) in the persistence store.

Specified by:

changeChangedProperty in interface ThreeWayConflictHandler

Parameters:

parent - root of the conflict

ours - our version of the property

theirs - their version of the property

base - the base version of the property

Returns:

ThreeWayConflictHandler.Resolution of the conflict

deleteDeletedProperty

@NotNull
public @NotNull ThreeWayConflictHandler.Resolution deleteDeletedProperty(@NotNull
 @NotNull NodeBuilder parent,
 @NotNull
 @NotNull PropertyState base)

Description copied from interface: ThreeWayConflictHandler

The property ours has been removed in parent while it was also removed in the persistence store.

Specified by:

deleteDeletedProperty in interface ThreeWayConflictHandler

Parameters:

parent - root of the conflict

base - the base version of the property

Returns:

ThreeWayConflictHandler.Resolution of the conflict

deleteChangedProperty

@NotNull
public @NotNull ThreeWayConflictHandler.Resolution deleteChangedProperty(@NotNull
 @NotNull NodeBuilder parent,
 @NotNull
 @NotNull PropertyState theirs,
 @NotNull
 @NotNull PropertyState base)

Description copied from interface: ThreeWayConflictHandler

The property theirs changed in the persistence store while it has been deleted locally.

Specified by:

deleteChangedProperty in interface ThreeWayConflictHandler

Parameters:

parent - root of the conflict

theirs - their version of the property

base - the base version of the property

Returns:

ThreeWayConflictHandler.Resolution of the conflict

addExistingNode

@NotNull
public @NotNull ThreeWayConflictHandler.Resolution addExistingNode(@NotNull
 @NotNull NodeBuilder parent,
 @NotNull
 @NotNull String name,
 @NotNull
 @NotNull NodeState ours,
 @NotNull
 @NotNull NodeState theirs)

Description copied from interface: ThreeWayConflictHandler

The node ours has been added to parent which conflicts with node theirs which has been added in the persistence store.

Specified by:

addExistingNode in interface ThreeWayConflictHandler

Parameters:

parent - root of the conflict

name - name of the node

ours - our version of the node

theirs - their version of the node

Returns:

ThreeWayConflictHandler.Resolution of the conflict

changeDeletedNode

@NotNull
public @NotNull ThreeWayConflictHandler.Resolution changeDeletedNode(@NotNull
 @NotNull NodeBuilder parent,
 @NotNull
 @NotNull String name,
 @NotNull
 @NotNull NodeState ours,
 @NotNull
 @NotNull NodeState base)

Description copied from interface: ThreeWayConflictHandler

The node ours has been changed in parent while it was removed in the persistence store.

Specified by:

changeDeletedNode in interface ThreeWayConflictHandler

Parameters:

parent - root of the conflict

name - name of the node

ours - our version of the node

base - the base version of the node

Returns:

ThreeWayConflictHandler.Resolution of the conflict

deleteChangedNode

@NotNull
public @NotNull ThreeWayConflictHandler.Resolution deleteChangedNode(@NotNull
 @NotNull NodeBuilder parent,
 @NotNull
 @NotNull String name,
 @NotNull
 @NotNull NodeState theirs,
 @NotNull
 @NotNull NodeState base)

Description copied from interface: ThreeWayConflictHandler

The node theirs changed in the persistence store while it has been deleted locally.

Specified by:

deleteChangedNode in interface ThreeWayConflictHandler

Parameters:

parent - root of the conflict

name - name of the node

theirs - their version of the node

base - the base version of the node

Returns:

ThreeWayConflictHandler.Resolution of the conflict

deleteDeletedNode

@NotNull
public @NotNull ThreeWayConflictHandler.Resolution deleteDeletedNode(@NotNull
 @NotNull NodeBuilder parent,
 @NotNull
 @NotNull String name,
 @NotNull
 @NotNull NodeState base)

Description copied from interface: ThreeWayConflictHandler

The node name has been removed in parent while it was also removed in the persistence store.

Specified by:

deleteDeletedNode in interface ThreeWayConflictHandler

Parameters:

parent - root of the conflict

name - name of the node

base - the base version of the node

Returns:

ThreeWayConflictHandler.Resolution of the conflict