Package net.i2p.apps.systray

Class UrlLauncher

  • All Implemented Interfaces:
    ClientApp
    public class UrlLauncher
extends Object
implements ClientApp
    A quick and simple multi-platform URL launcher. It attempts to launch the default browser for the host platform first, then popular third-party browsers if that was not successful.

    Handles Galeon, Internet Explorer, Konqueror, Links, Lynx, Mozilla, Mozilla Firefox, Netscape, Opera, and Safari.

    Author:
    hypercubus

    • Constructor Detail

      • UrlLauncher

        public UrlLauncher​(I2PAppContext context,
                   ClientAppManager mgr,
                   String[] args)
        ClientApp constructor used from clients.config
        Parameters:
        mgr - null OK
        args - URL in args[0] or null args for router console
        Since:
        0.9.18

      • UrlLauncher

        public UrlLauncher()
        Constructor from SysTray
        Since:
        0.9.18

    • Method Detail

      • openUrl

        public boolean openUrl​(String url)
                throws IOException
        Discovers the operating system the installer is running under and tries to launch the given URL using the default browser for that platform; if unsuccessful, an attempt is made to launch the URL using the most common browsers. As of 0.9.46, fails immediately if JVM is a Windows or Linux Service. BLOCKING. This repeatedly probes the server port at the given url until it is apparently ready.
        Parameters:
        url - The URL to open.
        Returns:
        true if the operation was successful, otherwise false.
        Throws:
        IOException

      • openUrl

        public boolean openUrl​(String url,
                       String browser)
                throws IOException
        Opens the given URL with the given browser. As of 0.9.38, the browser parameter will be parsed into arguments separated by spaces or tabs. %1, if present, will be replaced with the url. Arguments may be surrounded by single or double quotes if they contain spaces or tabs. There is no mechanism to escape quotes or other chars with backslashes. As of 0.9.46, fails immediately if JVM is a Windows or Linux Service. BLOCKING. However, this does NOT probe the server port to see if it is ready.
        Parameters:
        url - The URL to open.
        browser - The browser to use. See above for quoting rules.
        Returns:
        true if the operation was successful, otherwise false.
        Throws:
        IOException

      • startup

        public void startup()
        ClientApp interface As of 0.9.46, stops immediately if JVM is a Windows or Linux Service.
        Specified by:
        startup in interface ClientApp
        Since:
        0.9.18

      • getName

        public String getName()
        ClientApp interface
        Specified by:
        getName in interface ClientApp
        Returns:
        non-null
        Since:
        0.9.18

      • getDisplayName

        public String getDisplayName()
        ClientApp interface
        Specified by:
        getDisplayName in interface ClientApp
        Returns:
        non-null
        Since:
        0.9.18

      • shutdown

        public void shutdown​(String[] args)
        ClientApp interface
        Specified by:
        shutdown in interface ClientApp
        Parameters:
        args - generally null but could be stopArgs from clients.config
        Since:
        0.9.18

      • main

        public static void main​(String[] args)
        Obsolete, now uses ClientApp interface