Author: thomas.diesler(a)jboss.com Date: 2008-01-11 08:05:49 -0500 (Fri, 11 Jan 2008) New Revision: 5467 Modified: stack/native/trunk/build.xml Log: Add documentation Modified: stack/native/trunk/build.xml =================================================================== --- stack/native/trunk/build.xml 2008-01-11 10:56:48 UTC (rev 5466) +++ stack/native/trunk/build.xml 2008-01-11 13:05:49 UTC (rev 5467) @@ -11,6 +11,82 @@ <!-- $Id$ --> +<!-- + The JBossWS project is organised like this + + +~~~~~~~~~~~~~~~~~+ +~~~~~~~~~~~~~~~~~+ +~~~~~~~~~~~~~~~~~+ +~~~~+ + Target Container: | AS-5.0 | | AS-4.2 | | AS-4.0 | | | + +~~~~~~~~~~~~~~~~~+ +~~~~~~~~~~~~~~~~~+ +~~~~~~~~~~~~~~~~~+ | | + +~~~~~~~~~~~~~~~~~+ +~~~~~~~~~~~~~~~~~+ +~~~~~~~~~~~~~~~~~+ | | + Container Integration: | jbossws-jboss50 | | jbossws-jboss42 | | jbossws-jboss40 | | | + +~~~~~~~~~~~~~~~~~+ +~~~~~~~~~~~~~~~~~+ +~~~~~~~~~~~~~~~~~+ | | + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~+ | | + WS Framework: | jbossws-spi, jbossws-framework, jbossws-common | | | + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~+ | | + +~~~~~~~~~~~~~~~~~+ +~~~~~~~~~~~~~~~~~+ +~~~~~~~~~~~~~~~~~+ | | + WS Stack Integration: | jbossws-native | | jbossws-metro | | jbossws-cxf | | | + +~~~~~~~~~~~~~~~~~+ +~~~~~~~~~~~~~~~~~+ +~~~~~~~~~~~~~~~~~+ | | + +~~~~~~~~~~~~~~~~~+ +~~~~~~~~~~~~~~~~~+ +~~~~~~~~~~~~~~~~~+ | | + WS Stack: | jbossws-core | | Sun Metro | | Apache CXF | | | + +~~~~~~~~~~~~~~~~~+ +~~~~~~~~~~~~~~~~~+ +~~~~~~~~~~~~~~~~~+ | | + WS-* Extensions: +~+ +~+ +~+ +~+ +~+ +~+ | | + | | | | | | | | | | | | | | + | | | | | | | | | | | | | | + | | | | | | | | | | | | | | + | | | | | | | | | | | | | | + | | | | | | | | | | | | | | + +~+ +~+ +~+ +~+ +~+ +~+ +~~~~+ + JAXWS Testsuite + + + Typically you would build, deploy, test one of the WS stacks against one of the supported target containers. + Here we explain first the manual procedure. Further down you find instruction on how to do this using our + automated Hudson QA environment. + + Working with JBossWS-Native + ~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + To run the general JAXWS samples against our native WS stack on JBoss-5.0 you would run the sequence below. + This is also the required sequence before any SVN commit. If one of the tests fails, please complain loudly. + + cd stack/native/trunk + ant deploy-jboss500 + ant tests-smoke + + To run the collection of provider sample tests, you would run + + ant -Dtest=jaxws/samples/provider test + + To run a single specific test, you would run + + ant -Dtest=org.jboss.test.ws.jaxws.samples.provider.ProviderPayloadTestCase one-test + + This can be done in debug mode as well + + ant -Ddebug=true -Dtest=org.jboss.test.ws.jaxws.samples.provider.ProviderPayloadTestCase one-test + + Working with the Hudson QA environment + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + The Hudson QA environment helps you to test any supported stack against any supported target container. + To setup Hudson on your local box, you would run + + cd framework/trunk + ant hudson-setup + ant hudson-start + + When you hit http://localhost:8180/hudson you should be able to + + 1. login + 2. build a target container + 3. run a testsuite against the target container + + Publicly, Hudson is available at http://jbws.dyndns.org:8180/hudson/ + + Have fun + good luck + The JBossWS Team +--> + <project default="main" basedir="." name="JBossWS-Native"> <property name="core.dir" value="${basedir}"/>