ALF-7260: unit tests, bug fixes.

git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@31455 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261
2025-08-07 17:49:17 +00:00 · 2011-10-25 08:28:13 +00:00
parent b9c32d6aa5
commit 4ef52e4e72
27 changed files with 1428 additions and 187 deletions
--- a/source/java/org/alfresco/util/schemacomp/ComparisonUtils.java
+++ b/source/java/org/alfresco/util/schemacomp/ComparisonUtils.java
@@ -0,0 +1,83 @@
+/*
+ * Copyright (C) 2005-2011 Alfresco Software Limited.
+ *
+ * This file is part of Alfresco
+ *
+ * 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/>.
+ */
+
+package org.alfresco.util.schemacomp;
+
+import java.util.Collection;
+
+import org.alfresco.util.schemacomp.Result.Strength;
+import org.alfresco.util.schemacomp.model.DbObject;
+
+/**
+ * Utilities for comparing data structures in the context of comparing two database schemas.
+ * 
+ * @author Matt Ward
+ */
+public interface ComparisonUtils
+{
+    /**
+     * @param objToFind
+     * @return
+     */
+    DbObject findSameObjectAs(Collection<? extends DbObject> objects, final DbObject objToFind);
+
+    void compareSimpleCollections(Collection<? extends Object> leftCollection,
+                Collection<? extends Object> rightCollection, Differences differences,
+                Strength strength);
+
+    /**
+     * Compare collections, reporting differences using the default {@link Result.Strength}
+     * 
+     * @see #compareCollections(Collection, Collection, Differences, Strength)
+     */
+    void compareCollections(Collection<? extends DbObject> leftCollection,
+                Collection<? extends DbObject> rightCollection, Differences differences);
+
+    /**
+     * Compare collections of {@link DbObject}s using their {@link DbObject#diff(DbObject, Differences)} method.
+     * Differences are reported using the specified {@link Result.Strength}.
+     * 
+     * @param leftCollection
+     * @param rightCollection
+     * @param differences
+     * @param strength
+     */
+    void compareCollections(Collection<? extends DbObject> leftCollection,
+                Collection<? extends DbObject> rightCollection, Differences differences,
+                Strength strength);
+
+    /**
+     * Compare two simple objects. Differences are reported using the default Result.Strength.
+     * 
+     * @see #compareSimple(Object, Object, Differences, Strength)
+     */
+    void compareSimple(Object left, Object right, Differences differences);
+
+    /**
+     * Compare two 'simple' (i.e. non-{@link DbObject} objects) using their {@link Object#equals(Object)} method
+     * to decide if there is a difference. Differences are reported using the Result.Strength specified.
+     * 
+     * @param left
+     * @param right
+     * @param differences
+     * @param strength
+     */
+    void compareSimple(Object left, Object right, Differences differences, Strength strength);
+
+}