Class UrlLauncher

java.lang.Object
net.i2p.apps.systray.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, Falkon, Konqueror, Links, Lynx, Mozilla, Mozilla Firefox, Netscape, Opera, and Safari.

Author:
hypercubus
  • Constructor Details

    • 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 Details

    • 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. 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
    • getState

      public ClientAppState getState()
      ClientApp interface
      Specified by:
      getState in interface ClientApp
      Returns:
      non-null
      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