[6380] | 1 | // License: GPL. For details, see LICENSE file.
|
---|
[626] | 2 | package org.openstreetmap.josm;
|
---|
[5670] | 3 |
|
---|
[301] | 4 | import static org.openstreetmap.josm.tools.I18n.tr;
|
---|
| 5 |
|
---|
| 6 | import java.awt.Component;
|
---|
[11106] | 7 | import java.awt.GraphicsEnvironment;
|
---|
[9821] | 8 | import java.io.IOException;
|
---|
[4126] | 9 | import java.lang.ref.WeakReference;
|
---|
[6471] | 10 | import java.net.URL;
|
---|
[5481] | 11 | import java.text.MessageFormat;
|
---|
[2025] | 12 | import java.util.ArrayList;
|
---|
[301] | 13 | import java.util.Collection;
|
---|
[11986] | 14 | import java.util.Collections;
|
---|
[10044] | 15 | import java.util.EnumSet;
|
---|
[6642] | 16 | import java.util.HashMap;
|
---|
[4126] | 17 | import java.util.Iterator;
|
---|
[2025] | 18 | import java.util.List;
|
---|
[8404] | 19 | import java.util.Locale;
|
---|
[301] | 20 | import java.util.Map;
|
---|
[7083] | 21 | import java.util.Objects;
|
---|
[7434] | 22 | import java.util.Set;
|
---|
[5134] | 23 | import java.util.concurrent.Callable;
|
---|
[10212] | 24 | import java.util.concurrent.ExecutionException;
|
---|
[1465] | 25 | import java.util.concurrent.ExecutorService;
|
---|
[5134] | 26 | import java.util.concurrent.Executors;
|
---|
[2322] | 27 | import java.util.concurrent.Future;
|
---|
[301] | 28 |
|
---|
[3252] | 29 | import javax.swing.Action;
|
---|
[301] | 30 |
|
---|
[3444] | 31 | import org.openstreetmap.josm.actions.JosmAction;
|
---|
[301] | 32 | import org.openstreetmap.josm.data.Bounds;
|
---|
| 33 | import org.openstreetmap.josm.data.Preferences;
|
---|
| 34 | import org.openstreetmap.josm.data.UndoRedoHandler;
|
---|
[8168] | 35 | import org.openstreetmap.josm.data.cache.JCSCacheManager;
|
---|
[1990] | 36 | import org.openstreetmap.josm.data.coor.CoordinateFormat;
|
---|
[301] | 37 | import org.openstreetmap.josm.data.osm.DataSet;
|
---|
[6546] | 38 | import org.openstreetmap.josm.data.osm.OsmPrimitive;
|
---|
[301] | 39 | import org.openstreetmap.josm.data.projection.Projection;
|
---|
[4126] | 40 | import org.openstreetmap.josm.data.projection.ProjectionChangeListener;
|
---|
[12630] | 41 | import org.openstreetmap.josm.gui.MainApplication;
|
---|
[301] | 42 | import org.openstreetmap.josm.gui.MainMenu;
|
---|
[10432] | 43 | import org.openstreetmap.josm.gui.MainPanel;
|
---|
[301] | 44 | import org.openstreetmap.josm.gui.MapFrame;
|
---|
[5957] | 45 | import org.openstreetmap.josm.gui.MapFrameListener;
|
---|
[10279] | 46 | import org.openstreetmap.josm.gui.layer.MainLayerManager;
|
---|
[301] | 47 | import org.openstreetmap.josm.gui.preferences.ToolbarPreferences;
|
---|
[7185] | 48 | import org.openstreetmap.josm.io.FileWatcher;
|
---|
[7434] | 49 | import org.openstreetmap.josm.io.OnlineResource;
|
---|
[3934] | 50 | import org.openstreetmap.josm.io.OsmApi;
|
---|
[4126] | 51 | import org.openstreetmap.josm.tools.CheckParameterUtil;
|
---|
[301] | 52 | import org.openstreetmap.josm.tools.ImageProvider;
|
---|
[11374] | 53 | import org.openstreetmap.josm.tools.JosmRuntimeException;
|
---|
[10899] | 54 | import org.openstreetmap.josm.tools.Logging;
|
---|
[1023] | 55 | import org.openstreetmap.josm.tools.PlatformHook;
|
---|
[1465] | 56 | import org.openstreetmap.josm.tools.PlatformHookOsx;
|
---|
[1023] | 57 | import org.openstreetmap.josm.tools.PlatformHookUnixoid;
|
---|
| 58 | import org.openstreetmap.josm.tools.PlatformHookWindows;
|
---|
[1084] | 59 | import org.openstreetmap.josm.tools.Shortcut;
|
---|
[4288] | 60 | import org.openstreetmap.josm.tools.Utils;
|
---|
[11642] | 61 | import org.openstreetmap.josm.tools.bugreport.BugReport;
|
---|
[626] | 62 |
|
---|
[5829] | 63 | /**
|
---|
| 64 | * Abstract class holding various static global variables and methods used in large parts of JOSM application.
|
---|
| 65 | * @since 98
|
---|
| 66 | */
|
---|
[6883] | 67 | public abstract class Main {
|
---|
[2485] | 68 |
|
---|
[1104] | 69 | /**
|
---|
[6143] | 70 | * The JOSM website URL.
|
---|
[6897] | 71 | * @since 6897 (was public from 6143 to 6896)
|
---|
[6143] | 72 | */
|
---|
[6920] | 73 | private static final String JOSM_WEBSITE = "https://josm.openstreetmap.de";
|
---|
[6453] | 74 |
|
---|
[6143] | 75 | /**
|
---|
[6453] | 76 | * The OSM website URL.
|
---|
[6897] | 77 | * @since 6897 (was public from 6453 to 6896)
|
---|
[6453] | 78 | */
|
---|
[6920] | 79 | private static final String OSM_WEBSITE = "https://www.openstreetmap.org";
|
---|
[6453] | 80 |
|
---|
| 81 | /**
|
---|
[2343] | 82 | * Replies true if JOSM currently displays a map view. False, if it doesn't, i.e. if
|
---|
| 83 | * it only shows the MOTD panel.
|
---|
[10288] | 84 | * <p>
|
---|
| 85 | * You do not need this when accessing the layer manager. The layer manager will be empty if no map view is shown.
|
---|
[2512] | 86 | *
|
---|
[5357] | 87 | * @return <code>true</code> if JOSM currently displays a map view
|
---|
[12630] | 88 | * @deprecated use {@link org.openstreetmap.josm.gui.MainApplication#isDisplayingMapView()}
|
---|
[2343] | 89 | */
|
---|
[12630] | 90 | @Deprecated
|
---|
[6883] | 91 | public static boolean isDisplayingMapView() {
|
---|
[12631] | 92 | return MainApplication.isDisplayingMapView();
|
---|
[2343] | 93 | }
|
---|
[6070] | 94 |
|
---|
[2343] | 95 | /**
|
---|
[1104] | 96 | * Global parent component for all dialogs and message boxes
|
---|
| 97 | */
|
---|
| 98 | public static Component parent;
|
---|
[6070] | 99 |
|
---|
[1104] | 100 | /**
|
---|
| 101 | * Global application.
|
---|
| 102 | */
|
---|
[8126] | 103 | public static volatile Main main;
|
---|
[6070] | 104 |
|
---|
[1104] | 105 | /**
|
---|
| 106 | * The worker thread slave. This is for executing all long and intensive
|
---|
[12634] | 107 | * calculations. The executed runnables are guaranteed to be executed separately and sequential.
|
---|
| 108 | * @deprecated use {@link MainApplication#worker} instead
|
---|
[1104] | 109 | */
|
---|
[12634] | 110 | @Deprecated
|
---|
[12665] | 111 | public static ExecutorService worker;
|
---|
[6070] | 112 |
|
---|
[1104] | 113 | /**
|
---|
| 114 | * Global application preferences
|
---|
| 115 | */
|
---|
[10876] | 116 | public static final Preferences pref = new Preferences();
|
---|
[1814] | 117 |
|
---|
[1104] | 118 | /**
|
---|
[10975] | 119 | * The MapFrame.
|
---|
[10271] | 120 | * <p>
|
---|
[12637] | 121 | * There should be no need to access this to access any map data. Use {@link MainApplication#getLayerManager} instead.
|
---|
[10432] | 122 | *
|
---|
[12637] | 123 | * @deprecated Use {@link MainApplication#getMap()} instead
|
---|
[10432] | 124 | * @see MainPanel
|
---|
[1104] | 125 | */
|
---|
[12630] | 126 | @Deprecated
|
---|
[1104] | 127 | public static MapFrame map;
|
---|
[6070] | 128 |
|
---|
[1104] | 129 | /**
|
---|
| 130 | * The toolbar preference control to register new actions.
|
---|
[12637] | 131 | * @deprecated Use {@link MainApplication#getToolbar} instead
|
---|
[1104] | 132 | */
|
---|
[12637] | 133 | @Deprecated
|
---|
[8126] | 134 | public static volatile ToolbarPreferences toolbar;
|
---|
[626] | 135 |
|
---|
[5829] | 136 | /**
|
---|
| 137 | * The commands undo/redo handler.
|
---|
| 138 | */
|
---|
[12641] | 139 | public final UndoRedoHandler undoRedo = MainApplication.undoRedo;
|
---|
[626] | 140 |
|
---|
[5831] | 141 | /**
|
---|
[1104] | 142 | * The main menu bar at top of screen.
|
---|
[12643] | 143 | * @deprecated Use {@link MainApplication#getMenu} instead
|
---|
[1104] | 144 | */
|
---|
[12643] | 145 | @Deprecated
|
---|
[5134] | 146 | public MainMenu menu;
|
---|
[626] | 147 |
|
---|
[5481] | 148 | /**
|
---|
[12125] | 149 | * The main panel.
|
---|
[12642] | 150 | * @deprecated Use {@link MainApplication#getMainPanel} instead
|
---|
[12125] | 151 | * @since 12125
|
---|
| 152 | */
|
---|
[12642] | 153 | @Deprecated
|
---|
[12125] | 154 | public MainPanel panel;
|
---|
| 155 |
|
---|
| 156 | /**
|
---|
[7185] | 157 | * The file watcher service.
|
---|
| 158 | */
|
---|
| 159 | public static final FileWatcher fileWatcher = new FileWatcher();
|
---|
| 160 |
|
---|
[11650] | 161 | private static final Map<String, Throwable> NETWORK_ERRORS = new HashMap<>();
|
---|
[6642] | 162 |
|
---|
[10044] | 163 | private static final Set<OnlineResource> OFFLINE_RESOURCES = EnumSet.noneOf(OnlineResource.class);
|
---|
[7434] | 164 |
|
---|
[1356] | 165 | /**
|
---|
[6730] | 166 | * Logging level (5 = trace, 4 = debug, 3 = info, 2 = warn, 1 = error, 0 = none).
|
---|
[6248] | 167 | * @since 6248
|
---|
[10899] | 168 | * @deprecated Use {@link Logging} class.
|
---|
[1104] | 169 | */
|
---|
[10899] | 170 | @Deprecated
|
---|
[6248] | 171 | public static int logLevel = 3;
|
---|
[6474] | 172 |
|
---|
[10432] | 173 | /**
|
---|
[8857] | 174 | * Replies the first lines of last 5 error and warning messages, used for bug reports
|
---|
| 175 | * @return the first lines of last 5 error and warning messages
|
---|
[7420] | 176 | * @since 7420
|
---|
[12620] | 177 | * @deprecated Use {@link Logging#getLastErrorAndWarnings}.
|
---|
[7420] | 178 | */
|
---|
[12620] | 179 | @Deprecated
|
---|
[7420] | 180 | public static final Collection<String> getLastErrorAndWarnings() {
|
---|
[10899] | 181 | return Logging.getLastErrorAndWarnings();
|
---|
[7420] | 182 | }
|
---|
| 183 |
|
---|
| 184 | /**
|
---|
[8959] | 185 | * Clears the list of last error and warning messages.
|
---|
| 186 | * @since 8959
|
---|
[12620] | 187 | * @deprecated Use {@link Logging#clearLastErrorAndWarnings}.
|
---|
[8959] | 188 | */
|
---|
[12620] | 189 | @Deprecated
|
---|
[8959] | 190 | public static void clearLastErrorAndWarnings() {
|
---|
[10899] | 191 | Logging.clearLastErrorAndWarnings();
|
---|
[8959] | 192 | }
|
---|
| 193 |
|
---|
| 194 | /**
|
---|
[6248] | 195 | * Prints an error message if logging is on.
|
---|
[5481] | 196 | * @param msg The message to print.
|
---|
[6248] | 197 | * @since 6248
|
---|
[12620] | 198 | * @deprecated Use {@link Logging#error(String)}.
|
---|
[5481] | 199 | */
|
---|
[12620] | 200 | @Deprecated
|
---|
[6248] | 201 | public static void error(String msg) {
|
---|
[10899] | 202 | Logging.error(msg);
|
---|
[6248] | 203 | }
|
---|
[6474] | 204 |
|
---|
[6248] | 205 | /**
|
---|
| 206 | * Prints a warning message if logging is on.
|
---|
| 207 | * @param msg The message to print.
|
---|
[12620] | 208 | * @deprecated Use {@link Logging#warn(String)}.
|
---|
[6248] | 209 | */
|
---|
[12620] | 210 | @Deprecated
|
---|
[6248] | 211 | public static void warn(String msg) {
|
---|
[10899] | 212 | Logging.warn(msg);
|
---|
[4190] | 213 | }
|
---|
[6474] | 214 |
|
---|
[5481] | 215 | /**
|
---|
[6248] | 216 | * Prints an informational message if logging is on.
|
---|
[5481] | 217 | * @param msg The message to print.
|
---|
[12620] | 218 | * @deprecated Use {@link Logging#info(String)}.
|
---|
[5481] | 219 | */
|
---|
[12620] | 220 | @Deprecated
|
---|
[6248] | 221 | public static void info(String msg) {
|
---|
[10899] | 222 | Logging.info(msg);
|
---|
[4190] | 223 | }
|
---|
[6474] | 224 |
|
---|
[5481] | 225 | /**
|
---|
[6248] | 226 | * Prints a debug message if logging is on.
|
---|
[5481] | 227 | * @param msg The message to print.
|
---|
[12620] | 228 | * @deprecated Use {@link Logging#debug(String)}.
|
---|
[5481] | 229 | */
|
---|
[12620] | 230 | @Deprecated
|
---|
[6248] | 231 | public static void debug(String msg) {
|
---|
[10899] | 232 | Logging.debug(msg);
|
---|
[1104] | 233 | }
|
---|
[6474] | 234 |
|
---|
[5481] | 235 | /**
|
---|
[6730] | 236 | * Prints a trace message if logging is on.
|
---|
| 237 | * @param msg The message to print.
|
---|
[12620] | 238 | * @deprecated Use {@link Logging#trace(String)}.
|
---|
[6730] | 239 | */
|
---|
[12620] | 240 | @Deprecated
|
---|
[6730] | 241 | public static void trace(String msg) {
|
---|
[10899] | 242 | Logging.trace(msg);
|
---|
[6730] | 243 | }
|
---|
| 244 |
|
---|
| 245 | /**
|
---|
[6852] | 246 | * Determines if debug log level is enabled.
|
---|
| 247 | * Useful to avoid costly construction of debug messages when not enabled.
|
---|
| 248 | * @return {@code true} if log level is at least debug, {@code false} otherwise
|
---|
| 249 | * @since 6852
|
---|
[12620] | 250 | * @deprecated Use {@link Logging#isDebugEnabled}.
|
---|
[6852] | 251 | */
|
---|
[12620] | 252 | @Deprecated
|
---|
[6852] | 253 | public static boolean isDebugEnabled() {
|
---|
[12620] | 254 | return Logging.isDebugEnabled();
|
---|
[6852] | 255 | }
|
---|
| 256 |
|
---|
| 257 | /**
|
---|
| 258 | * Determines if trace log level is enabled.
|
---|
| 259 | * Useful to avoid costly construction of trace messages when not enabled.
|
---|
| 260 | * @return {@code true} if log level is at least trace, {@code false} otherwise
|
---|
| 261 | * @since 6852
|
---|
[12620] | 262 | * @deprecated Use {@link Logging#isTraceEnabled}.
|
---|
[6852] | 263 | */
|
---|
[12620] | 264 | @Deprecated
|
---|
[6852] | 265 | public static boolean isTraceEnabled() {
|
---|
[12620] | 266 | return Logging.isTraceEnabled();
|
---|
[6852] | 267 | }
|
---|
| 268 |
|
---|
| 269 | /**
|
---|
[6535] | 270 | * Prints a formatted error message if logging is on. Calls {@link MessageFormat#format}
|
---|
[5481] | 271 | * function to format text.
|
---|
[6535] | 272 | * @param msg The formatted message to print.
|
---|
[5481] | 273 | * @param objects The objects to insert into format string.
|
---|
[6248] | 274 | * @since 6248
|
---|
[12620] | 275 | * @deprecated Use {@link Logging#error(String, Object...)}.
|
---|
[5481] | 276 | */
|
---|
[12620] | 277 | @Deprecated
|
---|
[6248] | 278 | public static void error(String msg, Object... objects) {
|
---|
[10899] | 279 | Logging.error(msg, objects);
|
---|
[6248] | 280 | }
|
---|
[6474] | 281 |
|
---|
[6248] | 282 | /**
|
---|
[6535] | 283 | * Prints a formatted warning message if logging is on. Calls {@link MessageFormat#format}
|
---|
[6248] | 284 | * function to format text.
|
---|
[6535] | 285 | * @param msg The formatted message to print.
|
---|
[6248] | 286 | * @param objects The objects to insert into format string.
|
---|
[12620] | 287 | * @deprecated Use {@link Logging#warn(String, Object...)}.
|
---|
[6248] | 288 | */
|
---|
[12620] | 289 | @Deprecated
|
---|
[6248] | 290 | public static void warn(String msg, Object... objects) {
|
---|
[10899] | 291 | Logging.warn(msg, objects);
|
---|
[5481] | 292 | }
|
---|
[6474] | 293 |
|
---|
[5481] | 294 | /**
|
---|
[6535] | 295 | * Prints a formatted informational message if logging is on. Calls {@link MessageFormat#format}
|
---|
[5481] | 296 | * function to format text.
|
---|
[6535] | 297 | * @param msg The formatted message to print.
|
---|
[5481] | 298 | * @param objects The objects to insert into format string.
|
---|
[12620] | 299 | * @deprecated Use {@link Logging#info(String, Object...)}.
|
---|
[5481] | 300 | */
|
---|
[12620] | 301 | @Deprecated
|
---|
[6248] | 302 | public static void info(String msg, Object... objects) {
|
---|
[10899] | 303 | Logging.info(msg, objects);
|
---|
[5481] | 304 | }
|
---|
[6474] | 305 |
|
---|
[5481] | 306 | /**
|
---|
[6535] | 307 | * Prints a formatted debug message if logging is on. Calls {@link MessageFormat#format}
|
---|
[5481] | 308 | * function to format text.
|
---|
[6535] | 309 | * @param msg The formatted message to print.
|
---|
[5481] | 310 | * @param objects The objects to insert into format string.
|
---|
[12620] | 311 | * @deprecated Use {@link Logging#debug(String, Object...)}.
|
---|
[5481] | 312 | */
|
---|
[12620] | 313 | @Deprecated
|
---|
[6248] | 314 | public static void debug(String msg, Object... objects) {
|
---|
[10899] | 315 | Logging.debug(msg, objects);
|
---|
[5481] | 316 | }
|
---|
[6474] | 317 |
|
---|
[6248] | 318 | /**
|
---|
[8015] | 319 | * Prints a formatted trace message if logging is on. Calls {@link MessageFormat#format}
|
---|
| 320 | * function to format text.
|
---|
| 321 | * @param msg The formatted message to print.
|
---|
| 322 | * @param objects The objects to insert into format string.
|
---|
[12620] | 323 | * @deprecated Use {@link Logging#trace(String, Object...)}.
|
---|
[8015] | 324 | */
|
---|
[12620] | 325 | @Deprecated
|
---|
[8015] | 326 | public static void trace(String msg, Object... objects) {
|
---|
[10899] | 327 | Logging.trace(msg, objects);
|
---|
[8015] | 328 | }
|
---|
| 329 |
|
---|
| 330 | /**
|
---|
[6248] | 331 | * Prints an error message for the given Throwable.
|
---|
| 332 | * @param t The throwable object causing the error
|
---|
| 333 | * @since 6248
|
---|
[12620] | 334 | * @deprecated Use {@link Logging#error(Throwable)}.
|
---|
[6248] | 335 | */
|
---|
[12620] | 336 | @Deprecated
|
---|
[6248] | 337 | public static void error(Throwable t) {
|
---|
[12620] | 338 | Logging.error(t);
|
---|
[6248] | 339 | }
|
---|
[6474] | 340 |
|
---|
[6248] | 341 | /**
|
---|
| 342 | * Prints a warning message for the given Throwable.
|
---|
| 343 | * @param t The throwable object causing the error
|
---|
| 344 | * @since 6248
|
---|
[12620] | 345 | * @deprecated Use {@link Logging#warn(Throwable)}.
|
---|
[6248] | 346 | */
|
---|
[12620] | 347 | @Deprecated
|
---|
[6248] | 348 | public static void warn(Throwable t) {
|
---|
[12620] | 349 | Logging.warn(t);
|
---|
[6642] | 350 | }
|
---|
| 351 |
|
---|
| 352 | /**
|
---|
[10420] | 353 | * Prints a debug message for the given Throwable. Useful for exceptions usually ignored
|
---|
| 354 | * @param t The throwable object causing the error
|
---|
[10421] | 355 | * @since 10420
|
---|
[12620] | 356 | * @deprecated Use {@link Logging#debug(Throwable)}.
|
---|
[10420] | 357 | */
|
---|
[12620] | 358 | @Deprecated
|
---|
[10420] | 359 | public static void debug(Throwable t) {
|
---|
[12620] | 360 | Logging.debug(t);
|
---|
[10420] | 361 | }
|
---|
| 362 |
|
---|
| 363 | /**
|
---|
| 364 | * Prints a trace message for the given Throwable. Useful for exceptions usually ignored
|
---|
| 365 | * @param t The throwable object causing the error
|
---|
[10421] | 366 | * @since 10420
|
---|
[12620] | 367 | * @deprecated Use {@link Logging#trace(Throwable)}.
|
---|
[10420] | 368 | */
|
---|
[12620] | 369 | @Deprecated
|
---|
[10420] | 370 | public static void trace(Throwable t) {
|
---|
[12620] | 371 | Logging.trace(t);
|
---|
[10420] | 372 | }
|
---|
| 373 |
|
---|
| 374 | /**
|
---|
[6642] | 375 | * Prints an error message for the given Throwable.
|
---|
| 376 | * @param t The throwable object causing the error
|
---|
| 377 | * @param stackTrace {@code true}, if the stacktrace should be displayed
|
---|
[6643] | 378 | * @since 6642
|
---|
[12620] | 379 | * @deprecated Use {@link Logging#log(java.util.logging.Level, Throwable)}
|
---|
| 380 | * or {@link Logging#logWithStackTrace(java.util.logging.Level, Throwable)}.
|
---|
[6642] | 381 | */
|
---|
[12620] | 382 | @Deprecated
|
---|
[6642] | 383 | public static void error(Throwable t, boolean stackTrace) {
|
---|
| 384 | if (stackTrace) {
|
---|
[10899] | 385 | Logging.log(Logging.LEVEL_ERROR, t);
|
---|
| 386 | } else {
|
---|
| 387 | Logging.logWithStackTrace(Logging.LEVEL_ERROR, t);
|
---|
[6642] | 388 | }
|
---|
| 389 | }
|
---|
| 390 |
|
---|
| 391 | /**
|
---|
[10420] | 392 | * Prints an error message for the given Throwable.
|
---|
| 393 | * @param t The throwable object causing the error
|
---|
| 394 | * @param message additional error message
|
---|
[10421] | 395 | * @since 10420
|
---|
[12620] | 396 | * @deprecated Use {@link Logging#log(java.util.logging.Level, String, Throwable)}.
|
---|
[10420] | 397 | */
|
---|
[12620] | 398 | @Deprecated
|
---|
[10420] | 399 | public static void error(Throwable t, String message) {
|
---|
[10899] | 400 | Logging.log(Logging.LEVEL_ERROR, message, t);
|
---|
[10420] | 401 | }
|
---|
| 402 |
|
---|
| 403 | /**
|
---|
[6642] | 404 | * Prints a warning message for the given Throwable.
|
---|
| 405 | * @param t The throwable object causing the error
|
---|
| 406 | * @param stackTrace {@code true}, if the stacktrace should be displayed
|
---|
[6643] | 407 | * @since 6642
|
---|
[12620] | 408 | * @deprecated Use {@link Logging#log(java.util.logging.Level, Throwable)}
|
---|
| 409 | * or {@link Logging#logWithStackTrace(java.util.logging.Level, Throwable)}.
|
---|
[6642] | 410 | */
|
---|
[12620] | 411 | @Deprecated
|
---|
[6642] | 412 | public static void warn(Throwable t, boolean stackTrace) {
|
---|
| 413 | if (stackTrace) {
|
---|
[10899] | 414 | Logging.log(Logging.LEVEL_WARN, t);
|
---|
| 415 | } else {
|
---|
| 416 | Logging.logWithStackTrace(Logging.LEVEL_WARN, t);
|
---|
[6642] | 417 | }
|
---|
[6248] | 418 | }
|
---|
[6474] | 419 |
|
---|
[6642] | 420 | /**
|
---|
[10420] | 421 | * Prints a warning message for the given Throwable.
|
---|
| 422 | * @param t The throwable object causing the error
|
---|
| 423 | * @param message additional error message
|
---|
[10421] | 424 | * @since 10420
|
---|
[12620] | 425 | * @deprecated Use {@link Logging#log(java.util.logging.Level, String, Throwable)}.
|
---|
[10420] | 426 | */
|
---|
[12620] | 427 | @Deprecated
|
---|
[10420] | 428 | public static void warn(Throwable t, String message) {
|
---|
[10899] | 429 | Logging.log(Logging.LEVEL_WARN, message, t);
|
---|
[10420] | 430 | }
|
---|
| 431 |
|
---|
| 432 | /**
|
---|
[6642] | 433 | * Returns a human-readable message of error, also usable for developers.
|
---|
| 434 | * @param t The error
|
---|
| 435 | * @return The human-readable error message
|
---|
| 436 | * @since 6642
|
---|
[12620] | 437 | * @deprecated Use {@link Logging#getErrorMessage}.
|
---|
[6642] | 438 | */
|
---|
[12620] | 439 | @Deprecated
|
---|
[6642] | 440 | public static String getErrorMessage(Throwable t) {
|
---|
[6783] | 441 | if (t == null) {
|
---|
| 442 | return null;
|
---|
[10899] | 443 | } else {
|
---|
| 444 | return Logging.getErrorMessage(t);
|
---|
[6783] | 445 | }
|
---|
[6311] | 446 | }
|
---|
[301] | 447 |
|
---|
[1104] | 448 | /**
|
---|
| 449 | * Platform specific code goes in here.
|
---|
[12641] | 450 | * Plugins may replace it, however, some hooks will be called before any plugins have been loaded.
|
---|
[1104] | 451 | * So if you need to hook into those early ones, split your class and send the one with the early hooks
|
---|
| 452 | * to the JOSM team for inclusion.
|
---|
| 453 | */
|
---|
[8126] | 454 | public static volatile PlatformHook platform;
|
---|
[1023] | 455 |
|
---|
[8840] | 456 | private static volatile InitStatusListener initListener;
|
---|
[4681] | 457 |
|
---|
[11352] | 458 | /**
|
---|
| 459 | * Initialization task listener.
|
---|
| 460 | */
|
---|
[8512] | 461 | public interface InitStatusListener {
|
---|
[4681] | 462 |
|
---|
[11352] | 463 | /**
|
---|
| 464 | * Called when an initialization task updates its status.
|
---|
| 465 | * @param event task name
|
---|
| 466 | * @return new status
|
---|
| 467 | */
|
---|
[8497] | 468 | Object updateStatus(String event);
|
---|
[8510] | 469 |
|
---|
[11352] | 470 | /**
|
---|
| 471 | * Called when an initialization task completes.
|
---|
| 472 | * @param status final status
|
---|
| 473 | */
|
---|
[8497] | 474 | void finish(Object status);
|
---|
[4681] | 475 | }
|
---|
| 476 |
|
---|
[11352] | 477 | /**
|
---|
| 478 | * Sets initialization task listener.
|
---|
| 479 | * @param listener initialization task listener
|
---|
| 480 | */
|
---|
[4681] | 481 | public static void setInitStatusListener(InitStatusListener listener) {
|
---|
[8497] | 482 | CheckParameterUtil.ensureParameterNotNull(listener);
|
---|
[4681] | 483 | initListener = listener;
|
---|
| 484 | }
|
---|
| 485 |
|
---|
[6523] | 486 | /**
|
---|
[10340] | 487 | * Constructs new {@code Main} object.
|
---|
| 488 | * @see #initialize()
|
---|
[6523] | 489 | */
|
---|
[11656] | 490 | protected Main() {
|
---|
| 491 | setInstance(this);
|
---|
[10340] | 492 | }
|
---|
| 493 |
|
---|
[11656] | 494 | private static void setInstance(Main instance) {
|
---|
| 495 | main = instance;
|
---|
| 496 | }
|
---|
| 497 |
|
---|
[10340] | 498 | /**
|
---|
| 499 | * Initializes the main object. A lot of global variables are initialized here.
|
---|
| 500 | * @since 10340
|
---|
| 501 | */
|
---|
| 502 | public void initialize() {
|
---|
[12629] | 503 | // Initializes tasks that must be run before parallel tasks
|
---|
| 504 | runInitializationTasks(beforeInitializationTasks());
|
---|
[4681] | 505 |
|
---|
[12629] | 506 | // Initializes tasks to be executed (in parallel) by a ExecutorService
|
---|
[11642] | 507 | try {
|
---|
[10899] | 508 | ExecutorService service = Executors.newFixedThreadPool(
|
---|
[8734] | 509 | Runtime.getRuntime().availableProcessors(), Utils.newThreadFactory("main-init-%d", Thread.NORM_PRIORITY));
|
---|
[12629] | 510 | for (Future<Void> i : service.invokeAll(parallelInitializationTasks())) {
|
---|
[5195] | 511 | i.get();
|
---|
| 512 | }
|
---|
[11092] | 513 | // asynchronous initializations to be completed eventually
|
---|
[12629] | 514 | asynchronousRunnableTasks().forEach(service::submit);
|
---|
| 515 | asynchronousCallableTasks().forEach(service::submit);
|
---|
[8738] | 516 | service.shutdown();
|
---|
[10212] | 517 | } catch (InterruptedException | ExecutionException ex) {
|
---|
[11374] | 518 | throw new JosmRuntimeException(ex);
|
---|
[4718] | 519 | }
|
---|
[3669] | 520 |
|
---|
[12629] | 521 | // Initializes tasks that must be run after parallel tasks
|
---|
| 522 | runInitializationTasks(afterInitializationTasks());
|
---|
| 523 | }
|
---|
[4489] | 524 |
|
---|
[12629] | 525 | private static void runInitializationTasks(List<InitializationTask> tasks) {
|
---|
| 526 | for (InitializationTask task : tasks) {
|
---|
| 527 | try {
|
---|
| 528 | task.call();
|
---|
| 529 | } catch (JosmRuntimeException e) {
|
---|
| 530 | // Can happen if the current projection needs NTV2 grid which is not available
|
---|
| 531 | // In this case we want the user be able to change his projection
|
---|
| 532 | BugReport.intercept(e).warn();
|
---|
| 533 | }
|
---|
| 534 | }
|
---|
[1104] | 535 | }
|
---|
[626] | 536 |
|
---|
[10340] | 537 | /**
|
---|
[12629] | 538 | * Returns tasks that must be run before parallel tasks.
|
---|
| 539 | * @return tasks that must be run before parallel tasks
|
---|
| 540 | * @see #afterInitializationTasks
|
---|
| 541 | * @see #parallelInitializationTasks
|
---|
| 542 | */
|
---|
| 543 | protected List<InitializationTask> beforeInitializationTasks() {
|
---|
| 544 | return Collections.emptyList();
|
---|
| 545 | }
|
---|
| 546 |
|
---|
| 547 | /**
|
---|
| 548 | * Returns tasks to be executed (in parallel) by a ExecutorService.
|
---|
| 549 | * @return tasks to be executed (in parallel) by a ExecutorService
|
---|
| 550 | */
|
---|
| 551 | protected Collection<InitializationTask> parallelInitializationTasks() {
|
---|
| 552 | return Collections.emptyList();
|
---|
| 553 | }
|
---|
| 554 |
|
---|
| 555 | /**
|
---|
| 556 | * Returns asynchronous callable initializations to be completed eventually
|
---|
| 557 | * @return asynchronous callable initializations to be completed eventually
|
---|
| 558 | */
|
---|
| 559 | protected List<Callable<?>> asynchronousCallableTasks() {
|
---|
| 560 | return Collections.emptyList();
|
---|
| 561 | }
|
---|
| 562 |
|
---|
| 563 | /**
|
---|
| 564 | * Returns asynchronous runnable initializations to be completed eventually
|
---|
| 565 | * @return asynchronous runnable initializations to be completed eventually
|
---|
| 566 | */
|
---|
| 567 | protected List<Runnable> asynchronousRunnableTasks() {
|
---|
| 568 | return Collections.emptyList();
|
---|
| 569 | }
|
---|
| 570 |
|
---|
| 571 | /**
|
---|
| 572 | * Returns tasks that must be run after parallel tasks.
|
---|
| 573 | * @return tasks that must be run after parallel tasks
|
---|
| 574 | * @see #beforeInitializationTasks
|
---|
| 575 | * @see #parallelInitializationTasks
|
---|
| 576 | */
|
---|
| 577 | protected List<InitializationTask> afterInitializationTasks() {
|
---|
| 578 | return Collections.emptyList();
|
---|
| 579 | }
|
---|
| 580 |
|
---|
| 581 | protected static final class InitializationTask implements Callable<Void> {
|
---|
[6779] | 582 |
|
---|
| 583 | private final String name;
|
---|
[10936] | 584 | private final Runnable task;
|
---|
[6779] | 585 |
|
---|
[12629] | 586 | /**
|
---|
| 587 | * Constructs a new {@code InitializationTask}.
|
---|
| 588 | * @param name translated name to be displayed to user
|
---|
| 589 | * @param task runnable initialization task
|
---|
| 590 | */
|
---|
| 591 | public InitializationTask(String name, Runnable task) {
|
---|
[6779] | 592 | this.name = name;
|
---|
[10899] | 593 | this.task = task;
|
---|
[6779] | 594 | }
|
---|
| 595 |
|
---|
| 596 | @Override
|
---|
[8497] | 597 | public Void call() {
|
---|
| 598 | Object status = null;
|
---|
[6779] | 599 | if (initListener != null) {
|
---|
[8497] | 600 | status = initListener.updateStatus(name);
|
---|
[6779] | 601 | }
|
---|
[10899] | 602 | task.run();
|
---|
[8497] | 603 | if (initListener != null) {
|
---|
| 604 | initListener.finish(status);
|
---|
[6852] | 605 | }
|
---|
[6779] | 606 | return null;
|
---|
| 607 | }
|
---|
| 608 | }
|
---|
| 609 |
|
---|
[1104] | 610 | /**
|
---|
[10271] | 611 | * Returns the main layer manager that is used by the map view.
|
---|
| 612 | * @return The layer manager. The value returned will never change.
|
---|
[10279] | 613 | * @since 10279
|
---|
[12636] | 614 | * @deprecated use {@link MainApplication#getLayerManager} instead
|
---|
[10271] | 615 | */
|
---|
[12636] | 616 | @Deprecated
|
---|
[10279] | 617 | public static MainLayerManager getLayerManager() {
|
---|
[12636] | 618 | return MainApplication.getLayerManager();
|
---|
[10271] | 619 | }
|
---|
| 620 |
|
---|
| 621 | /**
|
---|
[6546] | 622 | * Replies the current selected primitives, from a end-user point of view.
|
---|
| 623 | * It is not always technically the same collection of primitives than {@link DataSet#getSelected()}.
|
---|
| 624 | * @return The current selected primitives, from a end-user point of view. Can be {@code null}.
|
---|
| 625 | * @since 6546
|
---|
| 626 | */
|
---|
| 627 | public Collection<OsmPrimitive> getInProgressSelection() {
|
---|
[12636] | 628 | return Collections.emptyList();
|
---|
[6546] | 629 | }
|
---|
[1750] | 630 |
|
---|
[11352] | 631 | /**
|
---|
[12691] | 632 | * Gets the data set of the active edit layer.
|
---|
| 633 | * @return That data set, <code>null</code> if there is no edit layer.
|
---|
| 634 | * @since 12691
|
---|
| 635 | */
|
---|
| 636 | public DataSet getEditDataSet() {
|
---|
| 637 | return null;
|
---|
| 638 | }
|
---|
| 639 |
|
---|
| 640 | /**
|
---|
[11352] | 641 | * Registers a {@code JosmAction} and its shortcut.
|
---|
| 642 | * @param action action defining its own shortcut
|
---|
[12639] | 643 | * @deprecated use {@link MainApplication#registerActionShortcut(JosmAction)} instead
|
---|
[11352] | 644 | */
|
---|
[12639] | 645 | @Deprecated
|
---|
[5278] | 646 | public static void registerActionShortcut(JosmAction action) {
|
---|
[12639] | 647 | MainApplication.registerActionShortcut(action);
|
---|
[5278] | 648 | }
|
---|
| 649 |
|
---|
[11352] | 650 | /**
|
---|
| 651 | * Registers an action and its shortcut.
|
---|
| 652 | * @param action action to register
|
---|
| 653 | * @param shortcut shortcut to associate to {@code action}
|
---|
[12639] | 654 | * @deprecated use {@link MainApplication#registerActionShortcut(Action, Shortcut)} instead
|
---|
[11352] | 655 | */
|
---|
[12639] | 656 | @Deprecated
|
---|
[3252] | 657 | public static void registerActionShortcut(Action action, Shortcut shortcut) {
|
---|
[12639] | 658 | MainApplication.registerActionShortcut(action, shortcut);
|
---|
[3252] | 659 | }
|
---|
| 660 |
|
---|
[11352] | 661 | /**
|
---|
| 662 | * Unregisters a shortcut.
|
---|
| 663 | * @param shortcut shortcut to unregister
|
---|
[12639] | 664 | * @deprecated use {@link MainApplication#unregisterShortcut(Shortcut)} instead
|
---|
[11352] | 665 | */
|
---|
[12639] | 666 | @Deprecated
|
---|
[5382] | 667 | public static void unregisterShortcut(Shortcut shortcut) {
|
---|
[12639] | 668 | MainApplication.unregisterShortcut(shortcut);
|
---|
[3252] | 669 | }
|
---|
| 670 |
|
---|
[11352] | 671 | /**
|
---|
| 672 | * Unregisters a {@code JosmAction} and its shortcut.
|
---|
| 673 | * @param action action to unregister
|
---|
[12639] | 674 | * @deprecated use {@link MainApplication#unregisterActionShortcut(JosmAction)} instead
|
---|
[11352] | 675 | */
|
---|
[12639] | 676 | @Deprecated
|
---|
[3444] | 677 | public static void unregisterActionShortcut(JosmAction action) {
|
---|
[12639] | 678 | MainApplication.unregisterActionShortcut(action);
|
---|
[3444] | 679 | }
|
---|
| 680 |
|
---|
[11352] | 681 | /**
|
---|
| 682 | * Unregisters an action and its shortcut.
|
---|
| 683 | * @param action action to unregister
|
---|
| 684 | * @param shortcut shortcut to unregister
|
---|
[12639] | 685 | * @deprecated use {@link MainApplication#unregisterActionShortcut(Action, Shortcut)} instead
|
---|
[11352] | 686 | */
|
---|
[12639] | 687 | @Deprecated
|
---|
[3444] | 688 | public static void unregisterActionShortcut(Action action, Shortcut shortcut) {
|
---|
[12639] | 689 | MainApplication.unregisterActionShortcut(action, shortcut);
|
---|
[3444] | 690 | }
|
---|
[6070] | 691 |
|
---|
[5696] | 692 | /**
|
---|
| 693 | * Replies the registered action for the given shortcut
|
---|
| 694 | * @param shortcut The shortcut to look for
|
---|
| 695 | * @return the registered action for the given shortcut
|
---|
[12639] | 696 | * @deprecated use {@link MainApplication#getRegisteredActionShortcut(Shortcut)} instead
|
---|
[5696] | 697 | * @since 5696
|
---|
| 698 | */
|
---|
[12639] | 699 | @Deprecated
|
---|
[5696] | 700 | public static Action getRegisteredActionShortcut(Shortcut shortcut) {
|
---|
[12639] | 701 | return MainApplication.getRegisteredActionShortcut(shortcut);
|
---|
[5696] | 702 | }
|
---|
[3444] | 703 |
|
---|
[1104] | 704 | ///////////////////////////////////////////////////////////////////////////
|
---|
| 705 | // Implementation part
|
---|
| 706 | ///////////////////////////////////////////////////////////////////////////
|
---|
[626] | 707 |
|
---|
[5829] | 708 | /**
|
---|
[1104] | 709 | * Should be called before the main constructor to setup some parameter stuff
|
---|
| 710 | */
|
---|
[10962] | 711 | public static void preConstructorInit() {
|
---|
[1990] | 712 | // init default coordinate format
|
---|
| 713 | try {
|
---|
| 714 | CoordinateFormat.setCoordinateFormat(CoordinateFormat.valueOf(Main.pref.get("coordinates")));
|
---|
| 715 | } catch (IllegalArgumentException iae) {
|
---|
[12620] | 716 | Logging.trace(iae);
|
---|
[1990] | 717 | CoordinateFormat.setCoordinateFormat(CoordinateFormat.DECIMAL_DEGREES);
|
---|
| 718 | }
|
---|
[1104] | 719 | }
|
---|
[626] | 720 |
|
---|
[11986] | 721 | /**
|
---|
[8412] | 722 | * Closes JOSM and optionally terminates the Java Virtual Machine (JVM).
|
---|
[6342] | 723 | * @param exit If {@code true}, the JVM is terminated by running {@link System#exit} with a given return code.
|
---|
| 724 | * @param exitCode The return code
|
---|
[12636] | 725 | * @return {@code true}
|
---|
| 726 | * @since 12636
|
---|
[5829] | 727 | */
|
---|
[12636] | 728 | public static boolean exitJosm(boolean exit, int exitCode) {
|
---|
| 729 | if (Main.main != null) {
|
---|
| 730 | Main.main.shutdown();
|
---|
| 731 | }
|
---|
[8412] | 732 |
|
---|
[12636] | 733 | if (exit) {
|
---|
| 734 | System.exit(exitCode);
|
---|
[5829] | 735 | }
|
---|
[12636] | 736 | return true;
|
---|
[3378] | 737 | }
|
---|
| 738 |
|
---|
[11986] | 739 | /**
|
---|
| 740 | * Shutdown JOSM.
|
---|
| 741 | */
|
---|
[10340] | 742 | protected void shutdown() {
|
---|
[11106] | 743 | if (!GraphicsEnvironment.isHeadless()) {
|
---|
| 744 | ImageProvider.shutdown(false);
|
---|
| 745 | JCSCacheManager.shutdown();
|
---|
| 746 | }
|
---|
[10340] | 747 | try {
|
---|
| 748 | pref.saveDefaults();
|
---|
| 749 | } catch (IOException ex) {
|
---|
[12620] | 750 | Logging.log(Logging.LEVEL_WARN, tr("Failed to save default preferences."), ex);
|
---|
[10340] | 751 | }
|
---|
[11106] | 752 | if (!GraphicsEnvironment.isHeadless()) {
|
---|
| 753 | ImageProvider.shutdown(true);
|
---|
| 754 | }
|
---|
[10340] | 755 | }
|
---|
| 756 |
|
---|
[2798] | 757 | /**
|
---|
[5829] | 758 | * Identifies the current operating system family and initializes the platform hook accordingly.
|
---|
| 759 | * @since 1849
|
---|
| 760 | */
|
---|
[1849] | 761 | public static void determinePlatformHook() {
|
---|
[1104] | 762 | String os = System.getProperty("os.name");
|
---|
| 763 | if (os == null) {
|
---|
[12620] | 764 | Logging.warn("Your operating system has no name, so I'm guessing its some kind of *nix.");
|
---|
[1104] | 765 | platform = new PlatformHookUnixoid();
|
---|
[8404] | 766 | } else if (os.toLowerCase(Locale.ENGLISH).startsWith("windows")) {
|
---|
[1104] | 767 | platform = new PlatformHookWindows();
|
---|
[6990] | 768 | } else if ("Linux".equals(os) || "Solaris".equals(os) ||
|
---|
| 769 | "SunOS".equals(os) || "AIX".equals(os) ||
|
---|
| 770 | "FreeBSD".equals(os) || "NetBSD".equals(os) || "OpenBSD".equals(os)) {
|
---|
[1104] | 771 | platform = new PlatformHookUnixoid();
|
---|
[8404] | 772 | } else if (os.toLowerCase(Locale.ENGLISH).startsWith("mac os x")) {
|
---|
[1104] | 773 | platform = new PlatformHookOsx();
|
---|
| 774 | } else {
|
---|
[12620] | 775 | Logging.warn("I don't know your operating system '"+os+"', so I'm guessing its some kind of *nix.");
|
---|
[1104] | 776 | platform = new PlatformHookUnixoid();
|
---|
| 777 | }
|
---|
| 778 | }
|
---|
[1023] | 779 |
|
---|
[4126] | 780 | /* ----------------------------------------------------------------------------------------- */
|
---|
| 781 | /* projection handling - Main is a registry for a single, global projection instance */
|
---|
| 782 | /* */
|
---|
| 783 | /* TODO: For historical reasons the registry is implemented by Main. An alternative approach */
|
---|
| 784 | /* would be a singleton org.openstreetmap.josm.data.projection.ProjectionRegistry class. */
|
---|
| 785 | /* ----------------------------------------------------------------------------------------- */
|
---|
| 786 | /**
|
---|
| 787 | * The projection method used.
|
---|
[12631] | 788 | * Use {@link #getProjection()} and {@link #setProjection(Projection)} for access.
|
---|
[4897] | 789 | * Use {@link #setProjection(Projection)} in order to trigger a projection change event.
|
---|
[4126] | 790 | */
|
---|
[8126] | 791 | private static volatile Projection proj;
|
---|
[4126] | 792 |
|
---|
| 793 | /**
|
---|
| 794 | * Replies the current projection.
|
---|
[4489] | 795 | *
|
---|
[5357] | 796 | * @return the currently active projection
|
---|
[4126] | 797 | */
|
---|
| 798 | public static Projection getProjection() {
|
---|
| 799 | return proj;
|
---|
| 800 | }
|
---|
| 801 |
|
---|
| 802 | /**
|
---|
| 803 | * Sets the current projection
|
---|
[4489] | 804 | *
|
---|
[4126] | 805 | * @param p the projection
|
---|
| 806 | */
|
---|
| 807 | public static void setProjection(Projection p) {
|
---|
| 808 | CheckParameterUtil.ensureParameterNotNull(p);
|
---|
| 809 | Projection oldValue = proj;
|
---|
[12631] | 810 | Bounds b = main != null ? main.getRealBounds() : null;
|
---|
[4126] | 811 | proj = p;
|
---|
[5234] | 812 | fireProjectionChanged(oldValue, proj, b);
|
---|
[4126] | 813 | }
|
---|
| 814 |
|
---|
[12631] | 815 | /**
|
---|
| 816 | * Returns the bounds for the current projection. Used for projection events.
|
---|
| 817 | * @return the bounds for the current projection
|
---|
| 818 | * @see #restoreOldBounds
|
---|
| 819 | */
|
---|
| 820 | protected Bounds getRealBounds() {
|
---|
| 821 | // To be overriden
|
---|
| 822 | return null;
|
---|
| 823 | }
|
---|
| 824 |
|
---|
| 825 | /**
|
---|
| 826 | * Restore clean state corresponding to old bounds after a projection change event.
|
---|
| 827 | * @param oldBounds bounds previously returned by {@link #getRealBounds}, before the change of projection
|
---|
| 828 | * @see #getRealBounds
|
---|
| 829 | */
|
---|
| 830 | protected void restoreOldBounds(Bounds oldBounds) {
|
---|
| 831 | // To be overriden
|
---|
| 832 | }
|
---|
| 833 |
|
---|
[4126] | 834 | /*
|
---|
| 835 | * Keep WeakReferences to the listeners. This relieves clients from the burden of
|
---|
| 836 | * explicitly removing the listeners and allows us to transparently register every
|
---|
| 837 | * created dataset as projection change listener.
|
---|
| 838 | */
|
---|
[7005] | 839 | private static final List<WeakReference<ProjectionChangeListener>> listeners = new ArrayList<>();
|
---|
[4126] | 840 |
|
---|
[5234] | 841 | private static void fireProjectionChanged(Projection oldValue, Projection newValue, Bounds oldBounds) {
|
---|
[10655] | 842 | if ((newValue == null ^ oldValue == null)
|
---|
[7083] | 843 | || (newValue != null && oldValue != null && !Objects.equals(newValue.toCode(), oldValue.toCode()))) {
|
---|
[8510] | 844 | synchronized (Main.class) {
|
---|
[4126] | 845 | Iterator<WeakReference<ProjectionChangeListener>> it = listeners.iterator();
|
---|
[8510] | 846 | while (it.hasNext()) {
|
---|
[4126] | 847 | WeakReference<ProjectionChangeListener> wr = it.next();
|
---|
[4724] | 848 | ProjectionChangeListener listener = wr.get();
|
---|
| 849 | if (listener == null) {
|
---|
[4126] | 850 | it.remove();
|
---|
| 851 | continue;
|
---|
| 852 | }
|
---|
[4724] | 853 | listener.projectionChanged(oldValue, newValue);
|
---|
[4126] | 854 | }
|
---|
| 855 | }
|
---|
[12631] | 856 | if (newValue != null && oldBounds != null && main != null) {
|
---|
| 857 | main.restoreOldBounds(oldBounds);
|
---|
[4126] | 858 | }
|
---|
| 859 | /* TODO - remove layers with fixed projection */
|
---|
| 860 | }
|
---|
| 861 | }
|
---|
| 862 |
|
---|
| 863 | /**
|
---|
[5538] | 864 | * Register a projection change listener.
|
---|
[12119] | 865 | * The listener is registered to be weak, so keep a reference of it if you want it to be preserved.
|
---|
[4489] | 866 | *
|
---|
[5357] | 867 | * @param listener the listener. Ignored if <code>null</code>.
|
---|
[4126] | 868 | */
|
---|
| 869 | public static void addProjectionChangeListener(ProjectionChangeListener listener) {
|
---|
| 870 | if (listener == null) return;
|
---|
| 871 | synchronized (Main.class) {
|
---|
| 872 | for (WeakReference<ProjectionChangeListener> wr : listeners) {
|
---|
| 873 | // already registered ? => abort
|
---|
| 874 | if (wr.get() == listener) return;
|
---|
| 875 | }
|
---|
[7005] | 876 | listeners.add(new WeakReference<>(listener));
|
---|
[4126] | 877 | }
|
---|
| 878 | }
|
---|
| 879 |
|
---|
| 880 | /**
|
---|
[5538] | 881 | * Removes a projection change listener.
|
---|
[4489] | 882 | *
|
---|
[5357] | 883 | * @param listener the listener. Ignored if <code>null</code>.
|
---|
[4126] | 884 | */
|
---|
| 885 | public static void removeProjectionChangeListener(ProjectionChangeListener listener) {
|
---|
| 886 | if (listener == null) return;
|
---|
[8510] | 887 | synchronized (Main.class) {
|
---|
[11339] | 888 | // remove the listener - and any other listener which got garbage
|
---|
| 889 | // collected in the meantime
|
---|
| 890 | listeners.removeIf(wr -> wr.get() == null || wr.get() == listener);
|
---|
[4126] | 891 | }
|
---|
| 892 | }
|
---|
[5538] | 893 |
|
---|
| 894 | /**
|
---|
| 895 | * Listener for window switch events.
|
---|
[6070] | 896 | *
|
---|
[5538] | 897 | * These are events, when the user activates a window of another application
|
---|
| 898 | * or comes back to JOSM. Window switches from one JOSM window to another
|
---|
| 899 | * are not reported.
|
---|
| 900 | */
|
---|
[8512] | 901 | public interface WindowSwitchListener {
|
---|
[5538] | 902 | /**
|
---|
| 903 | * Called when the user activates a window of another application.
|
---|
| 904 | */
|
---|
| 905 | void toOtherApplication();
|
---|
[9059] | 906 |
|
---|
[5538] | 907 | /**
|
---|
[9059] | 908 | * Called when the user comes from a window of another application back to JOSM.
|
---|
[5538] | 909 | */
|
---|
| 910 | void fromOtherApplication();
|
---|
| 911 | }
|
---|
| 912 |
|
---|
| 913 | /**
|
---|
[11904] | 914 | * Registers a new {@code MapFrameListener} that will be notified of MapFrame changes.
|
---|
| 915 | * <p>
|
---|
| 916 | * It will fire an initial mapFrameInitialized event when the MapFrame is present.
|
---|
| 917 | * Otherwise will only fire when the MapFrame is created or destroyed.
|
---|
[5957] | 918 | * @param listener The MapFrameListener
|
---|
| 919 | * @return {@code true} if the listeners collection changed as a result of the call
|
---|
[11904] | 920 | * @see #addMapFrameListener
|
---|
[12639] | 921 | * @deprecated use {@link MainApplication#addAndFireMapFrameListener} instead
|
---|
[11904] | 922 | * @since 11904
|
---|
[8020] | 923 | */
|
---|
[12639] | 924 | @Deprecated
|
---|
[11904] | 925 | public static boolean addAndFireMapFrameListener(MapFrameListener listener) {
|
---|
[12639] | 926 | return MainApplication.addAndFireMapFrameListener(listener);
|
---|
[8020] | 927 | }
|
---|
| 928 |
|
---|
| 929 | /**
|
---|
| 930 | * Registers a new {@code MapFrameListener} that will be notified of MapFrame changes
|
---|
| 931 | * @param listener The MapFrameListener
|
---|
| 932 | * @return {@code true} if the listeners collection changed as a result of the call
|
---|
[11904] | 933 | * @see #addAndFireMapFrameListener
|
---|
[12639] | 934 | * @deprecated use {@link MainApplication#addMapFrameListener} instead
|
---|
[5957] | 935 | * @since 5957
|
---|
| 936 | */
|
---|
[12639] | 937 | @Deprecated
|
---|
[5957] | 938 | public static boolean addMapFrameListener(MapFrameListener listener) {
|
---|
[12639] | 939 | return MainApplication.addMapFrameListener(listener);
|
---|
[5957] | 940 | }
|
---|
| 941 |
|
---|
| 942 | /**
|
---|
| 943 | * Unregisters the given {@code MapFrameListener} from MapFrame changes
|
---|
| 944 | * @param listener The MapFrameListener
|
---|
| 945 | * @return {@code true} if the listeners collection changed as a result of the call
|
---|
[12639] | 946 | * @deprecated use {@link MainApplication#removeMapFrameListener} instead
|
---|
[5957] | 947 | * @since 5957
|
---|
| 948 | */
|
---|
[12639] | 949 | @Deprecated
|
---|
[5957] | 950 | public static boolean removeMapFrameListener(MapFrameListener listener) {
|
---|
[12639] | 951 | return MainApplication.removeMapFrameListener(listener);
|
---|
[5957] | 952 | }
|
---|
[6642] | 953 |
|
---|
| 954 | /**
|
---|
| 955 | * Adds a new network error that occur to give a hint about broken Internet connection.
|
---|
| 956 | * Do not use this method for errors known for sure thrown because of a bad proxy configuration.
|
---|
[6852] | 957 | *
|
---|
[6642] | 958 | * @param url The accessed URL that caused the error
|
---|
| 959 | * @param t The network error
|
---|
| 960 | * @return The previous error associated to the given resource, if any. Can be {@code null}
|
---|
[6643] | 961 | * @since 6642
|
---|
[6642] | 962 | */
|
---|
| 963 | public static Throwable addNetworkError(URL url, Throwable t) {
|
---|
| 964 | if (url != null && t != null) {
|
---|
| 965 | Throwable old = addNetworkError(url.toExternalForm(), t);
|
---|
| 966 | if (old != null) {
|
---|
[12620] | 967 | Logging.warn("Already here "+old);
|
---|
[6642] | 968 | }
|
---|
| 969 | return old;
|
---|
| 970 | }
|
---|
| 971 | return null;
|
---|
| 972 | }
|
---|
| 973 |
|
---|
| 974 | /**
|
---|
| 975 | * Adds a new network error that occur to give a hint about broken Internet connection.
|
---|
| 976 | * Do not use this method for errors known for sure thrown because of a bad proxy configuration.
|
---|
[6852] | 977 | *
|
---|
[6642] | 978 | * @param url The accessed URL that caused the error
|
---|
| 979 | * @param t The network error
|
---|
| 980 | * @return The previous error associated to the given resource, if any. Can be {@code null}
|
---|
[6643] | 981 | * @since 6642
|
---|
[6642] | 982 | */
|
---|
| 983 | public static Throwable addNetworkError(String url, Throwable t) {
|
---|
| 984 | if (url != null && t != null) {
|
---|
[6806] | 985 | return NETWORK_ERRORS.put(url, t);
|
---|
[6642] | 986 | }
|
---|
| 987 | return null;
|
---|
| 988 | }
|
---|
| 989 |
|
---|
| 990 | /**
|
---|
| 991 | * Returns the network errors that occured until now.
|
---|
| 992 | * @return the network errors that occured until now, indexed by URL
|
---|
| 993 | * @since 6639
|
---|
| 994 | */
|
---|
| 995 | public static Map<String, Throwable> getNetworkErrors() {
|
---|
[7005] | 996 | return new HashMap<>(NETWORK_ERRORS);
|
---|
[6642] | 997 | }
|
---|
[6897] | 998 |
|
---|
| 999 | /**
|
---|
[12011] | 1000 | * Clears the network errors cache.
|
---|
| 1001 | * @since 12011
|
---|
| 1002 | */
|
---|
| 1003 | public static void clearNetworkErrors() {
|
---|
| 1004 | NETWORK_ERRORS.clear();
|
---|
| 1005 | }
|
---|
| 1006 |
|
---|
| 1007 | /**
|
---|
[6897] | 1008 | * Returns the JOSM website URL.
|
---|
| 1009 | * @return the josm website URL
|
---|
| 1010 | * @since 6897
|
---|
| 1011 | */
|
---|
| 1012 | public static String getJOSMWebsite() {
|
---|
[6920] | 1013 | if (Main.pref != null)
|
---|
[6897] | 1014 | return Main.pref.get("josm.url", JOSM_WEBSITE);
|
---|
| 1015 | return JOSM_WEBSITE;
|
---|
| 1016 | }
|
---|
| 1017 |
|
---|
| 1018 | /**
|
---|
| 1019 | * Returns the JOSM XML URL.
|
---|
| 1020 | * @return the josm XML URL
|
---|
| 1021 | * @since 6897
|
---|
| 1022 | */
|
---|
| 1023 | public static String getXMLBase() {
|
---|
[6920] | 1024 | // Always return HTTP (issues reported with HTTPS)
|
---|
[6900] | 1025 | return "http://josm.openstreetmap.de";
|
---|
[6897] | 1026 | }
|
---|
| 1027 |
|
---|
| 1028 | /**
|
---|
| 1029 | * Returns the OSM website URL.
|
---|
| 1030 | * @return the OSM website URL
|
---|
| 1031 | * @since 6897
|
---|
| 1032 | */
|
---|
| 1033 | public static String getOSMWebsite() {
|
---|
[6920] | 1034 | if (Main.pref != null)
|
---|
[6897] | 1035 | return Main.pref.get("osm.url", OSM_WEBSITE);
|
---|
| 1036 | return OSM_WEBSITE;
|
---|
| 1037 | }
|
---|
[6957] | 1038 |
|
---|
| 1039 | /**
|
---|
[11262] | 1040 | * Returns the OSM website URL depending on the selected {@link OsmApi}.
|
---|
| 1041 | * @return the OSM website URL depending on the selected {@link OsmApi}
|
---|
| 1042 | */
|
---|
| 1043 | private static String getOSMWebsiteDependingOnSelectedApi() {
|
---|
| 1044 | final String api = OsmApi.getOsmApi().getServerUrl();
|
---|
| 1045 | if (OsmApi.DEFAULT_API_URL.equals(api)) {
|
---|
| 1046 | return getOSMWebsite();
|
---|
| 1047 | } else {
|
---|
| 1048 | return api.replaceAll("/api$", "");
|
---|
| 1049 | }
|
---|
| 1050 | }
|
---|
| 1051 |
|
---|
| 1052 | /**
|
---|
[7678] | 1053 | * Replies the base URL for browsing information about a primitive.
|
---|
| 1054 | * @return the base URL, i.e. https://www.openstreetmap.org
|
---|
| 1055 | * @since 7678
|
---|
| 1056 | */
|
---|
| 1057 | public static String getBaseBrowseUrl() {
|
---|
| 1058 | if (Main.pref != null)
|
---|
[11262] | 1059 | return Main.pref.get("osm-browse.url", getOSMWebsiteDependingOnSelectedApi());
|
---|
| 1060 | return getOSMWebsiteDependingOnSelectedApi();
|
---|
[7678] | 1061 | }
|
---|
| 1062 |
|
---|
| 1063 | /**
|
---|
| 1064 | * Replies the base URL for browsing information about a user.
|
---|
| 1065 | * @return the base URL, i.e. https://www.openstreetmap.org/user
|
---|
| 1066 | * @since 7678
|
---|
| 1067 | */
|
---|
| 1068 | public static String getBaseUserUrl() {
|
---|
| 1069 | if (Main.pref != null)
|
---|
[11262] | 1070 | return Main.pref.get("osm-user.url", getOSMWebsiteDependingOnSelectedApi() + "/user");
|
---|
| 1071 | return getOSMWebsiteDependingOnSelectedApi() + "/user";
|
---|
[7678] | 1072 | }
|
---|
| 1073 |
|
---|
| 1074 | /**
|
---|
[6957] | 1075 | * Determines if we are currently running on OSX.
|
---|
| 1076 | * @return {@code true} if we are currently running on OSX
|
---|
| 1077 | * @since 6957
|
---|
| 1078 | */
|
---|
| 1079 | public static boolean isPlatformOsx() {
|
---|
| 1080 | return Main.platform instanceof PlatformHookOsx;
|
---|
| 1081 | }
|
---|
[7335] | 1082 |
|
---|
| 1083 | /**
|
---|
| 1084 | * Determines if we are currently running on Windows.
|
---|
| 1085 | * @return {@code true} if we are currently running on Windows
|
---|
| 1086 | * @since 7335
|
---|
| 1087 | */
|
---|
| 1088 | public static boolean isPlatformWindows() {
|
---|
| 1089 | return Main.platform instanceof PlatformHookWindows;
|
---|
| 1090 | }
|
---|
[7434] | 1091 |
|
---|
| 1092 | /**
|
---|
| 1093 | * Determines if the given online resource is currently offline.
|
---|
| 1094 | * @param r the online resource
|
---|
| 1095 | * @return {@code true} if {@code r} is offline and should not be accessed
|
---|
| 1096 | * @since 7434
|
---|
| 1097 | */
|
---|
| 1098 | public static boolean isOffline(OnlineResource r) {
|
---|
| 1099 | return OFFLINE_RESOURCES.contains(r) || OFFLINE_RESOURCES.contains(OnlineResource.ALL);
|
---|
| 1100 | }
|
---|
| 1101 |
|
---|
| 1102 | /**
|
---|
| 1103 | * Sets the given online resource to offline state.
|
---|
| 1104 | * @param r the online resource
|
---|
| 1105 | * @return {@code true} if {@code r} was not already offline
|
---|
| 1106 | * @since 7434
|
---|
| 1107 | */
|
---|
| 1108 | public static boolean setOffline(OnlineResource r) {
|
---|
| 1109 | return OFFLINE_RESOURCES.add(r);
|
---|
| 1110 | }
|
---|
| 1111 |
|
---|
| 1112 | /**
|
---|
[8506] | 1113 | * Sets the given online resource to online state.
|
---|
| 1114 | * @param r the online resource
|
---|
| 1115 | * @return {@code true} if {@code r} was offline
|
---|
| 1116 | * @since 8506
|
---|
| 1117 | */
|
---|
| 1118 | public static boolean setOnline(OnlineResource r) {
|
---|
| 1119 | return OFFLINE_RESOURCES.remove(r);
|
---|
| 1120 | }
|
---|
| 1121 |
|
---|
| 1122 | /**
|
---|
[7434] | 1123 | * Replies the set of online resources currently offline.
|
---|
| 1124 | * @return the set of online resources currently offline
|
---|
| 1125 | * @since 7434
|
---|
| 1126 | */
|
---|
| 1127 | public static Set<OnlineResource> getOfflineResources() {
|
---|
[10044] | 1128 | return EnumSet.copyOf(OFFLINE_RESOURCES);
|
---|
[7434] | 1129 | }
|
---|
[626] | 1130 | }
|
---|