imagej.patcher.LegacyHooks Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of ij1-patcher Show documentation
Show all versions of ij1-patcher Show documentation
A runtime patcher to introduce extension points into the original ImageJ (1.x). This project offers extension points for use with ImageJ2 and it also offers limited support for headless operations.
/*
* #%L
* ImageJ software for multidimensional image processing and analysis.
* %%
* Copyright (C) 2009 - 2016 Board of Regents of the University of
* Wisconsin-Madison, Broad Institute of MIT and Harvard, and Max Planck
* Institute of Molecular Cell Biology and Genetics.
* %%
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* 1. Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
* #L%
*/
package imagej.patcher;
import java.io.ByteArrayInputStream;
import java.io.File;
import java.io.InputStream;
import java.net.URL;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collection;
import java.util.Collections;
import java.util.Comparator;
import java.util.LinkedHashMap;
import java.util.LinkedHashSet;
import java.util.List;
import java.util.Map;
import java.util.regex.Pattern;
/**
* Extension points for ImageJ 1.x.
*
* These extension points will be patched into ImageJ 1.x by the
* {@link CodeHacker}. To override the behavior of ImageJ 1.x, a new instance of
* this interface needs to be installed into ij.IJ._hooks.
*
*
* The essential functionality of the hooks is provided in the
* {@link EssentialLegacyHooks} class, which makes an excellent base class for
* project-specific implementations.
*
*
* @author Johannes Schindelin
*/
@Deprecated
public abstract class LegacyHooks {
/**
* Determines whether the image windows should be displayed or not.
*
* @return false if ImageJ 1.x should be prevented from opening image windows.
*/
public boolean isLegacyMode() {
return true;
}
/**
* Return the current context, if any.
*
* For ImageJ2-specific hooks, the returned object will be the current SciJava
* context, or null if the context is not yet initialized.
*
*
* @return the context, or null
*/
public Object getContext() {
return null;
}
/**
* Disposes and prepares for quitting.
*
* @return whether ImageJ 1.x should be allowed to call System.exit()
*/
public boolean quit() {
return true;
}
/**
* Runs when the hooks are installed into an existing legacy environment.
*/
public void installed() {
// ignore
}
/**
* Disposes of the hooks.
*
* This method is called when ImageJ 1.x is quitting or when new hooks are
* installed.
*
*/
public void dispose() {
// ignore
}
/**
* Intercepts the call to {@link ij.IJ#runPlugIn(String, String)}.
*
* @param className the class name
* @param arg the argument passed to the {@code runPlugIn} method
* @return the object to return, or null to let ImageJ 1.x handle the call
*/
public Object interceptRunPlugIn(final String className, final String arg) {
return null;
}
/**
* Updates the progress bar, where 0 <= progress <= 1.0.
*
* @param progress between 0.0 and 1.0
*/
public void showProgress(final double progress) {}
/**
* Updates the progress bar, where the length of the bar is set to (
* currentValue + 1) / finalValue of the maximum bar length. The
* bar is erased if currentValue >= finalValue.
*
* @param currentIndex the step that was just started
* @param finalIndex the final step.
*/
public void showProgress(final int currentIndex, final int finalIndex) {}
/**
* Shows a status message.
*
* @param status the message
*/
public void showStatus(final String status) {}
/**
* Logs a message.
*
* @param message the message
*/
public void log(final String message) {}
/**
* Registers an image (possibly not seen before).
*
* @param image the new image
*/
public void registerImage(final Object image) {}
/**
* Releases an image.
*
* @param image the image
*/
public void unregisterImage(final Object image) {}
/**
* Logs a debug message (to be shown only in debug mode).
*
* @param string the debug message
*/
public void debug(final String string) {
System.err.println(string);
}
/**
* Shows an exception.
*
* @param t the exception
*/
public void error(final Throwable t) {
// ignore
}
/**
* Returns the name to use in place of "ImageJ".
*
* @return the application name
*/
public String getAppName() {
return "ImageJ";
}
/**
* Returns the icon to use in place of the ImageJ microscope.
*
* @return the URL to the icon to use, or null
*/
public URL getIconURL() {
return null;
}
/**
* Extension point to override ImageJ 1.x' editor.
*
* @param path the path to the file to open
* @return true if the hook opened a different editor
*/
public boolean openInEditor(final String path) {
return false;
}
/**
* Extension point to override ImageJ 1.x' editor.
*
* @param fileName the name of the new file
* @param content the initial content
* @return true if the hook opened a different editor
*/
public boolean createInEditor(final String fileName, final String content) {
return false;
}
private boolean enableIJ1PluginDirs = true;
protected void enableIJ1PluginDirs(final boolean enable) {
enableIJ1PluginDirs = enable;
}
final private Collection pluginClasspath = new LinkedHashSet();
protected void addPluginClasspath(final File file) {
pluginClasspath.add(file);
}
/**
* Extension point to add to ImageJ 1.x' PluginClassLoader's class path.
*
* @return a list of class path elements to add
*/
public List handleExtraPluginJars() {
final List result = new ArrayList();
result.addAll(pluginClasspath);
if (!enableIJ1PluginDirs) return result;
final String extraPluginDirs = System.getProperty("ij1.plugin.dirs");
if (extraPluginDirs != null) {
for (final String dir : extraPluginDirs.split(File.pathSeparator)) {
final File directory = new File(dir);
if (directory.isDirectory()) {
result.add(directory);
handleExtraPluginJars(directory, result);
}
}
return result;
}
final String userHome = System.getProperty("user.home");
if (userHome != null) {
final File dir = new File(userHome, ".plugins");
if (dir.isDirectory()) {
result.add(dir);
handleExtraPluginJars(dir, result);
}
}
return result;
}
private void handleExtraPluginJars(final File directory,
final List result)
{
final File[] list = directory.listFiles();
if (list == null) return;
for (final File file : list) {
if (file.isDirectory()) handleExtraPluginJars(file, result);
else if (file.isFile() && file.getName().endsWith(".jar")) {
result.add(file);
}
}
}
/**
* Extension point to run after Help>Refresh Menus
*/
public void runAfterRefreshMenus() {
// ignore
}
/**
* Extension point to enhance ImageJ 1.x' error reporting upon
* {@link NoSuchMethodError}.
*
* @param e the exception to handle
* @return true if the error was handled by the legacy hook
*/
public boolean handleNoSuchMethodError(final NoSuchMethodError e) {
return false; // not handled
}
/**
* Extension point to run after a new PluginClassLoader was initialized.
*
* @param loader the PluginClassLoader instance
*/
public void newPluginClassLoader(final ClassLoader loader) {
// do nothing
}
/**
* Extension point to modify the order in which .jar files are added to the
* PluginClassLoader.
*
* There is a problem which only strikes large distributions of ImageJ such as
* Fiji: some .jar files try to be helpful and bundle classes which are
* actually not theirs, causing problems when newer versions of those .jar
* files which they shadow are present in the plugins/ or jars/
* directory but are not respected by the class loader.
*
*
* The default hook of this extension point therefore hard-codes a few file
* names of known offenders (which we politely will call fat .jar files
* normally) and just pushes them back to the end of the list.
*
*
* @param directory the directory which ImageJ 1.x looked at
* @param names the list of file names in the order ImageJ 1.x discovered them
* @return the ordered, filtered and/or augmented list
*/
public String[]
addPluginDirectory(final File directory, final String[] names)
{
if (names != null) {
final Pattern pattern =
Pattern.compile("(batik|jython|jruby)(-[0-9].*)?\\.jar");
Arrays.sort(names, new FatJarNameComparator(pattern));
}
return names;
}
public final static class FatJarNameComparator implements Comparator {
private final Pattern pattern;
private FatJarNameComparator(Pattern pattern) {
this.pattern = pattern;
}
@Override
public int compare(final String a, final String b) {
return (pattern.matcher(a).matches() ? 1 : 0) -
(pattern.matcher(b).matches() ? 1 : 0);
}
}
/**
* First extension point to run just after ImageJ 1.x spun up.
*/
public void initialized() {
// do nothing by default
}
public InputStream autoGenerateConfigFile(final File directory) {
// skip unpacked ImageJ 1.x
if (new File(directory, "IJ_Props.txt").exists()) return null;
return new ByteArrayInputStream(autoGenerateConfigFile(directory,
directory, "Plugins", "", new StringBuilder()).toString().getBytes());
}
protected StringBuilder autoGenerateConfigFile(final File topLevelDirectory,
final File directory, final String menuPath, final String packageName,
final StringBuilder builder)
{
final File[] list = directory.listFiles();
if (list == null) return builder;
// make order consistent
Arrays.sort(list);
for (final File file : list) {
String name = file.getName();
if (name.startsWith("_")) continue;
if (file.isDirectory()) {
autoGenerateConfigFile(topLevelDirectory, file, menuPath + ">" +
name.replace('_', ' '), packageName + name + ".", builder);
}
else if (name.endsWith(".class") && name.contains("_") &&
!name.contains("$"))
{
if (topLevelDirectory == directory &&
Character.isLowerCase(name.charAt(0))) continue;
final String className = packageName + name.substring(0, name.length() - 6);
name = name.substring(0, name.length() - 6).replace('_', ' ');
builder.append(menuPath + ", \"" + name + "\", " + className + "\n");
}
}
return builder;
}
private Map menuStructure = new LinkedHashMap();
/**
* Callback for ImageJ 1.x' menu parsing machinery.
*
* This method is called whenever ImageJ 1.x adds a command to the menu structure.
*
*
* @param menuPath the menu path of the menu item, or null when reinitializing
* @param command the command associated with the menu item, or null when reinitializing
*/
public void addMenuItem(final String menuPath, final String command) {
if (menuPath == null) {
menuStructure.clear();
}
else if (menuPath.endsWith(">-")) {
int i = 1;
while (menuStructure.containsKey(menuPath + i)) {
i++;
}
menuStructure.put(menuPath + i, command);
}
else {
menuStructure.put(menuPath, command);
}
}
/**
* Returns ImageJ 1.x' menu structure as a map.
*
* @return the menu structure
*/
public Map getMenuStructure() {
return Collections.unmodifiableMap(menuStructure);
}
/**
* Optionally override opening resources via legacy hooks.
*
* This is intended as a "HandleExtraFileTypesPlus".
*
*
* @param path the path to the resource to open, or {@code null} if a dialog
* needs to be shown
* @param planeIndex
* If applicable - the index of plane to open or -1 for all planes
* @param display
* if true, the opened object should be displayed before returning
* @return The opened object, or {@code null} to let ImageJ 1.x open the path.
*/
public Object interceptOpen(final String path, final int planeIndex,
final boolean display) {
return null;
}
}