The Beehive compiler test framework is a JUnit TestCase which will 
attempt to compile pageflow controller files and any controls files 
in the test directory and then analyze the compiler output results.

Each compilation of a test directory which is laid out as a normal
Beehive webapp directory structure is considered a junit test.

You may put as many page flow directories as you want in each test 
directory . All the test directories should reside in one testsuite 
directory. The testsuite location should be specified throught an system 
viriable "testsuite.dir".

Each test directory should contain an expectedOutput directory that has 
all the expected compiler outputs. All the expected generated struts config 
files should be recorded there with the extention ".expected" instead of 
".xml". Any compiler warning or error messages are piped into a file named
warningorerror.actual. The expected warning or error output should also be 
recorded into the expectedOutput directory with the extention of ".expected"
instead of ".actual".

The test results are based on the line comparison between the actual and expected
ouputs.

Each of the test will be first copied into a build area which can be specified
through a system viriable "test.output.dir". You can specify a list of tests you 
want to include or exclude by the test directory name throught the system viriables 
"included.test.list" and "excluded.test.list". This two lists can work together to 
get the list of tests you want to include. 

A class path that is required to run the beehive compiler needs to be passed though 
a system varialble "compiler-tests.classpath". The class path should include 
beehive-netui-compiler.jar, beehive-controls.jar, a servletAPI jar file and velocity
jar files. The beehive-netui-core.jar is also needed when needing to run javac afte
the apt compiler.

To run the compiler Junit TestCase itselt, you will need the junit.jar, 
commons-logging and log4j in your your classpath.

The compiler test automation in beehive and beehive test distribution is built in
through netui/test/ant/junitCore.xml and netui/test/ant/compiler-test.properties.