]> gerrit.simantics Code Review - simantics/platform.git/blob - bundles/org.simantics.diagram/src/org/simantics/diagram/flag/FlagUtil.java
Fixed route graph splitting and diagram mapping race condition problem
[simantics/platform.git] / bundles / org.simantics.diagram / src / org / simantics / diagram / flag / FlagUtil.java
1 /*******************************************************************************
2  * Copyright (c) 2007, 2010 Association for Decentralized Information Management
3  * in Industry THTH ry.
4  * All rights reserved. This program and the accompanying materials
5  * are made available under the terms of the Eclipse Public License v1.0
6  * which accompanies this distribution, and is available at
7  * http://www.eclipse.org/legal/epl-v10.html
8  *
9  * Contributors:
10  *     VTT Technical Research Centre of Finland - initial API and implementation
11  *******************************************************************************/
12 package org.simantics.diagram.flag;
13
14 import java.util.Collection;
15 import java.util.Collections;
16 import java.util.HashSet;
17 import java.util.List;
18 import java.util.Set;
19
20 import org.simantics.db.ReadGraph;
21 import org.simantics.db.Resource;
22 import org.simantics.db.Statement;
23 import org.simantics.db.WriteGraph;
24 import org.simantics.db.common.procedure.adapter.TransientCacheListener;
25 import org.simantics.db.common.request.PossibleObjectWithType;
26 import org.simantics.db.common.request.TernaryRead;
27 import org.simantics.db.common.utils.NameUtils;
28 import org.simantics.db.common.utils.OrderedSetUtils;
29 import org.simantics.db.exception.DatabaseException;
30 import org.simantics.db.exception.ServiceException;
31 import org.simantics.db.function.DbBiFunction;
32 import org.simantics.db.function.DbConsumer;
33 import org.simantics.db.layer0.util.RemoverUtil;
34 import org.simantics.db.layer0.variable.Variable;
35 import org.simantics.diagram.content.ConnectionUtil;
36 import org.simantics.diagram.flag.IFlagType.FlagInfo;
37 import org.simantics.diagram.stubs.DiagramResource;
38 import org.simantics.diagram.synchronization.graph.DiagramGraphUtil;
39 import org.simantics.g2d.elementclass.FlagClass;
40 import org.simantics.layer0.Layer0;
41 import org.simantics.layer0.utils.triggers.IActivationManager;
42 import org.simantics.modeling.ModelingResources;
43 import org.simantics.structural.stubs.StructuralResource2;
44 import org.simantics.structural2.modelingRules.IModelingRules;
45 import org.simantics.structural2.queries.Terminal;
46 import org.simantics.structural2.variables.ConnectionBrowser;
47 import org.simantics.structural2.variables.ResourceWithContext;
48 import org.simantics.utils.datastructures.Triple;
49
50 import gnu.trove.set.hash.THashSet;
51
52 /**
53  * @author Tuukka Lehtonen
54  */
55 public final class FlagUtil {
56
57     public static boolean isDisconnected(ReadGraph graph, Resource flag) throws DatabaseException {
58         return !isJoined(graph, flag) && !isMarkedExternal(graph, flag);
59     }
60
61     private static boolean isMarkedExternal(ReadGraph graph, Resource flag) throws DatabaseException {
62         return graph.hasStatement(flag, DiagramResource.getInstance(graph).ExternalFlag);
63     }
64
65     public static boolean isExternal(ReadGraph graph, Resource flag) throws DatabaseException {
66         return isMarkedExternal(graph, flag) && !isJoined(graph, flag);
67     }
68
69     public static boolean isJoined(ReadGraph graph, Resource flag) throws DatabaseException {
70         return countCounterparts(graph, flag) > 0;
71     }
72
73     public static boolean isLifted(ReadGraph graph, Resource flag) throws DatabaseException {
74         Resource cp = getPossibleConnectionPoint(graph, flag);
75         return cp == null ? false : graph.isInstanceOf(cp, StructuralResource2.getInstance(graph).ConnectionRelation);
76     }
77
78     public static Resource getPossibleConnectionPoint(ReadGraph graph, Resource flag) throws DatabaseException {
79         DiagramResource DIA = DiagramResource.getInstance(graph);
80         return graph.getPossibleObject(flag, DIA.IsLiftedAs);
81     }
82
83     public static Resource getPossibleCounterpart(ReadGraph graph, Resource flag) throws DatabaseException {
84         DiagramResource DIA = DiagramResource.getInstance(graph);
85         for (Resource connectionJoin : graph.getObjects(flag, DIA.FlagIsJoinedBy)) {
86             for (Resource otherFlag : graph.getObjects(connectionJoin, DIA.JoinsFlag)) {
87                 if (flag.equals(otherFlag))
88                     continue;
89                 return otherFlag;
90             }
91         }
92         return null;
93     }
94
95     public static int countCounterparts(ReadGraph graph, Resource flag) throws DatabaseException {
96         DiagramResource DIA = DiagramResource.getInstance(graph);
97         int result = 0;
98         for (Resource connectionJoin : graph.getObjects(flag, DIA.FlagIsJoinedBy)) {
99             for (Resource otherFlag : graph.getObjects(connectionJoin, DIA.JoinsFlag)) {
100                 if (flag.equals(otherFlag))
101                     continue;
102                 ++result;
103             }
104         }
105         return result;
106     }
107
108     public static Set<Resource> getCounterparts(ReadGraph graph, Resource flag, Set<Resource> result) throws DatabaseException {
109         DiagramResource DIA = DiagramResource.getInstance(graph);
110         for (Resource connectionJoin : graph.getObjects(flag, DIA.FlagIsJoinedBy)) {
111             for (Resource otherFlag : graph.getObjects(connectionJoin, DIA.JoinsFlag)) {
112                 if (flag.equals(otherFlag))
113                     continue;
114                 result.add(otherFlag);
115             }
116         }
117         return result;
118     }
119
120     public static int forCounterparts(ReadGraph graph, Resource flag, DbConsumer<Resource> procedure) throws DatabaseException {
121         DiagramResource DIA = DiagramResource.getInstance(graph);
122         int count = 0;
123         for (Resource connectionJoin : graph.getObjects(flag, DIA.FlagIsJoinedBy)) {
124             for (Resource otherFlag : graph.getObjects(connectionJoin, DIA.JoinsFlag)) {
125                 if (!flag.equals(otherFlag)) {
126                     procedure.accept(otherFlag);
127                     ++count;
128                 }
129             }
130         }
131         return count;
132     }
133
134     public static int forCounterparts(ReadGraph graph, Resource flag, DbBiFunction<Resource, Resource, Boolean> procedure) throws DatabaseException {
135         DiagramResource DIA = DiagramResource.getInstance(graph);
136         int count = 0;
137         for (Resource connectionJoin : graph.getObjects(flag, DIA.FlagIsJoinedBy)) {
138             for (Resource otherFlag : graph.getObjects(connectionJoin, DIA.JoinsFlag)) {
139                 if (!flag.equals(otherFlag)) {
140                     if (!procedure.apply(connectionJoin, otherFlag))
141                         return ++count;
142                     ++count;
143                 }
144             }
145         }
146         return count;
147     }
148
149     /**
150      * Returns all flags that are joined with the given flag including the flag given as parameter.
151      */
152     public static Set<Resource> getCounterparts(ReadGraph graph, Resource flag) throws DatabaseException {
153         return getCounterparts(graph, flag, new HashSet<Resource>(8));
154     }
155
156     public static Set<Resource> getCounterpartsAndSelf(ReadGraph graph, Resource flag, Set<Resource> result) throws DatabaseException {
157         DiagramResource DIA = DiagramResource.getInstance(graph);
158         for (Resource connectionJoin : graph.getObjects(flag, DIA.FlagIsJoinedBy)) {
159             for (Resource otherFlag : graph.getObjects(connectionJoin, DIA.JoinsFlag)) {
160                 result.add(otherFlag);
161             }
162         }
163         if (result.size() == 0)
164                 result.add(flag);
165         return result;
166     }
167
168     public static Set<Resource> getCounterpartsAndSelf(ReadGraph graph, Resource flag) throws DatabaseException {
169         return getCounterpartsAndSelf(graph, flag, new HashSet<Resource>(8));
170     }
171     /**
172      * @param g
173      * @param flag
174      * @param otherFlag
175      * @return the created DIA.ConnectionJoin instance
176      * @throws DatabaseException
177      */
178     public static Resource join(WriteGraph g, Resource flag, Resource otherFlag) throws DatabaseException {
179         return join(g, flag, otherFlag, true);
180     }
181
182     /**
183      * @param g
184      * @param flag
185      * @param otherFlag
186      * @return the created DIA.ConnectionJoin instance
187      * @throws DatabaseException
188      */
189     public static Resource join(WriteGraph g, Resource flag, Resource otherFlag, boolean activateDiagramMapping) throws DatabaseException {
190         DiagramResource DIA = DiagramResource.getInstance(g);
191         StructuralResource2 STR = StructuralResource2.getInstance(g);
192         Resource connectionJoin = g.newResource();
193         Layer0 L0 = Layer0.getInstance(g);
194         g.claim(connectionJoin, L0.InstanceOf, null, STR.ConnectionJoin);
195         g.claim(connectionJoin, DIA.JoinsFlag, flag);
196         g.claim(connectionJoin, DIA.JoinsFlag, otherFlag);
197
198         if (activateDiagramMapping) {
199             activateMappingForParentDiagramsOf(g, flag, otherFlag);
200         }
201
202         return connectionJoin;
203     }
204
205     public static void activateMappingForParentDiagramsOf(WriteGraph graph, Resource... elements) throws DatabaseException {
206         IActivationManager manager = graph.getService(IActivationManager.class);
207         Set<Resource> diagrams = new HashSet<>(elements.length);
208         for (Resource e : elements) {
209             diagrams.addAll(OrderedSetUtils.getSubjects(graph, e));
210         }
211         for (Resource diagram : diagrams) {
212             manager.activateOnce(graph, diagram);
213         }
214     }
215
216     public static void disconnectFlag(WriteGraph graph, Resource flag) throws DatabaseException {
217         // Remove any :ConnectionJoin's this flag is joined by
218         // if there's less than two flags joined by the join.
219         DiagramResource DIA = DiagramResource.getInstance(graph);
220         StructuralResource2 STR = StructuralResource2.getInstance(graph);
221         THashSet<Resource> affectedConnections = new THashSet<Resource>(4); 
222         for (Resource connectionJoin : graph.getObjects(flag, DIA.FlagIsJoinedBy)) {
223             affectedConnections.addAll(graph.getObjects(connectionJoin, STR.Joins));
224             graph.deny(flag, DIA.FlagIsJoinedBy, connectionJoin);
225             if (graph.getObjects(connectionJoin, DIA.JoinsFlag).size() < 2) {
226                 RemoverUtil.remove(graph, connectionJoin);
227             }
228         }
229         fixBindsStatements(graph, STR, DIA, affectedConnections);
230     }
231
232     private static boolean isBindsStatementLegimite(ReadGraph graph,
233             DiagramResource DIA,
234             Resource connection,
235             Resource connectionRelation) throws DatabaseException {
236         ModelingResources MOD = ModelingResources.getInstance(graph);
237         for(Resource diagramConnection : graph.getObjects(connection, MOD.ConnectionToDiagramConnection))
238             for(Resource connector : graph.getObjects(diagramConnection, DIA.HasConnector))
239                 for(Resource flag : graph.getObjects(connector, DIA.Flag_ConnectionPoint_Inverse))
240                     if(graph.hasStatement(flag, DIA.IsLiftedAs, connectionRelation))
241                         return true;
242         return false;
243     }
244     
245     private static void fixBindsStatements(WriteGraph graph, StructuralResource2 STR, DiagramResource DIA, Collection<Resource> connections) throws DatabaseException {
246         for(Resource connection : connections)
247             for(Resource connectionRelation : graph.getObjects(connection, STR.Binds))
248                 if(!isBindsStatementLegimite(graph, DIA, connection, connectionRelation))
249                     graph.denyStatement(connection, STR.Binds, connectionRelation);
250     }
251     
252     public static void fixBindsStatements(WriteGraph graph, Resource connection) throws DatabaseException {
253         if(connection == null)
254             return;
255         DiagramResource DIA = DiagramResource.getInstance(graph);
256         StructuralResource2 STR = StructuralResource2.getInstance(graph);
257         for(Resource connectionRelation : graph.getObjects(connection, STR.Binds))
258             if(!isBindsStatementLegimite(graph, DIA, connection, connectionRelation))
259                 graph.denyStatement(connection, STR.Binds, connectionRelation);
260     }
261
262     public static void disconnectFlag(WriteGraph graph, Resource flag, Resource fromFlag) throws DatabaseException {
263         DiagramResource DIA = DiagramResource.getInstance(graph);
264         StructuralResource2 STR = StructuralResource2.getInstance(graph);
265         THashSet<Resource> affectedConnections = new THashSet<Resource>(4); 
266         for (Resource connectionJoin : graph.getObjects(flag, DIA.FlagIsJoinedBy)) {
267             affectedConnections.addAll(graph.getObjects(connectionJoin, STR.Joins));
268             for (Resource otherFlag : graph.getObjects(connectionJoin, DIA.JoinsFlag)) {
269                 if (flag.equals(otherFlag))
270                     continue;
271                 if (otherFlag.equals(fromFlag)) {
272                     graph.deny(connectionJoin, DIA.JoinsFlag, DIA.FlagIsJoinedBy, flag);
273                     if (graph.getObjects(connectionJoin, DIA.JoinsFlag).size() < 2) {
274                         RemoverUtil.remove(graph, connectionJoin);
275                     }
276                 }
277             }
278         }
279         fixBindsStatements(graph, STR, DIA, affectedConnections);
280     }
281
282     public static void removeFlag(WriteGraph graph, Resource flag) throws DatabaseException {
283         disconnectFlag(graph, flag);
284         RemoverUtil.remove(graph, flag);
285     }
286
287     /**
288      * @param graph
289      * @param flag
290      * @return <code>true</code> only if the specified flag is joined only
291      *         within the single diagram it resides in
292      * @throws DatabaseException
293      */
294     public static boolean isJoinedInSingleDiagram(ReadGraph graph, Resource flag) throws DatabaseException {
295         Collection<Resource> counterparts = getCounterparts(graph, flag);
296         if (counterparts.isEmpty())
297             return false;
298         DiagramResource DIA = DiagramResource.getInstance(graph);
299         Collection<Resource> flagDiagrams = OrderedSetUtils.getOwnerLists(graph, flag, DIA.Diagram);
300         for (Resource counterpart : counterparts) {
301             if (Collections.disjoint(flagDiagrams,
302                     OrderedSetUtils.getOwnerLists(graph, counterpart, DIA.Diagram)))
303                 return false;
304         }
305         return true;
306     }
307
308     public static boolean isJoinedBetweenDiagrams(ReadGraph graph, Resource flag) throws DatabaseException {
309         DiagramResource DIA = DiagramResource.getInstance(graph);
310         Collection<Resource> counterparts = getCounterparts(graph, flag);
311         if (counterparts.isEmpty())
312             return false;
313         Collection<Resource> flagDiagrams = OrderedSetUtils.getOwnerLists(graph, flag, DIA.Diagram);
314         for (Resource counterpart : counterparts)
315             if (Collections.disjoint(
316                     flagDiagrams,
317                     OrderedSetUtils.getOwnerLists(graph, counterpart, DIA.Diagram)))
318                 return true;
319         return false;
320     }
321
322     /**
323      * @return
324      * @throws DatabaseException
325      */
326     public static FlagClass.Type getFlagType(ReadGraph graph, Resource flag) throws DatabaseException {
327         return getFlagType(graph, flag, null);
328     }
329
330     /**
331      * @return
332      * @throws DatabaseException
333      */
334     public static FlagClass.Type getFlagType(ReadGraph graph, Resource flag, FlagClass.Type defaultFlagType) throws DatabaseException {
335         DiagramResource DIA = DiagramResource.getInstance(graph);
336         Resource type = graph.getPossibleObject(flag, DIA.HasFlagType);
337         return DiagramGraphUtil.toFlagType(DIA, type, defaultFlagType);
338     }
339
340     /**
341      * @return
342      * @throws DatabaseException
343      */
344     public static void setFlagType(WriteGraph graph, Resource flag, FlagClass.Type type) throws DatabaseException {
345         DiagramResource DIA = DiagramResource.getInstance(graph);
346         Resource flagType = DiagramGraphUtil.toFlagTypeResource(DIA, type);
347         Resource existingFlagType = graph.getPossibleObject(flag, DIA.HasFlagType);
348         if (flagType.equals(existingFlagType))
349             return;
350         graph.deny(flag, DIA.HasFlagType);
351 //        Resource defaultFlagType = graph.getPossibleObject(flag, DIA.HasFlagType);
352 //        if (flagType.equals(defaultFlagType))
353 //            return;
354         graph.claim(flag, DIA.HasFlagType, null, flagType);
355     }
356
357     public static Set<Resource> findDirectlyConnectedComponents(ReadGraph graph, Resource flag) throws DatabaseException {
358         StructuralResource2 STR = StructuralResource2.getInstance(graph);
359         ModelingResources MOD = ModelingResources.getInstance(graph);
360
361         for (Resource connector : graph.getObjects(flag, STR.IsConnectedTo)) {
362             Resource diagramConnection = ConnectionUtil.tryGetConnection(graph, connector);
363             if (diagramConnection == null)
364                 continue;
365
366             Resource connection = graph.getPossibleObject(diagramConnection, MOD.DiagramConnectionToConnection);
367             if (connection == null)
368                 continue;
369
370             return new HashSet<Resource>(graph.getObjects(connection, STR.Connects));
371         }
372         return Collections.emptySet();
373     }
374
375     public static Set<Terminal> findDirectlyConnectedTerminals(ReadGraph graph, Resource flag) throws DatabaseException {
376         StructuralResource2 STR = StructuralResource2.getInstance(graph);
377         ModelingResources MOD = ModelingResources.getInstance(graph);
378
379         for (Resource connector : graph.getObjects(flag, STR.IsConnectedTo)) {
380             Resource diagramConnection = ConnectionUtil.tryGetConnection(graph, connector);
381             if (diagramConnection == null)
382                 continue;
383
384             Resource connection = graph.getPossibleObject(diagramConnection, MOD.DiagramConnectionToConnection);
385             if (connection == null)
386                 continue;
387
388             Set<Terminal> terminals = new HashSet<Terminal>();
389             for (Statement stm : graph.getStatements(connection, STR.Connects)) {
390                 terminals.add(new Terminal(stm.getObject(), graph.getInverse(stm.getPredicate())));
391             }
392             return terminals;
393         }
394         return Collections.emptySet();
395     }
396
397     /**
398      * @param graph
399      * @param flag
400      * @return set of (module, terminal relation, attachment relation) triples
401      * @throws DatabaseException
402      */
403     public static Set<Triple<Resource,Resource,Resource>> findDirectlyConnectedElementTerminals(ReadGraph graph, Resource toElement) throws DatabaseException {
404         StructuralResource2 STR = StructuralResource2.getInstance(graph);
405         DiagramResource DIA = DiagramResource.getInstance(graph);
406
407         Set<Triple<Resource, Resource, Resource>> result = new HashSet<Triple<Resource, Resource, Resource>>();
408
409         for (Resource connector : graph.getObjects(toElement, STR.IsConnectedTo)) {
410             Resource diagramConnection = ConnectionUtil.tryGetConnection(graph, connector);
411             if (diagramConnection == null)
412                 continue;
413
414            //System.out.println("DC: " + NameUtils.getSafeName(graph, diagramConnection, true));
415
416             for (Statement connectionToConnector : graph.getStatements(diagramConnection, DIA.HasConnector)) {
417                 Resource connector2 = connectionToConnector.getObject();
418                 if (connector.equals(connector2))
419                     continue;
420
421                 Resource attachmentRelation = connectionToConnector.getPredicate();
422
423                 // Get element + terminal relation
424                 for (Statement connectorToElement : graph.getStatements(connector2, STR.Connects)) {
425                     Resource element = connectorToElement.getObject();
426                     if (diagramConnection.equals(element))
427                         continue;
428                     Resource terminalRelation = graph.getPossibleInverse(connectorToElement.getPredicate());
429                     if (terminalRelation == null)
430                         continue;
431                     result.add(Triple.make(element, terminalRelation, attachmentRelation));
432                 }
433             }
434         }
435
436         return result;
437     }
438     
439     public static Variable getPossibleFlagSignal(ReadGraph graph, Variable configuration, Resource flag, Resource type) throws DatabaseException {
440
441         DiagramResource DIA = DiagramResource.getInstance(graph);
442         ModelingResources MOD = ModelingResources.getInstance(graph);
443
444         Resource component = graph.getPossibleObject(flag, MOD.ElementToComponent);
445         if (component != null && graph.isInstanceOf(component, type)) {
446             Variable v = configuration.browsePossible(graph, component);
447             if (v != null)
448                 return v;
449         }
450
451         Resource connector = graph.getPossibleObject(flag, DIA.Flag_ConnectionPoint);
452         if(connector == null) return null;
453         
454         Resource connection = graph.sync(new PossibleObjectWithType(connector, DIA.IsConnectorOf, DIA.Connection));
455         if(connection == null) return null;
456         
457         return getPossibleConnectionSignal(graph, configuration, connection, type);
458
459     }
460     
461     public static Variable getPossibleConnectionSignal(ReadGraph graph, Variable configuration, Resource connection, Resource type) throws DatabaseException {
462         
463         return graph.syncRequest(new PossibleConnectionSignal(configuration, connection, type), TransientCacheListener.<Variable>instance());
464         
465     }
466     
467     public static class PossibleConnectionSignal extends TernaryRead<Variable, Resource, Resource, Variable> {
468
469                 public PossibleConnectionSignal(Variable configuration, Resource connection, Resource type) {
470                         super(configuration, connection, type);
471                 }
472
473                 @Override
474                 public Variable perform(ReadGraph graph) throws DatabaseException {
475                         
476                 ModelingResources MOD = ModelingResources.getInstance(graph);
477                 DiagramResource DIA = DiagramResource.getInstance(graph);
478
479                 Resource connection = parameter2;
480                 Resource mapped = graph.getPossibleObject(connection, MOD.DiagramConnectionToConnection);
481                 if(mapped != null) connection = mapped;
482
483                 for (ResourceWithContext module : ConnectionBrowser.findConnectedComponents(graph, connection, parameter)) {
484                         if (graph.isInstanceOf(module.getResource(), parameter3)) {
485                                 Resource element = graph.getPossibleObject(module.getResource(), MOD.ComponentToElement);
486                                 if(element != null) {
487                                         if(graph.isInstanceOf(element, DIA.Flag) || graph.isInstanceOf(element, DIA.Connection))
488                                                 return module.getContext();
489                                 } else {
490                                         System.err.println("no element for " + NameUtils.getSafeName(graph, module.getResource()));
491                                 }
492                         }
493                 }
494                 
495                 return null;
496                         
497                 }
498         
499     }
500
501     /**
502      * Verifies that the specified flag has the correct flag type as resolved
503      * through {@link IFlagType}. Please note that using this method assumes
504      * that the diagram mapping has been executed and the configuration is in
505      * sync with the diagram.
506      * 
507      * @param graph
508      * @param modelingRules
509      *            modeling rules for getting the connection type of the flag for
510      *            retrieving {@link IFlagTypeReader} and {@link IFlagType}
511      * @param flag
512      *            the flag for to verify type
513      * @param flagType
514      *            the current type of the flag
515      * @throws DatabaseException
516      */
517     public static void verifyFlagType(WriteGraph graph, IModelingRules modelingRules, Resource flag, FlagClass.Type flagType) throws DatabaseException {
518         if (modelingRules != null) {
519             // Follows the flag loading logic in FlagClassFactory.
520             IFlagTypeReader ftr = null;
521             Resource connectionType = DiagramGraphUtil.getConnectionTypeForFlag(graph, flag);
522             if (connectionType != null) {
523                 //System.out.println("FLAG " + NameUtils.getSafeName(g, flag) + ", CONNECTION TYPE " + NameUtils.getSafeName(g, connectionType));
524                 ftr = graph.getPossibleAdapter(connectionType, IFlagTypeReader.class);
525             }
526             if (ftr == null) {
527                 //System.out.println("FLAG " + NameUtils.getSafeName(g, flag) + ", NO CONNECTION TYPE");
528                 ftr = graph.getPossibleAdapter(flag, IFlagTypeReader.class);
529             }
530
531             if (ftr != null) {
532                 IFlagType ft = ftr.read(graph, flag, modelingRules);
533                 if (ft != null) {
534                     FlagInfo info = ft.getInfo(graph);
535                     if (flagType != info.getType()) {
536                         FlagUtil.setFlagType(graph, flag, info.getType());
537                     }
538                 }
539             }
540         }
541     }
542     
543     public static List<Resource> setFlagExternal (WriteGraph graph, List<Resource> flags, boolean external) throws ServiceException {
544         
545         DiagramResource DIA = DiagramResource.getInstance(graph);
546         for (Resource flag : flags) {
547                 if (external)
548                         graph.claim(flag, DIA.ExternalFlag, DIA.ExternalFlag, flag);
549                 else
550                         graph.deny(flag, DIA.ExternalFlag);
551         }
552         return flags;
553     }
554
555 }