Files
alfresco-community-repo/source/java/org/alfresco/util/schemacomp/ComparisonUtils.java
Alan Davis 84841e063f Merged 5.2.N (5.2.1) to HEAD (5.2)
125788 rmunteanu: Merged 5.1.N (5.1.2) to 5.2.N (5.2.1)
      125606 rmunteanu: Merged 5.1.1 (5.1.1) to 5.1.N (5.1.2)
         125515 slanglois: MNT-16155 Update source headers - add new Copyrights for Java and JSP source files + automatic check in the build


git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@127810 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261
2016-06-03 17:08:06 +00:00

90 lines
3.4 KiB
Java

/*
* #%L
* Alfresco Repository
* %%
* Copyright (C) 2005 - 2016 Alfresco Software Limited
* %%
* This file is part of the Alfresco software.
* If the software was purchased under a paid Alfresco license, the terms of
* the paid license agreement will prevail. Otherwise, the software is
* provided under the following open source license terms:
*
* Alfresco is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* Alfresco is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with Alfresco. If not, see <http://www.gnu.org/licenses/>.
* #L%
*/
package org.alfresco.util.schemacomp;
import java.util.Collection;
import java.util.List;
import org.alfresco.util.schemacomp.model.DbObject;
import com.google.gdata.data.extensions.Where;
/**
* Utilities for comparing data structures in the context of comparing two database schemas.
*
* @author Matt Ward
*/
public interface ComparisonUtils
{
List<DbObject> findEquivalentObjects(DbObject rootObject, DbObject objToMatch);
/**
* Compare two {@link List}s of 'simple' (i.e. non-{@link DbObject}) objects. Ordering
* is significant - if an element E appears in both collections but at different indexes
* then it is not considered to be the same item.
*
* @param leftProperty DbProperty
* @param rightProperty DbProperty
* @param ctx DiffContext
*/
void compareSimpleOrderedLists(DbProperty leftProperty, DbProperty rightProperty, DiffContext ctx);
/**
* Compare two collections. Similar to {@link #compareSimpleOrderedLists(DbProperty, DbProperty, DiffContext)}
* except that this method operates on {@link Collection}s and order (and cardinality) is not important. If
* an element E from the reference collection appears one or more times at any position in the target collection
* then that element is said to be {@link org.alfresco.util.schemacomp.Difference.Where#IN_BOTH_NO_DIFFERENCE in both with no difference}.
*
* @param leftProperty DbProperty
* @param rightProperty DbProperty
* @param ctx - context
*/
void compareSimpleCollections(DbProperty leftProperty, DbProperty rightProperty, DiffContext ctx);
/**
* Compare collections of {@link DbObject}s using their {@link DbObject#diff(DbObject, DiffContext)} method.
*
* @param leftCollection Collection<? extends DbObject>
* @param rightCollection Collection<? extends DbObject>
* @param ctx - context
*/
void compareCollections(Collection<? extends DbObject> leftCollection,
Collection<? extends DbObject> rightCollection, DiffContext ctx);
/**
* Compare two 'simple' (i.e. non-{@link DbObject}) objects using their {@link Object#equals(Object)} method
* to decide if there is a difference.
*
* @param left DbProperty
* @param right DbProperty
* @param ctx - context
*/
void compareSimple(DbProperty left, DbProperty right, DiffContext ctx);
}