Class XDesktopEntry

java.lang.Object

net.sourceforge.jnlp.util.XDesktopEntry

All Implemented Interfaces:

GenericDesktopEntry

public class XDesktopEntry
extends Object
implements GenericDesktopEntry

This class builds a (freedesktop.org) desktop entry out of a JNLPFile . This entry can be used to install desktop shortcuts. See xdg-desktop-icon (1) and http://standards.freedesktop.org/desktop-entry-spec/latest/ for more information

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private class	XDesktopEntry.NonFileProtocolException

Field Summary

Fields

Modifier and Type	Field	Description
static final String[]	BROWSERS
static final String	FAVICON
private JNLPFile	file
private static final String	GIF
private String	iconLocation
private int	iconSize
private static final String	JPEG
private static final String	JPG
private static final Logger	LOG
private static final String	MIC
private static final String	PNG
private static final int[]	VALID_ICON_SIZES
(package private) static final String	XDG_DESKTOP_DIR

Constructor Summary

Constructors

Constructor	Description
XDesktopEntry(JNLPFile file)	Create a XDesktopEntry for the given JNLP file

Method Summary

Modifier and Type	Method	Description
(package private) String	cacheAndGetIconLocation()
private void	cacheIcon()	Cache the icon for the desktop entry
private void	cantCache()
private File	convertToIco(File source, String targetName)
void	createDesktopShortcuts(AccessWarningPaneComplexReturn.ShortcutResult menu, AccessWarningPaneComplexReturn.ShortcutResult desktop)	Create a desktop shortcut for this desktop entry
void	createShortcutOnWindowsDesktop()
void	createWindowsMenu()
private static File	downloadFavIcon(JNLPFile file)
private static String	evaluateLinuxVariables(String orig)
private static String	evaluateLinuxVariables(String orig, Map<String,String> variables)
private static URL	favUrl(String delimiter, String path, JNLPFile file)
private static String	filterQuotes(String string)
private static String	findAndVerifyBasicDir(File f, String message)
private static String	findAndVerifyGeneratedJnlpDir()
private static String	findAndVerifyJavawsMenuDir()
private static String	findFreedesktopOrgDesktopPath()	Instead of having all this parsing of user-dirs.dirs and replacing variables we can execute `echo $(xdg-user-dir DESKTOP)` and it will do all the job in case approaches below become failing
static String	findFreedesktopOrgDesktopPathCatch()
static String	getBrowserBin()
(package private) String	getContent(boolean menu, AccessWarningPaneComplexReturn.ShortcutResult info)	Returns the contents of the XDesktopEntry as a String.
(package private) static File	getDesktop()
File	getDesktopIconFile()
(package private) static String	getFreedesktopOrgDesktopPathFrom(BufferedReader r)
private static String	getFreedesktopOrgDesktopPathFrom(File userDirs)
File	getGeneratedJnlpFileName()
File	getLinuxMenuIconFile()
private String	getShortcutFileName()
private String	getShortcutName()
(package private) File	getShortcutTmpFile()
private String	getUniqueIconName(String iconName)
private void	installDesktopLauncher(AccessWarningPaneComplexReturn.ShortcutResult info)	Install this XDesktopEntry into the user's desktop as a launcher.
private void	installMenuLauncher(AccessWarningPaneComplexReturn.ShortcutResult info)	Install this XDesktopEntry into the user's menu.
(package private) static List<String>	possibleFavIconLocations(String path)
void	refreshExistingShortcuts(boolean desktop, boolean menu)
private static String	sanitize(String input)	Sanitizes a string so that it can be used safely in a key=value pair in a desktop entry file.

Methods inherited from class Object

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

Field Details

LOG

private static final Logger LOG

file

private JNLPFile file

iconSize

private int iconSize

iconLocation

private String iconLocation

VALID_ICON_SIZES

private static final int[] VALID_ICON_SIZES

GIF

private static final String GIF

See Also:

• Constant Field Values

JPG

private static final String JPG

See Also:

• Constant Field Values

JPEG

private static final String JPEG

See Also:

• Constant Field Values

PNG

private static final String PNG

See Also:

• Constant Field Values

BROWSERS

public static final String[] BROWSERS

FAVICON

public static final String FAVICON

See Also:

• Constant Field Values

XDG_DESKTOP_DIR

static final String XDG_DESKTOP_DIR

See Also:

• Constant Field Values

MIC

private static final String MIC

See Also:

• Constant Field Values

Constructor Details

XDesktopEntry

public XDesktopEntry(JNLPFile file)

Create a XDesktopEntry for the given JNLP file

Parameters:

file - a JNLPFile that indicates the application to launch

Method Details

getContent

String getContent(boolean menu,
 AccessWarningPaneComplexReturn.ShortcutResult info)

Returns the contents of the XDesktopEntry as a String.

Parameters:

menu - whether to create this icon to menu

info - result of user's interference

Returns:

string with desktop shortcut specification

getBrowserBin

public static String getBrowserBin()

sanitize

private static String sanitize(String input)

Sanitizes a string so that it can be used safely in a key=value pair in a desktop entry file.

Parameters:

input - a String to sanitize

Returns:

a string safe to use as either the key or the value in the key=value pair in a desktop entry file

getShortcutTmpFile

File getShortcutTmpFile()

createDesktopShortcuts

public void createDesktopShortcuts(AccessWarningPaneComplexReturn.ShortcutResult menu,
 AccessWarningPaneComplexReturn.ShortcutResult desktop)

Create a desktop shortcut for this desktop entry

Specified by:

createDesktopShortcuts in interface GenericDesktopEntry

Parameters:

menu - how to create in menu

desktop - how to create on desktop

installMenuLauncher

private void installMenuLauncher(AccessWarningPaneComplexReturn.ShortcutResult info)

Install this XDesktopEntry into the user's menu.

installDesktopLauncher

private void installDesktopLauncher(AccessWarningPaneComplexReturn.ShortcutResult info)

Install this XDesktopEntry into the user's desktop as a launcher.

refreshExistingShortcuts

public void refreshExistingShortcuts(boolean desktop,
 boolean menu)

Specified by:

refreshExistingShortcuts in interface GenericDesktopEntry

getGeneratedJnlpFileName

public File getGeneratedJnlpFileName()

Specified by:

getGeneratedJnlpFileName in interface GenericDesktopEntry

cacheIcon

private void cacheIcon()
                throws IOException,
XDesktopEntry.NonFileProtocolException

Cache the icon for the desktop entry

Throws:

IOException

XDesktopEntry.NonFileProtocolException

getUniqueIconName

private String getUniqueIconName(String iconName)

convertToIco

private File convertToIco(File source,
 String targetName)

cacheAndGetIconLocation

String cacheAndGetIconLocation()

possibleFavIconLocations

static List<String> possibleFavIconLocations(String path)

favUrl

private static URL favUrl(String delimiter,
 String path,
 JNLPFile file)
                   throws MalformedURLException

Throws:

MalformedURLException

downloadFavIcon

private static File downloadFavIcon(JNLPFile file)

cantCache

private void cantCache()
                throws XDesktopEntry.NonFileProtocolException

Throws:

XDesktopEntry.NonFileProtocolException

getShortcutName

private String getShortcutName()

getDesktopIconFile

public File getDesktopIconFile()

Specified by:

getDesktopIconFile in interface GenericDesktopEntry

getDesktop

static File getDesktop()

getLinuxMenuIconFile

public File getLinuxMenuIconFile()

Specified by:

getLinuxMenuIconFile in interface GenericDesktopEntry

getShortcutFileName

private String getShortcutFileName()

findAndVerifyGeneratedJnlpDir

private static String findAndVerifyGeneratedJnlpDir()

findAndVerifyJavawsMenuDir

private static String findAndVerifyJavawsMenuDir()

findAndVerifyBasicDir

private static String findAndVerifyBasicDir(File f,
 String message)

findFreedesktopOrgDesktopPathCatch

public static String findFreedesktopOrgDesktopPathCatch()

findFreedesktopOrgDesktopPath

private static String findFreedesktopOrgDesktopPath()
                                             throws IOException

Instead of having all this parsing of user-dirs.dirs and replacing variables we can execute `echo $(xdg-user-dir DESKTOP)` and it will do all the job in case approaches below become failing

Returns:

variables (if declared) and quotation marks (unless escaped) free path

Throws:

IOException - if no file do not exists or key with desktop do not exists

getFreedesktopOrgDesktopPathFrom

private static String getFreedesktopOrgDesktopPathFrom(File userDirs)
                                                throws IOException

Throws:

IOException

getFreedesktopOrgDesktopPathFrom

static String getFreedesktopOrgDesktopPathFrom(BufferedReader r)
                                        throws IOException

Throws:

IOException

filterQuotes

private static String filterQuotes(String string)

evaluateLinuxVariables

private static String evaluateLinuxVariables(String orig)

evaluateLinuxVariables

private static String evaluateLinuxVariables(String orig,
 Map<String,String> variables)

createShortcutOnWindowsDesktop

public void createShortcutOnWindowsDesktop()

Specified by:

createShortcutOnWindowsDesktop in interface GenericDesktopEntry

createWindowsMenu

public void createWindowsMenu()

Specified by:

createWindowsMenu in interface GenericDesktopEntry