Commit | Line | Data |
---|---|---|
73005152 | 1 | /********************************************************************** |
c8422608 | 2 | * Copyright (c) 2005, 2013 IBM Corporation, Ericsson |
73005152 BH |
3 | * All rights reserved. This program and the accompanying materials |
4 | * are made available under the terms of the Eclipse Public License v1.0 | |
5 | * which accompanies this distribution, and is available at | |
6 | * http://www.eclipse.org/legal/epl-v10.html | |
a55887ca AM |
7 | * |
8 | * Contributors: | |
c8422608 AM |
9 | * IBM - Initial API and implementation |
10 | * Bernd Hufmann - Updated for TMF | |
73005152 | 11 | **********************************************************************/ |
c8422608 | 12 | |
2bdf0193 | 13 | package org.eclipse.tracecompass.tmf.ui.views.uml2sd.core; |
73005152 BH |
14 | |
15 | import java.util.ArrayList; | |
16 | import java.util.Arrays; | |
17 | import java.util.Iterator; | |
18 | import java.util.List; | |
19 | ||
2bdf0193 AM |
20 | import org.eclipse.tracecompass.tmf.core.timestamp.ITmfTimestamp; |
21 | import org.eclipse.tracecompass.tmf.ui.views.uml2sd.drawings.IColor; | |
22 | import org.eclipse.tracecompass.tmf.ui.views.uml2sd.drawings.IGC; | |
23 | import org.eclipse.tracecompass.tmf.ui.views.uml2sd.preferences.SDViewPref; | |
24 | import org.eclipse.tracecompass.tmf.ui.views.uml2sd.util.TimeEventComparator; | |
73005152 BH |
25 | |
26 | /** | |
27 | * The Frame class is the base sequence diagram graph nodes container.<br> | |
28 | * For instance, only one frame can be drawn in the View.<br> | |
29 | * Lifelines, Messages and Stop which are supposed to represent a Sequence diagram are drawn in a Frame.<br> | |
30 | * Only the graph node added to their representing list will be drawn. | |
a55887ca | 31 | * |
73005152 BH |
32 | * The lifelines are appended along the X axsis when added in a frame.<br> |
33 | * The syncMessages are ordered along the Y axsis depending on the event occurrence they are attached to.<br> | |
a55887ca | 34 | * |
2bdf0193 | 35 | * @see org.eclipse.tracecompass.tmf.ui.views.uml2sd.core.Lifeline Lifeline for more event occurence details |
73005152 BH |
36 | * @author sveyrier |
37 | * @version 1.0 | |
38 | */ | |
39 | public class Frame extends BasicFrame { | |
40 | ||
df0b8ff4 BH |
41 | // ------------------------------------------------------------------------ |
42 | // Attributes | |
43 | // ------------------------------------------------------------------------ | |
44 | /** | |
45 | * The lifeline that is current highlighted. | |
46 | */ | |
cab6c8ff | 47 | private Lifeline fHighlightLifeline = null; |
df0b8ff4 BH |
48 | /** |
49 | * The value of the start event. | |
50 | */ | |
cab6c8ff | 51 | private int fStartEvent = 0; |
df0b8ff4 | 52 | /** |
cab6c8ff | 53 | * The number of events in the frame. |
df0b8ff4 | 54 | */ |
cab6c8ff | 55 | private int fNbEvent = 0; |
df0b8ff4 BH |
56 | /** |
57 | * The color for highlighting. | |
58 | */ | |
cab6c8ff | 59 | private IColor fHighlightColor = null; |
df0b8ff4 BH |
60 | /** |
61 | * The list of time events of the corresponding execution occurrences. | |
62 | */ | |
cab6c8ff | 63 | private List<SDTimeEvent> fExecutionOccurrencesWithTime; |
df0b8ff4 BH |
64 | /** |
65 | * The Array of lifeline categories. | |
66 | */ | |
cab6c8ff | 67 | private LifelineCategories[] fLifelineCategories = null; |
73005152 | 68 | |
df0b8ff4 BH |
69 | // ------------------------------------------------------------------------ |
70 | // Methods | |
71 | // ------------------------------------------------------------------------ | |
72 | ||
73005152 BH |
73 | /** |
74 | * Returns a list of all lifelines known by this frame. Known lifelines are the only one which can be displayed on | |
75 | * screen. | |
a55887ca | 76 | * |
73005152 BH |
77 | * @return the lifelines list |
78 | */ | |
79 | protected List<GraphNode> getLifelines() { | |
cab6c8ff | 80 | if (!hasChildren()) { |
73005152 | 81 | return null; |
a55887ca | 82 | } |
cab6c8ff | 83 | return getNodeMap().get(Lifeline.LIFELINE_TAG); |
73005152 BH |
84 | } |
85 | ||
86 | /** | |
87 | * Returns the number of lifelines stored in the frame | |
a55887ca | 88 | * |
73005152 BH |
89 | * @return the number of lifelines |
90 | */ | |
91 | public int lifeLinesCount() { | |
92 | List<GraphNode> lifelines = getLifelines(); | |
df0b8ff4 | 93 | if (lifelines != null) { |
73005152 | 94 | return lifelines.size(); |
df0b8ff4 BH |
95 | } |
96 | return 0; | |
73005152 BH |
97 | } |
98 | ||
99 | /** | |
100 | * Returns the lifeline at the given index in the lifelines array | |
a55887ca | 101 | * |
73005152 | 102 | * @param index the position in the lifeline array |
df0b8ff4 | 103 | * @return the lifeline or <code>null</code> |
73005152 BH |
104 | */ |
105 | public Lifeline getLifeline(int index) { | |
df0b8ff4 | 106 | if ((getLifelines() != null) && (index >= 0) && (index < lifeLinesCount())) { |
73005152 | 107 | return (Lifeline) getLifelines().get(index); |
df0b8ff4 | 108 | } |
73005152 BH |
109 | return null; |
110 | } | |
111 | ||
112 | /** | |
113 | * Returns a list of syncMessages known by this frame. Known syncMessages are the only on which can be displayed on | |
114 | * screen | |
a55887ca | 115 | * |
73005152 BH |
116 | * @return the syncMessages list |
117 | */ | |
118 | protected List<GraphNode> getSyncMessages() { | |
cab6c8ff | 119 | if (!hasChildren()) { |
73005152 | 120 | return null; |
a55887ca | 121 | } |
cab6c8ff | 122 | return getNodeMap().get(SyncMessage.SYNC_MESS_TAG); |
73005152 BH |
123 | } |
124 | ||
125 | /** | |
126 | * Returns the number of syncMessages stored in the frame | |
a55887ca | 127 | * |
73005152 BH |
128 | * @return the number of syncMessage |
129 | */ | |
130 | public int syncMessageCount() { | |
df0b8ff4 | 131 | if (getSyncMessages() != null) { |
73005152 | 132 | return getSyncMessages().size(); |
a55887ca | 133 | } |
df0b8ff4 | 134 | return 0; |
73005152 BH |
135 | } |
136 | ||
137 | /** | |
138 | * Returns the syncMessage at the given index in the syncMessages array | |
a55887ca | 139 | * |
73005152 | 140 | * @param index the position in the syncMessages array |
df0b8ff4 | 141 | * @return the syncMessage or <code>null</code> |
73005152 BH |
142 | */ |
143 | public SyncMessage getSyncMessage(int index) { | |
df0b8ff4 | 144 | if ((getSyncMessages() != null) && (index >= 0) && (index < getSyncMessages().size())) { |
73005152 | 145 | return (SyncMessage) getSyncMessages().get(index); |
df0b8ff4 | 146 | } |
73005152 BH |
147 | return null; |
148 | } | |
149 | ||
150 | /** | |
151 | * Returns a list of asyncMessages known by this frame. Known asyncMessages are the only on which can be displayed | |
152 | * on screen | |
a55887ca | 153 | * |
df0b8ff4 | 154 | * @return the asyncMessages list or <code>null</code> |
73005152 BH |
155 | */ |
156 | protected List<GraphNode> getAsyncMessages() { | |
cab6c8ff | 157 | if (!hasChildren()) { |
73005152 | 158 | return null; |
df0b8ff4 | 159 | } |
cab6c8ff | 160 | return getNodeMap().get(AsyncMessage.ASYNC_MESS_TAG); |
73005152 BH |
161 | } |
162 | ||
163 | /** | |
164 | * Returns the number of asyncMessage stored in the frame | |
a55887ca | 165 | * |
73005152 BH |
166 | * @return the number of asyncMessage |
167 | */ | |
168 | public int asyncMessageCount() { | |
df0b8ff4 | 169 | if (getAsyncMessages() != null) { |
73005152 | 170 | return getAsyncMessages().size(); |
df0b8ff4 BH |
171 | } |
172 | return 0; | |
73005152 BH |
173 | } |
174 | ||
175 | /** | |
176 | * Returns the asyncMessage at the given index in the asyncMessage array | |
a55887ca | 177 | * |
73005152 | 178 | * @param index the position in the asyncMessage array |
df0b8ff4 | 179 | * @return the asyncMessage or <code>null</code> |
73005152 BH |
180 | */ |
181 | public AsyncMessage getAsyncMessage(int index) { | |
df0b8ff4 | 182 | if ((getAsyncMessages() != null) && (index >= 0) && (index < getAsyncMessages().size())) { |
73005152 | 183 | return (AsyncMessage) getAsyncMessages().get(index); |
df0b8ff4 | 184 | } |
73005152 BH |
185 | return null; |
186 | } | |
187 | ||
188 | /** | |
189 | * Returns a list of syncMessages return known by this frame. Known syncMessages return are the only on which can be | |
190 | * displayed on screen | |
a55887ca | 191 | * |
df0b8ff4 | 192 | * @return the syncMessages return list or <code>null</code> |
73005152 BH |
193 | */ |
194 | protected List<GraphNode> getSyncMessagesReturn() { | |
cab6c8ff | 195 | if (!hasChildren()) { |
73005152 | 196 | return null; |
df0b8ff4 | 197 | } |
cab6c8ff | 198 | return getNodeMap().get(SyncMessageReturn.SYNC_MESS_RET_TAG); |
73005152 BH |
199 | } |
200 | ||
201 | /** | |
202 | * Returns the number of syncMessageReturn stored in the frame | |
a55887ca | 203 | * |
73005152 BH |
204 | * @return the number of syncMessageReturn |
205 | */ | |
206 | public int syncMessageReturnCount() { | |
df0b8ff4 | 207 | if (getSyncMessagesReturn() != null) { |
73005152 | 208 | return getSyncMessagesReturn().size(); |
df0b8ff4 BH |
209 | } |
210 | return 0; | |
73005152 BH |
211 | } |
212 | ||
213 | /** | |
214 | * Returns the syncMessageReturn at the given index in the syncMessageReturn array | |
a55887ca | 215 | * |
73005152 | 216 | * @param index the position in the syncMessageReturn array |
df0b8ff4 | 217 | * @return the syncMessageReturn or <code>null</code> |
73005152 BH |
218 | */ |
219 | public SyncMessageReturn getSyncMessageReturn(int index) { | |
df0b8ff4 | 220 | if ((getSyncMessagesReturn() != null) && (index >= 0) && (index < getSyncMessagesReturn().size())) { |
73005152 | 221 | return (SyncMessageReturn) getSyncMessagesReturn().get(index); |
df0b8ff4 | 222 | } |
73005152 BH |
223 | return null; |
224 | } | |
225 | ||
226 | /** | |
227 | * Returns a list of asyncMessageRetun known by this frame. Known asyncMessageRetun are the only on which can be | |
228 | * displayed on screen | |
a55887ca | 229 | * |
df0b8ff4 | 230 | * @return the asyncMessageRetun list or <code>null</code> |
73005152 BH |
231 | */ |
232 | protected List<GraphNode> getAsyncMessagesReturn() { | |
cab6c8ff | 233 | if (!hasChildren()) { |
73005152 | 234 | return null; |
df0b8ff4 | 235 | } |
cab6c8ff | 236 | return getNodeMap().get(AsyncMessageReturn.ASYNC_MESS_RET_TAG); |
73005152 BH |
237 | } |
238 | ||
239 | /** | |
240 | * Returns the number of asyncMessageReturn stored in the frame | |
a55887ca | 241 | * |
73005152 BH |
242 | * @return the number of asyncMessageReturn |
243 | */ | |
244 | public int asyncMessageReturnCount() { | |
df0b8ff4 | 245 | if (getAsyncMessagesReturn() != null) { |
73005152 | 246 | return getAsyncMessagesReturn().size(); |
df0b8ff4 BH |
247 | } |
248 | return 0; | |
73005152 BH |
249 | } |
250 | ||
251 | /** | |
252 | * Returns the asyncMessageReturn at the given index in the asyncMessageReturn array | |
a55887ca | 253 | * |
73005152 | 254 | * @param index the position in the asyncMessageReturn array |
df0b8ff4 | 255 | * @return the asyncMessageReturn or <code>null</code> |
73005152 BH |
256 | */ |
257 | public AsyncMessageReturn getAsyncMessageReturn(int index) { | |
df0b8ff4 | 258 | if ((getAsyncMessagesReturn() != null) && (index >= 0) && (index < getAsyncMessagesReturn().size())) { |
73005152 | 259 | return (AsyncMessageReturn) getAsyncMessagesReturn().get(index); |
df0b8ff4 | 260 | } |
73005152 BH |
261 | return null; |
262 | } | |
263 | ||
264 | /** | |
265 | * Adds a lifeline to the frame lifelines list. The lifeline X drawing order depends on the lifeline addition order | |
266 | * into the frame lifelines list. | |
a55887ca | 267 | * |
0d9a6d76 | 268 | * @param lifeline the lifeline to add |
73005152 | 269 | */ |
0d9a6d76 | 270 | public void addLifeLine(Lifeline lifeline) { |
cab6c8ff | 271 | setComputeMinMax(true); |
df0b8ff4 | 272 | if (lifeline == null) { |
73005152 | 273 | return; |
df0b8ff4 | 274 | } |
73005152 | 275 | // set the lifeline parent frame |
0d9a6d76 | 276 | lifeline.setFrame(this); |
73005152 BH |
277 | // Increate the frame lifeline counter |
278 | // and set the lifeline drawing order | |
0d9a6d76 FC |
279 | lifeline.setIndex(getNewHorizontalIndex()); |
280 | if (lifeline.hasTimeInfo()) { | |
cab6c8ff | 281 | setHasTimeInfo(true); |
73005152 BH |
282 | } |
283 | // add the lifeline to the lifelines list | |
0d9a6d76 | 284 | addNode(lifeline); |
73005152 BH |
285 | } |
286 | ||
287 | /** | |
288 | * Returns the first visible lifeline drawn in the view | |
a55887ca | 289 | * |
73005152 BH |
290 | * @return the first visible lifeline index |
291 | */ | |
292 | public int getFirstVisibleLifeline() { | |
cab6c8ff | 293 | if (!hasChildren()) { |
73005152 | 294 | return 0; |
cab6c8ff BH |
295 | } else if (getIndexes().get(Lifeline.LIFELINE_TAG) != null) { |
296 | return getIndexes().get(Lifeline.LIFELINE_TAG).intValue(); | |
df0b8ff4 BH |
297 | } |
298 | return 0; | |
73005152 BH |
299 | } |
300 | ||
301 | /** | |
302 | * Returns the first visible synchronous message drawn in the view | |
a55887ca | 303 | * |
73005152 BH |
304 | * @return the first visible synchronous message index |
305 | */ | |
306 | public int getFirstVisibleSyncMessage() { | |
cab6c8ff | 307 | if (!hasChildren()) { |
73005152 | 308 | return 0; |
cab6c8ff BH |
309 | } else if (getIndexes().get(SyncMessage.SYNC_MESS_TAG) != null) { |
310 | return getIndexes().get(SyncMessage.SYNC_MESS_TAG).intValue(); | |
df0b8ff4 BH |
311 | } |
312 | return 0; | |
73005152 BH |
313 | } |
314 | ||
315 | /** | |
316 | * Returns the first visible synchronous message return drawn in the view | |
a55887ca | 317 | * |
73005152 BH |
318 | * @return the first visible synchronous message return index |
319 | */ | |
320 | public int getFirstVisibleSyncMessageReturn() { | |
cab6c8ff | 321 | if (!hasChildren()) { |
73005152 | 322 | return 0; |
cab6c8ff BH |
323 | } else if (getIndexes().get(SyncMessageReturn.SYNC_MESS_RET_TAG) != null) { |
324 | return getIndexes().get(SyncMessageReturn.SYNC_MESS_RET_TAG).intValue(); | |
df0b8ff4 BH |
325 | } |
326 | return 0; | |
73005152 BH |
327 | } |
328 | ||
329 | /** | |
330 | * Returns the first visible synchronous message drawn in the view | |
a55887ca | 331 | * |
73005152 BH |
332 | * @return the first visible synchronous message index |
333 | */ | |
334 | public int getFirstVisibleAsyncMessage() { | |
cab6c8ff | 335 | if (!hasChildren()) { |
73005152 | 336 | return 0; |
cab6c8ff BH |
337 | } else if (getIndexes().get(AsyncMessage.ASYNC_MESS_TAG) != null) { |
338 | return getIndexes().get(AsyncMessage.ASYNC_MESS_TAG).intValue(); | |
df0b8ff4 BH |
339 | } |
340 | return 0; | |
73005152 BH |
341 | } |
342 | ||
343 | /** | |
344 | * Returns the first visible synchronous message return drawn in the view | |
a55887ca | 345 | * |
73005152 BH |
346 | * @return the first visible synchronous message return index |
347 | */ | |
348 | public int getFirstVisibleAsyncMessageReturn() { | |
cab6c8ff | 349 | if (!hasChildren()) { |
73005152 | 350 | return 0; |
cab6c8ff BH |
351 | } else if (getIndexes().get(AsyncMessageReturn.ASYNC_MESS_RET_TAG) != null) { |
352 | return getIndexes().get(AsyncMessageReturn.ASYNC_MESS_RET_TAG).intValue(); | |
df0b8ff4 BH |
353 | } |
354 | return 0; | |
73005152 BH |
355 | } |
356 | ||
df0b8ff4 BH |
357 | /** |
358 | * Returns the list of execution occurrences. | |
a55887ca | 359 | * |
df0b8ff4 BH |
360 | * @return the list of execution occurrences |
361 | */ | |
73005152 | 362 | public List<SDTimeEvent> getExecutionOccurrencesWithTime() { |
eb63f5ff | 363 | return fExecutionOccurrencesWithTime; |
73005152 BH |
364 | } |
365 | ||
df0b8ff4 BH |
366 | /** |
367 | * Inserts a lifeline after a given lifeline. | |
a55887ca | 368 | * |
df0b8ff4 | 369 | * @param toInsert A lifeline to insert |
a55887ca | 370 | * @param after A lifelife the toInsert-lifeline will be inserted after. |
df0b8ff4 | 371 | */ |
73005152 | 372 | public void insertLifelineAfter(Lifeline toInsert, Lifeline after) { |
df0b8ff4 | 373 | if ((toInsert == null)) { |
73005152 | 374 | return; |
df0b8ff4 BH |
375 | } |
376 | if (toInsert == after) { | |
73005152 | 377 | return; |
df0b8ff4 | 378 | } |
73005152 | 379 | int insertPoint = 0; |
df0b8ff4 | 380 | if (after != null) { |
73005152 | 381 | insertPoint = after.getIndex(); |
df0b8ff4 | 382 | } |
73005152 | 383 | int removePoint = toInsert.getIndex() - 1; |
df0b8ff4 | 384 | if (removePoint >= insertPoint) { |
73005152 | 385 | getLifelines().remove(removePoint); |
df0b8ff4 | 386 | } |
73005152 | 387 | getLifelines().add(insertPoint, toInsert); |
df0b8ff4 | 388 | if (removePoint < insertPoint) { |
73005152 | 389 | getLifelines().remove(removePoint); |
df0b8ff4 | 390 | } |
73005152 | 391 | |
df0b8ff4 | 392 | if (removePoint >= insertPoint) { |
73005152 | 393 | toInsert.setIndex(insertPoint + 1); |
df0b8ff4 | 394 | } else { |
73005152 | 395 | toInsert.setIndex(insertPoint - 1); |
df0b8ff4 | 396 | } |
73005152 BH |
397 | |
398 | insertPoint++; | |
399 | if (removePoint >= insertPoint) { | |
400 | for (int i = insertPoint; i < getLifelines().size(); i++) { | |
401 | getLifeline(i).setIndex(i + 1); | |
402 | } | |
403 | } else { | |
404 | for (int i = 0; i < insertPoint && i < getLifelines().size(); i++) { | |
405 | getLifeline(i).setIndex(i + 1); | |
406 | } | |
407 | } | |
408 | } | |
409 | ||
df0b8ff4 BH |
410 | /** |
411 | * Inserts a lifeline before a given lifeline. | |
a55887ca AM |
412 | * |
413 | * @param toInsert | |
414 | * A lifeline to insert | |
415 | * @param before | |
416 | * A lifeline the toInsert-lifeline will be inserted before. | |
df0b8ff4 | 417 | */ |
73005152 | 418 | public void insertLifelineBefore(Lifeline toInsert, Lifeline before) { |
df0b8ff4 | 419 | if ((toInsert == null)) { |
73005152 | 420 | return; |
df0b8ff4 BH |
421 | } |
422 | if (toInsert == before) { | |
73005152 | 423 | return; |
df0b8ff4 | 424 | } |
73005152 | 425 | int insertPoint = 0; |
df0b8ff4 | 426 | if (before != null) { |
73005152 | 427 | insertPoint = before.getIndex() - 1; |
df0b8ff4 | 428 | } |
73005152 | 429 | int removePoint = toInsert.getIndex() - 1; |
df0b8ff4 | 430 | if (removePoint >= insertPoint) { |
73005152 | 431 | getLifelines().remove(removePoint); |
df0b8ff4 | 432 | } |
73005152 | 433 | getLifelines().add(insertPoint, toInsert); |
df0b8ff4 | 434 | if (removePoint < insertPoint) { |
73005152 | 435 | getLifelines().remove(removePoint); |
df0b8ff4 | 436 | } |
73005152 | 437 | |
df0b8ff4 | 438 | if (removePoint >= insertPoint) { |
73005152 | 439 | toInsert.setIndex(insertPoint + 1); |
df0b8ff4 | 440 | } else { |
73005152 | 441 | toInsert.setIndex(insertPoint - 1); |
df0b8ff4 | 442 | } |
73005152 BH |
443 | |
444 | insertPoint++; | |
445 | if (removePoint >= insertPoint) { | |
446 | for (int i = insertPoint; i < getLifelines().size(); i++) { | |
447 | getLifeline(i).setIndex(i + 1); | |
448 | } | |
449 | } else { | |
450 | for (int i = 0; i < insertPoint && i < getLifelines().size(); i++) { | |
451 | getLifeline(i).setIndex(i + 1); | |
452 | } | |
453 | } | |
454 | } | |
455 | ||
df0b8ff4 BH |
456 | /** |
457 | * Gets the closer life line to the given x-coordinate. | |
a55887ca | 458 | * |
df0b8ff4 | 459 | * @param x A x coordinate |
a55887ca | 460 | * @return the closer lifeline |
df0b8ff4 | 461 | */ |
73005152 BH |
462 | public Lifeline getCloserLifeline(int x) { |
463 | int index = (x - Metrics.FRAME_H_MARGIN + Metrics.LIFELINE_H_MAGIN) / Metrics.swimmingLaneWidth() - 1; | |
df0b8ff4 | 464 | if (index < 0) { |
73005152 | 465 | index = 0; |
df0b8ff4 BH |
466 | } |
467 | if (index >= getLifelines().size()) { | |
73005152 | 468 | index = getLifelines().size() - 1; |
df0b8ff4 | 469 | } |
73005152 BH |
470 | Lifeline node1, node2, node3; |
471 | int dist1, dist2, dist3; | |
472 | node1 = node2 = node3 = getLifeline(index); | |
473 | dist1 = dist2 = dist3 = Math.abs(node1.getX() + node1.getWidth() / 2 - x); | |
474 | if (index > 0) { | |
475 | node2 = getLifeline(index - 1); | |
476 | dist2 = Math.abs(node2.getX() + node2.getWidth() / 2 - x); | |
477 | } | |
478 | if (index < getLifelines().size() - 1) { | |
479 | node3 = getLifeline(index + 1); | |
480 | dist3 = Math.abs(node3.getX() + node3.getWidth() / 2 - x); | |
481 | } | |
df0b8ff4 | 482 | if (dist1 <= dist2 && dist1 <= dist3) { |
73005152 | 483 | return node1; |
df0b8ff4 | 484 | } else if (dist2 <= dist1 && dist2 <= dist3) { |
73005152 | 485 | return node2; |
df0b8ff4 BH |
486 | } |
487 | return node3; | |
73005152 BH |
488 | } |
489 | ||
df0b8ff4 BH |
490 | /** |
491 | * Re-orders the given list of lifelines. | |
a55887ca | 492 | * |
df0b8ff4 BH |
493 | * @param list A list of lifelines to reorder. |
494 | */ | |
eb63f5ff | 495 | public void reorder(List<?> list) { |
73005152 BH |
496 | for (int i = 0; i < list.size(); i++) { |
497 | if (list.get(i) instanceof Lifeline[]) { | |
498 | Lifeline temp[] = (Lifeline[]) list.get(i); | |
499 | if (temp.length == 2) { | |
500 | if (temp[1] == null) { | |
501 | insertLifelineAfter(temp[0], getLifeline(lifeLinesCount() - 1)); | |
df0b8ff4 | 502 | } else { |
73005152 | 503 | insertLifelineBefore(temp[0], temp[1]); |
df0b8ff4 | 504 | } |
73005152 BH |
505 | } |
506 | } | |
507 | } | |
508 | } | |
509 | ||
df0b8ff4 BH |
510 | /** |
511 | * Resets the time compression information. | |
512 | */ | |
73005152 | 513 | public void resetTimeCompression() { |
eb63f5ff BH |
514 | fHighlightLifeline = null; |
515 | this.fStartEvent = 0; | |
516 | this.fNbEvent = 0; | |
517 | fHighlightColor = null; | |
73005152 BH |
518 | } |
519 | ||
520 | @Override | |
521 | protected void computeMinMax() { | |
522 | List<SDTimeEvent> timeArray = buildTimeArray(); | |
3145ec83 | 523 | if ((timeArray == null) || timeArray.isEmpty()) { |
73005152 | 524 | return; |
df0b8ff4 | 525 | } |
73005152 | 526 | for (int i = 0; i < timeArray.size() - 1; i++) { |
abbdd66a AM |
527 | SDTimeEvent m1 = timeArray.get(i); |
528 | SDTimeEvent m2 = timeArray.get(i + 1); | |
eb63f5ff BH |
529 | if (SDViewPref.getInstance().excludeExternalTime() && ((m1.getGraphNode() instanceof BaseMessage) && (m2.getGraphNode() instanceof BaseMessage))) { |
530 | BaseMessage mes1 = (BaseMessage) m1.getGraphNode(); | |
531 | BaseMessage mes2 = (BaseMessage) m2.getGraphNode(); | |
cab6c8ff | 532 | if ((mes2.getStartLifeline() == null) || (mes1.getEndLifeline() == null)) { |
eb63f5ff | 533 | continue; |
73005152 | 534 | } |
eb63f5ff | 535 | } |
73005152 BH |
536 | |
537 | updateMinMax(m1, m2); | |
538 | } | |
539 | } | |
540 | ||
541 | /** | |
542 | * Find the two graph nodes that are closest to this date, one just earlier, second just later. If date is before | |
543 | * any graph node, bounds[0] is null and bounds[1] is the earliest. If date is after any graph node, bounds[1] is | |
544 | * null and bounds[0] is the latest. | |
a55887ca | 545 | * |
73005152 BH |
546 | * @param dateToFind date to be found |
547 | * @param bounds a two items array that will receive bounds if found | |
548 | * @return true if both bounds not null | |
3bd46eef | 549 | * @since 2.0 |
73005152 | 550 | */ |
d7dbf09a | 551 | public boolean findDateBounds(ITmfTimestamp dateToFind, ITimeRange bounds[]) { |
73005152 BH |
552 | if (hasTimeInfo()) { |
553 | List<SDTimeEvent> timeArray = buildTimeArray(); | |
3145ec83 BH |
554 | |
555 | if ((timeArray == null) || timeArray.isEmpty()) { | |
556 | return false; | |
557 | } | |
558 | ||
73005152 BH |
559 | bounds[0] = null; |
560 | bounds[1] = null; | |
561 | for (int i = 0; i < timeArray.size(); i++) { | |
abbdd66a | 562 | SDTimeEvent m = timeArray.get(i); |
73005152 BH |
563 | if (m.getTime().compareTo(dateToFind, true) > 0) { |
564 | bounds[1] = m.getGraphNode(); | |
565 | if (i > 0) { | |
abbdd66a | 566 | bounds[0] = timeArray.get(i - 1).getGraphNode(); |
73005152 BH |
567 | return true; |
568 | } | |
569 | return false; | |
570 | } | |
571 | } | |
abbdd66a | 572 | bounds[0] = timeArray.get(timeArray.size() - 1).getGraphNode(); |
73005152 BH |
573 | } |
574 | return false; | |
575 | } | |
576 | ||
73005152 | 577 | /** |
df0b8ff4 | 578 | * Highlights the time compression. |
a55887ca | 579 | * |
df0b8ff4 BH |
580 | * @param lifeline A lifeline to highlight |
581 | * @param startEvent A start event number | |
582 | * @param nbEvent A number of events | |
583 | * @param color A color for highlighting | |
73005152 BH |
584 | */ |
585 | public void highlightTimeCompression(Lifeline lifeline, int startEvent, int nbEvent, IColor color) { | |
eb63f5ff BH |
586 | fHighlightLifeline = lifeline; |
587 | this.fStartEvent = startEvent; | |
588 | this.fNbEvent = nbEvent; | |
589 | fHighlightColor = color; | |
73005152 BH |
590 | } |
591 | ||
592 | /** | |
593 | * Set the lifeline categories which will be use during the lifelines creation | |
a55887ca | 594 | * |
73005152 BH |
595 | * @see Lifeline#setCategory(int) |
596 | * @param categories the lifeline categories array | |
597 | */ | |
598 | public void setLifelineCategories(LifelineCategories[] categories) { | |
eb63f5ff | 599 | fLifelineCategories = Arrays.copyOf(categories, categories.length); |
73005152 BH |
600 | } |
601 | ||
602 | /** | |
603 | * Returns the lifeline categories array set for the this frame | |
a55887ca | 604 | * |
73005152 BH |
605 | * @return the lifeline categories array or null if not set |
606 | */ | |
607 | public LifelineCategories[] getLifelineCategories() { | |
a55887ca | 608 | return Arrays.copyOf(fLifelineCategories, fLifelineCategories.length); |
73005152 BH |
609 | } |
610 | ||
611 | /** | |
612 | * Adds a message to the Frame message list. Four kinds of syncMessages can be added:<br> | |
613 | * - synchronous syncMessages<br> | |
614 | * - synchronous syncMessages return<br> | |
615 | * - asynchronous syncMessages<br> | |
616 | * - asynchronous syncMessages return<br> | |
617 | * For drawing performance reason, it is recommended to add synchronous syncMessages in the same order they should | |
618 | * appear along the Y axis in the Frame. | |
a55887ca | 619 | * |
0d9a6d76 | 620 | * @param message the message to add |
73005152 BH |
621 | */ |
622 | public void addMessage(BaseMessage message) { | |
623 | addNode(message); | |
624 | } | |
625 | ||
626 | @Override | |
627 | public void draw(IGC context) { | |
628 | drawFrame(context); | |
cab6c8ff | 629 | if (!hasChildren()) { |
73005152 | 630 | return; |
df0b8ff4 | 631 | } |
a55887ca | 632 | |
eb63f5ff | 633 | if (fHighlightLifeline != null) { |
73005152 | 634 | IColor backupColor = context.getBackground(); |
3145ec83 | 635 | context.setBackground(SDViewPref.getInstance().getTimeCompressionSelectionColor()); |
eb63f5ff BH |
636 | int gy = fHighlightLifeline.getY() + fHighlightLifeline.getHeight() + (Metrics.getMessageFontHeigth() + Metrics.getMessagesSpacing()) * fStartEvent; |
637 | context.fillRectangle(Metrics.FRAME_H_MARGIN + 1, gy, fHighlightLifeline.getX() + Metrics.getLifelineWidth() / 2 - Metrics.FRAME_H_MARGIN, (Metrics.getMessageFontHeigth() + Metrics.getMessagesSpacing()) * fNbEvent); | |
73005152 BH |
638 | context.setBackground(backupColor); |
639 | } | |
640 | super.draw(context, false); | |
641 | int lifelineArryStep = 1; | |
df0b8ff4 | 642 | if (Metrics.swimmingLaneWidth() * context.getZoom() < Metrics.LIFELINE_SIGNIFICANT_HSPACING) { |
73005152 | 643 | lifelineArryStep = Math.round(Metrics.LIFELINE_SIGNIFICANT_HSPACING / (Metrics.swimmingLaneWidth() * context.getZoom())); |
df0b8ff4 | 644 | } |
cab6c8ff | 645 | if (getIndexes().size() == 0) { |
73005152 | 646 | return; |
df0b8ff4 | 647 | } |
cab6c8ff BH |
648 | int lifeLineDrawIndex = getIndexes().get(Lifeline.LIFELINE_TAG).intValue(); |
649 | for (int i = lifeLineDrawIndex; i < getNodeMap().get(Lifeline.LIFELINE_TAG).size(); i = i + lifelineArryStep) { | |
650 | Lifeline toDraw = (Lifeline) getNodeMap().get(Lifeline.LIFELINE_TAG).get(i); | |
df0b8ff4 | 651 | if (toDraw.getX() - Metrics.LIFELINE_SPACING / 2 > context.getContentsX() + context.getVisibleWidth()) { |
73005152 | 652 | break; |
df0b8ff4 | 653 | } |
73005152 BH |
654 | toDraw.drawName(context); |
655 | ||
eb63f5ff BH |
656 | if (fHighlightLifeline != null) { |
657 | if (toDraw == fHighlightLifeline) { | |
658 | toDraw.highlightExecOccurrenceRegion(context, fStartEvent, fNbEvent, fHighlightColor); | |
659 | } else if ((toDraw.getIndex() < fHighlightLifeline.getIndex()) || ((toDraw.getIndex() < fHighlightLifeline.getIndex()))) { | |
73005152 BH |
660 | |
661 | int acIndex = toDraw.getExecOccurrenceDrawIndex(); | |
662 | // acIndex = first visible execution occurrence | |
663 | // for drawing speed reason with only search on the visible subset | |
df0b8ff4 | 664 | if (toDraw.getExecutions() != null) { |
73005152 BH |
665 | for (int index = acIndex; index < toDraw.getExecutions().size(); index++) { |
666 | BasicExecutionOccurrence exec = (BasicExecutionOccurrence) toDraw.getExecutions().get(index); | |
eb63f5ff BH |
667 | int tempEvent = fStartEvent; |
668 | for (int j = 0; j < fNbEvent; j++) { | |
cab6c8ff | 669 | if (((tempEvent >= exec.getStartOccurrence()) && (tempEvent <= exec.getEndOccurrence()) && (tempEvent + 1 >= exec.getStartOccurrence()) && (tempEvent + 1 <= exec.getEndOccurrence()))) { |
3145ec83 | 670 | toDraw.highlightExecOccurrenceRegion(context, tempEvent, 1, SDViewPref.getInstance().getTimeCompressionSelectionColor()); |
73005152 BH |
671 | } |
672 | tempEvent = tempEvent + 1; | |
673 | } | |
674 | // if we are outside the visible area we stop right now | |
675 | // This works because execution occurrences are ordered along the Y axis | |
df0b8ff4 | 676 | if (exec.getY() > getY()) { |
73005152 | 677 | break; |
df0b8ff4 | 678 | } |
73005152 | 679 | } |
df0b8ff4 | 680 | } |
73005152 BH |
681 | } |
682 | } | |
683 | } | |
684 | } | |
685 | ||
686 | @Override | |
687 | protected List<SDTimeEvent> buildTimeArray() { | |
3145ec83 | 688 | |
cab6c8ff | 689 | if (!hasChildren()) { |
507b1336 | 690 | return new ArrayList<>(); |
3145ec83 BH |
691 | } |
692 | ||
693 | List<SDTimeEvent> timeArray = super.buildTimeArray(); | |
694 | fExecutionOccurrencesWithTime = null; | |
695 | if (getLifelines() != null) { | |
cab6c8ff BH |
696 | for (int i = 0; i < getNodeMap().get(Lifeline.LIFELINE_TAG).size(); i++) { |
697 | Lifeline lifeline = (Lifeline) getNodeMap().get(Lifeline.LIFELINE_TAG).get(i); | |
3145ec83 BH |
698 | if (lifeline.hasTimeInfo() && lifeline.getExecutions() != null) { |
699 | for (Iterator<GraphNode> j = lifeline.getExecutions().iterator(); j.hasNext();) { | |
700 | GraphNode o = j.next(); | |
701 | if (o instanceof ExecutionOccurrence) { | |
702 | ExecutionOccurrence eo = (ExecutionOccurrence) o; | |
703 | if (eo.hasTimeInfo()) { | |
704 | int event = eo.getStartOccurrence(); | |
705 | ITmfTimestamp time = eo.getStartTime(); | |
706 | SDTimeEvent f = new SDTimeEvent(time, event, eo); | |
707 | timeArray.add(f); | |
708 | if (fExecutionOccurrencesWithTime == null) { | |
507b1336 | 709 | fExecutionOccurrencesWithTime = new ArrayList<>(); |
73005152 | 710 | } |
3145ec83 BH |
711 | fExecutionOccurrencesWithTime.add(f); |
712 | event = eo.getEndOccurrence(); | |
713 | time = eo.getEndTime(); | |
714 | f = new SDTimeEvent(time, event, eo); | |
715 | timeArray.add(f); | |
716 | fExecutionOccurrencesWithTime.add(f); | |
73005152 BH |
717 | } |
718 | } | |
719 | } | |
720 | } | |
df0b8ff4 | 721 | } |
3145ec83 | 722 | } |
73005152 | 723 | |
3145ec83 BH |
724 | if (fExecutionOccurrencesWithTime != null) { |
725 | SDTimeEvent[] temp = fExecutionOccurrencesWithTime.toArray(new SDTimeEvent[fExecutionOccurrencesWithTime.size()]); | |
73005152 | 726 | Arrays.sort(temp, new TimeEventComparator()); |
3145ec83 | 727 | fExecutionOccurrencesWithTime = Arrays.asList(temp); |
73005152 | 728 | } |
3145ec83 BH |
729 | SDTimeEvent[] temp = timeArray.toArray(new SDTimeEvent[timeArray.size()]); |
730 | Arrays.sort(temp, new TimeEventComparator()); | |
731 | timeArray = Arrays.asList(temp); | |
732 | return timeArray; | |
73005152 BH |
733 | } |
734 | ||
df0b8ff4 BH |
735 | /** |
736 | * Get the closer leaving message. | |
a55887ca | 737 | * |
df0b8ff4 BH |
738 | * @param lifeline A lifeline reference |
739 | * @param message A message reference | |
740 | * @param list A list of graph nodes | |
741 | * @param smallerEvent A smaller event flag | |
742 | * @return the closer leaving message. | |
743 | */ | |
73005152 | 744 | protected GraphNode getCloserLeavingMessage(Lifeline lifeline, BaseMessage message, List<GraphNode> list, boolean smallerEvent) { |
df0b8ff4 | 745 | if (list == null) { |
73005152 | 746 | return null; |
df0b8ff4 BH |
747 | } |
748 | ||
3145ec83 | 749 | if (!smallerEvent) { |
73005152 | 750 | int event = 0; |
df0b8ff4 | 751 | if (message != null) { |
73005152 | 752 | event = message.getEventOccurrence(); |
df0b8ff4 | 753 | } |
73005152 | 754 | for (int i = 0; i < list.size(); i++) { |
abbdd66a | 755 | GraphNode node = list.get(i); |
73005152 BH |
756 | if (node instanceof SyncMessage) { |
757 | SyncMessage syncNode = (SyncMessage) node; | |
df0b8ff4 | 758 | if ((syncNode.getEventOccurrence() > event) && (syncNode.getStartLifeline() == lifeline) && !syncNode.isSameAs(message)) { |
73005152 | 759 | return node; |
df0b8ff4 | 760 | } |
73005152 BH |
761 | } else if (node instanceof AsyncMessage) { |
762 | AsyncMessage asyncNode = (AsyncMessage) node; | |
df0b8ff4 | 763 | if ((asyncNode.getStartOccurrence() > event) && (asyncNode.getStartLifeline() == lifeline) && !asyncNode.isSameAs(message)) { |
73005152 | 764 | return node; |
df0b8ff4 | 765 | } |
73005152 BH |
766 | } |
767 | } | |
768 | } else { | |
769 | int event = getMaxEventOccurrence(); | |
df0b8ff4 | 770 | if (message != null) { |
73005152 BH |
771 | if (message instanceof AsyncMessage) { |
772 | event = ((AsyncMessage) message).getStartOccurrence(); | |
df0b8ff4 | 773 | } else { |
73005152 | 774 | event = message.getEventOccurrence(); |
df0b8ff4 BH |
775 | } |
776 | } | |
73005152 | 777 | for (int i = list.size() - 1; i >= 0; i--) { |
abbdd66a | 778 | GraphNode node = list.get(i); |
73005152 BH |
779 | if (node instanceof SyncMessage) { |
780 | SyncMessage syncNode = (SyncMessage) node; | |
df0b8ff4 | 781 | if ((syncNode.getEventOccurrence() < event) && (syncNode.getStartLifeline() == lifeline) && !syncNode.isSameAs(message)) { |
73005152 | 782 | return node; |
df0b8ff4 | 783 | } |
73005152 BH |
784 | } else if (node instanceof AsyncMessage) { |
785 | AsyncMessage asyncNode = (AsyncMessage) node; | |
df0b8ff4 | 786 | if ((asyncNode.getStartOccurrence() < event) && (asyncNode.getStartLifeline() == lifeline) && !asyncNode.isSameAs(message)) { |
73005152 | 787 | return node; |
df0b8ff4 | 788 | } |
73005152 BH |
789 | } |
790 | } | |
791 | } | |
792 | return null; | |
793 | } | |
794 | ||
a55887ca | 795 | |
df0b8ff4 BH |
796 | /** |
797 | * Get the closer entering message. | |
a55887ca | 798 | * |
df0b8ff4 BH |
799 | * @param lifeline A lifeline reference |
800 | * @param message A message reference | |
801 | * @param list A list of graph nodes | |
802 | * @param smallerEvent A smaller event flag | |
803 | * @return the closer entering message. | |
804 | */ | |
73005152 | 805 | protected GraphNode getCloserEnteringMessage(Lifeline lifeline, BaseMessage message, List<GraphNode> list, boolean smallerEvent) { |
df0b8ff4 | 806 | if (list == null) { |
73005152 | 807 | return null; |
df0b8ff4 | 808 | } |
eb63f5ff | 809 | if (!smallerEvent) { |
73005152 | 810 | int event = 0; |
df0b8ff4 | 811 | if (message != null) { |
73005152 | 812 | event = message.getEventOccurrence(); |
df0b8ff4 | 813 | } |
73005152 | 814 | for (int i = 0; i < list.size(); i++) { |
abbdd66a | 815 | GraphNode node = list.get(i); |
73005152 BH |
816 | if (node instanceof SyncMessage) { |
817 | SyncMessage syncNode = (SyncMessage) node; | |
df0b8ff4 | 818 | if ((syncNode.getEventOccurrence() > event) && (syncNode.getEndLifeline() == lifeline) && !syncNode.isSameAs(message)) { |
73005152 | 819 | return node; |
df0b8ff4 | 820 | } |
73005152 BH |
821 | } else if (node instanceof AsyncMessage) { |
822 | AsyncMessage asyncNode = (AsyncMessage) node; | |
df0b8ff4 | 823 | if ((asyncNode.getStartOccurrence() > event) && (asyncNode.getEndLifeline() == lifeline) && !asyncNode.isSameAs(message)) { |
73005152 | 824 | return node; |
df0b8ff4 | 825 | } |
73005152 BH |
826 | } |
827 | } | |
828 | } else { | |
829 | int event = getMaxEventOccurrence(); | |
a55887ca | 830 | if (message != null) { |
73005152 BH |
831 | if (message instanceof AsyncMessage) { |
832 | event = ((AsyncMessage) message).getStartOccurrence(); | |
df0b8ff4 | 833 | } else { |
73005152 | 834 | event = message.getEventOccurrence(); |
df0b8ff4 | 835 | } |
a55887ca | 836 | } |
73005152 | 837 | for (int i = list.size() - 1; i >= 0; i--) { |
abbdd66a | 838 | GraphNode node = list.get(i); |
73005152 BH |
839 | if (node instanceof SyncMessage) { |
840 | SyncMessage syncNode = (SyncMessage) node; | |
df0b8ff4 | 841 | if ((syncNode.getEventOccurrence() < event) && (syncNode.getEndLifeline() == lifeline) && !syncNode.isSameAs(message)) { |
73005152 | 842 | return node; |
df0b8ff4 | 843 | } |
73005152 BH |
844 | } else if (node instanceof AsyncMessage) { |
845 | AsyncMessage asyncNode = (AsyncMessage) node; | |
df0b8ff4 | 846 | if ((asyncNode.getStartOccurrence() < event) && (asyncNode.getEndLifeline() == lifeline) && !asyncNode.isSameAs(message)) { |
73005152 | 847 | return node; |
df0b8ff4 | 848 | } |
73005152 BH |
849 | } |
850 | } | |
851 | } | |
852 | return null; | |
853 | } | |
854 | ||
df0b8ff4 BH |
855 | /** |
856 | * Get distance of given event from given graph node. | |
a55887ca | 857 | * |
df0b8ff4 BH |
858 | * @param node A graph node reference. |
859 | * @param event A event number to check. | |
860 | * @return distance of event from graph node. | |
861 | */ | |
73005152 BH |
862 | protected int distanceFromEvent(GraphNode node, int event) { |
863 | int distance = 0; | |
df0b8ff4 | 864 | if (node instanceof SyncMessage) { |
73005152 | 865 | distance = ((SyncMessage) node).getEventOccurrence() - event; |
df0b8ff4 | 866 | } else if (node instanceof AsyncMessage) { |
73005152 BH |
867 | int start = ((AsyncMessage) node).getStartOccurrence(); |
868 | int end = ((AsyncMessage) node).getEndOccurrence(); | |
df0b8ff4 | 869 | if ((start - event) < (end - event)) { |
73005152 | 870 | distance = start - event; |
df0b8ff4 | 871 | } else { |
73005152 | 872 | distance = end - event; |
df0b8ff4 | 873 | } |
73005152 BH |
874 | } |
875 | return Math.abs(distance); | |
876 | } | |
877 | ||
df0b8ff4 BH |
878 | /** |
879 | * Get node from 2 given nodes that is close to event. | |
a55887ca | 880 | * |
df0b8ff4 BH |
881 | * @param node1 A first graph node |
882 | * @param node2 A second graph node | |
883 | * @param event A event to check. | |
884 | * @return graph node that is closer or <code>null</code> | |
885 | */ | |
73005152 BH |
886 | protected GraphNode getCloserToEvent(GraphNode node1, GraphNode node2, int event) { |
887 | if ((node1 != null) && (node2 != null)) { | |
df0b8ff4 | 888 | if (distanceFromEvent(node1, event) < distanceFromEvent(node2, event)) { |
73005152 | 889 | return node1; |
df0b8ff4 | 890 | } |
abbdd66a | 891 | return node2; |
df0b8ff4 | 892 | } else if (node1 != null) { |
73005152 | 893 | return node1; |
df0b8ff4 | 894 | } else if (node2 != null) { |
73005152 | 895 | return node2; |
a55887ca | 896 | } |
df0b8ff4 | 897 | return null; |
73005152 BH |
898 | } |
899 | ||
df0b8ff4 BH |
900 | /** |
901 | * Get called message based on given start message. | |
a55887ca | 902 | * |
df0b8ff4 BH |
903 | * @param startMessage A start message to check. |
904 | * @return called message (graph node) or <code>null</code> | |
905 | */ | |
906 | public GraphNode getCalledMessage(BaseMessage startMessage) { | |
73005152 BH |
907 | int event = 0; |
908 | GraphNode result = null; | |
909 | Lifeline lifeline = null; | |
df0b8ff4 | 910 | if (startMessage != null) { |
abbdd66a AM |
911 | event = startMessage.getEventOccurrence(); |
912 | lifeline = startMessage.getEndLifeline(); | |
df0b8ff4 | 913 | if (lifeline == null) { |
abbdd66a | 914 | lifeline = startMessage.getStartLifeline(); |
df0b8ff4 | 915 | } |
73005152 | 916 | } |
df0b8ff4 | 917 | if (lifeline == null) { |
73005152 | 918 | return null; |
df0b8ff4 BH |
919 | } |
920 | GraphNode message = getCloserLeavingMessage(lifeline, startMessage, getSyncMessages(), false); | |
921 | GraphNode messageReturn = getCloserLeavingMessage(lifeline, startMessage, getSyncMessagesReturn(), false); | |
73005152 | 922 | result = getCloserToEvent(message, messageReturn, event); |
df0b8ff4 | 923 | message = getCloserLeavingMessage(lifeline, startMessage, getAsyncMessages(), false); |
73005152 | 924 | result = getCloserToEvent(result, message, event); |
df0b8ff4 | 925 | messageReturn = getCloserLeavingMessage(lifeline, startMessage, getAsyncMessagesReturn(), false); |
73005152 BH |
926 | result = getCloserToEvent(result, messageReturn, event); |
927 | return result; | |
928 | } | |
929 | ||
df0b8ff4 BH |
930 | /** |
931 | * Get caller message based on given start message. | |
a55887ca | 932 | * |
df0b8ff4 BH |
933 | * @param startMessage A start message to check. |
934 | * @return called message (graph node) or <code>null</code> | |
935 | */ | |
936 | public GraphNode getCallerMessage(BaseMessage startMessage) { | |
73005152 BH |
937 | int event = getMaxEventOccurrence(); |
938 | GraphNode result = null; | |
939 | Lifeline lifeline = null; | |
df0b8ff4 | 940 | if (startMessage != null) { |
abbdd66a AM |
941 | event = startMessage.getEventOccurrence(); |
942 | lifeline = startMessage.getStartLifeline(); | |
df0b8ff4 | 943 | if (lifeline == null) { |
abbdd66a | 944 | lifeline = startMessage.getEndLifeline(); |
df0b8ff4 | 945 | } |
73005152 | 946 | } |
df0b8ff4 | 947 | if (lifeline == null) { |
73005152 | 948 | return null; |
df0b8ff4 BH |
949 | } |
950 | GraphNode message = getCloserEnteringMessage(lifeline, startMessage, getSyncMessages(), true); | |
951 | GraphNode messageReturn = getCloserEnteringMessage(lifeline, startMessage, getSyncMessagesReturn(), true); | |
73005152 | 952 | result = getCloserToEvent(message, messageReturn, event); |
df0b8ff4 | 953 | message = getCloserEnteringMessage(lifeline, startMessage, getAsyncMessages(), true); |
73005152 | 954 | result = getCloserToEvent(result, message, event); |
df0b8ff4 | 955 | messageReturn = getCloserEnteringMessage(lifeline, startMessage, getAsyncMessagesReturn(), true); |
73005152 BH |
956 | result = getCloserToEvent(result, messageReturn, event); |
957 | return result; | |
958 | } | |
959 | ||
df0b8ff4 BH |
960 | /** |
961 | * Get next lifeline based on given message. | |
a55887ca | 962 | * |
df0b8ff4 BH |
963 | * @param lifeline A lifeline reference |
964 | * @param startMessage A start message to check | |
965 | * @return next lifeline or <code>null</code> | |
966 | */ | |
967 | public GraphNode getNextLifelineMessage(Lifeline lifeline, BaseMessage startMessage) { | |
73005152 | 968 | int event = 0; |
df0b8ff4 | 969 | if (startMessage != null) { |
abbdd66a | 970 | event = startMessage.getEventOccurrence(); |
df0b8ff4 BH |
971 | } |
972 | if (lifeline == null) { | |
73005152 | 973 | return null; |
df0b8ff4 BH |
974 | } |
975 | GraphNode message = getCloserLeavingMessage(lifeline, startMessage, getSyncMessages(), false); | |
976 | GraphNode messageReturn = getCloserLeavingMessage(lifeline, startMessage, getSyncMessagesReturn(), false); | |
73005152 | 977 | GraphNode result = getCloserToEvent(message, messageReturn, event); |
df0b8ff4 | 978 | message = getCloserLeavingMessage(lifeline, startMessage, getAsyncMessages(), false); |
73005152 | 979 | result = getCloserToEvent(result, message, event); |
df0b8ff4 | 980 | messageReturn = getCloserLeavingMessage(lifeline, startMessage, getAsyncMessagesReturn(), false); |
73005152 BH |
981 | result = getCloserToEvent(result, messageReturn, event); |
982 | return result; | |
983 | } | |
984 | ||
df0b8ff4 BH |
985 | /** |
986 | * Get previous lifeline based on given message. | |
a55887ca | 987 | * |
df0b8ff4 BH |
988 | * @param lifeline A lifeline reference |
989 | * @param startMessage A start message to check. | |
990 | * @return previous lifeline or <code>null</code> | |
991 | */ | |
992 | public GraphNode getPrevLifelineMessage(Lifeline lifeline, BaseMessage startMessage) { | |
993 | int event = getMaxEventOccurrence(); | |
a55887ca | 994 | if (startMessage != null) { |
df0b8ff4 BH |
995 | if (startMessage instanceof AsyncMessage) { |
996 | event = ((AsyncMessage) startMessage).getStartOccurrence(); | |
997 | } else { | |
998 | event = startMessage.getEventOccurrence(); | |
999 | } | |
a55887ca | 1000 | } |
df0b8ff4 BH |
1001 | if (lifeline == null) { |
1002 | return null; | |
1003 | } | |
1004 | GraphNode message = getCloserLeavingMessage(lifeline, startMessage, getSyncMessages(), true); | |
1005 | GraphNode messageReturn = getCloserLeavingMessage(lifeline, startMessage, getSyncMessagesReturn(), true); | |
1006 | GraphNode result = getCloserToEvent(message, messageReturn, event); | |
1007 | message = getCloserLeavingMessage(lifeline, startMessage, getAsyncMessages(), true); | |
1008 | result = getCloserToEvent(result, message, event); | |
1009 | messageReturn = getCloserLeavingMessage(lifeline, startMessage, getAsyncMessagesReturn(), true); | |
1010 | result = getCloserToEvent(result, messageReturn, event); | |
1011 | return result; | |
1012 | } | |
a55887ca | 1013 | |
df0b8ff4 BH |
1014 | /** |
1015 | * Get the first execution occurrence. | |
a55887ca | 1016 | * |
df0b8ff4 BH |
1017 | * @param lifeline A lifeline reference |
1018 | * @return the first execution occurrence of lifeline or <code>null</code>. | |
1019 | */ | |
73005152 | 1020 | public BasicExecutionOccurrence getFirstExecution(Lifeline lifeline) { |
df0b8ff4 | 1021 | if (lifeline == null) { |
73005152 | 1022 | return null; |
df0b8ff4 | 1023 | } |
73005152 | 1024 | List<GraphNode> list = lifeline.getExecutions(); |
eb63f5ff BH |
1025 | |
1026 | if ((list == null) || (list.isEmpty())) { | |
73005152 | 1027 | return null; |
df0b8ff4 | 1028 | } |
eb63f5ff | 1029 | |
73005152 BH |
1030 | BasicExecutionOccurrence result = (BasicExecutionOccurrence) list.get(0); |
1031 | for (int i = 0; i < list.size(); i++) { | |
1032 | BasicExecutionOccurrence e = (BasicExecutionOccurrence) list.get(i); | |
df0b8ff4 | 1033 | if ((e.getStartOccurrence() < result.getEndOccurrence())) { |
73005152 | 1034 | result = e; |
df0b8ff4 | 1035 | } |
73005152 BH |
1036 | } |
1037 | return result; | |
1038 | } | |
a55887ca | 1039 | |
df0b8ff4 BH |
1040 | /** |
1041 | * Get the previous execution occurrence relative to a given execution occurrence. | |
a55887ca | 1042 | * |
df0b8ff4 BH |
1043 | * @param exec A execution occurrence reference. |
1044 | * @return the previous execution occurrence of lifeline or <code>null</code>. | |
1045 | */ | |
73005152 | 1046 | public BasicExecutionOccurrence getPrevExecOccurrence(BasicExecutionOccurrence exec) { |
df0b8ff4 | 1047 | if (exec == null) { |
73005152 | 1048 | return null; |
df0b8ff4 | 1049 | } |
73005152 | 1050 | Lifeline lifeline = exec.getLifeline(); |
df0b8ff4 | 1051 | if (lifeline == null) { |
73005152 | 1052 | return null; |
df0b8ff4 | 1053 | } |
73005152 | 1054 | List<GraphNode> list = lifeline.getExecutions(); |
df0b8ff4 | 1055 | if (list == null) { |
73005152 | 1056 | return null; |
df0b8ff4 | 1057 | } |
73005152 BH |
1058 | BasicExecutionOccurrence result = null; |
1059 | for (int i = 0; i < list.size(); i++) { | |
1060 | BasicExecutionOccurrence e = (BasicExecutionOccurrence) list.get(i); | |
cab6c8ff | 1061 | if ((e.getStartOccurrence() < exec.getStartOccurrence()) && (result == null)) { |
73005152 | 1062 | result = e; |
df0b8ff4 | 1063 | } |
cab6c8ff | 1064 | if ((e.getStartOccurrence() < exec.getStartOccurrence()) && (result != null) && (e.getStartOccurrence() >= result.getEndOccurrence())) { |
73005152 | 1065 | result = e; |
df0b8ff4 | 1066 | } |
73005152 BH |
1067 | } |
1068 | return result; | |
1069 | } | |
1070 | ||
df0b8ff4 BH |
1071 | /** |
1072 | * Get the next execution occurrence relative to a given execution occurrence. | |
a55887ca | 1073 | * |
df0b8ff4 BH |
1074 | * @param exec A execution occurrence reference. |
1075 | * @return the next execution occurrence of lifeline or <code>null</code>. | |
1076 | */ | |
73005152 | 1077 | public BasicExecutionOccurrence getNextExecOccurrence(BasicExecutionOccurrence exec) { |
df0b8ff4 | 1078 | if (exec == null) { |
73005152 | 1079 | return null; |
df0b8ff4 | 1080 | } |
73005152 | 1081 | Lifeline lifeline = exec.getLifeline(); |
df0b8ff4 | 1082 | if (lifeline == null) { |
73005152 | 1083 | return null; |
df0b8ff4 | 1084 | } |
73005152 | 1085 | List<GraphNode> list = lifeline.getExecutions(); |
df0b8ff4 | 1086 | if (list == null) { |
73005152 | 1087 | return null; |
df0b8ff4 | 1088 | } |
73005152 BH |
1089 | BasicExecutionOccurrence result = null; |
1090 | for (int i = 0; i < list.size(); i++) { | |
1091 | BasicExecutionOccurrence e = (BasicExecutionOccurrence) list.get(i); | |
cab6c8ff | 1092 | if ((e.getStartOccurrence() > exec.getStartOccurrence()) && (result == null)) { |
73005152 | 1093 | result = e; |
df0b8ff4 | 1094 | } |
cab6c8ff | 1095 | if ((e.getStartOccurrence() > exec.getStartOccurrence()) && (result != null) && (e.getStartOccurrence() <= result.getEndOccurrence())) { |
73005152 | 1096 | result = e; |
df0b8ff4 | 1097 | } |
73005152 BH |
1098 | } |
1099 | return result; | |
1100 | } | |
1101 | ||
df0b8ff4 BH |
1102 | /** |
1103 | * Get the last execution occurrence. | |
a55887ca | 1104 | * |
df0b8ff4 BH |
1105 | * @param lifeline A lifeline reference. |
1106 | * @return the last execution occurrence of lifeline or <code>null</code>. | |
1107 | */ | |
73005152 | 1108 | public BasicExecutionOccurrence getLastExecOccurrence(Lifeline lifeline) { |
df0b8ff4 | 1109 | if (lifeline == null) { |
73005152 | 1110 | return null; |
df0b8ff4 | 1111 | } |
73005152 | 1112 | List<GraphNode> list = lifeline.getExecutions(); |
df0b8ff4 | 1113 | if (list == null) { |
73005152 | 1114 | return null; |
df0b8ff4 | 1115 | } |
73005152 BH |
1116 | BasicExecutionOccurrence result = null; |
1117 | for (int i = 0; i < list.size(); i++) { | |
1118 | BasicExecutionOccurrence e = (BasicExecutionOccurrence) list.get(i); | |
df0b8ff4 | 1119 | if (result == null) { |
73005152 | 1120 | result = e; |
df0b8ff4 BH |
1121 | } |
1122 | if (e.getStartOccurrence() > result.getEndOccurrence()) { | |
73005152 | 1123 | result = e; |
df0b8ff4 | 1124 | } |
73005152 BH |
1125 | } |
1126 | return result; | |
1127 | } | |
cab6c8ff BH |
1128 | |
1129 | /** | |
1130 | * @return highlighted life line if set else null. | |
1131 | * @since 2.0 | |
1132 | */ | |
1133 | protected Lifeline getHighlightLifeline() { | |
1134 | return fHighlightLifeline; | |
1135 | } | |
1136 | ||
1137 | /** | |
1138 | * @return the start event value. | |
1139 | * @since 2.0 | |
1140 | */ | |
1141 | protected int getStartEvent() { | |
1142 | return fStartEvent; | |
1143 | } | |
1144 | ||
1145 | /** | |
1146 | * Returns the number of events | |
1147 | * | |
1148 | * @return the number of events | |
1149 | * @since 2.0 | |
1150 | */ | |
1151 | protected int getNumberOfEvents() { | |
1152 | return fNbEvent; | |
1153 | } | |
1154 | ||
1155 | /** | |
1156 | * Returns the highlight color. | |
1157 | * @return the highlight color | |
1158 | * @since 2.0 | |
1159 | */ | |
1160 | protected IColor getHighlightColor() { | |
1161 | return fHighlightColor; | |
1162 | } | |
1163 | ||
1164 | /** | |
1165 | * Set the highlighted life line. | |
1166 | * @param lifeline | |
1167 | * The highlighted life line if set else null | |
1168 | * @since 2.0 | |
1169 | */ | |
1170 | protected void setHighlightLifeline(Lifeline lifeline) { | |
1171 | fHighlightLifeline = lifeline; | |
1172 | } | |
1173 | ||
1174 | /** | |
1175 | * Sets the start event value | |
1176 | * @param startEvent | |
1177 | * the start event value. | |
1178 | * @since 2.0 | |
1179 | */ | |
1180 | protected void setStartEvent(int startEvent) { | |
1181 | fStartEvent = startEvent; | |
1182 | } | |
1183 | ||
1184 | /** | |
1185 | * Sets the number of events | |
1186 | * | |
1187 | * @param nbEvents | |
1188 | * The number of events | |
1189 | * @since 2.0 | |
1190 | */ | |
1191 | protected void setNumberOfEvents(int nbEvents) { | |
1192 | fNbEvent = nbEvents; | |
1193 | } | |
1194 | ||
1195 | /** | |
1196 | * Sets the highlight color. | |
1197 | * @param color | |
1198 | * the highlight color | |
1199 | * @since 2.0 | |
1200 | */ | |
1201 | protected void setHighlightColor(IColor color) { | |
1202 | fHighlightColor = color; | |
1203 | } | |
1204 | ||
1205 | /** | |
1206 | * sets the list of execution occurrences. | |
1207 | * | |
1208 | * @param occurences | |
1209 | * the list of execution occurrences | |
1210 | * @since 2.0 | |
1211 | */ | |
1212 | protected void setExecutionOccurrencesWithTime(List<SDTimeEvent> occurences) { | |
1213 | fExecutionOccurrencesWithTime = occurences; | |
1214 | } | |
1215 | } |