SimpleApp - a sample application

The Source Code

The commented source code of SimpleApp can be found here.

Compiling SimpleApp

The source file for SimpleApp ( is available in the developer/src/armidale/test directory. You can copy this code to your own working directory, remove or change the package statement if required, and compile it using the standard Java compiler.

javac -classpath <classpath>


<classpath> includes armidale.jar.

Testing SimpleApp locally

Once compiled, SimpleApp can be tested stand-alone using the following command:

java -classpath <classpath> SimpleApp


<classpath> includes armidale.jar.

The following window should appear.

Installing your application on an armidale server

Once SimpleApp has been compiled using a standard Java compiler, it can be installed on a server by simply copying its class file or a jar containing the class file to a directory on the armidale servers Java class path. The easiest place to put them is in the <install_dir>/jars directory.

Running the armidale server

Once SimpleApp is installed, you can start the armidale server using the following command.

java -cp <install_dir>/jars/armidale.jar:<classpath> armidale.api.Server -port <port>


<install_dir> is the name of the directory in which armidale is installed.

<classpath> is a Java classpath that includes your application classes.

<port> is a TCP/IP port number (usually 3000).

See Command Line Programs for information on other switches which can be used when starting the armidale server.

Running your application

You can now run your application remotely by either using the armidale launcher or by using the command line as described here. To use the armidale launcher, open the following URL as detailed in the launcher instructions.



<your-host> is the name of the host running the armidale server or if the server is running on the same machine as the client.