Egg Timer jar file:  Copy it onto your system.  The file contains Javadoc (also linked from the 143 web), and all needed classes to create egg timers.  You can unzip the jar file, or you can use it without unzipping it.

To use the classes in Bluej without having to unzip the jar file, go into Tools/Preferences/Libraries and add a user library -- just point to wherever you copied the jar file on your system.

You can also unzip the jar file.  Copy all the files (except Javadoc) into your Bluej project -- preserving the directory (package) structure.  To check that the copy is correct: in your project directory (not in a subdirectory) you should see, among other things, EggTester.class, a bunch of other class files, and a couple of subdirectories.  It is NOT necessary to move or rename any of these files.

To use the classes in a program, regardless of how you installed them:

	import EggTimer.*;

If your program doesn't compile, then something is not set up right.

To create an egg timer, you create an object, and then start it:
	EggTimer myTimer = new EggTimer(60.0); //double value is number of SECONDS
	//the timer should immediately appear on the screen, near the lower right.
	myTimer.startEggTimer(); //starts the timer in motion.

At any time after this, you can call methods on the timer to find out how much time is left, how much time has elapsed, what percentage of time has elapsed, etc.  To remove the timer from the screen, call its stop() method.  A timer can only be started and stopped once.

If you are familiar with AWT/Swing events, you can add a listener to timer events; not necessary, however.

See the Javadoc for more information.

The jar file contains a fun egg timer tester, which is the static method EggTester.main. The non-fun part of this tester is that it runs forever and is hard to terminate, especially in Bluej...  You can call it from your own program.
You can also execute it directly from the jar file.  It is the default class, so on some systems you can just double click the jar file.  Running it outside Bluej is probably the best idea.  For example, assuming you are in the right directory, just type
java -jar <jar file>.jar


MD 12/1/2002