====== JAsCoDT for Eclipse ======

The JAsCo Eclipse plugin allows easy development of JAsCo enabled applications using the Eclipse IDE. Eclipse is an open, extensible and cross-platform IDE. For more information about Eclipse, see the [[http://www.eclipse.org|Eclipse website]].

===== Features =====


    * Compiling aspect beans, connectors and regular Java classes.
    * Makes sure that normal Java files are always transformed to JAsCo beans so that aspects are able to be triggered on them.
    * Visual wizards for both aspects and connectors.
    * Allows to find out which joinpoints match a certain hook instantiation.
    * Running and debugging JAsCo projects. 

===== System Requirements =====

     * Windows 2000/XP or Linux 
     * JDK 1.4+ (JDK1.5 recommended)
     * Eclipse 2.1 or Eclipse 3.0 (3.0 recommended)

===== Installation Instructions =====

The development tools for JAsCo are installed using the Eclipse update manager. 

   -  Install the plugin by employing the built-in update manager for the following url: http://ssel.vub.ac.be/jasco/update/. Select the correct JAsCo version depending on your Eclipse version (2.1 or 3.0), if you don't know which Eclipse version you have see Help->About. If you don't know how to use the update manager, click here for a detailed explanation.
   -  Set the tools.jar file in the window->preferences->JAsCo tab. For more information about this, see the online help: Help -> Help Contents -> JAsCo Plugin Help. 

** Important Upgrade Information:**  If you are upgrading from an earlier version of the Eclipse plugin, existing projects will still have the old JAsCo runtime libraries. Solution: Either make a new JAsCo project and move all contents to that one or manually alter the jasco.jar and jasco-libs.jar project libraries. Both are located in eclipse/plugins/<jasco-latest>/libs.


===== Manual for using the JAsCo Eclipse plugin =====

A manual for configuring and using the JAsCo Eclipse Plugin is integrated in the plugin itself from version 1.2.2 onwards. Go to: Help -> Help Contents -> JAsCo Plugin Help.

You also might want to subscribe to the [[community|JAsCo mailinglist]] for the latest information on JAsCo.


===== Example AOSD Project =====

A simple visual application which execution is logged using a JAsCo aspect bean.

Intructions:

    * Download the project here.
    * Create a new JAsCo project in Eclipse.
    * Import the example into the new project using File->Import.
    * Add the juggler.jar library (contained in the zip file) to the new project using Project->Properties->Java Build Path->Add External Jar
    * Create a new JAsCo runner and use RunJuggler as main class.
    * Launch the application! 

===== Example Adaptive Programming Project (using traversal connectors) for JAsCo 0.8+ (or eclipse plugin 1.3.2+) =====

This application runs two visitors on a sample data structure. Combination strategies are also employed. See the JAsCo language reference for more information about Adaptive Programming and traversal connectors.

Intructions:

    * Download the project here.
    * Create a new JAsCo project in Eclipse.
    * Import the example into the new project using File->Import->Zip File.
    * Create a new JAsCo runner and use RunTraversal as main class.
    * Launch the application!