001// License: GPL. For details, see LICENSE file.
002package org.openstreetmap.josm.actions;
003
004import static org.openstreetmap.josm.gui.help.HelpUtil.ht;
005import static org.openstreetmap.josm.tools.I18n.tr;
006
007import java.awt.BorderLayout;
008import java.awt.Component;
009import java.awt.GridLayout;
010import java.awt.Rectangle;
011import java.awt.event.ActionEvent;
012import java.awt.event.ActionListener;
013import java.awt.event.FocusEvent;
014import java.awt.event.FocusListener;
015import java.awt.event.KeyEvent;
016import java.util.ArrayList;
017import java.util.Collection;
018import java.util.Collections;
019import java.util.Deque;
020import java.util.LinkedList;
021import java.util.concurrent.Future;
022
023import javax.swing.AbstractAction;
024import javax.swing.Action;
025import javax.swing.ActionMap;
026import javax.swing.JButton;
027import javax.swing.JComponent;
028import javax.swing.JLabel;
029import javax.swing.JMenuItem;
030import javax.swing.JOptionPane;
031import javax.swing.JPanel;
032import javax.swing.JPopupMenu;
033import javax.swing.JScrollPane;
034import javax.swing.plaf.basic.BasicArrowButton;
035
036import org.openstreetmap.josm.Main;
037import org.openstreetmap.josm.actions.downloadtasks.DownloadOsmTask;
038import org.openstreetmap.josm.actions.downloadtasks.PostDownloadHandler;
039import org.openstreetmap.josm.data.Bounds;
040import org.openstreetmap.josm.data.preferences.CollectionProperty;
041import org.openstreetmap.josm.data.preferences.IntegerProperty;
042import org.openstreetmap.josm.gui.HelpAwareOptionPane;
043import org.openstreetmap.josm.gui.download.DownloadDialog;
044import org.openstreetmap.josm.gui.preferences.server.OverpassServerPreference;
045import org.openstreetmap.josm.gui.util.GuiHelper;
046import org.openstreetmap.josm.gui.widgets.HistoryComboBox;
047import org.openstreetmap.josm.gui.widgets.JosmTextArea;
048import org.openstreetmap.josm.io.OverpassDownloadReader;
049import org.openstreetmap.josm.tools.GBC;
050import org.openstreetmap.josm.tools.OverpassTurboQueryWizard;
051import org.openstreetmap.josm.tools.Shortcut;
052import org.openstreetmap.josm.tools.UncheckedParseException;
053import org.openstreetmap.josm.tools.Utils;
054
055/**
056 * Download map data from Overpass API server.
057 * @since 8684
058 */
059public class OverpassDownloadAction extends JosmAction {
060
061    /**
062     * Constructs a new {@code OverpassDownloadAction}.
063     */
064    public OverpassDownloadAction() {
065        super(tr("Download from Overpass API ..."), "download-overpass", tr("Download map data from Overpass API server."),
066                // CHECKSTYLE.OFF: LineLength
067                Shortcut.registerShortcut("file:download-overpass", tr("File: {0}", tr("Download from Overpass API ...")), KeyEvent.VK_DOWN, Shortcut.ALT_SHIFT),
068                // CHECKSTYLE.ON: LineLength
069                true, "overpassdownload/download", true);
070        putValue("help", ht("/Action/OverpassDownload"));
071    }
072
073    @Override
074    public void actionPerformed(ActionEvent e) {
075        OverpassDownloadDialog dialog = OverpassDownloadDialog.getInstance();
076        dialog.restoreSettings();
077        dialog.setVisible(true);
078        if (!dialog.isCanceled()) {
079            dialog.rememberSettings();
080            Bounds area = dialog.getSelectedDownloadArea();
081            DownloadOsmTask task = new DownloadOsmTask();
082            Future<?> future = task.download(
083                    new OverpassDownloadReader(area, OverpassServerPreference.getOverpassServer(), dialog.getOverpassQuery()),
084                    dialog.isNewLayerRequired(), area, null);
085            Main.worker.submit(new PostDownloadHandler(task, future));
086        }
087    }
088
089    private static final class DisableActionsFocusListener implements FocusListener {
090
091        private final ActionMap actionMap;
092
093        private DisableActionsFocusListener(ActionMap actionMap) {
094            this.actionMap = actionMap;
095        }
096
097        @Override
098        public void focusGained(FocusEvent e) {
099            enableActions(false);
100        }
101
102        @Override
103        public void focusLost(FocusEvent e) {
104            enableActions(true);
105        }
106
107        private void enableActions(boolean enabled) {
108            Object[] allKeys = actionMap.allKeys();
109            if (allKeys != null) {
110                for (Object key : allKeys) {
111                    Action action = actionMap.get(key);
112                    if (action != null) {
113                        action.setEnabled(enabled);
114                    }
115                }
116            }
117        }
118    }
119
120    private static final class OverpassDownloadDialog extends DownloadDialog {
121
122        private HistoryComboBox overpassWizard;
123        private JosmTextArea overpassQuery;
124        private static OverpassDownloadDialog instance;
125        private static final CollectionProperty OVERPASS_WIZARD_HISTORY = new CollectionProperty("download.overpass.wizard",
126                new ArrayList<String>());
127
128        private OverpassDownloadDialog(Component parent) {
129            super(parent, ht("/Action/OverpassDownload"));
130            cbDownloadOsmData.setEnabled(false);
131            cbDownloadOsmData.setSelected(false);
132            cbDownloadGpxData.setVisible(false);
133            cbDownloadNotes.setVisible(false);
134            cbStartup.setVisible(false);
135        }
136
137        public static OverpassDownloadDialog getInstance() {
138            if (instance == null) {
139                instance = new OverpassDownloadDialog(Main.parent);
140            }
141            return instance;
142        }
143
144        @Override
145        protected void buildMainPanelAboveDownloadSelections(JPanel pnl) {
146
147            DisableActionsFocusListener disableActionsFocusListener =
148                    new DisableActionsFocusListener(slippyMapChooser.getNavigationComponentActionMap());
149
150            pnl.add(new JLabel(), GBC.eol()); // needed for the invisible checkboxes cbDownloadGpxData, cbDownloadNotes
151
152            final String tooltip = tr("Builds an Overpass query using the Overpass Turbo query wizard");
153            overpassWizard = new HistoryComboBox();
154            overpassWizard.setToolTipText(tooltip);
155            overpassWizard.getEditorComponent().addFocusListener(disableActionsFocusListener);
156            final JButton buildQuery = new JButton(tr("Build query"));
157            buildQuery.addActionListener(new AbstractAction() {
158                @Override
159                public void actionPerformed(ActionEvent e) {
160                    final String overpassWizardText = overpassWizard.getText();
161                    try {
162                        overpassQuery.setText(OverpassTurboQueryWizard.getInstance().constructQuery(overpassWizardText));
163                    } catch (UncheckedParseException ex) {
164                        Main.error(ex);
165                        HelpAwareOptionPane.showOptionDialog(
166                                Main.parent,
167                                tr("<html>The Overpass wizard could not parse the following query:"
168                                        + Utils.joinAsHtmlUnorderedList(Collections.singleton(overpassWizardText))),
169                                tr("Parse error"),
170                                JOptionPane.ERROR_MESSAGE,
171                                null
172                        );
173                    }
174                }
175            });
176            buildQuery.setToolTipText(tooltip);
177            pnl.add(buildQuery, GBC.std().insets(5, 5, 5, 5));
178            pnl.add(overpassWizard, GBC.eol().fill(GBC.HORIZONTAL));
179
180            overpassQuery = new JosmTextArea("", 8, 80);
181            overpassQuery.setFont(GuiHelper.getMonospacedFont(overpassQuery));
182            overpassQuery.addFocusListener(disableActionsFocusListener);
183            JScrollPane scrollPane = new JScrollPane(overpassQuery);
184            final JPanel pane = new JPanel(new BorderLayout());
185            final BasicArrowButton arrowButton = new BasicArrowButton(BasicArrowButton.SOUTH);
186            arrowButton.addActionListener(new AbstractAction() {
187                @Override
188                public void actionPerformed(ActionEvent e) {
189                    OverpassQueryHistoryPopup.show(arrowButton, OverpassDownloadDialog.this);
190                }
191            });
192            pane.add(scrollPane, BorderLayout.CENTER);
193            pane.add(arrowButton, BorderLayout.EAST);
194            pnl.add(new JLabel(tr("Overpass query: ")), GBC.std().insets(5, 5, 5, 5));
195            GBC gbc = GBC.eol().fill(GBC.HORIZONTAL);
196            gbc.ipady = 200;
197            pnl.add(pane, gbc);
198
199        }
200
201        public String getOverpassQuery() {
202            return overpassQuery.getText();
203        }
204
205        public void setOverpassQuery(String text) {
206            overpassQuery.setText(text);
207        }
208
209        @Override
210        public void restoreSettings() {
211            super.restoreSettings();
212            overpassWizard.setPossibleItems(OVERPASS_WIZARD_HISTORY.get());
213        }
214
215        @Override
216        public void rememberSettings() {
217            super.rememberSettings();
218            overpassWizard.addCurrentItemToHistory();
219            OVERPASS_WIZARD_HISTORY.put(overpassWizard.getHistory());
220            OverpassQueryHistoryPopup.addToHistory(getOverpassQuery());
221        }
222
223    }
224
225    static class OverpassQueryHistoryPopup extends JPopupMenu {
226
227        static final CollectionProperty OVERPASS_QUERY_HISTORY = new CollectionProperty("download.overpass.query", new ArrayList<String>());
228        static final IntegerProperty OVERPASS_QUERY_HISTORY_SIZE = new IntegerProperty("download.overpass.query.size", 12);
229
230        OverpassQueryHistoryPopup(final OverpassDownloadDialog dialog) {
231            final Collection<String> history = OVERPASS_QUERY_HISTORY.get();
232            setLayout(new GridLayout((int) Math.ceil(history.size() / 2.), 2));
233            for (final String i : history) {
234                add(new OverpassQueryHistoryItem(i, dialog));
235            }
236        }
237
238        static void show(final JComponent parent, final OverpassDownloadDialog dialog) {
239            final OverpassQueryHistoryPopup menu = new OverpassQueryHistoryPopup(dialog);
240            final Rectangle r = parent.getBounds();
241            menu.show(parent.getParent(), r.x + r.width - (int) menu.getPreferredSize().getWidth(), r.y + r.height);
242        }
243
244        static void addToHistory(final String query) {
245            final Deque<String> history = new LinkedList<>(OVERPASS_QUERY_HISTORY.get());
246            if (!history.contains(query)) {
247                history.add(query);
248            }
249            while (history.size() > OVERPASS_QUERY_HISTORY_SIZE.get()) {
250                history.removeFirst();
251            }
252            OVERPASS_QUERY_HISTORY.put(history);
253        }
254    }
255
256    static class OverpassQueryHistoryItem extends JMenuItem implements ActionListener {
257
258        final String query;
259        final OverpassDownloadDialog dialog;
260
261        OverpassQueryHistoryItem(final String query, final OverpassDownloadDialog dialog) {
262            this.query = query;
263            this.dialog = dialog;
264            setText("<html><pre style='width:300px;'>" +
265                    Utils.escapeReservedCharactersHTML(Utils.restrictStringLines(query, 7)));
266            addActionListener(this);
267        }
268
269        @Override
270        public void actionPerformed(ActionEvent e) {
271            dialog.setOverpassQuery(query);
272        }
273    }
274
275}