ij.plugin.BrowserLauncher Maven / Gradle / Ivy
Show all versions of ij Show documentation
package ij.plugin;
import ij.IJ;
import java.io.File;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.lang.reflect.Constructor;
import java.lang.reflect.Field;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import java.net.URL;
import java.net.URLClassLoader;
/**
* This plugin implements the File/Import/URL command and the commands in the Help menu that
* open web pages. It is based on Eric Albert's cross-platform (Windows, Mac OS X and Unix)
* BrowserLauncher class.
*
* BrowserLauncher is a class that provides one static method, openURL, which opens the default
* web browser for the current user of the system to the given URL. It may support other
* protocols depending on the system -- mailto, ftp, etc. -- but that has not been rigorously
* tested and is not guaranteed to work.
*
* Yes, this is platform-specific code, and yes, it may rely on classes on certain platforms
* that are not part of the standard JDK. What we're trying to do, though, is to take something
* that's frequently desirable but inherently platform-specific -- opening a default browser --
* and allow programmers (you, for example) to do so without worrying about dropping into native
* code or doing anything else similarly evil.
*
* Anyway, this code is completely in Java and will run on all JDK 1.1-compliant systems without
* modification or a need for additional libraries. All classes that are required on certain
* platforms to allow this to run are dynamically loaded at runtime via reflection and, if not
* found, will not cause this to do anything other than returning an error when opening the
* browser.
*
* This code is Copyright 1999-2001 by Eric Albert ([email protected]) and may be
* redistributed or modified in any form without restrictions as long as the portion of this
* comment from this paragraph through the end of the comment is not removed. The author
* requests that he be notified of any application, applet, or other binary that makes use of
* this code, but that's more out of curiosity than anything and is not required. This software
* includes no warranty. The author is not repsonsible for any loss of data or functionality
* or any adverse or unexpected effects of using this software.
*
* Credits:
*
Steven Spencer, JavaWorld magazine (Java Tip 66)
*
Thanks also to Ron B. Yeh, Eric Shapiro, Ben Engber, Paul Teitlebaum, Andrea Cantatore,
* Larry Barowski, Trevor Bedzek, Frank Miedrich, and Ron Rabakukk
*
* @author Eric Albert ([email protected])
* @version 1.4b1 (Released June 20, 2001)
*/
public class BrowserLauncher implements PlugIn {
/** The com.apple.mrj.MRJFileUtils class */
private static Class mrjFileUtilsClass;
/** The openURL method of com.apple.mrj.MRJFileUtils */
private static Method openURL;
private static boolean error;
/** Opens the specified URL (default is the ImageJ home page). */
public void run(String theURL) {
if (error) return;
if (theURL==null || theURL.equals(""))
theURL = IJ.URL;
try {openURL(theURL);}
catch (IOException e) {}
}
/**
* Attempts to open the default web browser to the given URL.
* @param url The URL to open
* @throws IOException If the web browser could not be located or does not run
*/
public static void openURL(String url) throws IOException {
String errorMessage = "";
if (IJ.isMacOSX())
IJ.runMacro("exec('open', getArgument())",url);
else if (IJ.isWindows()) {
String cmd = "rundll32 url.dll,FileProtocolHandler " + url;
if (System.getProperty("os.name").startsWith("Windows 2000"))
cmd = "rundll32 shell32.dll,ShellExec_RunDLL " + url;
Process process = Runtime.getRuntime().exec(cmd);
// This avoids a memory leak on some versions of Java on Windows.
// That's hinted at in