Running
Starting Æjaks
Running Æjaks requires Java 1.4 or higher. If you don't have Java already, you can download Java from http://java.sun.com. Get the JRE package if you just want to run Æjaks, or the JDK if you want to develop additional Java components for Æjaks.
The Jetty web server is shipped with Æjaks to run out of the box. You can also use Tomcat, or any other Java Servlet engine to run Æjaks. All required libraries are bundled into the aejaks.war file.
To start Æjaks running the sample programs, execute the run.sh shell script (Unix/Linux/MacOSX), or run (run.bat, Windows). Shell users can execute stop.sh to stop the Jetty server, Windows users should press ^C in the console window.
Sample Apps
After starting the Jetty web server, start your browser and go to http://localhost:8080/. The index page allows you to start the sample apps.
-
Widget Tour
This application shows off some of the widgets can Æjaks. Besides playing with the widgets, a log is printed for actions (such as clicking a button) and source code that produced the demo can be inspected.
-
Æjaks Console
The sample console application allows you to interactive program in Tcl and the Æjaks widgets. Because Jacl is a full interpretive language with capabilities to read and write files, execute other programs, invoke any Java object, precautions are taken to prevent misuse. The console app will only work for browsers that connect from the localhost (127.0.0.1). Futher, when the application is started, a random number is printed on the web server's stdout as a password. That password is then prompted by the user interface before continuing.
NOTE THAT NO OTHER PRECAUTIONS ARE IN PLACE! The person running the console app basically has shell access to your system!
Note for those running on Mac OSX, you will have to open the Applications -> Utilities -> Console application in order to see the Æjaks Console passoword.
-
Clock
Clock is a simple text clock, showing off the Æjaks feature of asynchronous updating. Written and contributed by Geoffrey Wu.
-
NumberGuess
NumberGuess is a re-implementation of the Echo2 tutorial application. The Æjaks/Tcl version is less than one-third the size of the Echo2/Java version. Written and contributed by Geoffrey Wu.