Download/Installation

All results of this project are publicly available under the GNU General Public Licence. This includes the project documentation and all the software developed in the project in both source and object form. It includes in particular all the software for the XWeaver tool. This page gives access to the downloadable items.

Please refer to the Eclipse Plug-in installation page to install the Eclipse Plug-in for XWeaver (AXDT). Intalling the command line version of XWeaver (described on this page) is not needed to run the Eclipse Plug-in.

Requirements

XWeaver will run on any platform where there is a suitable Java 2 runtime environment (JDK 1.5 or higher required. To use XWeaver with JDK 1.4, you need to download the JAXP 1.3 library from Sun, and ensure that the files jaxp-api.jar and dom.jar are on your CLASSPATH).

You'll also need an installation of Jakarta Ant version 1.65 or higher and an XSLT 2.0 compliant XSLT processor (XWeaver was tested with the Saxon-B 8.4 XSLT processor).

If Ant is not already installed on your system you can downlaod it from the Jakarta Ant homepage. (Also see the Ant Installation Manual)

The saxon8.jar file for running Saxon-B 8.4 with Jakarta Ant is included in the XWeaver distribution. (In XWeaver/lib)

The src2srcml tool is also needed by XWeaver and is delivered with the XWeaver distribution. So far there are only Windows and Linux executables available of src2srcml.

Download

The software and documentation distributed through this site can be downloaded from sourceforge. By downloading this zip file you are accepting the licence condition stated here. The current release of XWeaver has not been tested on Linux.

Please read the Upgrade Section if you upgrade to a new version.

THE XWEAVER DELIVERABLES ARE PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE PROVIDER OF THE SOFTWARE BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Installation

Please read the Requirements section before you start with the installation.

The installation of XWeaver is simply done by unzipping the XWeaver distribution file in a dedicated target directory.

Apart from this there is only one more task to finish the installation. Copy the following files from the directory {XWeaverInstall}/XWeaver/lib to the lib directory of the Jakarta Ant installation:

  • saxon8.jar
  • srcml-ant.jar
  • xweaver-ant.jar

On linux systems you eventually have to set the executable permissions for the src2srcml tool (e.g: chmod 755 resources/srcML/linux/src2srcml)

You can test your installation by invoking the following command in the XWeaver/AspectXTestSuite directory (Takes about 1-2 minutes):

ant WeaveAndTestAll

If this Ant target runs through and finishes with the message "BUILD SUCCESSFUL", XWeaver is probably installed correctly.

Upgrade

If you upgrade to a new version of XWeaver you'll have to re-copy the jar files from {XWeaverInstall}/XWeaver/lib to the {ANT_HOME}/lib directory.

File Organization

  • /AspectXLib: Sample Aspects and source code (C/C++). These examples are extensively commented. The generated documentation can be found here.
  • /AspectXTestSuite: Aspects and source code that are used to test the XWeaver tool
  • /doc: HTML documentation
  • /lib: Jar files which are needed to run XWeaver (must be copied to Ant's lib directory)
  • /src: Contains sources of XWeaver.
  • /resources: Contains src2srcml tool