Interface Tool

src/org/opensourcephysics/tools/Tool.java:26–74

This is a Tool interface for osp data transfers via XML. @author Wolfgang Christian and Doug Brown @version 0.1

 * @version 0.1
 */
public interface Tool {
	/**
	 * Sends a job to this tool and specifies a tool to reply to.
	 *
	 * @param job     the Job
	 * @param replyTo the tool to notify when the job is complete (may be null)
	 */
	public void send(Job job, Tool replyTo);

	/**
	 * 
	 * @param item
	 * @param data 
	 * @param replyTo
	 * @param andDisplay
	 * @param toolClass
	 */
	static boolean setSendAction(JMenuItem item, String toolName, Object data, Tool replyTo, boolean andDisplay) {
		try {
			Class<?> toolClass = Class.forName("org.opensourcephysics.tools." + toolName); //$NON-NLS-1$
			item.addActionListener((e) -> {
				try {
					Method m = toolClass.getMethod("getTool", (Class[]) null); //$NON-NLS-1$
					Tool tool = (Tool) m.invoke(null, (Object[]) null);
					tool.send(new LocalJob(data), replyTo);
					if (andDisplay) {
						if (tool instanceof OSPFrame) {
							((OSPFrame) tool).setKeepHidden(false);
						}
						((JFrame) tool).setVisible(true);
					}
				} catch (Exception ex) {
					ex.printStackTrace();
				}
			});
			return true;
		} catch (Exception ex) {
			ex.printStackTrace();
			OSPLog.finest("Cannot instantiate " + toolName + ":\n" + ex.getMessage()); //$NON-NLS-1$
			return false;
		}
	}

	public static void reply(Tool replyTo, Job job, Tool from, Data reply) {
		job.setXML(new XMLControlElement(reply).toXML());
		replyTo.send(job, from);
	}

}

/*
 * Open Source Physics software is free software; you can redistribute it and/or