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

Last change on this file since 12053 was 12053, checked in by michael2402, 18 months ago

Fix #6447: Ensure that only move commands in same layer are combined.

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