org.apache.jackrabbit.oak.spi.commit

Class CompositeConflictHandler

java.lang.Object

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

All Implemented Interfaces:

ConflictHandler, PartialConflictHandler

public class CompositeConflictHandler
extends java.lang.Object
implements ConflictHandler

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 null) 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.PartialConflictHandler

PartialConflictHandler.Resolution

Constructor Summary

Constructors

Constructor and Description
CompositeConflictHandler() Create a new CompositeConflictHandler with no backing handlers.
CompositeConflictHandler(java.lang.Iterable<PartialConflictHandler> handlers) Create a new CompositeConflictHandler with an initial set of backing handler.

Method Summary

Modifier and Type	Method and Description
PartialConflictHandler.Resolution	addExistingNode(NodeBuilder parent, java.lang.String name, NodeState ours, NodeState theirs) The node ours has been added to parent which conflicts with node theirs which has been added in the persistence store.
PartialConflictHandler.Resolution	addExistingProperty(NodeBuilder parent, PropertyState ours, 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(PartialConflictHandler handler) Add a new backing conflict handler.
PartialConflictHandler.Resolution	changeChangedProperty(NodeBuilder parent, PropertyState ours, PropertyState theirs) The property ours has been changed in parent while it was also changed to a different value (theirs) in the persistence store.
PartialConflictHandler.Resolution	changeDeletedNode(NodeBuilder parent, java.lang.String name, NodeState ours) The node ours has been changed in parent while it was removed in the persistence store.
PartialConflictHandler.Resolution	changeDeletedProperty(NodeBuilder parent, PropertyState ours) The property ours has been changed in parent while it was removed in the persistence store.
PartialConflictHandler.Resolution	deleteChangedNode(NodeBuilder parent, java.lang.String name, NodeState theirs) The node theirs changed in the persistence store while it has been deleted locally.
PartialConflictHandler.Resolution	deleteChangedProperty(NodeBuilder parent, PropertyState theirs) The property theirs changed in the persistence store while it has been deleted locally.
PartialConflictHandler.Resolution	deleteDeletedNode(NodeBuilder parent, java.lang.String name) The node name has been removed in parent while it was also removed in the persistence store.
PartialConflictHandler.Resolution	deleteDeletedProperty(NodeBuilder parent, PropertyState ours) 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 Detail

CompositeConflictHandler

public CompositeConflictHandler(java.lang.Iterable<PartialConflictHandler> handlers)

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

Parameters:

handlers - the backing handlers

CompositeConflictHandler

public CompositeConflictHandler()

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

Method Detail

addHandler

public CompositeConflictHandler addHandler(PartialConflictHandler handler)

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

Parameters:

handler -

Returns:

this

addExistingProperty

public PartialConflictHandler.Resolution addExistingProperty(NodeBuilder parent,
                                                             PropertyState ours,
                                                             PropertyState theirs)

Description copied from interface: ConflictHandler

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 ConflictHandler

Specified by:

addExistingProperty in interface PartialConflictHandler

Parameters:

parent - root of the conflict

ours - our version of the property

theirs - their version of the property

Returns:

Resolution of the conflict

changeDeletedProperty

public PartialConflictHandler.Resolution changeDeletedProperty(NodeBuilder parent,
                                                               PropertyState ours)

Description copied from interface: ConflictHandler

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

Specified by:

changeDeletedProperty in interface ConflictHandler

Specified by:

changeDeletedProperty in interface PartialConflictHandler

Parameters:

parent - root of the conflict

ours - our version of the property

Returns:

Resolution of the conflict

changeChangedProperty

public PartialConflictHandler.Resolution changeChangedProperty(NodeBuilder parent,
                                                               PropertyState ours,
                                                               PropertyState theirs)

Description copied from interface: ConflictHandler

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 ConflictHandler

Specified by:

changeChangedProperty in interface PartialConflictHandler

Parameters:

parent - root of the conflict

ours - our version of the property

theirs - their version of the property

Returns:

Resolution of the conflict

deleteDeletedProperty

public PartialConflictHandler.Resolution deleteDeletedProperty(NodeBuilder parent,
                                                               PropertyState ours)

Description copied from interface: ConflictHandler

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

Specified by:

deleteDeletedProperty in interface ConflictHandler

Specified by:

deleteDeletedProperty in interface PartialConflictHandler

Parameters:

parent - root of the conflict

ours - our version of the property

Returns:

Resolution of the conflict

deleteChangedProperty

public PartialConflictHandler.Resolution deleteChangedProperty(NodeBuilder parent,
                                                               PropertyState theirs)

Description copied from interface: ConflictHandler

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

Specified by:

deleteChangedProperty in interface ConflictHandler

Specified by:

deleteChangedProperty in interface PartialConflictHandler

Parameters:

parent - root of the conflict

theirs - their version of the property

Returns:

Resolution of the conflict

addExistingNode

public PartialConflictHandler.Resolution addExistingNode(NodeBuilder parent,
                                                         java.lang.String name,
                                                         NodeState ours,
                                                         NodeState theirs)

Description copied from interface: ConflictHandler

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 ConflictHandler

Specified by:

addExistingNode in interface PartialConflictHandler

Parameters:

parent - root of the conflict

name - name of the node

ours - our version of the node

theirs - their version of the node

Returns:

Resolution of the conflict

changeDeletedNode

public PartialConflictHandler.Resolution changeDeletedNode(NodeBuilder parent,
                                                           java.lang.String name,
                                                           NodeState ours)

Description copied from interface: ConflictHandler

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

Specified by:

changeDeletedNode in interface ConflictHandler

Specified by:

changeDeletedNode in interface PartialConflictHandler

Parameters:

parent - root of the conflict

name - name of the node

ours - our version of the node

Returns:

Resolution of the conflict

deleteChangedNode

public PartialConflictHandler.Resolution deleteChangedNode(NodeBuilder parent,
                                                           java.lang.String name,
                                                           NodeState theirs)

Description copied from interface: ConflictHandler

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

Specified by:

deleteChangedNode in interface ConflictHandler

Specified by:

deleteChangedNode in interface PartialConflictHandler

Parameters:

parent - root of the conflict

name - name of the node

theirs - their version of the node

Returns:

Resolution of the conflict

deleteDeletedNode

public PartialConflictHandler.Resolution deleteDeletedNode(NodeBuilder parent,
                                                           java.lang.String name)

Description copied from interface: ConflictHandler

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

Specified by:

deleteDeletedNode in interface ConflictHandler

Specified by:

deleteDeletedNode in interface PartialConflictHandler

Parameters:

parent - root of the conflict

name - name of the node

Returns:

Resolution of the conflict