bundles/org.simantics.diagram/src/org/simantics/diagram/content/DiagramContentTracker.java

   1 /*******************************************************************************\r
   2  * Copyright (c) 2007, 2010 Association for Decentralized Information Management\r
   3  * in Industry THTH ry.\r
   4  * All rights reserved. This program and the accompanying materials\r
   5  * are made available under the terms of the Eclipse Public License v1.0\r
   6  * which accompanies this distribution, and is available at\r
   7  * http://www.eclipse.org/legal/epl-v10.html\r
   8  *\r
   9  * Contributors:\r
  10  *     VTT Technical Research Centre of Finland - initial API and implementation\r
  11  *******************************************************************************/\r
  12 package org.simantics.diagram.content;\r
  13 \r
  14 import org.simantics.db.RequestProcessor;\r
  15 import org.simantics.db.Resource;\r
  16 import org.simantics.db.Session;\r
  17 import org.simantics.db.exception.DatabaseException;\r
  18 import org.simantics.diagram.adapter.DiagramContentRequest;\r
  19 import org.simantics.diagram.synchronization.ErrorHandler;\r
  20 import org.simantics.g2d.canvas.ICanvasContext;\r
  21 import org.simantics.utils.ui.ErrorLogger;\r
  22 \r
  23 /**\r
  24  * A utility for requesting a diagram's contents and keeping track of them and\r
  25  * obtaining differences.\r
  26  * \r
  27  * <p>\r
  28  * This class is not thread-safe.\r
  29  * \r
  30  * @author Tuukka Lehtonen\r
  31  */\r
  32 public class DiagramContentTracker {\r
  33 \r
  34     private final ErrorHandler errorHandler = new ErrorHandler() {\r
  35         @Override\r
  36         public void warning(String message, Exception e) {\r
  37             ErrorLogger.defaultLogWarning(message, e);\r
  38         }\r
  39         @Override\r
  40         public void error(String message, Throwable t) {\r
  41             ErrorLogger.defaultLogError(message, t);\r
  42         }\r
  43     };\r
  44 \r
  45     private DiagramContents       lastContents   = new DiagramContents();\r
  46     private DiagramContentChanges lastDifference = DiagramContentChanges.EMPTY;\r
  47 \r
  48     private final ICanvasContext  context;\r
  49     private final Session         session;\r
  50     private final Resource        diagram;\r
  51 \r
  52     public static DiagramContentTracker start(ICanvasContext context, RequestProcessor processor, Resource diagram) throws DatabaseException {\r
  53         DiagramContentTracker tracker = new DiagramContentTracker(context, processor.getSession(), diagram);\r
  54         tracker.update(processor);\r
  55         return tracker;\r
  56     }\r
  57 \r
  58     private DiagramContentTracker(ICanvasContext context, Session session, Resource diagram) {\r
  59         if (context == null)\r
  60             throw new NullPointerException("null canvas context");\r
  61         if (session == null)\r
  62             throw new NullPointerException("null session");\r
  63         if (diagram == null)\r
  64             throw new NullPointerException("null diagram");\r
  65         this.context = context;\r
  66         this.session = session;\r
  67         this.diagram = diagram;\r
  68     }\r
  69 \r
  70     public DiagramContentChanges update() throws DatabaseException {\r
  71         return update(session);\r
  72     }\r
  73 \r
  74     public DiagramContentChanges update(RequestProcessor processor) throws DatabaseException {\r
  75         DiagramContents contents = processor.syncRequest(new DiagramContentRequest(context, diagram, errorHandler));\r
  76         DiagramContentChanges changes = contents.differenceFrom(lastContents);\r
  77         this.lastDifference = changes;\r
  78         this.lastContents = contents;\r
  79         return changes;\r
  80     }\r
  81 \r
  82     public DiagramContents getLastContents() {\r
  83         return lastContents;\r
  84     }\r
  85 \r
  86     public DiagramContentChanges getLastDifference() {\r
  87         return lastDifference;\r
  88     }\r
  89 \r
  90 }\r