src/jalview/util/BrowserLauncher.java

   1 /*
   2  * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
   3  * Copyright (C) $$Year-Rel$$ The Jalview Authors
   4  *
   5  * This file is part of Jalview.
   6  *
   7  * Jalview is free software: you can redistribute it and/or
   8  * modify it under the terms of the GNU General Public License
   9  * as published by the Free Software Foundation, either version 3
  10  * of the License, or (at your option) any later version.
  11  *
  12  * Jalview is distributed in the hope that it will be useful, but
  13  * WITHOUT ANY WARRANTY; without even the implied warranty
  14  * of MERCHANTABILITY or FITNESS FOR A PARTICULAR
  15  * PURPOSE.  See the GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License
  18  * along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
  19  * The Jalview Authors are detailed in the 'AUTHORS' file.
  20  */
  21 package jalview.util;
  22
  23 import java.io.File;
  24 import java.io.IOException;
  25 import java.lang.reflect.Constructor;
  26 import java.lang.reflect.Field;
  27 import java.lang.reflect.InvocationTargetException;
  28 import java.lang.reflect.Method;
  29
  30 /**
  31  * BrowserLauncher is a class that provides one static method, openURL, which
  32  * opens the default web browser for the current user of the system to the given
  33  * URL. It may support other protocols depending on the system -- mailto, ftp,
  34  * etc. -- but that has not been rigorously tested and is not guaranteed to
  35  * work.
  36  * <p>
  37  * Yes, this is platform-specific code, and yes, it may rely on classes on
  38  * certain platforms that are not part of the standard JDK. What we're trying to
  39  * do, though, is to take something that's frequently desirable but inherently
  40  * platform-specific -- opening a default browser -- and allow programmers (you,
  41  * for example) to do so without worrying about dropping into native code or
  42  * doing anything else similarly evil.
  43  * <p>
  44  * Anyway, this code is completely in Java and will run on all JDK 1.1-compliant
  45  * systems without modification or a need for additional libraries. All classes
  46  * that are required on certain platforms to allow this to run are dynamically
  47  * loaded at runtime via reflection and, if not found, will not cause this to do
  48  * anything other than returning an error when opening the browser.
  49  * <p>
  50  * There are certain system requirements for this class, as it's running through
  51  * Runtime.exec(), which is Java's way of making a native system call.
  52  * Currently, this requires that a Macintosh have a Finder which supports the
  53  * GURL event, which is true for Mac OS 8.0 and 8.1 systems that have the
  54  * Internet Scripting AppleScript dictionary installed in the Scripting
  55  * Additions folder in the Extensions folder (which is installed by default as
  56  * far as I know under Mac OS 8.0 and 8.1), and for all Mac OS 8.5 and later
  57  * systems. On Windows, it only runs under Win32 systems (Windows 95, 98, and NT
  58  * 4.0, as well as later versions of all). On other systems, this drops back
  59  * from the inherently platform-sensitive concept of a default browser and
  60  * simply attempts to launch Netscape via a shell command.
  61  * <p>
  62  * This code is Copyright 1999-2001 by Eric Albert (ejalbert\@cs.stanford.edu)
  63  * and may be redistributed or modified in any form without restrictions as long
  64  * as the portion of this comment from this paragraph through the end of the
  65  * comment is not removed. The author requests that he be notified of any
  66  * application, applet, or other binary that makes use of this code, but that's
  67  * more out of curiosity than anything and is not required. This software
  68  * includes no warranty. The author is not repsonsible for any loss of data or
  69  * functionality or any adverse or unexpected effects of using this software.
  70  * <p>
  71  * Credits: <br>
  72  * Steven Spencer, JavaWorld magazine
  73  * (<a href="http://www.javaworld.com/javaworld/javatips/jw-javatip66.html">Java
  74  * Tip 66</a>) <br>
  75  * Thanks also to Ron B. Yeh, Eric Shapiro, Ben Engber, Paul Teitlebaum, Andrea
  76  * Cantatore, Larry Barowski, Trevor Bedzek, Frank Miedrich, and Ron Rabakukk
  77  *
  78  * @author Eric Albert (<a href=
  79  *         "mailto:ejalbert@cs.stanford.edu">ejalbert@cs.stanford.edu</a>)
  80  * @version 1.4b1 (Released June 20, 2001)
  81  */
  82 public class BrowserLauncher
  83 {
  84   /**
  85    * The Java virtual machine that we are running on. Actually, in most cases we
  86    * only care about the operating system, but some operating systems require us
  87    * to switch on the VM.
  88    */
  89   private static int jvm;
  90
  91   /** The browser for the system */
  92   private static Object browser;
  93
  94   /**
  95    * Caches whether any classes, methods, and fields that are not part of the
  96    * JDK and need to be dynamically loaded at runtime loaded successfully.
  97    * <p>
  98    * Note that if this is <code>false</code>, <code>openURL()</code> will always
  99    * return an IOException.
 100    */
 101   private static boolean loadedWithoutErrors;
 102
 103   /** The com.apple.mrj.MRJFileUtils class */
 104   private static Class mrjFileUtilsClass;
 105
 106   /** The com.apple.mrj.MRJOSType class */
 107   private static Class mrjOSTypeClass;
 108
 109   /** The com.apple.MacOS.AEDesc class */
 110   private static Class aeDescClass;
 111
 112   /** The &lt;init&gt;(int) method of com.apple.MacOS.AETarget */
 113   private static Constructor aeTargetConstructor;
 114
 115   /** The &lt;init&gt;(int, int, int) method of com.apple.MacOS.AppleEvent */
 116   private static Constructor appleEventConstructor;
 117
 118   /** The &lt;init&gt;(String) method of com.apple.MacOS.AEDesc */
 119   private static Constructor aeDescConstructor;
 120
 121   /** The findFolder method of com.apple.mrj.MRJFileUtils */
 122   private static Method findFolder;
 123
 124   /** The getFileCreator method of com.apple.mrj.MRJFileUtils */
 125   private static Method getFileCreator;
 126
 127   /** The getFileType method of com.apple.mrj.MRJFileUtils */
 128   private static Method getFileType;
 129
 130   /** The openURL method of com.apple.mrj.MRJFileUtils */
 131   private static Method openURL;
 132
 133   /** The makeOSType method of com.apple.MacOS.OSUtils */
 134   private static Method makeOSType;
 135
 136   /** The putParameter method of com.apple.MacOS.AppleEvent */
 137   private static Method putParameter;
 138
 139   /** The sendNoReply method of com.apple.MacOS.AppleEvent */
 140   private static Method sendNoReply;
 141
 142   /** Actually an MRJOSType pointing to the System Folder on a Macintosh */
 143   private static Object kSystemFolderType;
 144
 145   /** The keyDirectObject AppleEvent parameter type */
 146   private static Integer keyDirectObject;
 147
 148   /** The kAutoGenerateReturnID AppleEvent code */
 149   private static Integer kAutoGenerateReturnID;
 150
 151   /** The kAnyTransactionID AppleEvent code */
 152   private static Integer kAnyTransactionID;
 153
 154   /** The linkage object required for JDirect 3 on Mac OS X. */
 155   private static Object linkage;
 156
 157   /** The framework to reference on Mac OS X */
 158   private static final String JDirect_MacOSX = "/System/Library/Frameworks/Carbon.framework/Frameworks/HIToolbox.framework/HIToolbox";
 159
 160   /** JVM constant for MRJ 2.0 */
 161   private static final int MRJ_2_0 = 0;
 162
 163   /** JVM constant for MRJ 2.1 or later */
 164   private static final int MRJ_2_1 = 1;
 165
 166   /** JVM constant for Java on Mac OS X 10.0 (MRJ 3.0) */
 167   private static final int MRJ_3_0 = 3;
 168
 169   /** JVM constant for MRJ 3.1 */
 170   private static final int MRJ_3_1 = 4;
 171
 172   /** JVM constant for any Windows NT JVM */
 173   private static final int WINDOWS_NT = 5;
 174
 175   /** JVM constant for any Windows 9x JVM */
 176   private static final int WINDOWS_9x = 6;
 177
 178   /** JVM constant for any other platform */
 179   private static final int OTHER = -1;
 180
 181   /**
 182    * The file type of the Finder on a Macintosh. Hardcoding "Finder" would keep
 183    * non-U.S. English systems from working properly.
 184    */
 185   private static final String FINDER_TYPE = "FNDR";
 186
 187   /**
 188    * The creator code of the Finder on a Macintosh, which is needed to send
 189    * AppleEvents to the application.
 190    */
 191   private static final String FINDER_CREATOR = "MACS";
 192
 193   /** The name for the AppleEvent type corresponding to a GetURL event. */
 194   private static final String GURL_EVENT = "GURL";
 195
 196   /**
 197    * The first parameter that needs to be passed into Runtime.exec() to open the
 198    * default web browser on Windows.
 199    */
 200   private static final String FIRST_WINDOWS_PARAMETER = "/c";
 201
 202   /** The second parameter for Runtime.exec() on Windows. */
 203   private static final String SECOND_WINDOWS_PARAMETER = "start";
 204
 205   /**
 206    * The third parameter for Runtime.exec() on Windows. This is a "title"
 207    * parameter that the command line expects. Setting this parameter allows URLs
 208    * containing spaces to work.
 209    */
 210   private static final String THIRD_WINDOWS_PARAMETER = "\"\"";
 211
 212   /**
 213    * The shell parameters for Netscape that opens a given URL in an already-open
 214    * copy of Netscape on many command-line systems.
 215    */
 216   private static final String NETSCAPE_REMOTE_PARAMETER = "-remote";
 217
 218   private static final String NETSCAPE_OPEN_PARAMETER_START = "openURL(";
 219
 220   private static final String NETSCAPE_OPEN_NEW_WINDOW = ", new-window";
 221
 222   private static final String NETSCAPE_OPEN_PARAMETER_END = ")";
 223
 224   /**
 225    * The message from any exception thrown throughout the initialization
 226    * process.
 227    */
 228   private static String errorMessage;
 229
 230   /**
 231    * An initialization block that determines the operating system and loads the
 232    * necessary runtime data.
 233    */
 234   static
 235   {
 236
 237     loadedWithoutErrors = true;
 238
 239     if (!Platform.isJS())
 240     /**
 241      * Java only
 242      *
 243      * @j2sIgnore
 244      *
 245      */
 246     {
 247     String osName = System.getProperty("os.name");
 248
 249     if (osName.startsWith("Mac OS"))
 250     {
 251       String mrjVersion = System.getProperty("mrj.version");
 252       String majorMRJVersion;
 253       if (mrjVersion == null)
 254       {
 255         // must be on some later build with mrj support
 256         majorMRJVersion = "3.1";
 257       }
 258       else
 259       {
 260         majorMRJVersion = mrjVersion.substring(0, 3);
 261       }
 262
 263       try
 264       {
 265         double version = Double.valueOf(majorMRJVersion).doubleValue();
 266
 267         if (version == 2)
 268         {
 269           jvm = MRJ_2_0;
 270         }
 271         else if ((version >= 2.1) && (version < 3))
 272         {
 273           // Assume that all 2.x versions of MRJ work the same. MRJ 2.1 actually
 274           // works via Runtime.exec() and 2.2 supports that but has an openURL()
 275           // method
 276           // as well that we currently ignore.
 277           jvm = MRJ_2_1;
 278         }
 279         else if (version == 3.0)
 280         {
 281           jvm = MRJ_3_0;
 282         }
 283         else if (version >= 3.1)
 284         {
 285           // Assume that all 3.1 and later versions of MRJ work the same.
 286           jvm = MRJ_3_1;
 287         }
 288         else
 289         {
 290           loadedWithoutErrors = false;
 291           errorMessage = "Unsupported MRJ version: " + version;
 292         }
 293       } catch (NumberFormatException nfe)
 294       {
 295         loadedWithoutErrors = false;
 296         errorMessage = "Invalid MRJ version: " + mrjVersion;
 297       }
 298     }
 299     else if (osName.startsWith("Windows"))
 300     {
 301       if (osName.indexOf("9") != -1)
 302       {
 303         jvm = WINDOWS_9x;
 304       }
 305       else
 306       {
 307         jvm = WINDOWS_NT;
 308       }
 309     }
 310     else
 311     {
 312       jvm = OTHER;
 313     }
 314
 315     if (loadedWithoutErrors)
 316     { // if we haven't hit any errors yet
 317       loadedWithoutErrors = loadClasses();
 318     }
 319     }
 320   }
 321
 322   /**
 323    * This class should be never be instantiated; this just ensures so.
 324    */
 325   private BrowserLauncher()
 326   {
 327   }
 328
 329   /**
 330    * Called by a static initializer to load any classes, fields, and methods
 331    * required at runtime to locate the user's web browser.
 332    *
 333    * @return <code>true</code> if all intialization succeeded <code>false</code>
 334    *         if any portion of the initialization failed
 335    */
 336   private static boolean loadClasses()
 337   {
 338
 339     if (!Platform.isJS())
 340     /**
 341      * Java only
 342      *
 343      * @j2sIgnore
 344      *
 345      */
 346     {
 347     switch (jvm)
 348     {
 349     case MRJ_2_0:
 350
 351       try
 352       {
 353         Class aeTargetClass = Class.forName("com.apple.MacOS.AETarget");
 354         Class osUtilsClass = Class.forName("com.apple.MacOS.OSUtils");
 355         Class appleEventClass = Class.forName("com.apple.MacOS.AppleEvent");
 356         Class aeClass = Class.forName("com.apple.MacOS.ae");
 357         aeDescClass = Class.forName("com.apple.MacOS.AEDesc");
 358
 359         aeTargetConstructor = aeTargetClass
 360                 .getDeclaredConstructor(new Class[]
 361                 { int.class });
 362         appleEventConstructor = appleEventClass
 363                 .getDeclaredConstructor(new Class[]
 364                 { int.class, int.class, aeTargetClass, int.class,
 365                     int.class });
 366         aeDescConstructor = aeDescClass
 367                 .getDeclaredConstructor(new Class[]
 368                 { String.class });
 369
 370         makeOSType = osUtilsClass.getDeclaredMethod("makeOSType",
 371                 new Class[]
 372                 { String.class });
 373         putParameter = appleEventClass.getDeclaredMethod("putParameter",
 374                 new Class[]
 375                 { int.class, aeDescClass });
 376         sendNoReply = appleEventClass.getDeclaredMethod("sendNoReply",
 377                 new Class[] {});
 378
 379         Field keyDirectObjectField = aeClass
 380                 .getDeclaredField("keyDirectObject");
 381         keyDirectObject = (Integer) keyDirectObjectField.get(null);
 382
 383         Field autoGenerateReturnIDField = appleEventClass
 384                 .getDeclaredField("kAutoGenerateReturnID");
 385         kAutoGenerateReturnID = (Integer) autoGenerateReturnIDField
 386                 .get(null);
 387
 388         Field anyTransactionIDField = appleEventClass
 389                 .getDeclaredField("kAnyTransactionID");
 390         kAnyTransactionID = (Integer) anyTransactionIDField.get(null);
 391       } catch (ClassNotFoundException cnfe)
 392       {
 393         errorMessage = cnfe.getMessage();
 394
 395         return false;
 396       } catch (NoSuchMethodException nsme)
 397       {
 398         errorMessage = nsme.getMessage();
 399
 400         return false;
 401       } catch (NoSuchFieldException nsfe)
 402       {
 403         errorMessage = nsfe.getMessage();
 404
 405         return false;
 406       } catch (IllegalAccessException iae)
 407       {
 408         errorMessage = iae.getMessage();
 409
 410         return false;
 411       }
 412
 413       break;
 414
 415     case MRJ_2_1:
 416
 417       try
 418       {
 419         mrjFileUtilsClass = Class.forName("com.apple.mrj.MRJFileUtils");
 420         mrjOSTypeClass = Class.forName("com.apple.mrj.MRJOSType");
 421
 422         Field systemFolderField = mrjFileUtilsClass
 423                 .getDeclaredField("kSystemFolderType");
 424         kSystemFolderType = systemFolderField.get(null);
 425         findFolder = mrjFileUtilsClass.getDeclaredMethod("findFolder",
 426                 new Class[]
 427                 { mrjOSTypeClass });
 428         getFileCreator = mrjFileUtilsClass
 429                 .getDeclaredMethod("getFileCreator", new Class[]
 430                 { File.class });
 431         getFileType = mrjFileUtilsClass.getDeclaredMethod("getFileType",
 432                 new Class[]
 433                 { File.class });
 434       } catch (ClassNotFoundException cnfe)
 435       {
 436         errorMessage = cnfe.getMessage();
 437
 438         return false;
 439       } catch (NoSuchFieldException nsfe)
 440       {
 441         errorMessage = nsfe.getMessage();
 442
 443         return false;
 444       } catch (NoSuchMethodException nsme)
 445       {
 446         errorMessage = nsme.getMessage();
 447
 448         return false;
 449       } catch (SecurityException se)
 450       {
 451         errorMessage = se.getMessage();
 452
 453         return false;
 454       } catch (IllegalAccessException iae)
 455       {
 456         errorMessage = iae.getMessage();
 457
 458         return false;
 459       }
 460
 461       break;
 462
 463     case MRJ_3_0:
 464
 465       try
 466       {
 467         Class linker = Class.forName("com.apple.mrj.jdirect.Linker");
 468         Constructor constructor = linker
 469                 .getConstructor(new Class[]
 470                 { Class.class });
 471         linkage = constructor
 472                 .newInstance(new Object[]
 473                 { BrowserLauncher.class });
 474       } catch (ClassNotFoundException cnfe)
 475       {
 476         errorMessage = cnfe.getMessage();
 477
 478         return false;
 479       } catch (NoSuchMethodException nsme)
 480       {
 481         errorMessage = nsme.getMessage();
 482
 483         return false;
 484       } catch (InvocationTargetException ite)
 485       {
 486         errorMessage = ite.getMessage();
 487
 488         return false;
 489       } catch (InstantiationException ie)
 490       {
 491         errorMessage = ie.getMessage();
 492
 493         return false;
 494       } catch (IllegalAccessException iae)
 495       {
 496         errorMessage = iae.getMessage();
 497
 498         return false;
 499       }
 500
 501       break;
 502
 503     case MRJ_3_1:
 504
 505       try
 506       {
 507         mrjFileUtilsClass = Class.forName("com.apple.mrj.MRJFileUtils");
 508         openURL = mrjFileUtilsClass.getDeclaredMethod("openURL",
 509                 new Class[]
 510                 { String.class });
 511       } catch (ClassNotFoundException cnfe)
 512       {
 513         errorMessage = cnfe.getMessage();
 514
 515         return false;
 516       } catch (NoSuchMethodException nsme)
 517       {
 518         errorMessage = nsme.getMessage();
 519
 520         return false;
 521       }
 522
 523       break;
 524
 525     default:
 526       break;
 527     }
 528
 529     }
 530     return true;
 531   }
 532
 533   /**
 534    * Attempts to locate the default web browser on the local system. s results
 535    * so it only locates the browser once for each use of this class per JVM
 536    * instance.
 537    *
 538    * @return The browser for the system. Note that this may not be what you
 539    *         would consider to be a standard web browser; instead, it's the
 540    *         application that gets called to open the default web browser. In
 541    *         some cases, this will be a non-String object that provides the
 542    *         means of calling the default browser.
 543    */
 544   private static Object locateBrowser()
 545   {
 546     if (!Platform.isJS())
 547     /**
 548      * Java only
 549      *
 550      * @j2sIgnore
 551      *
 552      */
 553     {
 554     if (browser != null)
 555     {
 556       return browser;
 557     }
 558
 559     switch (jvm)
 560     {
 561     case MRJ_2_0:
 562
 563       try
 564       {
 565         Integer finderCreatorCode = (Integer) makeOSType.invoke(null,
 566                 new Object[]
 567                 { FINDER_CREATOR });
 568         Object aeTarget = aeTargetConstructor
 569                 .newInstance(new Object[]
 570                 { finderCreatorCode });
 571         Integer gurlType = (Integer) makeOSType.invoke(null,
 572                 new Object[]
 573                 { GURL_EVENT });
 574         Object appleEvent = appleEventConstructor
 575                 .newInstance(new Object[]
 576                 { gurlType, gurlType, aeTarget, kAutoGenerateReturnID,
 577                     kAnyTransactionID });
 578
 579         // Don't set browser = appleEvent because then the next time we call
 580         // locateBrowser(), we'll get the same AppleEvent, to which we'll
 581         // already have
 582         // added the relevant parameter. Instead, regenerate the AppleEvent
 583         // every time.
 584         // There's probably a way to do this better; if any has any ideas,
 585         // please let
 586         // me know.
 587         return appleEvent;
 588       } catch (IllegalAccessException iae)
 589       {
 590         browser = null;
 591         errorMessage = iae.getMessage();
 592
 593         return browser;
 594       } catch (InstantiationException ie)
 595       {
 596         browser = null;
 597         errorMessage = ie.getMessage();
 598
 599         return browser;
 600       } catch (InvocationTargetException ite)
 601       {
 602         browser = null;
 603         errorMessage = ite.getMessage();
 604
 605         return browser;
 606       }
 607
 608     case MRJ_2_1:
 609
 610       File systemFolder;
 611
 612       try
 613       {
 614         systemFolder = (File) findFolder.invoke(null,
 615                 new Object[]
 616                 { kSystemFolderType });
 617       } catch (IllegalArgumentException iare)
 618       {
 619         browser = null;
 620         errorMessage = iare.getMessage();
 621
 622         return browser;
 623       } catch (IllegalAccessException iae)
 624       {
 625         browser = null;
 626         errorMessage = iae.getMessage();
 627
 628         return browser;
 629       } catch (InvocationTargetException ite)
 630       {
 631         browser = null;
 632         errorMessage = ite.getTargetException().getClass() + ": "
 633                 + ite.getTargetException().getMessage();
 634
 635         return browser;
 636       }
 637
 638       String[] systemFolderFiles = systemFolder.list();
 639
 640       // Avoid a FilenameFilter because that can't be stopped mid-list
 641       for (int i = 0; i < systemFolderFiles.length; i++)
 642       {
 643         try
 644         {
 645           File file = new File(systemFolder, systemFolderFiles[i]);
 646
 647           if (!file.isFile())
 648           {
 649             continue;
 650           }
 651
 652           // We're looking for a file with a creator code of 'MACS' and
 653           // a type of 'FNDR'. Only requiring the type results in non-Finder
 654           // applications being picked up on certain Mac OS 9 systems,
 655           // especially German ones, and sending a GURL event to those
 656           // applications results in a logout under Multiple Users.
 657           Object fileType = getFileType.invoke(null, new Object[] { file });
 658
 659           if (FINDER_TYPE.equals(fileType.toString()))
 660           {
 661             Object fileCreator = getFileCreator.invoke(null,
 662                     new Object[]
 663                     { file });
 664
 665             if (FINDER_CREATOR.equals(fileCreator.toString()))
 666             {
 667               browser = file.toString(); // Actually the Finder, but that's OK
 668
 669               return browser;
 670             }
 671           }
 672         } catch (IllegalArgumentException iare)
 673         {
 674           errorMessage = iare.getMessage();
 675
 676           return null;
 677         } catch (IllegalAccessException iae)
 678         {
 679           browser = null;
 680           errorMessage = iae.getMessage();
 681
 682           return browser;
 683         } catch (InvocationTargetException ite)
 684         {
 685           browser = null;
 686           errorMessage = ite.getTargetException().getClass() + ": "
 687                   + ite.getTargetException().getMessage();
 688
 689           return browser;
 690         }
 691       }
 692
 693       browser = null;
 694
 695       break;
 696
 697     case MRJ_3_0:
 698     case MRJ_3_1:
 699       browser = ""; // Return something non-null
 700
 701       break;
 702
 703     case WINDOWS_NT:
 704       browser = "cmd.exe";
 705
 706       break;
 707
 708     case WINDOWS_9x:
 709       browser = "command.com";
 710
 711       break;
 712
 713     case OTHER:
 714     default:
 715       browser = jalview.bin.Cache.getDefault("DEFAULT_BROWSER", "firefox");
 716
 717       break;
 718     }
 719
 720     }
 721
 722     return browser;
 723
 724   }
 725
 726   /**
 727    * used to ensure that browser is up-to-date after a configuration change
 728    * (Unix DEFAULT_BROWSER property change).
 729    */
 730   public static void resetBrowser()
 731   {
 732     browser = null;
 733   }
 734
 735   /**
 736    * Attempts to open the default web browser to the given URL.
 737    *
 738    * @param url
 739    *          The URL to open
 740    * @throws IOException
 741    *           If the web browser could not be located or does not run
 742    */
 743   public static void openURL(String url) throws IOException
 744   {
 745
 746     if (Platform.isJS())
 747     {
 748       Platform.openURL(url);
 749       return;
 750     }
 751     else
 752     /**
 753      * Java only
 754      *
 755      * @j2sIgnore
 756      */
 757     {
 758
 759     if (!loadedWithoutErrors)
 760     {
 761       throw new IOException(MessageManager
 762               .formatMessage("exception.browser_not_found", new String[]
 763               { errorMessage }));
 764     }
 765
 766     Object browser = locateBrowser();
 767
 768     if (browser == null)
 769     {
 770       throw new IOException(MessageManager.formatMessage(
 771               "exception.browser_unable_to_locate", new String[]
 772               { errorMessage }));
 773     }
 774
 775     switch (jvm)
 776     {
 777     case MRJ_2_0:
 778
 779       Object aeDesc = null;
 780
 781       try
 782       {
 783         aeDesc = aeDescConstructor.newInstance(new Object[] { url });
 784         putParameter.invoke(browser,
 785                 new Object[]
 786                 { keyDirectObject, aeDesc });
 787         sendNoReply.invoke(browser, new Object[] {});
 788       } catch (InvocationTargetException ite)
 789       {
 790         throw new IOException(MessageManager.formatMessage(
 791                 "exception.invocation_target_exception_creating_aedesc",
 792                 new String[]
 793                 { ite.getMessage() }));
 794       } catch (IllegalAccessException iae)
 795       {
 796         throw new IOException(MessageManager.formatMessage(
 797                 "exception.illegal_access_building_apple_evt", new String[]
 798                 { iae.getMessage() }));
 799       } catch (InstantiationException ie)
 800       {
 801         throw new IOException(MessageManager.formatMessage(
 802                 "exception.illegal_access_building_apple_evt", new String[]
 803                 { ie.getMessage() }));
 804       } finally
 805       {
 806         aeDesc = null; // Encourage it to get disposed if it was created
 807         browser = null; // Ditto
 808       }
 809
 810       break;
 811
 812     case MRJ_2_1:
 813       Runtime.getRuntime().exec(new String[] { (String) browser, url });
 814
 815       break;
 816
 817     case MRJ_3_0:
 818
 819       int[] instance = new int[1];
 820       int result = ICStart(instance, 0);
 821
 822       if (result == 0)
 823       {
 824         int[] selectionStart = new int[] { 0 };
 825         byte[] urlBytes = url.getBytes();
 826         int[] selectionEnd = new int[] { urlBytes.length };
 827         result = ICLaunchURL(instance[0], new byte[] { 0 }, urlBytes,
 828                 urlBytes.length, selectionStart, selectionEnd);
 829
 830         if (result == 0)
 831         {
 832           // Ignore the return value; the URL was launched successfully
 833           // regardless of what happens here.
 834           ICStop(instance);
 835         }
 836         else
 837         {
 838           throw new IOException(MessageManager.formatMessage(
 839                   "exception.unable_to_launch_url", new String[]
 840                   { Integer.valueOf(result).toString() }));
 841         }
 842       }
 843       else
 844       {
 845         throw new IOException(MessageManager.formatMessage(
 846                 "exception.unable_to_create_internet_config", new String[]
 847                 { Integer.valueOf(result).toString() }));
 848       }
 849
 850       break;
 851
 852     case MRJ_3_1:
 853
 854       try
 855       {
 856         openURL.invoke(null, new Object[] { url });
 857       } catch (InvocationTargetException ite)
 858       {
 859         throw new IOException(MessageManager.formatMessage(
 860                 "exception.invocation_target_calling_url", new String[]
 861                 { ite.getMessage() }));
 862       } catch (IllegalAccessException iae)
 863       {
 864         throw new IOException(MessageManager.formatMessage(
 865                 "exception.illegal_access_calling_url", new String[]
 866                 { iae.getMessage() }));
 867       }
 868
 869       break;
 870
 871     case WINDOWS_NT:
 872     case WINDOWS_9x:
 873
 874       // Add quotes around the URL to allow ampersands and other special
 875       // characters to work.
 876       Process process = Runtime.getRuntime()
 877               .exec(new String[]
 878               { (String) browser, FIRST_WINDOWS_PARAMETER,
 879                   SECOND_WINDOWS_PARAMETER, THIRD_WINDOWS_PARAMETER,
 880                   '"' + url + '"' });
 881
 882       // This avoids a memory leak on some versions of Java on Windows.
 883       // That's hinted at in
 884       // <http://developer.java.sun.com/developer/qow/archive/68/>.
 885       try
 886       {
 887         process.waitFor();
 888         process.exitValue();
 889       } catch (InterruptedException ie)
 890       {
 891         throw new IOException(MessageManager.formatMessage(
 892                 "exception.interrupted_launching_browser", new String[]
 893                 { ie.getMessage() }));
 894       }
 895
 896       break;
 897
 898     case OTHER:
 899
 900       // Assume that we're on Unix and that Netscape (actually Firefox) is
 901       // installed
 902       // First, attempt to open the URL in a currently running session of
 903       // Netscape
 904       // JBPNote log debug
 905
 906       /*
 907        * System.out.println("Executing : "+browser+" "+
 908        * NETSCAPE_REMOTE_PARAMETER+" "+ NETSCAPE_OPEN_PARAMETER_START + url +
 909        * NETSCAPE_OPEN_NEW_WINDOW + NETSCAPE_OPEN_PARAMETER_END);
 910        */
 911       process = Runtime.getRuntime()
 912               .exec(new String[]
 913               { (String) browser, NETSCAPE_REMOTE_PARAMETER,
 914
 915                   NETSCAPE_OPEN_PARAMETER_START + url
 916                           + NETSCAPE_OPEN_NEW_WINDOW
 917                           + NETSCAPE_OPEN_PARAMETER_END });
 918
 919       try
 920       {
 921         int exitCode = process.waitFor();
 922
 923         if (exitCode != 0)
 924         { // if Netscape was not open
 925           Runtime.getRuntime().exec(new String[] { (String) browser, url });
 926         }
 927       } catch (InterruptedException ie)
 928       {
 929         throw new IOException(MessageManager.formatMessage(
 930                 "exception.interrupted_launching_browser", new String[]
 931                 { ie.getMessage() }));
 932       }
 933
 934       break;
 935
 936     default:
 937
 938       // This should never occur, but if it does, we'll try the simplest thing
 939       // possible
 940       Runtime.getRuntime().exec(new String[] { (String) browser, url });
 941
 942       break;
 943     }
 944     }
 945   }
 946
 947
 948   /**
 949    * Methods required for Mac OS X. The presence of native methods does not
 950    * cause any problems on other platforms.
 951    */
 952   private native static int ICStart(int[] instance, int signature);
 953
 954   private native static int ICStop(int[] instance);
 955
 956   private native static int ICLaunchURL(int instance, byte[] hint,
 957           byte[] data, int len, int[] selectionStart, int[] selectionEnd);
 958 }