Getting started

Make sure that SUN's J2SE 1.3 or greater is installed on your computer. To run the WEB, you must get J2SE 1.4 since the Jetty version used by default is compiled for J2SE 1.4. If you don't have the Java 2 Sandard Environment installed, visit this link before installing JAC: J2SE.

To use JAR version of JAC, download a JAC release at the downloads section. The JAR version of JAC does not require any extra library to work, they are already included.

Once you have downloaded the archive, install JAC:

Linux

  1. Extract the archive and go in to the jac directory:
    cd <work_dir>
    tar zxf jac-xxx.tar.gz
    cd jac
    

    It will create a directory named org/objectweb/jac/ and extract all files in it.

  2. Run samples using on of the four .sh scripts. For instance, to launch the photo sample with the swing GUI:
    ./samples/photos-swing.sh
    

    Read the readme file (samples/photos-README.txt) to learn how to use the sample.

  3. Run UML Aspectual Factory:
    ./UML_AF.sh
    

    It will run UML Aspectual Factory, which is an IDE that supports UML-like and UML for aspects. To learn how to create your own JAC program with UMLAF, see the IDE Tutorial.

  4. Run an application that you created for JAC:
    cd jac
    java -jar org.objectweb.jac.jar -R . 
         -C <application_root_pkg>[:<optional_classpath>] 
         [<gui_opt> <gui_name>]
         <jac_file>
    

    It will run your application with the selected GUI (if there is one). You can also run your application from another directory if you modify paths accordingly.

Windows

  1. Extract the archive:

    Use a compression program such as WinZip to extract files in C:\. It will create a directory C:\jac\ and extract all files in it. JAC must be installed in C:\jac\. Otherwise, you'll have to change all the shortcuts.

  2. Run samples:

    Go to samples directory (C:\jac\samples) and double-click on the shortcut corresponding to the sample you want to run, with the GUI you want to use. It will run the associated sample.

    Shortcut names are like this : <sample_name>-<gui>.pif, where <sample_name> is the name of the sample and <gui> is the type of GUI used.

  3. Run UML Aspectual Factory:

    Go to jac directory (C:\jac) and double-click on UML_AF shortcut.

    It will run UML Aspectual Factory, which is an IDE that supports UML-like and UML for aspects. For creating your own JAC program with UMLAF, go to the IDE Tutorial.

  4. Run an application that you created for JAC:

    Go to jac directory (C:\jac) and run a command console (execute command "command" to open a console). Then type:

    java -jar org.objectweb.jac.jar -R .
         -C <application_root_pkg>[;<optional_classpath>] 
         [<gui_opt> <gui_name>]
         <jac_file>
    

    It will run your application with the selected GUI (if there is one). You can also run your application from another directory if you modify paths accordingly.