Logo Search packages:      
Sourcecode: cdk version File versions  Download package

CDKPluginManager.java

/* $RCSfile$
 * $Author: egonw $
 * $Date: 2007-01-04 18:26:00 +0100 (Thu, 04 Jan 2007) $
 * $Revision: 7634 $
 *
 * Copyright (C) 2003-2007  The Chemistry Development Kit (CDK) project
 *
 * Contact: cdk-devel@lists.sourceforge.net
 *
 *  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, 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 
 */
package org.openscience.cdk.applications.plugin;

import org.openscience.cdk.applications.APIVersionTester;
import org.openscience.cdk.event.ChemObjectChangeEvent;
import org.openscience.cdk.tools.LoggingTool;

import javax.swing.*;
import java.awt.event.ActionEvent;
import java.io.File;
import java.io.IOException;
import java.net.URL;
import java.util.Enumeration;
import java.util.Hashtable;
import java.util.jar.JarEntry;
import java.util.jar.JarFile;

/**
 * Manager that loads and maintains CDK plugins. In addition, it provides a JMenu 
 * to allow access to the plugin's functionality.
 *
 * <p>Plugins can be loaded by name, but by default it will download the plugins
 * in the <code>pluginDirName</code> directory passed as argument to the
 * constructor. The jars in this directory are browsed, and the first class
 * it encounters which name ends in Plugin will be loaded as plugin.
 *
 * @cdk.module applications
 * @cdk.require swing
 */
00052 public class CDKPluginManager {

    private LoggingTool logger;
    private Hashtable cdkPlugins;
    
    private String pluginConfigDirName;
    private ICDKEditBus editBus;
    
    private ClassLoader parentClassLoader=null;
    
    /**
     * Instantiate a CDKPluginManager.
     *
     * @param pluginDirName       directory where the plugin jars can be found
     * @param pluginConfigDirName directory where the plugin config files can be found
     * @param editBus             object implementing the CDKEditBus interface
     *
     * @see   org.openscience.cdk.applications.plugin.ICDKEditBus
     */
00071     public CDKPluginManager(String pluginDirName, String pluginConfigDirName,
                            ICDKEditBus editBus) {
        this(pluginConfigDirName, editBus);
        loadPlugins(pluginDirName);
    }
    public CDKPluginManager(String pluginConfigDirName, ICDKEditBus editBus) {
        this.logger = new LoggingTool(this);
        this.editBus = editBus;
        this.pluginConfigDirName = pluginConfigDirName;
        this.cdkPlugins = new Hashtable();
    }
    
    /**
     * Returns a JMenu with submenus for each loaded plugin.
     */
00086     public JMenu getMenu() {
        JMenu menu = new JMenu("Plugins");
        Enumeration pluginsEnum = cdkPlugins.elements();
        while (pluginsEnum.hasMoreElements()) {
            ICDKPlugin plugin = (ICDKPlugin)pluginsEnum.nextElement();
            JMenu pluginMenu = new JMenu(plugin.getName());
            
            // add default items
            boolean hasOneOrMoreDefaultMenuItems = false;
            JPanel pluginPanel = plugin.getPluginPanel();
            if (pluginPanel != null) {
                // add action that fires up a window
                JMenuItem windowMenu = new JMenuItem("Plugin Window");
                windowMenu.addActionListener(
                    new PluginDialogAction(plugin)
                );
                pluginMenu.add(windowMenu);
                hasOneOrMoreDefaultMenuItems = true;
            }
            JPanel configPanel = plugin.getPluginConfigPanel();
            if (configPanel != null) {
                // add action that fires up a window
                pluginMenu.add(new JMenuItem("Config Window"));
                hasOneOrMoreDefaultMenuItems = true;
            }
            
            // try to plugin's private menu
            JMenu customPluginMenu = plugin.getMenu();
            if (customPluginMenu != null) {
                if (hasOneOrMoreDefaultMenuItems) {
                    pluginMenu.addSeparator();
                };
                if (customPluginMenu.getText().length() == 0) {
                    customPluginMenu.setText("Plugin's menu");
                }
                pluginMenu.add(customPluginMenu);
            }

            // add menu with plugin info
            pluginMenu.addSeparator();
            JMenu aboutMenu = new JMenu("About");
            JMenuItem versionMenuItem = new JMenuItem("v. " + plugin.getPluginVersion());
            versionMenuItem.setEnabled(false);
            aboutMenu.add(versionMenuItem);
            if (APIVersionTester.isBiggerOrEqual("1.10", plugin.getAPIVersion())) {
                JMenuItem licenseMenuItem = new JMenuItem("license: " + plugin.getPluginLicense());
                versionMenuItem.setEnabled(false);
                aboutMenu.add(licenseMenuItem);
            }
            pluginMenu.add(aboutMenu);

            menu.add(pluginMenu);
        }
        return menu;
    }
    
    /** 
     * Load a plugin based on it's class name.
     *
     * @param className Class name of the class constituting the plugin main class.
     */
00147     public void loadPlugin(String className) {
        loadPlugin(this.getClass().getClassLoader(), className);
    }
     
    public void loadPlugin(ClassLoader classLoader, String className) {
        try {
            Class c = classLoader.loadClass(className);
            Object plugin = c.newInstance();
            if (plugin instanceof ICDKPlugin) {
                ICDKPlugin cdkPlugin = (ICDKPlugin)plugin;
                if (APIVersionTester.isSmaller("1.4", cdkPlugin.getAPIVersion())) {
                    // ignore old plugins
                    logger.warn("Will not load plugins with old API: ", className);
                    logger.debug("  the plugin has API version: ", cdkPlugin.getAPIVersion());
                } else {
                    boolean loadPlugin = false;
                    if (cdkPlugins.containsKey(className)) {
                        // deal with already loaded plugins
                        ICDKPlugin alreadyLoadedPlugin = (ICDKPlugin)cdkPlugins.get(className);
                        /* ok, here's the deal: the plugin with the latest version stays */
                        if (Double.parseDouble(alreadyLoadedPlugin.getPluginVersion()) <=
                            Double.parseDouble(cdkPlugin.getPluginVersion())) {
                            loadPlugin = true;
                        } // already loaded plugin is of same version, or better
                    } else {
                        loadPlugin = true;
                    }
                    if (loadPlugin) {
                        // this plugin is not loaded yet, or there is a newer version installed
                        if (APIVersionTester.isBiggerOrEqual("1.5", cdkPlugin.getAPIVersion())) {
                            logger.debug("Setting prop dir in plugin...");
                            cdkPlugin.setPropertyDirectory(pluginConfigDirName);
                        } else {
                            logger.warn("Plugin is too old to set property directory");
                            logger.debug("  the plugin has API version: ", cdkPlugin.getAPIVersion());
                        }
                        cdkPlugin.setEditBus(editBus);
                        cdkPlugins.put(className, cdkPlugin);
                    }
                }
            } else {
                logger.info("Class is not type CDKPluginInterface");
            }
        } catch (ClassNotFoundException exception) {
            logger.error("Could not find class");
            logger.debug(exception);
        } catch (IllegalAccessException exception) {
            logger.error("Don't have access to class");
            logger.debug(exception);
        } catch (InstantiationException exception) {
            logger.error("Could not instantiate object");
            logger.debug(exception);
        } catch (NoSuchMethodError error) {
            logger.warn("Plugin is too old. Download a more recent version.");
            logger.debug(error);
        }
    }
    
    /**
     * Returns an Enumeration of CDK plugins.
     */
00208     public Enumeration getPlugins() {
        return cdkPlugins.elements();
    }
    
    public void closePlugins() {
        Enumeration plugins = getPlugins();
        if (plugins.hasMoreElements()) {
            while (plugins.hasMoreElements()) {
                ICDKPlugin plugin = (ICDKPlugin)plugins.nextElement();
                plugin.stop();
            }
        }
    }

    /**
     * Loads the plugins from a certain directory.
     */
00225     public void loadPlugins(String pluginDirName) {
        File pluginDir = new File(pluginDirName);
        logger.info("User plugin dir: ", pluginDir);
        logger.debug("       exists: ", pluginDir.exists());
        logger.debug("  isDirectory: ", pluginDir.isDirectory());
        if (pluginDir.exists() && pluginDir.isDirectory()) {
            File[] plugins = pluginDir.listFiles();
            for (int i=0; i<plugins.length; i++) {
                // loop over these files and load them
                String pluginJarName = plugins[i].getName();
                if (pluginJarName.endsWith("jar")) {
                    logger.debug("Possible plugin found: ", pluginJarName);
                    try {
                        JarFile jarfile = new JarFile(plugins[i]);
                        Enumeration entries = jarfile.entries();
                        while (entries.hasMoreElements()) {
                            JarEntry entry = (JarEntry)entries.nextElement();
                            if (entry.getName().endsWith("Plugin.class")) {
                                StringBuffer buffer = new StringBuffer(entry.getName());
                                for (int charIndex=0; charIndex<buffer.length(); charIndex++) {
                                    if (buffer.charAt(charIndex) == '/') {
                                        buffer.setCharAt(charIndex, '.');
                                    }
                                }
                                String pluginName = buffer.toString().substring(0, buffer.toString().indexOf(".class"));
                                logger.info("Plugin class found: ", pluginName);

                                // FIXME: use a classloader that loads the whole jar
                                logger.debug("Plugin URL: ", plugins[i].toURL());
                                URL u = new URL("jar", "", plugins[i].toURL() + "!/");
                                ClassLoader loader = new PluginClassLoader(u);
                                if(parentClassLoader!=null)
                                    loader = new PluginClassLoader(u,parentClassLoader);
                                try {
                                    loadPlugin(loader, pluginName);
                                    logger.info("  loaded.");
                                    break;
                                } catch (Throwable exception) {
                                    logger.error("  could not load Plugin.class (continuing search): ", exception.getMessage());
                                    logger.debug(exception);
                                }
                            }
                        }
                    } catch (IOException exception) {
                        logger.error("Could not load plugin jar file: ");
                        logger.debug(exception);
                    }
                }
            }
        }
    }
    
    /**
     * Signal the plugins that the ChemModel/ChemFile has changed.
     */
00280       public void stateChanged(ChemObjectChangeEvent sourceEvent) {
        // send event to plugins
        Enumeration plugins = getPlugins();
        if (plugins.hasMoreElements()) {
            while (plugins.hasMoreElements()) {
                ICDKPlugin plugin = (ICDKPlugin)plugins.nextElement();
                if (APIVersionTester.isBiggerOrEqual("1.6", plugin.getAPIVersion())) {
                    try {
                        plugin.stateChanged(sourceEvent);
                    } catch (Throwable exception) {
                        logger.warn("Exception thrown in plugin. Ignore, but user is invited to report the problem:");
                        logger.warn("  ", exception.getMessage());
                        logger.debug(exception);
                    }
                } else {
                    logger.debug("Plugin API ", plugin.getAPIVersion() , " is not bigger than 1.6.",
                        "Not sending it the change event: ", plugin.getName());
                }
            }
        }
      }

    /**
     * Action that creates a dialog with the content defined by the plugin for
     * which the dialog is created.
     */
00306     class PluginDialogAction extends AbstractAction {
        
            private static final long serialVersionUID = -2699051675412699258L;
            
            private ICDKPlugin plugin;
        
        public PluginDialogAction(ICDKPlugin plugin) {
            super("PluginDialog");
            this.plugin = plugin;
        }
        
        public void actionPerformed(ActionEvent e) {
            JPanel pluginPanel = plugin.getPluginPanel();
            plugin.start();
            if (pluginPanel != null) {
                JDialog pluginWindow = new JDialog();
                pluginWindow.setTitle(plugin.getName());
                pluginWindow.getContentPane().add(pluginPanel);
                pluginWindow.setJMenuBar(getMenuBar());
                pluginWindow.pack();
                pluginWindow.setVisible(true);
            }
        }
        
        private JMenuBar getMenuBar() {
            JMenuBar menuBar = new JMenuBar();

            // try to plugin's private menu
            JMenu customPluginMenu = plugin.getMenu();
            if (customPluginMenu != null) {
                if (customPluginMenu.getText().length() == 0) {
                    customPluginMenu.setText("Menu");
                }
                menuBar.add(customPluginMenu);
            }
                
            // add menu with plugin info
            JMenu aboutMenu = new JMenu("About");
            JMenuItem versionMenuItem = new JMenuItem("v. " + plugin.getPluginVersion());
            versionMenuItem.setEnabled(false);
            aboutMenu.add(versionMenuItem);
            menuBar.add(aboutMenu);
            
            return menuBar;
        }
        
    }

      public void setParentClassLoader(ClassLoader parentClassLoader) {
            this.parentClassLoader = parentClassLoader;
      }
    
}


Generated by  Doxygen 1.6.0   Back to index