org.openstreetmap.josm.tools

Class PlatformHookUnixoid

java.lang.Object

org.openstreetmap.josm.tools.PlatformHookUnixoid

All Implemented Interfaces:

PlatformHook

Direct Known Subclasses:

PlatformHookOsx, PlatformHookWindows

public class PlatformHookUnixoid
extends Object
implements PlatformHook

see PlatformHook.java BTW: THIS IS A STUB. See comments below for details. Don't write (Main.platform instanceof PlatformHookUnixoid) because other platform hooks are subclasses of this class.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	PlatformHookUnixoid.LinuxReleaseInfo

Field Summary

Fields

Modifier and Type	Field and Description
private String	osDescription

Constructor Summary

Constructors

Constructor and Description
PlatformHookUnixoid()

Method Summary

Modifier and Type	Method and Description
protected void	askUpdateJava(String version)
protected String	buildOSDescription()
boolean	canFullscreen() Determines if the platform allows full-screen.
String	getDefaultStyle() Returns the default LAF to be used on this platform to look almost as a native application.
String	getJavaPackageDetails() Get the Java package name including detailed version.
String	getOSDescription() Returns a detailed OS description (at least family + version).
void	initSystemShortcuts() The initSystemShortcuts hook will be called by the Shortcut class after the modifier groups have been read from the config, but before any shortcuts are read from it or registered from within the application.
String	makeTooltip(String name, Shortcut sc) This should work for all platforms.
void	openUrl(String url) The openURL hook will be used to open an URL in the default web browser.
void	preStartupHook() The preStartupHook will be called extremly early.
boolean	rename(File from, File to) Renames a file.
void	startupHook() The startupHook will be called early, but after the GUI setup has started.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

osDescription

private String osDescription

Constructor Detail

PlatformHookUnixoid

public PlatformHookUnixoid()

Method Detail

preStartupHook

public void preStartupHook()

Description copied from interface: PlatformHook

The preStartupHook will be called extremly early. It is guaranteed to be called before the GUI setup has started. Reason: On OSX we need to inform the Swing libraries that we want to be integrated with the OS before we setup our GUI.

Specified by:

preStartupHook in interface PlatformHook

startupHook

public void startupHook()

Description copied from interface: PlatformHook

The startupHook will be called early, but after the GUI setup has started. Reason: On OSX we need to register some callbacks with the OS, so we'll receive events from the system menu.

Specified by:

startupHook in interface PlatformHook

openUrl

public void openUrl(String url)
             throws IOException

Description copied from interface: PlatformHook

The openURL hook will be used to open an URL in the default web browser.

Specified by:

openUrl in interface PlatformHook

Parameters:

url - The URL to open

Throws:

IOException - if any I/O error occurs

initSystemShortcuts

public void initSystemShortcuts()

Description copied from interface: PlatformHook

The initSystemShortcuts hook will be called by the Shortcut class after the modifier groups have been read from the config, but before any shortcuts are read from it or registered from within the application. Plese note that you are not allowed to register any shortuts from this hook, but only "systemCuts"! BTW: SystemCuts should be named "system:", and it'd be best if sou'd recycle the names already used by the Windows and OSX hooks. Especially the later has really many of them. You should also register any and all shortcuts that the operation system handles itself to block JOSM from trying to use them---as that would just not work. Call setAutomatic on them to prevent the keyboard preferences from allowing the user to change them.

Specified by:

initSystemShortcuts in interface PlatformHook

makeTooltip

public String makeTooltip(String name,
                          Shortcut sc)

This should work for all platforms. Yeah, should. See PlatformHook.java for a list of reasons why this is implemented here...

Specified by:

makeTooltip in interface PlatformHook

Parameters:

name - Tooltip text to display

sc - Shortcut associated (to display accelerator between parenthesis)

Returns:

Full tooltip text (name + accelerator)

getDefaultStyle

public String getDefaultStyle()

Description copied from interface: PlatformHook

Returns the default LAF to be used on this platform to look almost as a native application.

Specified by:

getDefaultStyle in interface PlatformHook

Returns:

The default native LAF for this platform

canFullscreen

public boolean canFullscreen()

Description copied from interface: PlatformHook

Determines if the platform allows full-screen.

Specified by:

canFullscreen in interface PlatformHook

Returns:

true if full screen is allowed, false otherwise

rename

public boolean rename(File from,
                      File to)

Description copied from interface: PlatformHook

Renames a file.

Specified by:

rename in interface PlatformHook

Parameters:

from - Source file

to - Target file

Returns:

true if the file has been renamed, false otherwise

getJavaPackageDetails

public String getJavaPackageDetails()

Get the Java package name including detailed version. Some Java bugs are specific to a certain security update, so in addition to the Java version, we also need the exact package version. This was originally written for #8921, so only Debian based distributions are covered at the moment. This can be extended to other distributions if needed.

Returns:

The package name and package version if it can be identified, null otherwise

buildOSDescription

protected String buildOSDescription()

getOSDescription

public String getOSDescription()

Description copied from interface: PlatformHook

Returns a detailed OS description (at least family + version).

Specified by:

getOSDescription in interface PlatformHook

Returns:

A detailed OS description.

askUpdateJava

protected void askUpdateJava(String version)