/* * 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 . */ package org.alfresco.util.schemacomp; import java.util.ArrayList; import java.util.Collection; import java.util.List; import org.alfresco.util.schemacomp.Difference.Where; import org.alfresco.util.schemacomp.model.DbObject; import org.alfresco.util.schemacomp.validator.DbValidator; /** * A collection of utility methods for determining differences between two database schemas. * * @author Matt Ward */ public class DefaultComparisonUtils implements ComparisonUtils { @Override public List findEquivalentObjects(DbObject rootObject, DbObject objToMatch) { EquivalentObjectSeeker objectSeeker = new EquivalentObjectSeeker(objToMatch); rootObject.accept(objectSeeker); return objectSeeker.getMatches(); } @Override public void compareSimpleOrderedLists(DbProperty refProp, DbProperty targetProp, DiffContext ctx) { checkPropertyContainsList(refProp); checkPropertyContainsList(targetProp); // Check whether the leftProperty should be compared to the rightProperty DbObject leftDbObject = refProp.getDbObject(); if (leftDbObject.hasValidators()) { for (DbValidator validator : leftDbObject.getValidators()) { if (validator.validates(refProp.getPropertyName())) { // Don't perform differencing on this property - a validator will handle it. return; } } } @SuppressWarnings("unchecked") ArrayList refList = new ArrayList((List) refProp.getPropertyValue()); @SuppressWarnings("unchecked") ArrayList targetList = new ArrayList((List) targetProp.getPropertyValue()); Results differences = ctx.getComparisonResults(); int maxSize = Math.max(refList.size(), targetList.size()); for (int i = 0; i < maxSize; i++) { if (i < refList.size() && i < targetList.size()) { DbProperty refIndexedProp = new DbProperty(refProp.getDbObject(), refProp.getPropertyName(), i); DbProperty targetIndexedProp = new DbProperty(targetProp.getDbObject(), targetProp.getPropertyName(), i); if (refList.get(i).equals(targetList.get(i))) { differences.add(Where.IN_BOTH_NO_DIFFERENCE, refIndexedProp, targetIndexedProp); } else { differences.add(Where.IN_BOTH_BUT_DIFFERENCE, refIndexedProp, targetIndexedProp); } } else if (i < refList.size()) { DbProperty indexedProp = new DbProperty(refProp.getDbObject(), refProp.getPropertyName(), i); differences.add(Where.ONLY_IN_REFERENCE, indexedProp, null); } else { DbProperty indexedProp = new DbProperty(targetProp.getDbObject(), targetProp.getPropertyName(), i); // No equivalent object in the reference collection. differences.add(Where.ONLY_IN_TARGET, null, indexedProp); } } } /** * Ensure the property is carrying a list as its payload. A List is required * rather than a Collection as the latter may not be ordered. * * @param prop */ private void checkPropertyContainsList(DbProperty prop) { if (!List.class.isAssignableFrom(prop.getPropertyValue().getClass())) { throw new IllegalArgumentException("List required, but was " + prop.getPropertyValue().getClass()); } } @Override public void compareSimpleCollections(DbProperty leftProp, DbProperty rightProp, DiffContext ctx) { // Check whether the leftProperty should be compared to the rightProperty DbObject leftDbObject = leftProp.getDbObject(); if (leftDbObject.hasValidators()) { for (DbValidator validator : leftDbObject.getValidators()) { if (validator.validates(leftProp.getPropertyName())) { // Don't perform differencing on this property - a validator will handle it. return; } } } @SuppressWarnings("unchecked") Collection leftCollection = (Collection) leftProp.getPropertyValue(); @SuppressWarnings("unchecked") Collection rightCollection = (Collection) rightProp.getPropertyValue(); ArrayList leftList = new ArrayList(leftCollection); ArrayList rightList = new ArrayList(rightCollection); Results differences = ctx.getComparisonResults(); for (int leftIndex = 0; leftIndex < leftList.size(); leftIndex++) { Object leftObj = leftList.get(leftIndex); DbProperty leftIndexedProp = new DbProperty(leftProp.getDbObject(), leftProp.getPropertyName(), leftIndex); int rightIndex; if ((rightIndex = rightList.indexOf(leftObj)) != -1) { // The same valued object in the right hand collection as in the left. // Note: it isn't possible to determine a result of Where.IN_BOTH_BUT_DIFFERENCE // with a 'simple' value — as there is no way of knowing if the term represents the same value // (e.g. two strings {red_value, green_value}, are these meant to be the same or different?) DbProperty rightIndexedProp = new DbProperty(rightProp.getDbObject(), rightProp.getPropertyName(), rightIndex); differences.add(Where.IN_BOTH_NO_DIFFERENCE, leftIndexedProp, rightIndexedProp); } else { // No equivalent object in the right hand collection. // Using rightIndexedProperty would result in index out of bounds error. differences.add(Where.ONLY_IN_REFERENCE, leftIndexedProp, rightProp); } } // Identify objects in the right collection but not the left for (int rightIndex = 0; rightIndex < rightList.size(); rightIndex++) { Object rightObj = rightList.get(rightIndex); if (!leftCollection.contains(rightObj)) { DbProperty rightIndexedProp = new DbProperty(rightProp.getDbObject(), rightProp.getPropertyName(), rightIndex); // No equivalent object in the left hand collection. differences.add(Where.ONLY_IN_TARGET, leftProp, rightIndexedProp); } } } @Override public void compareCollections(Collection leftCollection, Collection rightCollection, DiffContext ctx) { Results differences = ctx.getComparisonResults(); for (DbObject leftObj : leftCollection) { if (leftObj.hasObjectLevelValidator()) { // Don't report differences regarding this object - there is a validator // that takes sole responsibility for doing so. continue; } boolean foundMatch = false; for (DbObject rootObject : rightCollection) { List matches = findEquivalentObjects(rootObject, leftObj); for (DbObject match : matches) { // There is an equivalent object in the right hand collection as in the left. leftObj.diff(match, ctx); } if (matches.size() > 0) { foundMatch = true; } } if (!foundMatch) { // No equivalent object in the target collection. differences.add(Where.ONLY_IN_REFERENCE, new DbProperty(leftObj, null), null); } } // Identify objects in the right collection but not the left for (DbObject rightObj : rightCollection) { if (rightObj.hasObjectLevelValidator()) { // Don't report differences regarding this object - there is a validator // that takes sole responsibility for doing so. continue; } boolean foundMatch = false; for (DbObject rootObject : leftCollection) { List matches = findEquivalentObjects(rootObject, rightObj); if (matches.size() > 0) { foundMatch = true; break; } } if (!foundMatch) { // No equivalent object in the left hand collection. differences.add(Where.ONLY_IN_TARGET, null, new DbProperty(rightObj, null)); } } } @Override public void compareSimple(DbProperty leftProperty, DbProperty rightProperty, DiffContext ctx) { // Check whether the leftProperty should be compared to the rightProperty DbObject leftDbObject = leftProperty.getDbObject(); if (leftDbObject.hasValidators()) { for (DbValidator validator : leftDbObject.getValidators()) { if (validator.validates(leftProperty.getPropertyName())) { // Don't perform differencing on this property - a validator will handle it. return; } } } Where where = null; Object left = leftProperty.getPropertyValue(); checkNotDbObject(left); Object right = rightProperty.getPropertyValue(); checkNotDbObject(right); if (left == right) { // Same object, or both nulls where = Where.IN_BOTH_NO_DIFFERENCE; } else if (left == null) { // right can't be null, or left == right would have been true where = Where.ONLY_IN_TARGET; } else if (right == null) { // left can't be null, or left == right would have been true where = Where.ONLY_IN_REFERENCE; } else { // neither are null boolean objectsAreEqual; // Strings are compared case-insensitively, e.g. table names. if (left instanceof String && right instanceof String) { objectsAreEqual = ((String) left).equalsIgnoreCase((String) right); } else { objectsAreEqual = left.equals(right); } if (objectsAreEqual) { where = Where.IN_BOTH_NO_DIFFERENCE; } else { where = Where.IN_BOTH_BUT_DIFFERENCE; } } ctx.getComparisonResults().add(where, leftProperty, rightProperty); } /** * @param obj */ private void checkNotDbObject(Object obj) { if (obj != null && DbObject.class.isAssignableFrom(obj.getClass())) { throw new IllegalArgumentException( "Property value is a DbObject - this method shouldn't be used to compare this type: " + obj); } } public static class EquivalentObjectSeeker implements DbObjectVisitor { private final List matches = new ArrayList(); private final DbObject objToMatch; public EquivalentObjectSeeker(DbObject objToMatch) { this.objToMatch = objToMatch; } @Override public void visit(DbObject dbObject) { if (objToMatch.sameAs(dbObject)) { matches.add(dbObject); } } /** * @return the matches */ public List getMatches() { return this.matches; } } }