AXIS Test Rearchitecture

Quick Start
Common Design Principles
General Changes
Samples Changes
Test Changes

Quick Start

To run the full build system, as the old was run, do the following:

ant clean functional-tests
To see how the componentized build structure is affected, as well as cross-dependancies, do the following:
ant clean compile
cd test/encoding
ant clean compile run
(The encoding test has a dependancy on the echo sample)

Back to the Top

Common Design Principles

There were 6 design goals that were laid out for me before undertaking this project:

  1. Determine the needs and dependancies of each test and sample
  2. Reduce the complexity of the xml that compiles, deploys, execs, and undeploys samples and tests
  3. Enable a new test or sample to be "plugged in" to the suites, without disturbing currently working things
  4. Enable the ability to instantiate any single sample or any single test
  5. Identify tests and samples that need "network" or "internet" resources
  6. Enable the ability to group tests and samples together in "bundles"

To this end, the general theory was applied to everything:

Back to the Top

Generic Changes

A new top-level path was created, named "xmls". This path houses the common xml configuration file fragments. Roughly, in order of their inclusion, they are:

properties.xml contains common properties, eliminating the large property setting blocks at the top of each build*.xml file.
path_refs.xml contains the common CLASSPATH setup, to eliminate needing to track, or multiply define this large structure in all files separately.
taskdefs.xml contains common ant tasks that are set up, the are inherent in the configuration.
taskdefs_post_compile.xml contains the definitions of tasks that are built during the compilation of tasks, such as forEach, java2wsdl, and wsdl2java.
targets.xml contains common configuration level targets that required hundreds of lines of repeated code in the build*.xml files.

Back to the Top

Samples

The old $(TOP)/build.xml had a target called "samples" which did a very simple full-compile on everything referenced by samples/**/*.java. Although this was very simple, it was not very "strong" in that everything in the samples tree needed to be able to be compiled by this rule. Whenever anything needed to be altered in the samples, this main file needed to be modified. It was very possible for someone to add a sample that needed a change, and by changing the master file, could break an large number of things.

In order to alleviate this risk, and to better define the actual samples compilation and use, the samples building has been moved to a new xml file buildSamples.xml but the original target is still stubbed into build.xml for backwards compatibility and use does not change.

Then, I extracted the actual compilation logic for each sample, and componentized it into a build.xml file, located in the actual sample sub-directory. For example, for the echo sample is now run by the file samples/echo/build.xml. It can be singularly instantiated by invoking:

ant -buildfile buildSamples.xml echo
or as part of the batch (as the old function) by invoking:
ant samples
which is what build.xml does in the "samples" target.

Back to the Top

Tests

The old $(TOP)/build.xml had a target called "buildTest" which did a very simple full-compile on every thing referenced by test/**/*.java. Although this was very simple, it was not very "strong" in that everything in the test tree needed to be able to be compiled by this rule. Whenever anything needed to be altered in the test, this main file needed to be modified. It was very possible for someone to add a test that needed a change, and by changing the master file, could break an large number of things.

In order to alleviate this risk, and to better define the actual test compilation and use, the test building has been moved to a new xml file buildTest.xml but the original target is still stubbed into build.xml for backwards compatibility and use does not change.

Then, I extracted the actual compilation logic for each test, and componentized it into a build.xml file, located in the actual test sub-directory. For example, for the session test is now compiled by the file test/session/build.xml. It can be singularly instantiated by invoking:

ant -buildfile buildTest.xml session
or as part of the batch (as the old function) by invoking:
ant functional-tests
which is what build.xml does in the "buildTest" target.