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 java.lang.Object
implements PlatformHook

PlatformHook base implementation. 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 java.lang.String	osDescription

Constructor Summary

Constructors

Constructor and Description
PlatformHookUnixoid()

Method Summary

Modifier and Type	Method and Description
protected void	askUpdateJava(java.lang.String version)
protected void	askUpdateJava(java.lang.String version, java.lang.String url)
protected java.lang.String	buildOSDescription()
boolean	canFullscreen() Determines if the platform allows full-screen.
java.io.File	getDefaultCacheDirectory() Returns the platform-dependent default cache directory.
java.io.File	getDefaultPrefDirectory() Returns the platform-dependent default preferences directory.
java.lang.String	getDefaultStyle() Returns the default LAF to be used on this platform to look almost as a native application.
java.io.File	getDefaultUserDataDirectory() Returns the platform-dependent default user data directory.
java.lang.String	getJavaPackageDetails() Get the Java package name including detailed version.
java.lang.String	getOSDescription() Returns a detailed OS description (at least family + version).
static java.lang.String	getPackageDetails(java.lang.String... packageNames) Get the package name including detailed version.
java.lang.String	getWebStartPackageDetails() Get the Web Start package name including detailed 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.
static boolean	isOpenJDK() Determines if the JVM is OpenJDK-based.
java.lang.String	makeTooltip(java.lang.String name, Shortcut sc) This should work for all platforms.
void	openUrl(java.lang.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(java.io.File from, java.io.File to) Renames a file.
boolean	setupHttpsCertificate(java.lang.String entryAlias, java.security.KeyStore.TrustedCertificateEntry trustedCert) Setup system keystore to add JOSM HTTPS certificate (for remote control).
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 java.lang.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(java.lang.String url)
             throws java.io.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:

java.io.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:<whatever>", 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 java.lang.String makeTooltip(java.lang.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 java.lang.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(java.io.File from,
                      java.io.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

isOpenJDK

public static boolean isOpenJDK()

Determines if the JVM is OpenJDK-based.

Returns:

true if java.home contains "openjdk", false otherwise

Since:

6951

getPackageDetails

public static java.lang.String getPackageDetails(java.lang.String... packageNames)

Get the package name including detailed version.

Parameters:

packageNames - The possible package names (when a package can have different names on different distributions)

Returns:

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

Since:

7314

getJavaPackageDetails

public java.lang.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.

Returns:

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

getWebStartPackageDetails

public java.lang.String getWebStartPackageDetails()

Get the Web Start package name including detailed version. OpenJDK packages are shipped with icedtea-web package, but its version generally does not match main java package version. Simply return null if there's no separate package for Java WebStart.

Returns:

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

buildOSDescription

protected java.lang.String buildOSDescription()

getOSDescription

public java.lang.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(java.lang.String version)

askUpdateJava

protected void askUpdateJava(java.lang.String version,
                             java.lang.String url)

setupHttpsCertificate

public boolean setupHttpsCertificate(java.lang.String entryAlias,
                                     java.security.KeyStore.TrustedCertificateEntry trustedCert)
                              throws java.security.KeyStoreException,
                                     java.security.NoSuchAlgorithmException,
                                     java.security.cert.CertificateException,
                                     java.io.IOException

Description copied from interface: PlatformHook

Setup system keystore to add JOSM HTTPS certificate (for remote control).

Specified by:

setupHttpsCertificate in interface PlatformHook

Parameters:

entryAlias - The entry alias to use

trustedCert - the JOSM certificate for localhost

Returns:

true if something has changed as a result of the call (certificate installation, etc.)

Throws:

java.security.KeyStoreException - in case of error

java.security.NoSuchAlgorithmException - in case of error

java.security.cert.CertificateException - in case of error

java.io.IOException - in case of error

getDefaultCacheDirectory

public java.io.File getDefaultCacheDirectory()

Description copied from interface: PlatformHook

Returns the platform-dependent default cache directory.

Specified by:

getDefaultCacheDirectory in interface PlatformHook

Returns:

the platform-dependent default cache directory

getDefaultPrefDirectory

public java.io.File getDefaultPrefDirectory()

Description copied from interface: PlatformHook

Returns the platform-dependent default preferences directory.

Specified by:

getDefaultPrefDirectory in interface PlatformHook

Returns:

the platform-dependent default preferences directory

getDefaultUserDataDirectory

public java.io.File getDefaultUserDataDirectory()

Description copied from interface: PlatformHook

Returns the platform-dependent default user data directory.

Specified by:

getDefaultUserDataDirectory in interface PlatformHook

Returns:

the platform-dependent default user data directory