source: josm/trunk/src/org/openstreetmap/josm/actions/mapmode/SelectAction.java@ 10179

Last change on this file since 10179 was 10179, checked in by Don-vip, 8 years ago

sonar - squid:AssignmentInSubExpressionCheck - Assignments should not be made from within sub-expressions

  • Property svn:eol-style set to native
File size: 50.5 KB
Line 
1// License: GPL. For details, see LICENSE file.
2package org.openstreetmap.josm.actions.mapmode;
3
4import static org.openstreetmap.josm.gui.help.HelpUtil.ht;
5import static org.openstreetmap.josm.tools.I18n.tr;
6import static org.openstreetmap.josm.tools.I18n.trn;
7
8import java.awt.Cursor;
9import java.awt.Point;
10import java.awt.Rectangle;
11import java.awt.event.ActionEvent;
12import java.awt.event.ActionListener;
13import java.awt.event.KeyEvent;
14import java.awt.event.MouseEvent;
15import java.awt.geom.Point2D;
16import java.util.Collection;
17import java.util.Collections;
18import java.util.HashSet;
19import java.util.Iterator;
20import java.util.LinkedList;
21import java.util.Set;
22
23import javax.swing.JOptionPane;
24
25import org.openstreetmap.josm.Main;
26import org.openstreetmap.josm.actions.MergeNodesAction;
27import org.openstreetmap.josm.command.AddCommand;
28import org.openstreetmap.josm.command.ChangeCommand;
29import org.openstreetmap.josm.command.Command;
30import org.openstreetmap.josm.command.MoveCommand;
31import org.openstreetmap.josm.command.RotateCommand;
32import org.openstreetmap.josm.command.ScaleCommand;
33import org.openstreetmap.josm.command.SequenceCommand;
34import org.openstreetmap.josm.data.coor.EastNorth;
35import org.openstreetmap.josm.data.coor.LatLon;
36import org.openstreetmap.josm.data.osm.DataSet;
37import org.openstreetmap.josm.data.osm.Node;
38import org.openstreetmap.josm.data.osm.OsmPrimitive;
39import org.openstreetmap.josm.data.osm.Way;
40import org.openstreetmap.josm.data.osm.WaySegment;
41import org.openstreetmap.josm.data.osm.visitor.AllNodesVisitor;
42import org.openstreetmap.josm.data.osm.visitor.paint.WireframeMapRenderer;
43import org.openstreetmap.josm.gui.ExtendedDialog;
44import org.openstreetmap.josm.gui.MapFrame;
45import org.openstreetmap.josm.gui.MapView;
46import org.openstreetmap.josm.gui.SelectionManager;
47import org.openstreetmap.josm.gui.SelectionManager.SelectionEnded;
48import org.openstreetmap.josm.gui.layer.Layer;
49import org.openstreetmap.josm.gui.layer.OsmDataLayer;
50import org.openstreetmap.josm.gui.util.GuiHelper;
51import org.openstreetmap.josm.gui.util.KeyPressReleaseListener;
52import org.openstreetmap.josm.gui.util.ModifierListener;
53import org.openstreetmap.josm.tools.ImageProvider;
54import org.openstreetmap.josm.tools.Pair;
55import org.openstreetmap.josm.tools.Shortcut;
56import org.openstreetmap.josm.tools.Utils;
57
58/**
59 * Move is an action that can move all kind of OsmPrimitives (except keys for now).
60 *
61 * If an selected object is under the mouse when dragging, move all selected objects.
62 * If an unselected object is under the mouse when dragging, it becomes selected
63 * and will be moved.
64 * If no object is under the mouse, move all selected objects (if any)
65 *
66 * On Mac OS X, Ctrl + mouse button 1 simulates right click (map move), so the
67 * feature "selection remove" is disabled on this platform.
68 */
69public class SelectAction extends MapMode implements ModifierListener, KeyPressReleaseListener, SelectionEnded {
70
71 /**
72 * Select action mode.
73 * @since 7543
74 */
75 public enum Mode {
76 /** "MOVE" means either dragging or select if no mouse movement occurs (i.e. just clicking) */
77 MOVE,
78 /** "ROTATE" allows to apply a rotation transformation on the selected object (see {@link RotateCommand}) */
79 ROTATE,
80 /** "SCALE" allows to apply a scaling transformation on the selected object (see {@link ScaleCommand}) */
81 SCALE,
82 /** "SELECT" means the selection rectangle */
83 SELECT
84 }
85
86 // contains all possible cases the cursor can be in the SelectAction
87 private enum SelectActionCursor {
88 rect("normal", /* ICON(cursor/modifier/) */ "selection"),
89 rect_add("normal", /* ICON(cursor/modifier/) */ "select_add"),
90 rect_rm("normal", /* ICON(cursor/modifier/) */ "select_remove"),
91 way("normal", /* ICON(cursor/modifier/) */ "select_way"),
92 way_add("normal", /* ICON(cursor/modifier/) */ "select_way_add"),
93 way_rm("normal", /* ICON(cursor/modifier/) */ "select_way_remove"),
94 node("normal", /* ICON(cursor/modifier/) */ "select_node"),
95 node_add("normal", /* ICON(cursor/modifier/) */ "select_node_add"),
96 node_rm("normal", /* ICON(cursor/modifier/) */ "select_node_remove"),
97 virtual_node("normal", /* ICON(cursor/modifier/) */ "addnode"),
98 scale(/* ICON(cursor/) */ "scale", null),
99 rotate(/* ICON(cursor/) */ "rotate", null),
100 merge(/* ICON(cursor/) */ "crosshair", null),
101 lasso("normal", /* ICON(cursor/modifier/) */ "rope"),
102 merge_to_node("crosshair", /* ICON(cursor/modifier/) */ "joinnode"),
103 move(Cursor.MOVE_CURSOR);
104
105 private final Cursor c;
106 SelectActionCursor(String main, String sub) {
107 c = ImageProvider.getCursor(main, sub);
108 }
109
110 SelectActionCursor(int systemCursor) {
111 c = Cursor.getPredefinedCursor(systemCursor);
112 }
113
114 public Cursor cursor() {
115 return c;
116 }
117 }
118
119 private boolean lassoMode;
120 public boolean repeatedKeySwitchLassoOption;
121
122 // Cache previous mouse event (needed when only the modifier keys are
123 // pressed but the mouse isn't moved)
124 private MouseEvent oldEvent;
125
126 private Mode mode;
127 private final transient SelectionManager selectionManager;
128 private boolean cancelDrawMode;
129 private boolean drawTargetHighlight;
130 private boolean didMouseDrag;
131 /**
132 * The component this SelectAction is associated with.
133 */
134 private final MapView mv;
135 /**
136 * The old cursor before the user pressed the mouse button.
137 */
138 private Point startingDraggingPos;
139 /**
140 * point where user pressed the mouse to start movement
141 */
142 private EastNorth startEN;
143 /**
144 * The last known position of the mouse.
145 */
146 private Point lastMousePos;
147 /**
148 * The time of the user mouse down event.
149 */
150 private long mouseDownTime;
151 /**
152 * The pressed button of the user mouse down event.
153 */
154 private int mouseDownButton;
155 /**
156 * The time of the user mouse down event.
157 */
158 private long mouseReleaseTime;
159 /**
160 * The time which needs to pass between click and release before something
161 * counts as a move, in milliseconds
162 */
163 private int initialMoveDelay;
164 /**
165 * The screen distance which needs to be travelled before something
166 * counts as a move, in pixels
167 */
168 private int initialMoveThreshold;
169 private boolean initialMoveThresholdExceeded;
170
171 /**
172 * elements that have been highlighted in the previous iteration. Used
173 * to remove the highlight from them again as otherwise the whole data
174 * set would have to be checked.
175 */
176 private transient Set<OsmPrimitive> oldHighlights = new HashSet<>();
177
178 /**
179 * Create a new SelectAction
180 * @param mapFrame The MapFrame this action belongs to.
181 */
182 public SelectAction(MapFrame mapFrame) {
183 super(tr("Select"), "move/move", tr("Select, move, scale and rotate objects"),
184 Shortcut.registerShortcut("mapmode:select", tr("Mode: {0}", tr("Select")), KeyEvent.VK_S, Shortcut.DIRECT),
185 mapFrame,
186 ImageProvider.getCursor("normal", "selection"));
187 mv = mapFrame.mapView;
188 putValue("help", ht("/Action/Select"));
189 selectionManager = new SelectionManager(this, false, mv);
190 }
191
192 @Override
193 public void enterMode() {
194 super.enterMode();
195 mv.addMouseListener(this);
196 mv.addMouseMotionListener(this);
197 mv.setVirtualNodesEnabled(Main.pref.getInteger("mappaint.node.virtual-size", 8) != 0);
198 drawTargetHighlight = Main.pref.getBoolean("draw.target-highlight", true);
199 initialMoveDelay = Main.pref.getInteger("edit.initial-move-delay", 200);
200 initialMoveThreshold = Main.pref.getInteger("edit.initial-move-threshold", 5);
201 repeatedKeySwitchLassoOption = Main.pref.getBoolean("mappaint.select.toggle-lasso-on-repeated-S", true);
202 cycleManager.init();
203 virtualManager.init();
204 // This is required to update the cursors when ctrl/shift/alt is pressed
205 Main.map.keyDetector.addModifierListener(this);
206 Main.map.keyDetector.addKeyListener(this);
207 }
208
209 @Override
210 public void exitMode() {
211 super.exitMode();
212 selectionManager.unregister(mv);
213 mv.removeMouseListener(this);
214 mv.removeMouseMotionListener(this);
215 mv.setVirtualNodesEnabled(false);
216 Main.map.keyDetector.removeModifierListener(this);
217 Main.map.keyDetector.removeKeyListener(this);
218 removeHighlighting();
219 }
220
221 @Override
222 public void modifiersChanged(int modifiers) {
223 if (!Main.isDisplayingMapView() || oldEvent == null) return;
224 if (giveUserFeedback(oldEvent, modifiers)) {
225 mv.repaint();
226 }
227 }
228
229 /**
230 * handles adding highlights and updating the cursor for the given mouse event.
231 * Please note that the highlighting for merging while moving is handled via mouseDragged.
232 * @param e {@code MouseEvent} which should be used as base for the feedback
233 * @return {@code true} if repaint is required
234 */
235 private boolean giveUserFeedback(MouseEvent e) {
236 return giveUserFeedback(e, e.getModifiers());
237 }
238
239 /**
240 * handles adding highlights and updating the cursor for the given mouse event.
241 * Please note that the highlighting for merging while moving is handled via mouseDragged.
242 * @param e {@code MouseEvent} which should be used as base for the feedback
243 * @param modifiers define custom keyboard modifiers if the ones from MouseEvent are outdated or similar
244 * @return {@code true} if repaint is required
245 */
246 private boolean giveUserFeedback(MouseEvent e, int modifiers) {
247 Collection<OsmPrimitive> c = asColl(
248 mv.getNearestNodeOrWay(e.getPoint(), mv.isSelectablePredicate, true));
249
250 updateKeyModifiers(modifiers);
251 determineMapMode(!c.isEmpty());
252
253 Set<OsmPrimitive> newHighlights = new HashSet<>();
254
255 virtualManager.clear();
256 if (mode == Mode.MOVE) {
257 if (!dragInProgress() && virtualManager.activateVirtualNodeNearPoint(e.getPoint())) {
258 DataSet ds = getCurrentDataSet();
259 if (ds != null && drawTargetHighlight) {
260 ds.setHighlightedVirtualNodes(virtualManager.virtualWays);
261 }
262 mv.setNewCursor(SelectActionCursor.virtual_node.cursor(), this);
263 // don't highlight anything else if a virtual node will be
264 return repaintIfRequired(newHighlights);
265 }
266 }
267
268 mv.setNewCursor(getCursor(c), this);
269
270 // return early if there can't be any highlights
271 if (!drawTargetHighlight || mode != Mode.MOVE || c.isEmpty())
272 return repaintIfRequired(newHighlights);
273
274 // CTRL toggles selection, but if while dragging CTRL means merge
275 final boolean isToggleMode = ctrl && !dragInProgress();
276 for (OsmPrimitive x : c) {
277 // only highlight primitives that will change the selection
278 // when clicked. I.e. don't highlight selected elements unless
279 // we are in toggle mode.
280 if (isToggleMode || !x.isSelected()) {
281 newHighlights.add(x);
282 }
283 }
284 return repaintIfRequired(newHighlights);
285 }
286
287 /**
288 * works out which cursor should be displayed for most of SelectAction's
289 * features. The only exception is the "move" cursor when actually dragging
290 * primitives.
291 * @param nearbyStuff primitives near the cursor
292 * @return the cursor that should be displayed
293 */
294 private Cursor getCursor(Collection<OsmPrimitive> nearbyStuff) {
295 String c = "rect";
296 switch(mode) {
297 case MOVE:
298 if (virtualManager.hasVirtualNode()) {
299 c = "virtual_node";
300 break;
301 }
302 final Iterator<OsmPrimitive> it = nearbyStuff.iterator();
303 final OsmPrimitive osm = it.hasNext() ? it.next() : null;
304
305 if (dragInProgress()) {
306 // only consider merge if ctrl is pressed and there are nodes in
307 // the selection that could be merged
308 if (!ctrl || getCurrentDataSet().getSelectedNodes().isEmpty()) {
309 c = "move";
310 break;
311 }
312 // only show merge to node cursor if nearby node and that node is currently
313 // not being dragged
314 final boolean hasTarget = osm instanceof Node && !osm.isSelected();
315 c = hasTarget ? "merge_to_node" : "merge";
316 break;
317 }
318
319 c = (osm instanceof Node) ? "node" : c;
320 c = (osm instanceof Way) ? "way" : c;
321 if (shift) {
322 c += "_add";
323 } else if (ctrl) {
324 c += osm == null || osm.isSelected() ? "_rm" : "_add";
325 }
326 break;
327 case ROTATE:
328 c = "rotate";
329 break;
330 case SCALE:
331 c = "scale";
332 break;
333 case SELECT:
334 if (lassoMode) {
335 c = "lasso";
336 } else {
337 c = "rect" + (shift ? "_add" : (ctrl && !Main.isPlatformOsx() ? "_rm" : ""));
338 }
339 break;
340 }
341 return SelectActionCursor.valueOf(c).cursor();
342 }
343
344 /**
345 * Removes all existing highlights.
346 * @return true if a repaint is required
347 */
348 private boolean removeHighlighting() {
349 boolean needsRepaint = false;
350 DataSet ds = getCurrentDataSet();
351 if (ds != null && !ds.getHighlightedVirtualNodes().isEmpty()) {
352 needsRepaint = true;
353 ds.clearHighlightedVirtualNodes();
354 }
355 if (oldHighlights.isEmpty())
356 return needsRepaint;
357
358 for (OsmPrimitive prim : oldHighlights) {
359 prim.setHighlighted(false);
360 }
361 oldHighlights = new HashSet<>();
362 return true;
363 }
364
365 private boolean repaintIfRequired(Set<OsmPrimitive> newHighlights) {
366 if (!drawTargetHighlight)
367 return false;
368
369 boolean needsRepaint = false;
370 for (OsmPrimitive x : newHighlights) {
371 if (oldHighlights.contains(x)) {
372 continue;
373 }
374 needsRepaint = true;
375 x.setHighlighted(true);
376 }
377 oldHighlights.removeAll(newHighlights);
378 for (OsmPrimitive x : oldHighlights) {
379 x.setHighlighted(false);
380 needsRepaint = true;
381 }
382 oldHighlights = newHighlights;
383 return needsRepaint;
384 }
385
386 /**
387 * Look, whether any object is selected. If not, select the nearest node.
388 * If there are no nodes in the dataset, do nothing.
389 *
390 * If the user did not press the left mouse button, do nothing.
391 *
392 * Also remember the starting position of the movement and change the mouse
393 * cursor to movement.
394 */
395 @Override
396 public void mousePressed(MouseEvent e) {
397 mouseDownButton = e.getButton();
398 // return early
399 if (!mv.isActiveLayerVisible() || !(Boolean) this.getValue("active") || mouseDownButton != MouseEvent.BUTTON1)
400 return;
401
402 // left-button mouse click only is processed here
403
404 // request focus in order to enable the expected keyboard shortcuts
405 mv.requestFocus();
406
407 // update which modifiers are pressed (shift, alt, ctrl)
408 updateKeyModifiers(e);
409
410 // We don't want to change to draw tool if the user tries to (de)select
411 // stuff but accidentally clicks in an empty area when selection is empty
412 cancelDrawMode = shift || ctrl;
413 didMouseDrag = false;
414 initialMoveThresholdExceeded = false;
415 mouseDownTime = System.currentTimeMillis();
416 lastMousePos = e.getPoint();
417 startEN = mv.getEastNorth(lastMousePos.x, lastMousePos.y);
418
419 // primitives under cursor are stored in c collection
420
421 OsmPrimitive nearestPrimitive = mv.getNearestNodeOrWay(e.getPoint(), mv.isSelectablePredicate, true);
422
423 determineMapMode(nearestPrimitive != null);
424
425 switch(mode) {
426 case ROTATE:
427 case SCALE:
428 // if nothing was selected, select primitive under cursor for scaling or rotating
429 if (getCurrentDataSet().getSelected().isEmpty()) {
430 getCurrentDataSet().setSelected(asColl(nearestPrimitive));
431 }
432
433 // Mode.select redraws when selectPrims is called
434 // Mode.move redraws when mouseDragged is called
435 // Mode.rotate redraws here
436 // Mode.scale redraws here
437 break;
438 case MOVE:
439 // also include case when some primitive is under cursor and no shift+ctrl / alt+ctrl is pressed
440 // so this is not movement, but selection on primitive under cursor
441 if (!cancelDrawMode && nearestPrimitive instanceof Way) {
442 virtualManager.activateVirtualNodeNearPoint(e.getPoint());
443 }
444 OsmPrimitive toSelect = cycleManager.cycleSetup(nearestPrimitive, e.getPoint());
445 selectPrims(asColl(toSelect), false, false);
446 useLastMoveCommandIfPossible();
447 // Schedule a timer to update status line "initialMoveDelay+1" ms in the future
448 GuiHelper.scheduleTimer(initialMoveDelay+1, new ActionListener() {
449 @Override
450 public void actionPerformed(ActionEvent evt) {
451 updateStatusLine();
452 }
453 }, false);
454 break;
455 case SELECT:
456 default:
457 if (!(ctrl && Main.isPlatformOsx())) {
458 // start working with rectangle or lasso
459 selectionManager.register(mv, lassoMode);
460 selectionManager.mousePressed(e);
461 break;
462 }
463 }
464 if (giveUserFeedback(e)) {
465 mv.repaint();
466 }
467 updateStatusLine();
468 }
469
470 @Override
471 public void mouseMoved(MouseEvent e) {
472 // Mac OSX simulates with ctrl + mouse 1 the second mouse button hence no dragging events get fired.
473 if (Main.isPlatformOsx() && (mode == Mode.ROTATE || mode == Mode.SCALE)) {
474 mouseDragged(e);
475 return;
476 }
477 oldEvent = e;
478 if (giveUserFeedback(e)) {
479 mv.repaint();
480 }
481 }
482
483 /**
484 * If the left mouse button is pressed, move all currently selected
485 * objects (if one of them is under the mouse) or the current one under the
486 * mouse (which will become selected).
487 */
488 @Override
489 public void mouseDragged(MouseEvent e) {
490 if (!mv.isActiveLayerVisible())
491 return;
492
493 // Swing sends random mouseDragged events when closing dialogs by double-clicking their top-left icon on Windows
494 // Ignore such false events to prevent issues like #7078
495 if (mouseDownButton == MouseEvent.BUTTON1 && mouseReleaseTime > mouseDownTime)
496 return;
497
498 cancelDrawMode = true;
499 if (mode == Mode.SELECT) {
500 // Unregisters selectionManager if ctrl has been pressed after mouse click on Mac OS X in order to move the map
501 if (ctrl && Main.isPlatformOsx()) {
502 selectionManager.unregister(mv);
503 mv.requestClearRect();
504 // Make sure correct cursor is displayed
505 mv.setNewCursor(Cursor.MOVE_CURSOR, this);
506 }
507 return;
508 }
509
510 // do not count anything as a move if it lasts less than 100 milliseconds.
511 if ((mode == Mode.MOVE) && (System.currentTimeMillis() - mouseDownTime < initialMoveDelay))
512 return;
513
514 if (mode != Mode.ROTATE && mode != Mode.SCALE && (e.getModifiersEx() & MouseEvent.BUTTON1_DOWN_MASK) == 0) {
515 // button is pressed in rotate mode
516 return;
517 }
518
519 if (mode == Mode.MOVE) {
520 // If ctrl is pressed we are in merge mode. Look for a nearby node,
521 // highlight it and adjust the cursor accordingly.
522 final boolean canMerge = ctrl && !getCurrentDataSet().getSelectedNodes().isEmpty();
523 final OsmPrimitive p = canMerge ? findNodeToMergeTo(e.getPoint()) : null;
524 boolean needsRepaint = removeHighlighting();
525 if (p != null) {
526 p.setHighlighted(true);
527 oldHighlights.add(p);
528 needsRepaint = true;
529 }
530 mv.setNewCursor(getCursor(asColl(p)), this);
531 // also update the stored mouse event, so we can display the correct cursor
532 // when dragging a node onto another one and then press CTRL to merge
533 oldEvent = e;
534 if (needsRepaint) {
535 mv.repaint();
536 }
537 }
538
539 if (startingDraggingPos == null) {
540 startingDraggingPos = new Point(e.getX(), e.getY());
541 }
542
543 if (lastMousePos == null) {
544 lastMousePos = e.getPoint();
545 return;
546 }
547
548 if (!initialMoveThresholdExceeded) {
549 int dp = (int) lastMousePos.distance(e.getX(), e.getY());
550 if (dp < initialMoveThreshold)
551 return; // ignore small drags
552 initialMoveThresholdExceeded = true; //no more ingnoring uintil nex mouse press
553 }
554 if (e.getPoint().equals(lastMousePos))
555 return;
556
557 EastNorth currentEN = mv.getEastNorth(e.getX(), e.getY());
558
559 if (virtualManager.hasVirtualWaysToBeConstructed()) {
560 virtualManager.createMiddleNodeFromVirtual(currentEN);
561 } else {
562 if (!updateCommandWhileDragging(currentEN)) return;
563 }
564
565 mv.repaint();
566 if (mode != Mode.SCALE) {
567 lastMousePos = e.getPoint();
568 }
569
570 didMouseDrag = true;
571 }
572
573 @Override
574 public void mouseExited(MouseEvent e) {
575 if (removeHighlighting()) {
576 mv.repaint();
577 }
578 }
579
580 @Override
581 public void mouseReleased(MouseEvent e) {
582 if (!mv.isActiveLayerVisible())
583 return;
584
585 startingDraggingPos = null;
586 mouseReleaseTime = System.currentTimeMillis();
587
588 if (mode == Mode.SELECT) {
589 if (e.getButton() != MouseEvent.BUTTON1) {
590 return;
591 }
592 selectionManager.endSelecting(e);
593 selectionManager.unregister(mv);
594
595 // Select Draw Tool if no selection has been made
596 if (getCurrentDataSet().getSelected().isEmpty() && !cancelDrawMode) {
597 Main.map.selectDrawTool(true);
598 updateStatusLine();
599 return;
600 }
601 }
602
603 if (mode == Mode.MOVE && e.getButton() == MouseEvent.BUTTON1) {
604 if (!didMouseDrag) {
605 // only built in move mode
606 virtualManager.clear();
607 // do nothing if the click was to short too be recognized as a drag,
608 // but the release position is farther than 10px away from the press position
609 if (lastMousePos == null || lastMousePos.distanceSq(e.getPoint()) < 100) {
610 updateKeyModifiers(e);
611 selectPrims(cycleManager.cyclePrims(), true, false);
612
613 // If the user double-clicked a node, change to draw mode
614 Collection<OsmPrimitive> c = getCurrentDataSet().getSelected();
615 if (e.getClickCount() >= 2 && c.size() == 1 && c.iterator().next() instanceof Node) {
616 // We need to do it like this as otherwise drawAction will see a double
617 // click and switch back to SelectMode
618 Main.worker.execute(new Runnable() {
619 @Override
620 public void run() {
621 Main.map.selectDrawTool(true);
622 }
623 });
624 return;
625 }
626 }
627 } else {
628 confirmOrUndoMovement(e);
629 }
630 }
631
632 mode = null;
633
634 // simply remove any highlights if the middle click popup is active because
635 // the highlights don't depend on the cursor position there. If something was
636 // selected beforehand this would put us into move mode as well, which breaks
637 // the cycling through primitives on top of each other (see #6739).
638 if (e.getButton() == MouseEvent.BUTTON2) {
639 removeHighlighting();
640 } else {
641 giveUserFeedback(e);
642 }
643 updateStatusLine();
644 }
645
646 @Override
647 public void selectionEnded(Rectangle r, MouseEvent e) {
648 updateKeyModifiers(e);
649 selectPrims(selectionManager.getSelectedObjects(alt), true, true);
650 }
651
652 @Override
653 public void doKeyPressed(KeyEvent e) {
654 if (!Main.isDisplayingMapView() ||
655 !repeatedKeySwitchLassoOption || !getShortcut().isEvent(e)) return;
656 if (Main.isDebugEnabled()) {
657 Main.debug(getClass().getName()+" consuming event "+e);
658 }
659 e.consume();
660 if (!lassoMode) {
661 Main.map.selectMapMode(Main.map.mapModeSelectLasso);
662 } else {
663 Main.map.selectMapMode(Main.map.mapModeSelect);
664 }
665 }
666
667 @Override
668 public void doKeyReleased(KeyEvent e) {
669 // Do nothing
670 }
671
672 /**
673 * sets the mapmode according to key modifiers and if there are any
674 * selectables nearby. Everything has to be pre-determined for this
675 * function; its main purpose is to centralize what the modifiers do.
676 * @param hasSelectionNearby {@code true} if some primitves are selectable nearby
677 */
678 private void determineMapMode(boolean hasSelectionNearby) {
679 if (shift && ctrl) {
680 mode = Mode.ROTATE;
681 } else if (alt && ctrl) {
682 mode = Mode.SCALE;
683 } else if (hasSelectionNearby || dragInProgress()) {
684 mode = Mode.MOVE;
685 } else {
686 mode = Mode.SELECT;
687 }
688 }
689
690 /**
691 * Determines whenever elements have been grabbed and moved (i.e. the initial
692 * thresholds have been exceeded) and is still in progress (i.e. mouse button still pressed)
693 * @return true if a drag is in progress
694 */
695 private boolean dragInProgress() {
696 return didMouseDrag && startingDraggingPos != null;
697 }
698
699 /**
700 * Create or update data modification command while dragging mouse - implementation of
701 * continuous moving, scaling and rotation
702 * @param currentEN - mouse position
703 * @return status of action (<code>true</code> when action was performed)
704 */
705 private boolean updateCommandWhileDragging(EastNorth currentEN) {
706 // Currently we support only transformations which do not affect relations.
707 // So don't add them in the first place to make handling easier
708 Collection<OsmPrimitive> selection = getCurrentDataSet().getSelectedNodesAndWays();
709 if (selection.isEmpty()) { // if nothing was selected to drag, just select nearest node/way to the cursor
710 OsmPrimitive nearestPrimitive = mv.getNearestNodeOrWay(mv.getPoint(startEN), mv.isSelectablePredicate, true);
711 getCurrentDataSet().setSelected(nearestPrimitive);
712 }
713
714 Collection<Node> affectedNodes = AllNodesVisitor.getAllNodes(selection);
715 // for these transformations, having only one node makes no sense - quit silently
716 if (affectedNodes.size() < 2 && (mode == Mode.ROTATE || mode == Mode.SCALE)) {
717 return false;
718 }
719 Command c = getLastCommand();
720 if (mode == Mode.MOVE) {
721 if (startEN == null) return false; // fix #8128
722 getCurrentDataSet().beginUpdate();
723 if (c instanceof MoveCommand && affectedNodes.equals(((MoveCommand) c).getParticipatingPrimitives())) {
724 ((MoveCommand) c).saveCheckpoint();
725 ((MoveCommand) c).applyVectorTo(currentEN);
726 } else {
727 c = new MoveCommand(selection, startEN, currentEN);
728 Main.main.undoRedo.add(c);
729 }
730 for (Node n : affectedNodes) {
731 LatLon ll = n.getCoor();
732 if (ll != null && ll.isOutSideWorld()) {
733 // Revert move
734 ((MoveCommand) c).resetToCheckpoint();
735 getCurrentDataSet().endUpdate();
736 JOptionPane.showMessageDialog(
737 Main.parent,
738 tr("Cannot move objects outside of the world."),
739 tr("Warning"),
740 JOptionPane.WARNING_MESSAGE);
741 mv.setNewCursor(cursor, this);
742 return false;
743 }
744 }
745 } else {
746 startEN = currentEN; // drag can continue after scaling/rotation
747
748 if (mode != Mode.ROTATE && mode != Mode.SCALE) {
749 return false;
750 }
751
752 getCurrentDataSet().beginUpdate();
753
754 if (mode == Mode.ROTATE) {
755 if (c instanceof RotateCommand && affectedNodes.equals(((RotateCommand) c).getTransformedNodes())) {
756 ((RotateCommand) c).handleEvent(currentEN);
757 } else {
758 Main.main.undoRedo.add(new RotateCommand(selection, currentEN));
759 }
760 } else if (mode == Mode.SCALE) {
761 if (c instanceof ScaleCommand && affectedNodes.equals(((ScaleCommand) c).getTransformedNodes())) {
762 ((ScaleCommand) c).handleEvent(currentEN);
763 } else {
764 Main.main.undoRedo.add(new ScaleCommand(selection, currentEN));
765 }
766 }
767
768 Collection<Way> ways = getCurrentDataSet().getSelectedWays();
769 if (doesImpactStatusLine(affectedNodes, ways)) {
770 Main.map.statusLine.setDist(ways);
771 }
772 }
773 getCurrentDataSet().endUpdate();
774 return true;
775 }
776
777 private static boolean doesImpactStatusLine(Collection<Node> affectedNodes, Collection<Way> selectedWays) {
778 for (Way w : selectedWays) {
779 for (Node n : w.getNodes()) {
780 if (affectedNodes.contains(n)) {
781 return true;
782 }
783 }
784 }
785 return false;
786 }
787
788 /**
789 * Adapt last move command (if it is suitable) to work with next drag, started at point startEN
790 */
791 private void useLastMoveCommandIfPossible() {
792 Command c = getLastCommand();
793 Collection<Node> affectedNodes = AllNodesVisitor.getAllNodes(getCurrentDataSet().getSelected());
794 if (c instanceof MoveCommand && affectedNodes.equals(((MoveCommand) c).getParticipatingPrimitives())) {
795 // old command was created with different base point of movement, we need to recalculate it
796 ((MoveCommand) c).changeStartPoint(startEN);
797 }
798 }
799
800 /**
801 * Obtain command in undoRedo stack to "continue" when dragging
802 * @return last command
803 */
804 private static Command getLastCommand() {
805 Command c = !Main.main.undoRedo.commands.isEmpty()
806 ? Main.main.undoRedo.commands.getLast() : null;
807 if (c instanceof SequenceCommand) {
808 c = ((SequenceCommand) c).getLastCommand();
809 }
810 return c;
811 }
812
813 /**
814 * Present warning in the following cases and undo unwanted movements: <ul>
815 * <li>large and possibly unwanted movements</li>
816 * <li>movement of node with attached ways that are hidden by filters</li>
817 * </ul>
818 *
819 * @param e the mouse event causing the action (mouse released)
820 */
821 private void confirmOrUndoMovement(MouseEvent e) {
822 if (movesHiddenWay()) {
823 final ExtendedDialog ed = new ConfirmMoveDialog();
824 ed.setContent(tr("Are you sure that you want to move elements with attached ways that are hidden by filters?"));
825 ed.toggleEnable("movedHiddenElements");
826 ed.showDialog();
827 if (ed.getValue() != 1) {
828 Main.main.undoRedo.undo();
829 }
830 }
831 int max = Main.pref.getInteger("warn.move.maxelements", 20), limit = max;
832 for (OsmPrimitive osm : getCurrentDataSet().getSelected()) {
833 if (osm instanceof Way) {
834 limit -= ((Way) osm).getNodes().size();
835 }
836 if (--limit < 0) {
837 break;
838 }
839 }
840 if (limit < 0) {
841 final ExtendedDialog ed = new ConfirmMoveDialog();
842 ed.setContent(
843 /* for correct i18n of plural forms - see #9110 */
844 trn("You moved more than {0} element. " + "Moving a large number of elements is often an error.\n" + "Really move them?",
845 "You moved more than {0} elements. " + "Moving a large number of elements is often an error.\n" + "Really move them?",
846 max, max));
847 ed.toggleEnable("movedManyElements");
848 ed.showDialog();
849
850 if (ed.getValue() != 1) {
851 Main.main.undoRedo.undo();
852 }
853 } else {
854 // if small number of elements were moved,
855 updateKeyModifiers(e);
856 if (ctrl) mergePrims(e.getPoint());
857 }
858 getCurrentDataSet().fireSelectionChanged();
859 }
860
861 static class ConfirmMoveDialog extends ExtendedDialog {
862 ConfirmMoveDialog() {
863 super(Main.parent,
864 tr("Move elements"),
865 new String[]{tr("Move them"), tr("Undo move")});
866 setButtonIcons(new String[]{"reorder", "cancel"});
867 setCancelButton(2);
868 }
869 }
870
871 private static boolean movesHiddenWay() {
872 final Collection<OsmPrimitive> elementsToTest = new HashSet<>(getCurrentDataSet().getSelected());
873 for (Way osm : Utils.filteredCollection(getCurrentDataSet().getSelected(), Way.class)) {
874 elementsToTest.addAll(osm.getNodes());
875 }
876 for (OsmPrimitive node : Utils.filteredCollection(elementsToTest, Node.class)) {
877 for (Way ref : Utils.filteredCollection(node.getReferrers(), Way.class)) {
878 if (ref.isDisabledAndHidden()) {
879 return true;
880 }
881 }
882 }
883 return false;
884 }
885
886 /**
887 * Merges the selected nodes to the one closest to the given mouse position if the control
888 * key is pressed. If there is no such node, no action will be done and no error will be
889 * reported. If there is, it will execute the merge and add it to the undo buffer.
890 * @param p mouse position
891 */
892 private void mergePrims(Point p) {
893 Collection<Node> selNodes = getCurrentDataSet().getSelectedNodes();
894 if (selNodes.isEmpty())
895 return;
896
897 Node target = findNodeToMergeTo(p);
898 if (target == null)
899 return;
900
901 if (selNodes.size() == 1) {
902 // Move all selected primitive to preserve shape #10748
903 Collection<OsmPrimitive> selection =
904 getCurrentDataSet().getSelectedNodesAndWays();
905 Collection<Node> affectedNodes = AllNodesVisitor.getAllNodes(selection);
906 Command c = getLastCommand();
907 getCurrentDataSet().beginUpdate();
908 if (c instanceof MoveCommand
909 && affectedNodes.equals(((MoveCommand) c).getParticipatingPrimitives())) {
910 Node selectedNode = selNodes.iterator().next();
911 EastNorth selectedEN = selectedNode.getEastNorth();
912 EastNorth targetEN = target.getEastNorth();
913 ((MoveCommand) c).moveAgain(targetEN.getX() - selectedEN.getX(),
914 targetEN.getY() - selectedEN.getY());
915 }
916 getCurrentDataSet().endUpdate();
917 }
918
919 Collection<Node> nodesToMerge = new LinkedList<>(selNodes);
920 nodesToMerge.add(target);
921 mergeNodes(Main.main.getEditLayer(), nodesToMerge, target);
922 }
923
924 /**
925 * Merge nodes using {@code MergeNodesAction}.
926 * Can be overridden for testing purpose.
927 * @param layer layer the reference data layer. Must not be null
928 * @param nodes the collection of nodes. Ignored if null
929 * @param targetLocationNode this node's location will be used for the target node
930 */
931 public void mergeNodes(OsmDataLayer layer, Collection<Node> nodes,
932 Node targetLocationNode) {
933 MergeNodesAction.doMergeNodes(layer, nodes, targetLocationNode);
934 }
935
936 /**
937 * Tries to find a node to merge to when in move-merge mode for the current mouse
938 * position. Either returns the node or null, if no suitable one is nearby.
939 * @param p mouse position
940 * @return node to merge to, or null
941 */
942 private Node findNodeToMergeTo(Point p) {
943 Collection<Node> target = mv.getNearestNodes(p,
944 getCurrentDataSet().getSelectedNodes(),
945 mv.isSelectablePredicate);
946 return target.isEmpty() ? null : target.iterator().next();
947 }
948
949 private void selectPrims(Collection<OsmPrimitive> prims, boolean released, boolean area) {
950 DataSet ds = getCurrentDataSet();
951
952 // not allowed together: do not change dataset selection, return early
953 // Virtual Ways: if non-empty the cursor is above a virtual node. So don't highlight
954 // anything if about to drag the virtual node (i.e. !released) but continue if the
955 // cursor is only released above a virtual node by accident (i.e. released). See #7018
956 if (ds == null || (shift && ctrl) || (ctrl && !released) || (virtualManager.hasVirtualWaysToBeConstructed() && !released))
957 return;
958
959 if (!released) {
960 // Don't replace the selection if the user clicked on a
961 // selected object (it breaks moving of selected groups).
962 // Do it later, on mouse release.
963 shift |= ds.getSelected().containsAll(prims);
964 }
965
966 if (ctrl) {
967 // Ctrl on an item toggles its selection status,
968 // but Ctrl on an *area* just clears those items
969 // out of the selection.
970 if (area) {
971 ds.clearSelection(prims);
972 } else {
973 ds.toggleSelected(prims);
974 }
975 } else if (shift) {
976 // add prims to an existing selection
977 ds.addSelected(prims);
978 } else {
979 // clear selection, then select the prims clicked
980 ds.setSelected(prims);
981 }
982 }
983
984 /**
985 * Returns the current select mode.
986 * @return the select mode
987 * @since 7543
988 */
989 public final Mode getMode() {
990 return mode;
991 }
992
993 @Override
994 public String getModeHelpText() {
995 if (mouseDownButton == MouseEvent.BUTTON1 && mouseReleaseTime < mouseDownTime) {
996 if (mode == Mode.SELECT)
997 return tr("Release the mouse button to select the objects in the rectangle.");
998 else if (mode == Mode.MOVE && (System.currentTimeMillis() - mouseDownTime >= initialMoveDelay)) {
999 final boolean canMerge = getCurrentDataSet() != null && !getCurrentDataSet().getSelectedNodes().isEmpty();
1000 final String mergeHelp = canMerge ? ' ' + tr("Ctrl to merge with nearest node.") : "";
1001 return tr("Release the mouse button to stop moving.") + mergeHelp;
1002 } else if (mode == Mode.ROTATE)
1003 return tr("Release the mouse button to stop rotating.");
1004 else if (mode == Mode.SCALE)
1005 return tr("Release the mouse button to stop scaling.");
1006 }
1007 return tr("Move objects by dragging; Shift to add to selection (Ctrl to toggle); Shift-Ctrl to rotate selected; " +
1008 "Alt-Ctrl to scale selected; or change selection");
1009 }
1010
1011 @Override
1012 public boolean layerIsSupported(Layer l) {
1013 return l instanceof OsmDataLayer;
1014 }
1015
1016 /**
1017 * Enable or diable the lasso mode
1018 * @param lassoMode true to enable the lasso mode, false otherwise
1019 */
1020 public void setLassoMode(boolean lassoMode) {
1021 this.selectionManager.setLassoMode(lassoMode);
1022 this.lassoMode = lassoMode;
1023 }
1024
1025 private final transient CycleManager cycleManager = new CycleManager();
1026 private final transient VirtualManager virtualManager = new VirtualManager();
1027
1028 private class CycleManager {
1029
1030 private Collection<OsmPrimitive> cycleList = Collections.emptyList();
1031 private boolean cyclePrims;
1032 private OsmPrimitive cycleStart;
1033 private boolean waitForMouseUpParameter;
1034 private boolean multipleMatchesParameter;
1035 /**
1036 * read preferences
1037 */
1038 private void init() {
1039 waitForMouseUpParameter = Main.pref.getBoolean("mappaint.select.waits-for-mouse-up", false);
1040 multipleMatchesParameter = Main.pref.getBoolean("selectaction.cycles.multiple.matches", false);
1041 }
1042
1043 /**
1044 * Determine primitive to be selected and build cycleList
1045 * @param nearest primitive found by simple method
1046 * @param p point where user clicked
1047 * @return OsmPrimitive to be selected
1048 */
1049 private OsmPrimitive cycleSetup(OsmPrimitive nearest, Point p) {
1050 OsmPrimitive osm = null;
1051
1052 if (nearest != null) {
1053 osm = nearest;
1054
1055 if (!(alt || multipleMatchesParameter)) {
1056 // no real cycling, just one element in cycle list
1057 cycleList = asColl(osm);
1058
1059 if (waitForMouseUpParameter) {
1060 // prefer a selected nearest node or way, if possible
1061 osm = mv.getNearestNodeOrWay(p, mv.isSelectablePredicate, true);
1062 }
1063 } else {
1064 // Alt + left mouse button pressed: we need to build cycle list
1065 cycleList = mv.getAllNearest(p, mv.isSelectablePredicate);
1066
1067 if (cycleList.size() > 1) {
1068 cyclePrims = false;
1069
1070 // find first already selected element in cycle list
1071 OsmPrimitive old = osm;
1072 for (OsmPrimitive o : cycleList) {
1073 if (o.isSelected()) {
1074 cyclePrims = true;
1075 osm = o;
1076 break;
1077 }
1078 }
1079
1080 // special case: for cycle groups of 2, we can toggle to the
1081 // true nearest primitive on mousePressed right away
1082 if (cycleList.size() == 2 && !waitForMouseUpParameter) {
1083 if (!(osm.equals(old) || osm.isNew() || ctrl)) {
1084 cyclePrims = false;
1085 osm = old;
1086 } // else defer toggling to mouseRelease time in those cases:
1087 /*
1088 * osm == old -- the true nearest node is the
1089 * selected one osm is a new node -- do not break
1090 * unglue ways in ALT mode ctrl is pressed -- ctrl
1091 * generally works on mouseReleased
1092 */
1093 }
1094 }
1095 }
1096 }
1097 return osm;
1098 }
1099
1100 /**
1101 * Modifies current selection state and returns the next element in a
1102 * selection cycle given by
1103 * <code>cycleList</code> field
1104 * @return the next element of cycle list
1105 */
1106 private Collection<OsmPrimitive> cyclePrims() {
1107 if (cycleList.size() <= 1) {
1108 // no real cycling, just return one-element collection with nearest primitive in it
1109 return cycleList;
1110 }
1111 // updateKeyModifiers() already called before!
1112
1113 DataSet ds = getCurrentDataSet();
1114 OsmPrimitive first = cycleList.iterator().next(), foundInDS = null;
1115 OsmPrimitive nxt = first;
1116
1117 if (cyclePrims && shift) {
1118 for (Iterator<OsmPrimitive> i = cycleList.iterator(); i.hasNext();) {
1119 nxt = i.next();
1120 if (!nxt.isSelected()) {
1121 break; // take first primitive in cycleList not in sel
1122 }
1123 }
1124 // if primitives 1,2,3 are under cursor, [Alt-press] [Shift-release] gives 1 -> 12 -> 123
1125 } else {
1126 for (Iterator<OsmPrimitive> i = cycleList.iterator(); i.hasNext();) {
1127 nxt = i.next();
1128 if (nxt.isSelected()) {
1129 foundInDS = nxt;
1130 // first selected primitive in cycleList is found
1131 if (cyclePrims || ctrl) {
1132 ds.clearSelection(foundInDS); // deselect it
1133 nxt = i.hasNext() ? i.next() : first;
1134 // return next one in cycle list (last->first)
1135 }
1136 break; // take next primitive in cycleList
1137 }
1138 }
1139 }
1140
1141 // if "no-alt-cycling" is enabled, Ctrl-Click arrives here.
1142 if (ctrl) {
1143 // a member of cycleList was found in the current dataset selection
1144 if (foundInDS != null) {
1145 // mouse was moved to a different selection group w/ a previous sel
1146 if (!cycleList.contains(cycleStart)) {
1147 ds.clearSelection(cycleList);
1148 cycleStart = foundInDS;
1149 } else if (cycleStart.equals(nxt)) {
1150 // loop detected, insert deselect step
1151 ds.addSelected(nxt);
1152 }
1153 } else {
1154 // setup for iterating a sel group again or a new, different one..
1155 nxt = cycleList.contains(cycleStart) ? cycleStart : first;
1156 cycleStart = nxt;
1157 }
1158 } else {
1159 cycleStart = null;
1160 }
1161 // return one-element collection with one element to be selected (or added to selection)
1162 return asColl(nxt);
1163 }
1164 }
1165
1166 private class VirtualManager {
1167
1168 private Node virtualNode;
1169 private Collection<WaySegment> virtualWays = new LinkedList<>();
1170 private int nodeVirtualSize;
1171 private int virtualSnapDistSq2;
1172 private int virtualSpace;
1173
1174 private void init() {
1175 nodeVirtualSize = Main.pref.getInteger("mappaint.node.virtual-size", 8);
1176 int virtualSnapDistSq = Main.pref.getInteger("mappaint.node.virtual-snap-distance", 8);
1177 virtualSnapDistSq2 = virtualSnapDistSq*virtualSnapDistSq;
1178 virtualSpace = Main.pref.getInteger("mappaint.node.virtual-space", 70);
1179 }
1180
1181 /**
1182 * Calculate a virtual node if there is enough visual space to draw a
1183 * crosshair node and the middle of a way segment is clicked. If the
1184 * user drags the crosshair node, it will be added to all ways in
1185 * <code>virtualWays</code>.
1186 *
1187 * @param p the point clicked
1188 * @return whether
1189 * <code>virtualNode</code> and
1190 * <code>virtualWays</code> were setup.
1191 */
1192 private boolean activateVirtualNodeNearPoint(Point p) {
1193 if (nodeVirtualSize > 0) {
1194
1195 Collection<WaySegment> selVirtualWays = new LinkedList<>();
1196 Pair<Node, Node> vnp = null, wnp = new Pair<>(null, null);
1197
1198 Way w = null;
1199 for (WaySegment ws : mv.getNearestWaySegments(p, mv.isSelectablePredicate)) {
1200 w = ws.way;
1201
1202 wnp.a = w.getNode(ws.lowerIndex);
1203 wnp.b = w.getNode(ws.lowerIndex + 1);
1204 Point2D p1 = mv.getPoint2D(wnp.a);
1205 Point2D p2 = mv.getPoint2D(wnp.b);
1206 if (WireframeMapRenderer.isLargeSegment(p1, p2, virtualSpace)) {
1207 Point2D pc = new Point2D.Double((p1.getX() + p2.getX()) / 2, (p1.getY() + p2.getY()) / 2);
1208 if (p.distanceSq(pc) < virtualSnapDistSq2) {
1209 // Check that only segments on top of each other get added to the
1210 // virtual ways list. Otherwise ways that coincidentally have their
1211 // virtual node at the same spot will be joined which is likely unwanted
1212 Pair.sort(wnp);
1213 if (vnp == null) {
1214 vnp = new Pair<>(wnp.a, wnp.b);
1215 virtualNode = new Node(mv.getLatLon(pc.getX(), pc.getY()));
1216 }
1217 if (vnp.equals(wnp)) {
1218 // if mutiple line segments have the same points,
1219 // add all segments to be splitted to virtualWays list
1220 // if some lines are selected, only their segments will go to virtualWays
1221 (w.isSelected() ? selVirtualWays : virtualWays).add(ws);
1222 }
1223 }
1224 }
1225 }
1226
1227 if (!selVirtualWays.isEmpty()) {
1228 virtualWays = selVirtualWays;
1229 }
1230 }
1231
1232 return !virtualWays.isEmpty();
1233 }
1234
1235 private void createMiddleNodeFromVirtual(EastNorth currentEN) {
1236 Collection<Command> virtualCmds = new LinkedList<>();
1237 virtualCmds.add(new AddCommand(virtualNode));
1238 for (WaySegment virtualWay : virtualWays) {
1239 Way w = virtualWay.way;
1240 Way wnew = new Way(w);
1241 wnew.addNode(virtualWay.lowerIndex + 1, virtualNode);
1242 virtualCmds.add(new ChangeCommand(w, wnew));
1243 }
1244 virtualCmds.add(new MoveCommand(virtualNode, startEN, currentEN));
1245 String text = trn("Add and move a virtual new node to way",
1246 "Add and move a virtual new node to {0} ways", virtualWays.size(),
1247 virtualWays.size());
1248 Main.main.undoRedo.add(new SequenceCommand(text, virtualCmds));
1249 getCurrentDataSet().setSelected(Collections.singleton((OsmPrimitive) virtualNode));
1250 clear();
1251 }
1252
1253 private void clear() {
1254 virtualWays.clear();
1255 virtualNode = null;
1256 }
1257
1258 private boolean hasVirtualNode() {
1259 return virtualNode != null;
1260 }
1261
1262 private boolean hasVirtualWaysToBeConstructed() {
1263 return !virtualWays.isEmpty();
1264 }
1265 }
1266
1267 /**
1268 * Returns {@code o} as collection of {@code o}'s type.
1269 * @param <T> object type
1270 * @param o any object
1271 * @return {@code o} as collection of {@code o}'s type.
1272 */
1273 protected static <T> Collection<T> asColl(T o) {
1274 if (o == null)
1275 return Collections.emptySet();
1276 return Collections.singleton(o);
1277 }
1278}
Note: See TracBrowser for help on using the repository browser.