Here is a simple "Hello World" example as a Cytoscape plugin where a Java Swing utility class is used to display the message in a dialog window.
1 package helloworld;
2
3 import java.awt.event.ActionEvent;
4 import javax.swing.JOptionPane;
5 import cytoscape.Cytoscape;
6 import cytoscape.plugin.CytoscapePlugin;
7 import cytoscape.util.CytoscapeAction;
8
9
10 /**
11 * A menu item "Hello World" will appear at Plugins menu. Click on the menu
12 * item, a message dialog will show up.
13 */
14 public class HelloWorldPlugin extends CytoscapePlugin {
15
16 public HelloWorldPlugin() {
17 MyPluginMenuAction menuAction = new MyPluginMenuAction(this);
18 Cytoscape.getDesktop().getCyMenus().addCytoscapeAction((CytoscapeAction) menuAction);
19 }
20
21 public class MyPluginMenuAction extends CytoscapeAction {
22
23 public MyPluginMenuAction(HelloWorldPlugin myPlugin) {
24 super("Hello World");
25 setPreferredMenu("Plugins");
26 }
27
28 public void actionPerformed(ActionEvent e) {
29 JOptionPane.showMessageDialog(Cytoscape.getDesktop(),"Hello World is selected!");
30 }
31 }
32 }
33
Looking at the Plugin
Imports:
1 import cytoscape.plugin.CytoscapePlugin;
2 import cytoscape.Cytoscape;
3
All plugins must extend the class cytoscape.plugin.CytoscapePlugin. The specific class that extends CytoscapePlugin doesn't need to stand alone; it can reference any number of other classes and libraries. This "main" class is simply Cytoscape's entry point to your code.
The static class cytoscape.Cytoscape provides access the data objects and utilities of the Cytoscape core. Here, the plugin gets a reference to a window created by Cytoscape for a parent of a new dialog window.
Methods:
1 public HelloWorldPlugin ()
2
- All plugins must have a default constructor (that is, a constructor with no arguments). Cytoscape will call this constructor to create an instance of your plugin class.
To load this plugin into Cytoscape, save the jar file at the above link to your local disk in the Cytoscape plugins folder. Then start Cytoscape which will then load the plugin from the jar. You should see the "Hello World" dialog appear above your main Cytoscape window.