403f21c8db
Added a "Quit" option to Savant's File menu. Factored out the Close option in doing so. Exceptions in many action listeners are now handled by org.thdl.util.ThdlActionListener or org.thdl.util.ThdlAbstractAction. Many exceptions that we used to just log now optionally cause aborts. This option is on by default for developers using 'ant savant-run'-style targets, but it is off for users. An erroneous CLASSPATH now causes a useful error message in almost all situations. Fixed some typos and bad links in Javadoc comments. Added a simple assertion facility, but the overhead is suffered even in release builds. Factored out the code that sets up log files like savant.log and jskad.log.
85 lines
3.2 KiB
Java
85 lines
3.2 KiB
Java
/*
|
|
The contents of this file are subject to the THDL Open Community License
|
|
Version 1.0 (the "License"); you may not use this file except in compliance
|
|
with the License. You may obtain a copy of the License on the THDL web site
|
|
(http://www.thdl.org/).
|
|
|
|
Software distributed under the License is distributed on an "AS IS" basis,
|
|
WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
|
|
License for the specific terms governing rights and limitations under the
|
|
License.
|
|
|
|
The Initial Developer of this software is the Tibetan and Himalayan Digital
|
|
Library (THDL). Portions created by the THDL are Copyright 2001 THDL.
|
|
All Rights Reserved.
|
|
|
|
Contributor(s): ______________________________________.
|
|
*/
|
|
|
|
package org.thdl.util;
|
|
|
|
import javax.swing.AbstractAction;
|
|
import javax.swing.Icon;
|
|
import java.awt.event.ActionEvent;
|
|
|
|
import org.thdl.util.ThdlDebug;
|
|
|
|
/**
|
|
* This ActionListener is like any other except in the way that it
|
|
* handles exceptions or errors thrown during the execution of
|
|
* <code>actionPerformed()</code>. Because event listeners are on
|
|
* threads, an exception during <code>actionPerformed()</code> is just
|
|
* printed out on the console by
|
|
* <code>java.awt.EventDispatchThread.run()</code>. It does not cause
|
|
* the program to terminate. In our code, it helps developers more
|
|
* quickly get to the root of a problem if the program terminates as
|
|
* soon after a problem as possible.
|
|
*
|
|
* Thus, this class calls <code>System.exit(1)</code> when an
|
|
* exception is throw by <code>theRealActionPerformed()</code>, which
|
|
* is the method that subclasses should implement.
|
|
*
|
|
* @see ThdlActionListener
|
|
*
|
|
* @author David Chandler
|
|
*
|
|
* There is a pertinent Usenet thread at <code>http://groups.google.com/groups?hl=en&lr=&ie=UTF-8&oe=utf-8&threadm=6ntgl6%244hl%241%40tarantula.europe.shiva.com&rnum=2&prev=/groups%3Fq%3Dexception%2BactionPerformed%26hl%3Den%26lr%3D%26ie%3DUTF-8%26oe%3Dutf-8%26selm%3D6ntgl6%25244hl%25241%2540tarantula.europe.shiva.com%26rnum%3D2</code>.
|
|
*/
|
|
public class ThdlAbstractAction extends AbstractAction {
|
|
|
|
/** Just calls the super's constructor with the same args. */
|
|
public ThdlAbstractAction(String s, Icon i) {
|
|
super(s, i);
|
|
}
|
|
|
|
/** Subclasses don't override this. Instead, they override
|
|
* <code>theRealActionPerformed()</code>.
|
|
* @see #actionPerformed(ActionEvent)
|
|
*/
|
|
public final void actionPerformed(ActionEvent e) {
|
|
try {
|
|
theRealActionPerformed(e);
|
|
} catch (NoClassDefFoundError err) {
|
|
/* This is an especially common exception, and is in fact
|
|
the motivating force behind the ThdlActionListener
|
|
class and this class. Handle it well so that users
|
|
know what's up: */
|
|
ThdlDebug.handleClasspathError(null, err);
|
|
} catch (Throwable t) {
|
|
System.err.println("THDL_ERR 107: This application failed due to the following exception: ");
|
|
t.printStackTrace(System.err);
|
|
System.exit(1);
|
|
}
|
|
}
|
|
|
|
/** Subclasses should override this method to do the real action
|
|
* performed.
|
|
* @see #actionPerformed(ActionEvent)
|
|
*/
|
|
protected void theRealActionPerformed(ActionEvent e)
|
|
throws Throwable
|
|
{
|
|
/* do nothing */
|
|
}
|
|
}
|
|
|