Conflict.java

// License: GPL. For details, see LICENSE file.
package org.openstreetmap.josm.data.conflict;

import org.openstreetmap.josm.data.osm.OsmPrimitive;
import org.openstreetmap.josm.data.osm.PrimitiveId;

/**
 * Represents a conflict between two {@see OsmPrimitive}s. It is represented as
 * a pair of {@see OsmPrimitive}s where one element of the pair has the role <em>my</em>
 * and the other has the role <em>their</em>.
 * <ul>
 *   <li><code>my</code> is the {@see OsmPrimitive} in the local dataset</li>
 *   <li><code>their</code> is the {@see OsmPrimitive} which caused the conflict when it
 *   it was tried to merge it onto <code>my</code>. <code>their</code> is usually the
 *   {@see OsmPrimitive} from the dataset in another layer or the one retrieved from the server.</li>
 * </ul>
 *
 *
 */
public class  Conflict<T extends OsmPrimitive> {
    private final T my;
    private final T their;
    private final boolean isMyDeleted;

    public Conflict(T my, T their) {
        this(my, their, false);
    }

    public Conflict(T my, T their, boolean isMyDeleted) {
        this.my = my;
        this.their = their;
        this.isMyDeleted = isMyDeleted;
    }

    public T getMy() {
        return my;
    }

    public T getTheir() {
        return their;
    }

    public boolean isMatchingMy(OsmPrimitive my) {
        return this.my == my;
    }

    public boolean isMatchingTheir(OsmPrimitive their) {
        return this.their == their;
    }

    /**
     * Replies true if the primitive <code>primitive</code> is participating
     * in this conflict
     * 
     * @param primitive the primitive
     * @return true if the primitive <code>primitive</code> is participating
     * in this conflict
     */
    public boolean isParticipating(OsmPrimitive primitive) {
        if (primitive == null) return false;
        return primitive.getPrimitiveId().equals(my.getPrimitiveId())
        || primitive.getPrimitiveId().equals(their.getPrimitiveId());
    }

    /**
     * Replies true if the primitive with id <code>id</code> is participating
     * in this conflict
     * 
     * @param id the primitive id
     * @return true if the primitive <code>primitive</code> is participating
     * in this conflict
     */
    public boolean isParticipating(PrimitiveId id) {
        if (id == null) return false;
        return id.equals(my.getPrimitiveId())
        || id.equals(their.getPrimitiveId());
    }

    @Override
    public int hashCode() {
        final int prime = 31;
        int result = 1;
        result = prime * result + ((my == null) ? 0 : my.hashCode());
        result = prime * result + ((their == null) ? 0 : their.hashCode());
        return result;
    }

    @SuppressWarnings("unchecked")
    @Override
    public boolean equals(Object obj) {
        if (this == obj)
            return true;
        if (obj == null)
            return false;
        if (getClass() != obj.getClass())
            return false;
        Conflict<T> other = (Conflict<T>) obj;
        if (my != other.my)
            return false;
        if(their != other.their)
            return false;
        return true;
    }

    /**
     * 
     * @return True if my primitive was deleted but it has set non deleted status because it's referred by another
     * primitive and references to deleted primitives are not allowed.
     */
    public boolean isMyDeleted() {
        return isMyDeleted;
    }
}