Extracted our hairy bunch of logic for launching an external web browser into a

reusable location.


git-svn-id: svn+ssh://src.earth.threerings.net/narya/trunk@3894 542714f4-19e9-0310-aa3c-eee0fc999fb1

src/java/com/threerings/util/BrowserUtil.java

@@ -0,0 +1,141 @@
+//
+// $Id$
+//
+// Narya library - tools for developing networked games
+// Copyright (C) 2002-2006 Three Rings Design, Inc., All Rights Reserved
+// http://www.threerings.net/code/narya/
+//
+// This library is free software; you can redistribute it and/or modify it
+// under the terms of the GNU Lesser General Public License as published
+// by the Free Software Foundation; either version 2.1 of the License, or
+// (at your option) any later version.
+//
+// This library is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+// Lesser General Public License for more details.
+//
+// You should have received a copy of the GNU Lesser General Public
+// License along with this library; if not, write to the Free Software
+// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+
+package com.threerings.util;
+
+import java.net.URL;
+
+import com.samskivert.util.ResultListener;
+import com.samskivert.util.RunAnywhere;
+import com.samskivert.util.StringUtil;
+
+/**
+ * Encapsulates a bunch of hackery needed to invoke an external web browser
+ * from within a Java application.
+ */
+public class BrowserUtil
+{
+    /**
+     * Opens the user's web browser with the specified URL.
+     *
+     * @param url the URL to display in an external browser.
+     * @param listener a listener to be notified if we failed to launch the
+     * browser.
+     */
+    public static void browseURL (URL url, ResultListener listener)
+    {
+        browseURL(url, listener, "firefox");
+    }
+
+    /**
+     * Opens the user's web browser with the specified URL.
+     *
+     * @param url the URL to display in an external browser.
+     * @param listener a listener to be notified if we failed to launch the
+     * browser.
+     * @param genagent the path to the browser to execute on non-Windows,
+     * non-MacOS.
+     */
+    public static void browseURL (
+        URL url, ResultListener listener, String genagent)
+    {
+        String[] cmd;
+        if (RunAnywhere.isWindows()) {
+            // TODO: test this on Vinders 98
+//          cmd = new String[] { "rundll32", "url.dll,FileProtocolHandler",
+//              url.toString() };
+            String osName = System.getProperty("os.name");
+            if (osName.indexOf("9") != -1 || osName.indexOf("Me") != -1) {
+                cmd = new String[] { "command.com", "/c", "start",
+                                     "\"" + url.toString() + "\"" };
+            } else {
+                cmd = new String[] { "cmd.exe", "/c", "start", "\"\"",
+                                     "\"" + url.toString() + "\"" };
+            }
+
+        } else if (RunAnywhere.isMacOS()) {
+            cmd = new String[] { "open", url.toString() };
+
+        } else { // Linux, Solaris, etc
+            cmd = new String[] { genagent, url.toString() };
+        }
+
+        Log.info("Browsing URL [cmd=" + StringUtil.join(cmd, " ") + "].");
+        try {
+            Process process = Runtime.getRuntime().exec(cmd);
+            BrowserTracker tracker = new BrowserTracker(process, url, listener);
+            tracker.start();
+        } catch (Exception e) {
+            Log.warning("Failed to launch browser [url=" + url +
+                        ", error=" + e + "].");
+            listener.requestFailed(e);
+        }
+    }
+
+    protected static class BrowserTracker extends Thread
+    {
+        public BrowserTracker(Process process, URL url, ResultListener rl) {
+            super("BrowserLaunchWaiter");
+            setDaemon(true);
+            _process = process;
+            _url = url;
+            _listener = rl;
+        }
+
+        public void run () {
+            try {
+                _process.waitFor();
+                int rv = _process.exitValue();
+                if (rv == 0) {
+                    return;
+                }
+
+                String errmsg = "Launched browser failed [rv=" + rv + "].";
+                Log.warning(errmsg);
+                if (!RunAnywhere.isWindows()) {
+                    _listener.requestFailed(new Exception(errmsg));
+                    return;
+                }
+
+                // if we're on windows, make a last ditch effort
+                String[] cmd = new String[] { 
+                    "C:\\Program Files\\Internet Explorer\\" +
+                    "IEXPLORE.EXE", "\"" + _url.toString() + "\""};
+                Process process = Runtime.getRuntime().exec(cmd);
+                process.waitFor();
+                rv = process.exitValue();
+                if (rv != 0) {
+                    errmsg = "Failed to launch iexplore.exe [rv=" + rv + "].";
+                    Log.warning(errmsg);
+                    _listener.requestFailed(new Exception(errmsg));
+                }
+
+            } catch (Exception e) {
+                Log.logStackTrace(e);
+                _listener.requestFailed(e);
+            }
+        }
+
+        protected Process _process;
+        protected URL _url;
+        protected ResultListener _listener;
+    };
+}