/*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program 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 General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
/*
* MetaBean.java
* Copyright (C) 2005 University of Waikato, Hamilton, New Zealand
*
*/
package weka.gui.beans;
import weka.gui.Logger;
import java.awt.BorderLayout;
import java.awt.Dimension;
import java.awt.Point;
import java.awt.event.MouseAdapter;
import java.awt.event.MouseEvent;
import java.awt.image.BufferedImage;
import java.beans.EventSetDescriptor;
import java.beans.IntrospectionException;
import java.beans.Introspector;
import java.beans.PropertyChangeListener;
import java.io.Serializable;
import java.util.Enumeration;
import java.util.Vector;
import javax.swing.ImageIcon;
import javax.swing.JComponent;
import javax.swing.JLabel;
import javax.swing.JPanel;
import javax.swing.JWindow;
/**
* A meta bean that encapsulates several other regular beans, useful for
* grouping large KnowledgeFlows.
*
*
* @author Mark Hall (mhall at cs dot waikato dot ac dot nz)
* @version $Revision: 6014 $
*/
public class MetaBean
extends JPanel
implements BeanCommon, Visible, EventConstraints,
Serializable, UserRequestAcceptor {
/** for serialization */
private static final long serialVersionUID = -6582768902038027077L;
protected BeanVisual m_visual =
new BeanVisual("Group",
BeanVisual.ICON_PATH+"DiamondPlain.gif",
BeanVisual.ICON_PATH+"DiamondPlain.gif");
private transient Logger m_log = null;
private transient JWindow m_previewWindow = null;
private transient javax.swing.Timer m_previewTimer = null;
protected Vector m_subFlow = new Vector();
protected Vector m_inputs = new Vector();
protected Vector m_outputs = new Vector();
// the internal connections for the grouping
protected Vector m_associatedConnections = new Vector();
// Holds a preview image of the encapsulated sub-flow
protected ImageIcon m_subFlowPreview = null;
public MetaBean() {
setLayout(new BorderLayout());
add(m_visual, BorderLayout.CENTER);
}
/**
* Set a custom (descriptive) name for this bean
*
* @param name the name to use
*/
public void setCustomName(String name) {
m_visual.setText(name);
}
/**
* Get the custom (descriptive) name for this bean (if one has been set)
*
* @return the custom name (or the default name)
*/
public String getCustomName() {
return m_visual.getText();
}
public void setAssociatedConnections(Vector ac) {
m_associatedConnections = ac;
}
public Vector getAssociatedConnections() {
return m_associatedConnections;
}
public void setSubFlow(Vector sub) {
m_subFlow = sub;
}
public Vector getSubFlow() {
return m_subFlow;
}
public void setInputs(Vector inputs) {
m_inputs = inputs;
}
public Vector getInputs() {
return m_inputs;
}
public void setOutputs(Vector outputs) {
m_outputs = outputs;
}
public Vector getOutputs() {
return m_outputs;
}
private Vector getBeans(Vector beans, int type) {
Vector comps = new Vector();
for (int i = 0; i < beans.size(); i++) {
BeanInstance temp = (BeanInstance)beans.elementAt(i);
// need to check for sub MetaBean!
if (temp.getBean() instanceof MetaBean) {
switch (type) {
case 0 :
comps.addAll(((MetaBean)temp.getBean()).getBeansInSubFlow());
break;
case 1 :
comps.addAll(((MetaBean)temp.getBean()).getBeansInInputs());
break;
case 2:
comps.addAll(((MetaBean)temp.getBean()).getBeansInOutputs());
break;
}
} else {
comps.add(temp);
}
}
return comps;
}
private boolean beanSetContains(Vector set, BeanInstance toCheck) {
boolean ok = false;
for (int i = 0; i < set.size(); i++) {
BeanInstance temp = (BeanInstance)set.elementAt(i);
if (toCheck == temp) {
ok = true;
break;
}
}
return ok;
}
public boolean subFlowContains(BeanInstance toCheck) {
return beanSetContains(m_subFlow, toCheck);
}
public boolean inputsContains(BeanInstance toCheck) {
return beanSetContains(m_inputs, toCheck);
}
public boolean outputsContains(BeanInstance toCheck) {
return beanSetContains(m_outputs, toCheck);
}
/**
* Return all the beans in the sub flow
*
* @return a Vector of all the beans in the sub flow
*/
public Vector getBeansInSubFlow() {
return getBeans(m_subFlow, 0);
}
/**
* Return all the beans in the inputs
*
* @return a Vector of all the beans in the inputs
*/
public Vector getBeansInInputs() {
return getBeans(m_inputs, 1);
}
/**
* Return all the beans in the outputs
*
* @return a Vector of all the beans in the outputs
*/
public Vector getBeansInOutputs() {
return getBeans(m_outputs, 2);
}
private Vector getBeanInfos(Vector beans, int type) {
Vector infos = new Vector();
for (int i = 0; i < beans.size(); i++) {
BeanInstance temp = (BeanInstance)beans.elementAt(i);
if (temp.getBean() instanceof MetaBean) {
switch (type) {
case 0:
infos.addAll(((MetaBean)temp.getBean()).getBeanInfoSubFlow());
break;
case 1:
infos.addAll(((MetaBean)temp.getBean()).getBeanInfoInputs());
break;
case 2:
infos.addAll(((MetaBean)temp.getBean()).getBeanInfoOutputs());
}
} else {
try {
infos.add(Introspector.getBeanInfo(temp.getBean().getClass()));
} catch (IntrospectionException ex) {
ex.printStackTrace();
}
}
}
return infos;
}
public Vector getBeanInfoSubFlow() {
return getBeanInfos(m_subFlow, 0);
}
public Vector getBeanInfoInputs() {
return getBeanInfos(m_inputs, 1);
}
public Vector getBeanInfoOutputs() {
return getBeanInfos(m_outputs, 2);
}
// stores the original position of the beans
// when this group is created. Used
// to restore their locations if the group is ungrouped.
private Vector m_originalCoords;
/**
* returns the vector containing the original coordinates (instances of class
* Point) for the inputs
* @return the containing the coord Points of the original inputs
*/
public Vector getOriginalCoords() {
return m_originalCoords;
}
/**
* sets the vector containing the original coordinates (instances of class
* Point) for the inputs
* @param value the vector containing the points of the coords of the original inputs
*/
public void setOriginalCoords(Vector value) {
m_originalCoords = value;
}
/**
* Move coords of all inputs and outputs of this meta bean
* to the coords of the supplied BeanInstance. Typically
* the supplied BeanInstance is the BeanInstance that encapsulates
* this meta bean; the result in this case is that all inputs
* and outputs are shifted so that their coords coincide with
* the meta bean and all connections to them appear (visually) to
* go to/from the meta bean.
*
* @param toShiftTo the BeanInstance whos coordinates will
* be used.
* @param save true if coordinates are to be saved.
*/
public void shiftBeans(BeanInstance toShiftTo,
boolean save) {
if (save) {
m_originalCoords = new Vector();
}
int targetX = toShiftTo.getX();
int targetY = toShiftTo.getY();
for (int i = 0; i < m_subFlow.size(); i++) {
BeanInstance temp = (BeanInstance)m_subFlow.elementAt(i);
if (save) {
Point p = new Point(temp.getX(), temp.getY());
m_originalCoords.add(p);
}
temp.setX(targetX); temp.setY(targetY);
}
}
public void restoreBeans() {
for (int i = 0; i < m_subFlow.size(); i++) {
BeanInstance temp = (BeanInstance)m_subFlow.elementAt(i);
Point p = (Point)m_originalCoords.elementAt(i);
JComponent c = (JComponent)temp.getBean();
Dimension d = c.getPreferredSize();
int dx = (int)(d.getWidth() / 2);
int dy = (int)(d.getHeight() / 2);
temp.setX((int)p.getX()+dx);
temp.setY((int)p.getY()+dy);
}
}
/**
* Returns true, if at the current time, the event described by the
* supplied event descriptor could be generated.
*
* @param esd an EventSetDescriptor
value
* @return a boolean
value
*/
public boolean eventGeneratable(EventSetDescriptor esd) {
String eventName = esd.getName();
return eventGeneratable(eventName);
}
/**
* Returns true, if at the current time, the named event could
* be generated. Assumes that the supplied event name is
* an event that could be generated by this bean
*
* @param eventName the name of the event in question
* @return true if the named event could be generated at this point in
* time
*/
public boolean eventGeneratable(String eventName) {
for (int i = 0; i < m_subFlow.size(); i++) {
BeanInstance output = (BeanInstance)m_subFlow.elementAt(i);
if (output.getBean() instanceof EventConstraints) {
if (((EventConstraints)output.getBean()).eventGeneratable(eventName)) {
return true;
}
}
}
return false;
}
/**
* Returns true if, at this time,
* the object will accept a connection with respect to the
* supplied EventSetDescriptor
*
* @param esd the EventSetDescriptor
* @return true if the object will accept a connection
*/
public boolean connectionAllowed(EventSetDescriptor esd) {
Vector targets = getSuitableTargets(esd);
for (int i = 0; i < targets.size(); i++) {
BeanInstance input = (BeanInstance)targets.elementAt(i);
if (input.getBean() instanceof BeanCommon) {
//if (((BeanCommon)input.getBean()).connectionAllowed(esd.getName())) {
if (((BeanCommon)input.getBean()).connectionAllowed(esd)) {
return true;
}
} else {
return true;
}
}
return false;
}
public boolean connectionAllowed(String eventName) {
return false;
}
/**
* Notify this object that it has been registered as a listener with
* a source with respect to the named event. This is just a dummy
* method in this class to satisfy the interface. Specific code
* in BeanConnection takes care of this method for MetaBeans
*
* @param eventName the event
* @param source the source with which this object has been registered as
* a listener
*/
public synchronized void connectionNotification(String eventName,
Object source) {
}
/**
* Notify this object that it has been deregistered as a listener with
* a source with respect to the supplied event name. This is just a dummy
* method in this class to satisfy the interface. Specific code
* in BeanConnection takes care of this method for MetaBeans
*
* @param eventName the event
* @param source the source with which this object has been registered as
* a listener
*/
public synchronized void disconnectionNotification(String eventName,
Object source) {
}
/**
* Stop all encapsulated beans
*/
public void stop() {
for (int i = 0; i < m_inputs.size(); i++) {
Object temp = m_inputs.elementAt(i);
if (temp instanceof BeanCommon) {
((BeanCommon)temp).stop();
}
}
}
/**
* Returns true if. at this time, the bean is busy with some
* (i.e. perhaps a worker thread is performing some calculation).
*
* @return true if the bean is busy.
*/
public boolean isBusy() {
boolean result = false;
for (int i = 0; i < m_subFlow.size(); i++) {
Object temp = m_subFlow.elementAt(i);
if (temp instanceof BeanCommon) {
if (((BeanCommon)temp).isBusy()) {
result = true;
break;
}
}
}
return result;
}
/**
* Sets the visual appearance of this wrapper bean
*
* @param newVisual a BeanVisual
value
*/
public void setVisual(BeanVisual newVisual) {
m_visual = newVisual;
}
/**
* Gets the visual appearance of this wrapper bean
*/
public BeanVisual getVisual() {
return m_visual;
}
/**
* Use the default visual appearance for this bean
*/
public void useDefaultVisual() {
m_visual.loadIcons(BeanVisual.ICON_PATH+"DiamondPlain.gif",
BeanVisual.ICON_PATH+"DiamondPlain.gif");
}
/**
* Return an enumeration of requests that can be made by the user
*
* @return an Enumeration
value
*/
public Enumeration enumerateRequests() {
Vector newVector = new Vector();
if (m_subFlowPreview != null) {
String text = "Show preview";
if (m_previewWindow != null) {
text = "$"+text;
}
newVector.addElement(text);
}
for (int i = 0; i < m_subFlow.size(); i++) {
BeanInstance temp = (BeanInstance)m_subFlow.elementAt(i);
if (temp.getBean() instanceof UserRequestAcceptor) {
String prefix = "";
if ((temp.getBean() instanceof BeanCommon)) {
prefix = ((BeanCommon)temp.getBean()).getCustomName();
} else {
prefix = temp.getBean().getClass().getName();
prefix = prefix.substring(prefix.lastIndexOf('.')+1, prefix.length());
}
prefix = ""+(i+1)+": ("+prefix+")";
Enumeration en = ((UserRequestAcceptor)temp.getBean()).enumerateRequests();
while (en.hasMoreElements()) {
String req = (String)en.nextElement();
if (req.charAt(0) == '$') {
prefix = '$'+prefix;
req = req.substring(1, req.length());
}
if (req.charAt(0) == '?') {
prefix = '?' + prefix;
req = req.substring(1, req.length());
}
newVector.add(prefix+" "+req);
}
} else if (temp.getBean() instanceof Startable) {
String prefix = "";
if ((temp.getBean() instanceof BeanCommon)) {
prefix = ((BeanCommon)temp.getBean()).getCustomName();
} else {
prefix = temp.getBean().getClass().getName();
prefix = prefix.substring(prefix.lastIndexOf('.')+1, prefix.length());
}
prefix = ""+(i+1)+": ("+prefix+")";
String startMessage = ((Startable)temp.getBean()).getStartMessage();
if (startMessage.charAt(0) == '$') {
prefix = '$'+prefix;
startMessage = startMessage.substring(1, startMessage.length());
}
newVector.add(prefix + " " + startMessage);
}
}
return newVector.elements();
}
public void setSubFlowPreview(ImageIcon sfp) {
m_subFlowPreview = sfp;
}
private void showPreview() {
if (m_previewWindow == null) {
JLabel jl = new JLabel(m_subFlowPreview);
//Dimension d = jl.getPreferredSize();
jl.setLocation(0,0);
m_previewWindow = new JWindow();
//popup.getContentPane().setLayout(null);
m_previewWindow.getContentPane().add(jl);
m_previewWindow.validate();
m_previewWindow.setSize(m_subFlowPreview.getIconWidth(), m_subFlowPreview.getIconHeight());
m_previewWindow.addMouseListener(new MouseAdapter() {
public void mouseClicked(MouseEvent e) {
m_previewWindow.dispose();
m_previewWindow = null;
}
});
m_previewWindow.setLocation(
getParent().getLocationOnScreen().x + getX() + getWidth() / 2 -
m_subFlowPreview.getIconWidth() / 2,
getParent().getLocationOnScreen().y + getY() + getHeight() / 2 -
m_subFlowPreview.getIconHeight() / 2);
//popup.pack();
m_previewWindow.setVisible(true);
m_previewTimer =
new javax.swing.Timer(8000, new java.awt.event.ActionListener() {
public void actionPerformed(java.awt.event.ActionEvent e) {
if (m_previewWindow != null) {
m_previewWindow.dispose();
m_previewWindow = null;
m_previewTimer = null;
}
}
});
m_previewTimer.setRepeats(false);
m_previewTimer.start();
}
}
/**
* Perform a particular request
*
* @param request the request to perform
* @exception IllegalArgumentException if an error occurs
*/
public void performRequest(String request) {
if (request.compareTo("Show preview") == 0) {
showPreview();
return;
}
// first grab the index if any
if (request.indexOf(":") < 0) {
return;
}
String tempI = request.substring(0, request.indexOf(':'));
int index = Integer.parseInt(tempI);
index--;
String req = request.substring(request.indexOf(')')+1,
request.length()).trim();
Object target = (((BeanInstance)m_subFlow.elementAt(index)).getBean());
if (target instanceof Startable && req.equals(((Startable)target).getStartMessage())) {
try {
((Startable)target).start();
} catch (Exception ex) {
if (m_log != null) {
String compName = (target instanceof BeanCommon) ? ((BeanCommon)target).getCustomName() : "";
m_log.logMessage("Problem starting subcomponent " + compName);
}
}
} else {
((UserRequestAcceptor)target).performRequest(req);
}
}
/**
* Set a logger
*
* @param logger a Logger
value
*/
public void setLog(Logger logger) {
m_log = logger;
}
public void removePropertyChangeListenersSubFlow(PropertyChangeListener pcl) {
for (int i = 0; i < m_subFlow.size(); i++) {
BeanInstance temp = (BeanInstance)m_subFlow.elementAt(i);
if (temp.getBean() instanceof Visible) {
((Visible)(temp.getBean())).getVisual().
removePropertyChangeListener(pcl);
}
if (temp.getBean() instanceof MetaBean) {
((MetaBean)temp.getBean()).removePropertyChangeListenersSubFlow(pcl);
}
}
}
public void addPropertyChangeListenersSubFlow(PropertyChangeListener pcl) {
for (int i = 0; i < m_subFlow.size(); i++) {
BeanInstance temp = (BeanInstance)m_subFlow.elementAt(i);
if (temp.getBean() instanceof Visible) {
((Visible)(temp.getBean())).getVisual().
addPropertyChangeListener(pcl);
}
if (temp.getBean() instanceof MetaBean) {
((MetaBean)temp.getBean()).addPropertyChangeListenersSubFlow(pcl);
}
}
}
/**
* Checks to see if any of the inputs to this group implements
* the supplied listener class
*
* @param listenerClass the listener to check for
*/
public boolean canAcceptConnection(Class listenerClass) {
for (int i = 0; i < m_inputs.size(); i++) {
BeanInstance input = (BeanInstance)m_inputs.elementAt(i);
if (listenerClass.isInstance(input.getBean())) {
return true;
}
}
return false;
}
/**
* Return a list of input beans capable of receiving the
* supplied event
*
* @param esd the event in question
* @return a vector of beans capable of handling the event
*/
public Vector getSuitableTargets(EventSetDescriptor esd) {
Class listenerClass = esd.getListenerType(); // class of the listener
Vector targets = new Vector();
for (int i = 0; i < m_inputs.size(); i++) {
BeanInstance input = (BeanInstance)m_inputs.elementAt(i);
if (listenerClass.isInstance(input.getBean())) {
targets.add(input);
}
}
return targets;
}
}