edu.cmu.tetradapp.workbench.GraphNodeError Maven / Gradle / Ivy
///////////////////////////////////////////////////////////////////////////////
// For information as to what this class does, see the Javadoc, below. //
// Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, //
// 2007, 2008, 2009, 2010, 2014, 2015, 2022 by Peter Spirtes, Richard //
// Scheines, Joseph Ramsey, and Clark Glymour. //
// //
// 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA //
///////////////////////////////////////////////////////////////////////////////
package edu.cmu.tetradapp.workbench;
import edu.cmu.tetrad.graph.EdgeListGraph;
import edu.cmu.tetrad.graph.Graph;
import edu.cmu.tetrad.graph.Node;
import edu.cmu.tetrad.graph.NodeType;
import edu.cmu.tetrad.util.JOptionUtils;
import edu.cmu.tetrad.util.NamingProtocol;
import edu.cmu.tetrad.util.TetradLogger;
import javax.swing.*;
import java.awt.event.FocusAdapter;
import java.awt.event.FocusEvent;
import java.io.IOException;
import java.io.ObjectInputStream;
import java.io.ObjectOutputStream;
import java.io.Serial;
import java.util.List;
/**
* Represents an error node in the workbench. Appears as a white oval with black border, with the variable name in it.
* Clicking on the oval pops up a dialog that lets the user modify the name of the variable.
*
* @author josephramsey
* @author Willie Wheeler
* @version $Id: $Id
*/
public class GraphNodeError extends DisplayNode {
/**
* Constructs a display node for an error term.
*
* @param modelNode a {@link edu.cmu.tetrad.graph.Node} object
*/
public GraphNodeError(Node modelNode) {
setModelNode(modelNode);
if (modelNode.getNodeType() != NodeType.ERROR) {
throw new IllegalArgumentException("GraphNodeError requires " +
"a GraphNode of type NodeType.ERROR.");
}
setDisplayComp(new ErrorDisplayComp(modelNode.getName()));
}
//===========================PUBLIC METHODS========================//
/**
* {@inheritDoc}
*
* Launches a dialog that lets the user change the name of the variable, making sure the user doesn't pick a name
* that's already being used. That's what the given graph is used for--to provide a list of variables whose names
* should not be picked by the user as the new name for any variable.
*/
public void doDoubleClickAction(Graph graph) {
List nodes = graph.getNodes();
String newName = chooseNewVariableName(nodes);
if (this.getModelNode() != null) {
this.getModelNode().setName(newName);
}
}
/**
* doDoubleClickAction.
*/
public void doDoubleClickAction() {
doDoubleClickAction(new EdgeListGraph());
}
//==========================PRIVATE METHODS=========================//
private String chooseNewVariableName(List nodes) {
String newName;
loop:
while (true) {
JTextField nameField = new JTextField(8);
// This makes sure the name field has focus when the dialog (below)
// is made visible, but that after this it allows other gadgets
// to grab focus.
nameField.addFocusListener(new FocusAdapter() {
boolean alreadyLostFocus;
public void focusLost(FocusEvent e) {
if (this.alreadyLostFocus) return;
JTextField field = (JTextField) e.getSource();
field.grabFocus();
this.alreadyLostFocus = true;
}
});
nameField.setText(getName());
nameField.setCaretPosition(0);
nameField.moveCaretPosition(getName().length());
JPanel message = new JPanel();
message.add(new JLabel("Name:"));
message.add(nameField);
JOptionPane pane = new JOptionPane(message, JOptionPane.PLAIN_MESSAGE,
JOptionPane.OK_CANCEL_OPTION);
JDialog dialog = pane.createDialog(this, "Node Properties");
dialog.pack();
dialog.setVisible(true);
newName = nameField.getText();
// Tests that newName is a well formed variable
if (!NamingProtocol.isLegalName(newName)) {
JOptionPane.showMessageDialog(JOptionUtils.centeringComp(),
NamingProtocol.getProtocolDescription());
continue;
}
// Tests that newName is not in the nodes list.
else if (nodes != null) {
for (Node node : nodes) {
if (newName.equals(node.toString()) &&
!newName.equals(this.getModelNode().getName())) {
JOptionPane.showMessageDialog(
JOptionUtils.centeringComp(), "The name '" +
newName + "' is already being used." +
"\nPlease choose another name.");
continue loop;
}
}
}
break;
}
return newName;
}
/**
* Writes the object to the specified ObjectOutputStream.
*
* @param out The ObjectOutputStream to write the object to.
* @throws IOException If an I/O error occurs.
*/
@Serial
private void writeObject(ObjectOutputStream out) throws IOException {
try {
out.defaultWriteObject();
} catch (IOException e) {
TetradLogger.getInstance().log("Failed to serialize object: " + getClass().getCanonicalName()
+ ", " + e.getMessage());
throw e;
}
}
/**
* Reads the object from the specified ObjectInputStream. This method is used during deserialization
* to restore the state of the object.
*
* @param in The ObjectInputStream to read the object from.
* @throws IOException If an I/O error occurs.
* @throws ClassNotFoundException If the class of the serialized object cannot be found.
*/
@Serial
private void readObject(ObjectInputStream in) throws IOException, ClassNotFoundException {
try {
in.defaultReadObject();
} catch (IOException e) {
TetradLogger.getInstance().log("Failed to deserialize object: " + getClass().getCanonicalName()
+ ", " + e.getMessage());
throw e;
}
}
}