Application: gvSIG desktop

/*

 * Created on 07-sep-2007

 *

 * gvSIG. Sistema de Informaci?n Geogr?fica de la Generalitat Valenciana

 *

 * Copyright (C) 2004 IVER T.I. and Generalitat Valenciana.

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program 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 General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307,USA.

 *

 * For more information, contact:

 *

 *  Generalitat Valenciana

 *   Conselleria d'Infraestructures i Transport

 *   Av. Blasco Ib??ez, 50

 *   46010 VALENCIA

 *   SPAIN

 *

 *      +34 963862235

 *   gvsig@gva.es

 *      www.gvsig.gva.es

 *

 *    or

 *

 *   IVER T.I. S.A

 *   Salamanca 50

 *   46005 Valencia

 *   Spain

 *

 *   +34 963163400

 *   dac@iver.es

 */

/* CVS MESSAGES:

 *

 * $Id: 

 * $Log: 

 */

package org.gvsig.topology;

import java.awt.geom.Rectangle2D;

import java.util.ArrayList;

import java.util.Collection;

import java.util.Collections;

import java.util.HashMap;

import java.util.Iterator;

import java.util.List;

import java.util.Map;

import org.apache.log4j.Logger;

import org.cresques.cts.IProjection;

import org.gvsig.topology.topologyrules.MustBeLargerThanClusterTolerance;

import com.hardcode.gdbms.driver.exceptions.ReadDriverException;

import com.iver.cit.gvsig.exceptions.expansionfile.ExpansionFileReadException;

import com.iver.cit.gvsig.fmap.MapContext;

import com.iver.cit.gvsig.fmap.core.FShape;

import com.iver.cit.gvsig.fmap.layers.CancelationException;

import com.iver.cit.gvsig.fmap.layers.FLayer;

import com.iver.cit.gvsig.fmap.layers.FLayers;

import com.iver.cit.gvsig.fmap.layers.FLyrVect;

import com.iver.cit.gvsig.fmap.layers.XMLException;

import com.iver.utiles.IPersistence;

import com.iver.utiles.XMLEntity;

import com.iver.utiles.swing.threads.CancellableProgressTask;

/**

 * 

 * This class represents a Topology, as a group of vectorial layers

 * and topology rules that checks geometries and their spatial relationships of

 * these layers.

 * 

 * It extends FLayers to reuse all already existent code related with

 * groups of layers (TOC related, etc.)

 * 

 * 

 * 

 * TODO Study if we must syncronize writing methods (validate, markAsException, addError,

 * ruleId++, etc)

 * Study how to add ChangeStatusListener to this topology

 * 

 * @author azabala

 *

 */

public class Topology extends FLayers implements ITopologyStatus, ITopologyErrorContainer {

        private static Logger logger = Logger.getLogger(Topology.class.getName());

        /**

         * topology name

         */

        private String name;

        /**

         * cluster tolerance of the topology

         */

        private double clusterTolerance;

        /**

         * validation status of the topology

         */

        private byte status = EMPTY;

        /**

         * If during validation process a topoly exceeds this parameters, validation

         * will be stopped.

         * 

         */

        private int maxNumberOfErrors = -1;

        /**

         * topology rules of the topology

         */

        private List<ITopologyRule> rules;

        /**

         * Each layer of a topology must have a cluster tolerance rule

         */

        private List<MustBeLargerThanClusterTolerance> clusterToleranceRules;

        /**

         * Regions of the topology to be validated

         */

        private List<Rectangle2D> dirtyZones;

        /**

         * Error container in which topology delegates error container

         * responsability.

         */

        private ITopologyErrorContainer errorContainer;

        /**

         * Map that relates a FLyrVect of the Topology with its rank (weight when we

         * are going to snap many coordinates)

         */

        private Map<FLyrVect, XYZLayerRank> layerRanks;

        /**

         * Numerical identifier for rules of a topology

         */

        private int ruleId = 0;

        /**

         * Default constructor for a topology as a FLayers

         * 

         * @param fmap

         * @param parent

         */

        public Topology(MapContext fmap, 

                                        FLayers parent, 

                                        double clusterTolerance, 

                                        int numberOfErrors,

                                        ITopologyErrorContainer errorContainer) {

                super(fmap, parent);

                this.clusterTolerance = clusterTolerance;

                this.maxNumberOfErrors = numberOfErrors;

                this.errorContainer = errorContainer;

                rules = new ArrayList<ITopologyRule>();

                clusterToleranceRules = new ArrayList<MustBeLargerThanClusterTolerance>();

                dirtyZones = new ArrayList<Rectangle2D>();

                layerRanks = new HashMap<FLyrVect, XYZLayerRank>();

        }

        public Topology(MapContext mapContext, FLayers layers){

                this(mapContext, layers, 0d, 1000, new SimpleTopologyErrorContainer());

        }

        /**

         * Creates a topology from its XML representation

         * @param xmlEntity

         * @return

         */

        public static Topology createFromXML(MapContext mapContext, XMLEntity xmlEntity){

                FLayers rootLyr = mapContext.getLayers();

                Topology solution = new Topology(mapContext, rootLyr);

                try {

                        solution.setXMLEntity(xmlEntity);

                        if(solution.getErrorContainer() == null){

                                solution.setErrorContainer(new SimpleTopologyErrorContainer());

                        }

                } catch (XMLException e) {

                        logger.error("Error al reconstruir la topologia desde fichero xml", e);

                }

                return solution;

        }

        /**

         * Changes the cluster tolerance of the topology

         * 

         * 

         * This operation resets the status of the topology (it clears

         * errors and dirty zones)

         * 

         * @param clusterTolerance

         */

        public void setClusterTolerance(double clusterTolerance) {

                if(status == VALIDATING)

                        return;//maybe we could launch an exception??

                this.clusterTolerance = clusterTolerance;

                resetStatus();

                Iterator<MustBeLargerThanClusterTolerance> rulesIt = this.clusterToleranceRules.iterator();

                while(rulesIt.hasNext()){

                        MustBeLargerThanClusterTolerance rule = rulesIt.next();

                        rule.setClusterTolerance(clusterTolerance);

                }

        }

        public double getClusterTolerance() {

                return clusterTolerance;

        }

        public void resetStatus(){

                status = NOT_VALIDATED;

                this.clear();

                this.dirtyZones.clear();

        }

        /**

         * Adds a new topology rule to the topology.

         * 

         * The layers referenced by the rule must exist in the topology.

         * 

         * The state of the topology changes to "NON_VALIDATED", and a new dirty zone

         * is added for the scope of the new rule (envelope of one or two layers).

         * 

         * 

         * @throws TopologyRuleDefinitionException

         */

        public void addRule(ITopologyRule rule) throws RuleNotAllowedException,

                        TopologyRuleDefinitionException {

                if(status == VALIDATING)

                        throw new RuleNotAllowedException("No se puede a?adir una regla si la topologia est? siendo validada");

                Rectangle2D ruleScope = null;

                try {

                        if (rule instanceof IOneLyrRule) {

                                FLyrVect originLyr = ((IOneLyrRule) rule).getOriginLyr();

                                if (getLayer(originLyr.getName()) == null) {

                                        throw new RuleNotAllowedException(

                                                        "Regla con capa  que no forma parte de la topologia");

                                }

                                ruleScope = originLyr.getFullExtent();

                        }

                        if (rule instanceof ITwoLyrRule) {

                                FLyrVect destLyr = ((ITwoLyrRule) rule).getDestinationLyr();

                                if (getLayer(destLyr.getName()) == null) {

                                        throw new RuleNotAllowedException(

                                                        "Regla con capa  que no forma parte de la topologia");

                                }

                                if (ruleScope != null)

                                        ruleScope.add(destLyr.getFullExtent());

                        }

                } catch (ExpansionFileReadException e) {

                        e.printStackTrace();

                        throw new TopologyRuleDefinitionException(e);

                } catch (ReadDriverException e) {

                        e.printStackTrace();

                        throw new TopologyRuleDefinitionException(e);

                }

                // before to add the rule we check if it verifies preconditions

                rule.checkPreconditions();

                rules.add(rule);

//   Si se a?ade una nueva regla, no es posible conservar los errores

//   y las zonas sucias previas

//                if(status == EMPTY)

//                        status = NOT_VALIDATED;

//                else if(status == VALIDATED ){

//                        status = VALIDATED_WITH_DIRTY_ZONES;

//                        addDirtyZone(ruleScope);

//                }else if(status == VALIDATED_WITH_ERRORS){

//                        //we dont change the status, but add a new dirty zone

//                        addDirtyZone(ruleScope);

//                }

                resetStatus();

                rule.setTopologyErrorContainer(this);

                rule.setId(this.ruleId++);

        }

        /*

         * Overwrited implementations of FLayers methods

         */

        public void addLayer(FLayer layer) {

                addLayer(layers.size(), layer);

        }

        public void addLayer(int pos, FLayer layer)  {

                if (!(layer instanceof FLyrVect))

                        throw new WrongLyrForTopologyException(

                                        "Intentando a?adir capa no vectorial a una topologia");

                super.addLayer(pos, layer);

                setRank((FLyrVect) layer, 1, 1);

                int shapeType = -1;

                try {

                        shapeType = ((FLyrVect)layer).getShapeType();

                        if( (shapeType == FShape.POINT) || (shapeType == FShape.MULTIPOINT) || (shapeType == FShape.TEXT))

                                return;

                } catch (ReadDriverException e) {

                        e.printStackTrace();

                        throw new WrongLyrForTopologyException("Error al intentar verificar el tipo de geometria de la capa", e);

                }

                MustBeLargerThanClusterTolerance rule = new 

                        MustBeLargerThanClusterTolerance(this, (FLyrVect) layer, clusterTolerance);

                rule.setId(this.ruleId++);

                Rectangle2D ruleScope;

                try {

                        ruleScope = layer.getFullExtent();

//                 before to add the rule we check if it verifies preconditions

                        rule.checkPreconditions();

                        if(status == EMPTY)

                                status = NOT_VALIDATED;

                        else if(status == VALIDATED ){

                                status = VALIDATED_WITH_DIRTY_ZONES;

                                addDirtyZone(ruleScope);

                        }else if(status == VALIDATED_WITH_ERRORS){

                                //we dont change the status, but add a new dirty zone

//                                addDirtyZone(ruleScope);

                                //si habia errores, la reevaluacion haria que se repitiesen

                                resetStatus();

                        }

                        rule.setTopologyErrorContainer(this);

                        clusterToleranceRules.add(rule);

                } catch (ExpansionFileReadException e) {

                        e.printStackTrace();

                        throw new WrongLyrForTopologyException("No es posible acceder all FullExtent de la capa", e);

                } catch (ReadDriverException e) {

                        e.printStackTrace();

                        throw new WrongLyrForTopologyException("No es posible acceder all FullExtent de la capa", e);

                } catch (TopologyRuleDefinitionException e) {

                        e.printStackTrace();

                        throw new WrongLyrForTopologyException("Regla topologica mal definida", e);

                }

        }

        /**

         * Sets the rank/importance of a layer in xy and z planes.

         * 

         * @param lyr layer

         * 

         * @param xyRank importance of this layer coordinates in xy plane

         * 

         * @param zRank importante of this layer coordinates in z plane

         */

        public void setRank(FLyrVect lyr, int xyRank, int zRank) {

                XYZLayerRank rank = new XYZLayerRank(lyr.getName(), xyRank, zRank);

                layerRanks.put(lyr, rank);

        }

        public XYZLayerRank getRank(FLyrVect lyr){

                return layerRanks.get(lyr);

        }

        /**

         * Adds a layer to the topology. If the topology has been validated, changes

         * topology status to NON-VALIDATED and adds a dirty zone equals to the

         * layer extent.

         */

        public void addLayer(FLyrVect layer, int xyRank, int zRank) {

                this.addLayer(layer);

                setRank(layer, xyRank, zRank);

        }

        /**

         * Remove a layer from a topology.

         * 

         * This task is more complex than removing a layer from a LayerCollection:

         * -must remove all rules which references to this layer.

         * -must recompute status and dirty zones.

         * etc.

         * 

         * TODO Implement remove layer as a geoprocess.

         * 

         */

        public void removeLayer(FLayer lyr) throws CancelationException {

//                super.removeLayer(lyr);

//                this.layerRanks.remove(lyr);

        }

        /**

         * Ranks (in xy plane and z plane) for layers of the topology.

         * 

         * The rank of layer marks its weight for computing weihgted average

         * coordinates.

         * 

         * @author azabala

         * 

         */

        class XYZLayerRank implements IPersistence {

                int xyRank;

                int zRank;

                String layerName;

                XYZLayerRank(String layerName, int xyRank, int zRank) {

                        this.layerName = layerName;

                        this.xyRank = xyRank;

                        this.zRank = zRank;

                }

                XYZLayerRank(){}

                public String getClassName() {

                        return this.getClass().getName();

                }

                public XMLEntity getXMLEntity() {

                        XMLEntity solution = new XMLEntity();

                        solution.putProperty("layerName", layerName);

                        solution.putProperty("xyRank", xyRank);

                        solution.putProperty("zRank", zRank);

                        return solution;

                }

                public void setXMLEntity(XMLEntity xml) {

                        if(xml.contains("layerName"))

                                layerName = xml.getStringProperty("layerName");

                        if(xml.contains("xyRank"))

                                xyRank = xml.getIntProperty("xyRank");

                        if(xml.contains("zRank"))

                                zRank = xml.getIntProperty("zRank");

                }

        }

        public void setStatus(byte status) {

                this.status = status;

        }

        public byte getStatus() {

                return status;

        }

        /**

         * Adds a dirty zone to the topology (usually whe a feature of a layer of

         * the topology has been edited)

         */

        public void addDirtyZone(Rectangle2D newDirtyZone) {

                if(status == NOT_VALIDATED)

                        return;

                Iterator<Rectangle2D> zonesIt = dirtyZones.iterator();

                while (zonesIt.hasNext()) {

                        Rectangle2D dirtyZone = zonesIt.next();

                        if (dirtyZone.contains(newDirtyZone)) {

                                return;// we dont add this dirty zone. Its redundant

                        }

                        if (newDirtyZone.contains(dirtyZone)) {

                                zonesIt.remove();

                                dirtyZones.add(newDirtyZone);

                                return;

                        }

                        if (dirtyZone.intersects(newDirtyZone)) {

                                dirtyZone.add(newDirtyZone);

                                return;

                        }

                }// while

                if(status == VALIDATED)

                        status = VALIDATED_WITH_DIRTY_ZONES;

                // at this point, we add the new dirty zone

                dirtyZones.add(newDirtyZone);

        }

        public void removeDirtyZone(Rectangle2D newDirtyZone) {

                if(status == NOT_VALIDATED)

                        return;//maybe we must launch an inconsistent status exception

                Iterator<Rectangle2D> zonesIt = dirtyZones.iterator();

                while (zonesIt.hasNext()) {

                        Rectangle2D dirtyZone = zonesIt.next();

                        if (newDirtyZone.contains(dirtyZone)) {

                                zonesIt.remove();

                                continue;

                        }

                }// while

                // at this point, we add the new dirty zone

                dirtyZones.remove(newDirtyZone);

        }

        public Rectangle2D getDirtyZone(int i) {

                return dirtyZones.get(i);

        }

        public int getNumberOfDirtyZones(){

                return dirtyZones.size();

        }

        public void validate(){

                validate(null);

        }

        /**

         * Validates the topology: it validates each topology rule for the given

         * dirty zones. After the end of the process,

         */

        public void validate(CancellableProgressTask progressMonitor) {

                if(progressMonitor != null){

                        progressMonitor.setInitialStep(0);

                        int numOfSteps = rules.size() + clusterToleranceRules.size();

                        progressMonitor.setFinalStep(numOfSteps);

                        progressMonitor.setDeterminatedProcess(true);

                        progressMonitor.setNote(Messages.getText("Validating_a_topology"));

                        progressMonitor.setStatusMessage(Messages.getText(rules.get(0).getDescription()));

                }

                if (this.status == EMPTY) {

                        //TODO Maybe we must do progressMonitor.setFinished(true)

                        //or throw an exception

                        return;

                } else if (this.status == VALIDATED) {

                        return;

                } 

                else if (this.status == NOT_VALIDATED){

                        status = VALIDATING;

                        //we make a local copy of dirty zones to avoid to use dirty zones created in 

                        //the current validation.

                        ArrayList<Rectangle2D> dirtyZonesCopy = new ArrayList<Rectangle2D>();

                        Collections.copy(dirtyZonesCopy, this.dirtyZones);

                        Iterator<MustBeLargerThanClusterTolerance> it = 

                                clusterToleranceRules.iterator();

                        while(it.hasNext()){

                                MustBeLargerThanClusterTolerance rule = it.next();

                                if(progressMonitor != null){

                                        if(progressMonitor.isCanceled()/*|| progressMonitor.isFinished()*/){

                                                resetStatus();

                                                return;

                                        }

                                        progressMonitor.setNote(Messages.getText("VALIDANDO_REGLA")+" "+

                                                   Messages.getText(rule.getName()));

                                        progressMonitor.reportStep();

                                   }

                                if(getNumberOfErrors() >= this.maxNumberOfErrors){

                                        if(progressMonitor != null)

                                                progressMonitor.setCanceled(true);

                                        return;

                                }

                                rule.checkRule(progressMonitor);

                        }

                        Iterator<ITopologyRule> rulesIt = this.rules.iterator();

                        while (rulesIt.hasNext()) {

                                ITopologyRule rule = rulesIt.next();

                                if(progressMonitor != null){

                                        if(progressMonitor.isCanceled()/*|| progressMonitor.isFinished()*/){

                                                resetStatus();

                                                return;

                                        }

                                        progressMonitor.setNote(Messages.getText("VALIDANDO_REGLA")+" "+

                                                   Messages.getText(rule.getName()));

                                        progressMonitor.reportStep();

                                   }

                                if(getNumberOfErrors() >= this.maxNumberOfErrors){

                                        if(progressMonitor != null)

                                                progressMonitor.setCanceled(true);

                                        return;

                                }

                                if(dirtyZonesCopy.size() == 0){

                                        rule.checkRule(progressMonitor);

                                }else{

                                        //A topology is NON_VALIDATED with dirty zones when

                                        //it has VALIDATED status and we add a new rule.

                                        //TODO Check to add a new rule to a topology

                                        //with VALIDATED_WITH_ERROR status

                                        Iterator<Rectangle2D> dirtyZonesIt = dirtyZonesCopy.iterator();

                                        while(dirtyZonesIt.hasNext()){

                                                Rectangle2D rect = dirtyZonesIt.next();

                                                rule.checkRule(progressMonitor,rect);

                                        }//while

                                }//else

                        }//while

                        if(this.errorContainer.getNumberOfErrors() > 0)

                                this.status = VALIDATED_WITH_ERRORS;

                        else

                                this.status = VALIDATED;        

                }

                else if (this.status == VALIDATED_WITH_ERRORS || 

                                this.status == ITopologyStatus.VALIDATED_WITH_DIRTY_ZONES) {

                        status = VALIDATING;

                        // this topology must have at least one dirty zone

                        if (this.dirtyZones.size() < 1){

//                                 FIXME Deberiamos lanzar una

                                // InconsistentStatusException ??

                                return;

                        }

                        Iterator<Rectangle2D> dirtyZonesIt = this.dirtyZones.iterator();

                        while (dirtyZonesIt.hasNext()) {

                                Rectangle2D dirtyZone = dirtyZonesIt.next();

                                Iterator<MustBeLargerThanClusterTolerance> it = this.clusterToleranceRules.iterator();

                                while(it.hasNext()){

                                        MustBeLargerThanClusterTolerance rule = it.next();

                                        if(progressMonitor != null){

                                                if(progressMonitor.isCanceled()/*|| progressMonitor.isFinished()*/){

                                                        resetStatus();

                                                        return;

                                                }

                                                progressMonitor.setNote(Messages.getText("VALIDANDO_REGLA")+" "+

                                                           Messages.getText(rule.getName()));

                                                progressMonitor.reportStep();

                                           }

                                        if(getNumberOfErrors() >= this.maxNumberOfErrors){

                                                if(progressMonitor != null)

                                                        progressMonitor.setCanceled(true);

                                                return;

                                        }

                                        rule.checkRule(dirtyZone);

                                }

                                Iterator<ITopologyRule> rulesIt = this.rules.iterator();

                                while (rulesIt.hasNext()) {

                                        ITopologyRule rule = rulesIt.next();

                                        if(progressMonitor != null){

                                                if(progressMonitor.isCanceled()/*|| progressMonitor.isFinished()*/){

                                                        resetStatus();

                                                        return;

                                                }

                                                progressMonitor.setNote(Messages.getText("VALIDANDO_REGLA")+" "+

                                                           Messages.getText(rule.getName()));

                                                progressMonitor.reportStep();

                                           }

                                        if(getNumberOfErrors() >= this.maxNumberOfErrors){

                                                if(progressMonitor != null)

                                                        progressMonitor.setCanceled(true);

                                                return;

                                        }

                                        rule.checkRule(dirtyZone);

                                }//while

                        }//while

                        if(this.errorContainer.getNumberOfErrors() > 0)

                                this.status = VALIDATED_WITH_ERRORS;

                        else

                                this.status = VALIDATED;

                }//if

        }

        public int getLayerCount() {

                return super.getLayersCount();

        }

        public List getLayers(){

                return this.layers;

        }

        public int getRuleCount() {

                return rules.size();

        }

        public FLyrVect getLyr(int lyrIndex) {

                return (FLyrVect) super.getLayer(lyrIndex);

        }

        public ITopologyRule getRule(int ruleIndex) {

                return rules.get(ruleIndex);

        }

        public ITopologyRule getRuleById(int ruleId){

                for(int i = 0; i < rules.size(); i++){

                        ITopologyRule rule = rules.get(i);

                        if(rule.getId() == ruleId){

                                return rule;

                        }//if

                }//for

                for(int i = 0; i < clusterToleranceRules.size(); i++){

                        MustBeLargerThanClusterTolerance rule = clusterToleranceRules.get(i);

                        if(rule.getId() == ruleId){

                                return rule;

                        }//if

                }

                return null;

        }

        /**

         * Returns if a specified rectangle touch one of the existing dirty zones.

         * If not, probably is needed to add to the dirty zones collection. If true,

         * maybe it could modify the dirty zone.

         */

        public boolean isInDirtyZone(Rectangle2D envelope) {

                Iterator<Rectangle2D> zonesIt = dirtyZones.iterator();

                while (zonesIt.hasNext()) {

                        Rectangle2D rect = zonesIt.next();

                        if (rect.contains(envelope))

                                return true;

                }

                return false;

        }

        /**

         * Modify the dirty zone of the specified index

         * 

         * TODO Make thread safe ?

         */

        public void updateDirtyZone(int dirtyZoneIndex, Rectangle2D dirtyZone) {

                dirtyZones.remove(dirtyZoneIndex);

                dirtyZones.add(dirtyZoneIndex, dirtyZone);

        }

        public void setMaxNumberOfErrors(int maxNumberOfErrors) {

                this.maxNumberOfErrors = maxNumberOfErrors;

        }

        public int getMaxNumberOfErrors() {

                return maxNumberOfErrors;

        }

        /*

         * @see org.gvsig.topology.ITopologyErrorContainer#addTopologyError(org.gvsig.topology.TopologyError)

         */

        public void addTopologyError(TopologyError topologyError) {

                errorContainer.addTopologyError(topologyError);

                Rectangle2D rect = topologyError.getGeometry().getBounds2D();

                addDirtyZone(rect);

        }

        /**

         * marks topologyErrors as an exception (and removes its bounds of the 

         * dirty zones list)

         * @param topologyError error to mark as exceptions

         */

        public void markAsTopologyException(TopologyError topologyError) {

                errorContainer.markAsTopologyException(topologyError);

                Rectangle2D rect = topologyError.getGeometry().getBounds2D();

                removeDirtyZone(rect);

                if(status == VALIDATED_WITH_DIRTY_ZONES){

                        if(dirtyZones.size() == 0)

                                status = VALIDATED;

                }else if(status == VALIDATED_WITH_ERRORS){

                        if(getNumberOfErrors() == getNumberOfExceptions())

                                status = VALIDATED;

                }

        }

        public void demoteToError(TopologyError topologyError) {

                errorContainer.demoteToError(topologyError);

                Rectangle2D rect = topologyError.getGeometry().getBounds2D();

                addDirtyZone(rect);

                if(getNumberOfErrors() > getNumberOfExceptions() )

                        status = VALIDATED_WITH_ERRORS;

        }

        public List<TopologyError> getTopologyErrorsByLyr(FLyrVect layer,

                                                                                                        IProjection desiredProjection, 

                                                                                                        boolean includeExceptions) {

                return errorContainer.getTopologyErrorsByLyr(layer, 

                                                                                 desiredProjection,  

                                                                                 includeExceptions);

        }

        public List<TopologyError> getTopologyErrorsByRule(String ruleName,

                        IProjection desiredProjection, boolean includeExceptions) {

                return errorContainer.getTopologyErrorsByRule(ruleName, 

                                                                                                desiredProjection, 

                                                                                                includeExceptions);

        }

        public List<TopologyError> getTopologyErrorsByShapeType(int shapeType,

                        IProjection desiredProjection, boolean includeExceptions) {

                return errorContainer.getTopologyErrorsByShapeType(shapeType, 

                                                                                                        desiredProjection, 

                                                                                                        includeExceptions);        

        }

        /**

         * Get TopologyError filtered byte shapeType, sourte layer of the rule which

         * was violtated by this error.

         */

        public List<TopologyError> getTopologyErrors(String ruleName,

                        int shapeType, FLyrVect sourceLayer, IProjection desiredProjection,

                        boolean includeExceptions) {

                return errorContainer.getTopologyErrors(ruleName,

                                                                                                shapeType, 

                                                                                                sourceLayer, 

                                                                                                desiredProjection, 

                                                                                                includeExceptions);

        }

        /**

         * Return an unique identifier for the error saved in this

         * TopologyErrorContainer.

         * 

         * Until a new error would be added to this error container, it will

         * return always the same error fid.

         */

        public synchronized String getErrorFid() {

                return errorContainer.getErrorFid();

        }

        public int getNumberOfErrors() {

                return errorContainer.getNumberOfErrors();

        }

        public TopologyError getTopologyError(int index) {

                return errorContainer.getTopologyError(index);

        }

        public void clear() {

                errorContainer.clear();

        }

        public XMLEntity getXMLEntity() throws XMLException{

                //Topology is a subclass of FLayers, so the call to super

                //allows to persist layer status, toc information and layers

                XMLEntity xml = super.getXMLEntity();

                //Si no ponemos esto className ser? FLayerDefault, no??

                xml.putProperty("className", this.getClass().getName());

                xml.putProperty("name", name);

                xml.putProperty("clusterTolerance", clusterTolerance);

                xml.putProperty("status", status);

                xml.putProperty("maxNumberOfErrors", maxNumberOfErrors);

                int numberOfTopologyRules = rules.size();

                xml.putProperty("numberOfTopologyRules", numberOfTopologyRules);

                for(int i = 0; i < numberOfTopologyRules; i++){

                        ITopologyRule rule = rules.get(i);

                        xml.addChild(rule.getXMLEntity());

                }

                int numberOfClusterRules = clusterToleranceRules.size();

                xml.putProperty("numberOfClusterRules", numberOfClusterRules);

                for(int i = 0; i < numberOfClusterRules; i++){

                        MustBeLargerThanClusterTolerance rule = clusterToleranceRules.get(i);

                        xml.addChild(rule.getXMLEntity());

                }

                int numberOfDirtyZones = dirtyZones.size();

                xml.putProperty("numberOfDirtyZones", numberOfDirtyZones);

                for(int i = 0; i < numberOfDirtyZones; i++){

                        Rectangle2D rect = dirtyZones.get(i);

                        if(rect != null){

                                XMLEntity dirtyZoneXML = new XMLEntity();

                                dirtyZoneXML.putProperty("extent" + i + "X", rect.getX());

                                dirtyZoneXML.putProperty("extent" + i + "Y", rect.getY());

                                dirtyZoneXML.putProperty("extent" + i + "W", rect.getWidth());

                                dirtyZoneXML.putProperty("extent" + i + "H", rect.getHeight());        

                                xml.addChild(dirtyZoneXML);

                        }//if

                }//for

                XMLEntity errorContainerXML = errorContainer.getXMLEntity();

                xml.addChild(errorContainerXML);

                Collection<XYZLayerRank> ranksVal = layerRanks.values();

                int numberOfRanks = ranksVal.size();

                xml.putProperty("numberOfRanks", numberOfRanks);

                Iterator<XYZLayerRank> xyzRankIterator = layerRanks.values().iterator();

                while(xyzRankIterator.hasNext()){

                        XYZLayerRank layerRank = xyzRankIterator.next();

                        XMLEntity entity = layerRank.getXMLEntity();

                        xml.addChild(entity);

                }

                return xml;

        }

        public void setXMLEntity(XMLEntity xml) throws XMLException {

                super.setXMLEntity(xml);

                //FIXME Cambiar el uso de childrenCount por el empleo de propiedades

                int numLayers = this.getLayersCount();

                int numProperties = this.getExtendedProperties().size();

                int childrenCount = numLayers + numProperties;

                if(xml.contains("clusterTolerance"))

                {

                        this.clusterTolerance = xml.getDoubleProperty("clusterTolerance");

                }

                if(xml.contains("name"))

                {

                        this.name = xml.getStringProperty("name");

                }

                if(xml.contains("status"))

                {

                        this.status = (byte) xml.getIntProperty("status");

                }

                if(xml.contains("maxNumberOfErrors"))

                {

                        this.maxNumberOfErrors =  xml.getIntProperty("maxNumberOfErrors");

                }

                if(xml.contains("numberOfTopologyRules"))

                {

                        int numberOfTopologyRules =   xml.getIntProperty("numberOfTopologyRules");

                        for(int i = 0; i < numberOfTopologyRules; i++){

                                XMLEntity ruleXML = xml.getChild(childrenCount++);

                                ITopologyRule rule = TopologyRuleFactory.createFromXML(this, ruleXML);

                                this.rules.add(rule);

                        }

                }

                if(xml.contains("numberOfClusterRules")){

                        int numberOfClusterRules = xml.getIntProperty("numberOfClusterRules");

                        for(int i = 0; i < numberOfClusterRules; i++){

                                XMLEntity ruleXML = xml.getChild(childrenCount++);

                                MustBeLargerThanClusterTolerance rule = (MustBeLargerThanClusterTolerance)TopologyRuleFactory.createFromXML(this, ruleXML);

                                this.clusterToleranceRules.add(rule);

                        }

                }

                if(xml.contains("numberOfDirtyZones")){

                        int numberOfDirtyZones = xml.getIntProperty("numberOfDirtyZones");

                        for(int i = 0; i < numberOfDirtyZones; i++){

                                XMLEntity dirtyZoneXml = xml.getChild(childrenCount++);

                                double x = dirtyZoneXml.getDoubleProperty("extent"+i+"X");

                                double y = dirtyZoneXml.getDoubleProperty("extent"+i+"Y");

                                double w = dirtyZoneXml.getDoubleProperty("extent"+i+"W");

                                double h = dirtyZoneXml.getDoubleProperty("extent"+i+"H");

                                Rectangle2D.Double rect = new Rectangle2D.Double(x, y, w, h);

                                dirtyZones.add(rect);

                        }

                }

                XMLEntity errorContainerXML = xml.getChild(childrenCount++);

                if(errorContainerXML != null)

                {

                        this.errorContainer = TopologyPersister.createErrorContainerFromXML(errorContainerXML);

                }

                if(xml.contains("numberOfRanks")){

                        int numberOfRanks = xml.getIntProperty("numberOfRanks");

                        for(int i = 0; i < numberOfRanks; i++){

                                XMLEntity xmlRank = xml.getChild(childrenCount++);

                                XYZLayerRank rank = new XYZLayerRank();

                                rank.setXMLEntity(xmlRank);

                        }

                }                

        }

        public int getNumberOfExceptions() {

                return this.errorContainer.getNumberOfExceptions();

        }

        public String getName() {

                return name;

        }

        public void setName(String name) {

                this.name = name;

        }

        public ITopologyErrorContainer getErrorContainer(){

                return this.errorContainer;

        }

        public void setErrorContainer(ITopologyErrorContainer errorContainer){

                this.errorContainer = errorContainer;

        }

}