Installation of the Java binding

Please read this introductory page before proceeding.

If you have any suggestion on how to ameliorate the installation process, you are welcome to create a discussion or to participate to a related one in this forum.

Installation of the toolkit

To install the Java binding of the Atlas toolkit, in addition of the requirement indicated in above mentioned introductory page, you naturally have Java to be installed. The toolkit was tested only against Java version 1.8. There is no guarantee that the Atlas toolkit works, or even will be properly installed, with another version of Java.

Once all the needed software be installed, you have to define the JAVA_HOME environment variable, so it points to the JDK root directory. Then, you only have to launch npm install atlastk-java. This is made with something like (has to be adapt according to the shell and the version of the JDK you use):

  • under GNU/Linux (Debian; may differ with other distributions): export JAVA_HOME="/usr/lib/jvm/default-java/",
  • under macOS: export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk<version>.jdk/Contents/Home/,
  • under Windows: set JAVA_HOME="C:\Program Files\Java\jdk<version>".

Installation of the examples

The examples naturally needs the Atlas toolkit, so this examples have the same software requirements as indicated above. But don't launch the npm install atlastk-java command indicated above; this will be done automatically by the below described installation procedure.

The commands below only work when the Java executable is in the executable path. If this is not the case, you have to give the full path to the Java executable instead of only java.

Furthermore, under GNU/Linux and macOS (and probably other OSes), you may have to add following argument : -Djava.library.path=..

TodoMVC

This is the Java version of the TodoMVC application.

Retrieve the following repository: http://github.com/epeios-q37/todomvc-java/, then, from the inner of the repository, launch npm install.

To launch the desktop version of the application, launch java -cp classes TodoMVC.

For the web version, launch java -cp classes TodoMVC web, and go to http://localhost:8080.

Other

This is the application you can see at http://atlastk.org:8080.

Retrieve this the following repository: http://github.com/epeios-q37/atlas-java-demo/, then, from the inner of the repository, launch npm install.

To launch the desktop version of the application, launch java -cp classes Notes. For the web version, launch java Notes web, and go to http://localhost:8080.

There is another example, a very basic one, which you can launch with java -cp classes Blank [web]. You can use a copy of this example as starting point for your own application.