001    // License: GPL. For details, see LICENSE file.
002    package org.openstreetmap.josm.actions;
003    
004    import static org.openstreetmap.josm.gui.help.HelpUtil.ht;
005    import static org.openstreetmap.josm.tools.I18n.tr;
006    
007    import java.awt.event.ActionEvent;
008    import java.awt.event.KeyEvent;
009    import java.text.MessageFormat;
010    import java.util.Collection;
011    import java.util.Map;
012    
013    import org.openstreetmap.josm.Main;
014    import org.openstreetmap.josm.actions.downloadtasks.DownloadReferrersTask;
015    import org.openstreetmap.josm.data.osm.OsmPrimitive;
016    import org.openstreetmap.josm.data.osm.OsmPrimitiveType;
017    import org.openstreetmap.josm.gui.layer.OsmDataLayer;
018    import org.openstreetmap.josm.tools.CheckParameterUtil;
019    import org.openstreetmap.josm.tools.Shortcut;
020    
021    /**
022     * This action loads the set of primitives referring to the current selection from the OSM
023     * server.
024     *
025     */
026    public class DownloadReferrersAction extends JosmAction{
027    
028        public DownloadReferrersAction() {
029            super(tr("Download parent ways/relations..."), "downloadreferrers", tr("Download objects referring to one of the selected objects"),
030                    Shortcut.registerShortcut("file:downloadreferrers", tr("File: {0}", tr("Download parent ways/relations...")), KeyEvent.VK_D, Shortcut.ALT_CTRL), true);
031            putValue("help", ht("/Action/DownloadParentWaysAndRelation"));
032        }
033    
034        /**
035         * Downloads the primitives referring to the primitives in <code>primitives</code>
036         * into the target layer <code>targetLayer</code>.
037         * Does nothing if primitives is null or empty.
038         *
039         * @param targetLayer  the target layer. Must not be null.
040         * @param children the collection of child primitives.
041         * @exception IllegalArgumentException thrown if targetLayer is null
042         */
043        static public void downloadReferrers(OsmDataLayer targetLayer, Collection<OsmPrimitive> children) throws IllegalArgumentException {
044            if (children == null || children.isEmpty()) return;
045            Main.worker.submit(new DownloadReferrersTask(targetLayer, children));
046        }
047    
048        /**
049         * Downloads the primitives referring to the primitives in <code>primitives</code>
050         * into the target layer <code>targetLayer</code>.
051         * Does nothing if primitives is null or empty.
052         *
053         * @param targetLayer  the target layer. Must not be null.
054         * @param children the collection of primitives, given as map of ids and types
055         * @exception IllegalArgumentException thrown if targetLayer is null
056         */
057        static public void downloadReferrers(OsmDataLayer targetLayer, Map<Long, OsmPrimitiveType> children) throws IllegalArgumentException {
058            if (children == null || children.isEmpty()) return;
059            Main.worker.submit(new DownloadReferrersTask(targetLayer, children));
060        }
061    
062        /**
063         * Downloads the primitives referring to the primitive given by <code>id</code> and
064         * <code>type</code>.
065         *
066         *
067         * @param targetLayer  the target layer. Must not be null.
068         * @param id the primitive id. id > 0 required.
069         * @param type the primitive type. type != null required
070         * @exception IllegalArgumentException thrown if targetLayer is null
071         * @exception IllegalArgumentException thrown if id <= 0
072         * @exception IllegalArgumentException thrown if type == null
073         */
074        static public void downloadReferrers(OsmDataLayer targetLayer, long id, OsmPrimitiveType type) throws IllegalArgumentException {
075            if (id <= 0)
076                throw new IllegalArgumentException(MessageFormat.format("Id > 0 required, got {0}", id));
077            CheckParameterUtil.ensureParameterNotNull(type, "type");
078            Main.worker.submit(new DownloadReferrersTask(targetLayer, id, type));
079        }
080    
081        public void actionPerformed(ActionEvent e) {
082            if (!isEnabled() || ! Main.isDisplayingMapView())
083                return;
084            OsmDataLayer layer = Main.map.mapView.getEditLayer();
085            if (layer == null)
086                return;
087            Collection<OsmPrimitive> primitives = layer.data.getSelected();
088            downloadReferrers(layer,primitives);
089        }
090    
091        @Override
092        protected void updateEnabledState() {
093            if (getCurrentDataSet() == null) {
094                setEnabled(false);
095            } else {
096                updateEnabledState(getCurrentDataSet().getSelected());
097            }
098        }
099    
100        @Override
101        protected void updateEnabledState(Collection<? extends OsmPrimitive> selection) {
102            setEnabled(selection != null && !selection.isEmpty());
103        }
104    }