You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@beehive.apache.org by ek...@apache.org on 2006/07/30 18:54:34 UTC
svn commit: r426899 - in /beehive/wsm/trunk: BUILDING.txt build.xml pom.xml
src/beehive-wsm.pom wsm-imports.xml
Author: ekoneil
Date: Sun Jul 30 09:54:33 2006
New Revision: 426899
URL: http://svn.apache.org/viewvc?rev=426899&view=rev
Log:
Fixes for BEEHIVE-1136/7 that fix issues getting started building / installing WSM. Fixes here:
- switch to StAX from JSR-173 RI API JAR
- fix bug in beehive-wsm.pom which was using an incorrect artifactId
- add instructions to BUILDING.txt for testing against Tomcat and remove other useless doc
- fix default target in build.xml
Test: WSM pass
Modified:
beehive/wsm/trunk/BUILDING.txt
beehive/wsm/trunk/build.xml
beehive/wsm/trunk/pom.xml
beehive/wsm/trunk/src/beehive-wsm.pom
beehive/wsm/trunk/wsm-imports.xml
Modified: beehive/wsm/trunk/BUILDING.txt
URL: http://svn.apache.org/viewvc/beehive/wsm/trunk/BUILDING.txt?rev=426899&r1=426898&r2=426899&view=diff
==============================================================================
--- beehive/wsm/trunk/BUILDING.txt (original)
+++ beehive/wsm/trunk/BUILDING.txt Sun Jul 30 09:54:33 2006
@@ -16,6 +16,10 @@
for security, asynchrony, state management, etc. Note, WSM *is not* a SOAP stack. It is simply
an infrastructure for using Java 5 metadata to describe a WSDL from a POJO.
+==========
+Building
+==========
+
To build WSM, install the following software:
Ant 1.6.x
Maven 2.0.2+
@@ -24,32 +28,39 @@
The build calls Maven from Ant to download the dependencies listed in pom.xml and uses Ant for
compilation, testing, and generating documentation.
-Build WSM:
- ant build
+A typical build process looks like:
+ $> ant clean build install
+
+The "build" step builds the various WSM JAR files.
+
+The "install" step will install the WSM JARs into your local Maven2 repository with
+the groupId "org.apache.beehive" and the relevant artifactIds for the various JARs.
-Install WSM into your local Maven2 repository:
- ant install
+The "clean" step removes the build/ directory that contained all of the generated sources,
+compiled class files, and build JARs. Note, this does *not* remove JARs that may have been
+installed in your local Maven2 repository during the "install" step.
-Test WSM:
- ant test
+==========
+Testing
+==========
+The WSM test suite consists of two parts -- a JUnit part for API testing and a web application
+for testing against Axis2.
-Clean WSM:
- ant clean
+In order to run the web application, Tomcat must be installed locally and configured so the
+Tomcat deployment APIs can be used from the command line. To install and configure Tomcat,
+follow these steps:
-Once the dependencies have been downloaded, a typical build process looks like:
+1) Install Tomcat 5.x or higher
+2) Set CATALINA_HOME to point to this directory
+3) Edit $CATALINA_HOME/conf/tomcat-users.xml to configure the "manager" role with:
- ant clean build install test
+ <user username="manager" password="manager" roles="tomcat,standard,manager"/>
-Note, before building WSM for the first time, the JSR-173 API JAR file needs to be installed.
-To do this, download the JAR file from here:
+The manager role's default username/password is manager/manager and this is currently
+not configurable. Disclaimer, don't go into production with this role enabled using
+this (rather naive) username/password combination. :)
- http://www.ibiblio.org/maven/xmlbeans/jars/jsr173_1.0_api.jar
-and install it in your local Maven2 repository using this command:
- mvn install:install-file -Dfile=<path-to-jar>/jsr173_1.0_api.jar -DgroupId=xmlbeans -DartifactId=xmlbeans-jsr173-api -Dversion=2.0-dev -Dpackaging=jar
-Together, this might be:
- get http://www.ibiblio.org/maven/xmlbeans/jars/jsr173_1.0_api.jar > jsr173_1.0_api.jar
- mvn install:install-file -Dfile=jsr173_1.0_api.jar -DgroupId=xmlbeans -DartifactId=jsr173_1.0_api -Dversion=1.0 -Dpackaging=jar
\ No newline at end of file
Modified: beehive/wsm/trunk/build.xml
URL: http://svn.apache.org/viewvc/beehive/wsm/trunk/build.xml?rev=426899&r1=426898&r2=426899&view=diff
==============================================================================
--- beehive/wsm/trunk/build.xml (original)
+++ beehive/wsm/trunk/build.xml Sun Jul 30 09:54:33 2006
@@ -370,4 +370,10 @@
<delete file="${schema.jar}"/>
</target>
+ <target name="usage" description="Print the usage for this build.xml">
+ <java fork="no" classname="org.apache.tools.ant.Main">
+ <arg line="-f ${ant.file} -projecthelp"/>
+ </java>
+ </target>
+
</project>
Modified: beehive/wsm/trunk/pom.xml
URL: http://svn.apache.org/viewvc/beehive/wsm/trunk/pom.xml?rev=426899&r1=426898&r2=426899&view=diff
==============================================================================
--- beehive/wsm/trunk/pom.xml (original)
+++ beehive/wsm/trunk/pom.xml Sun Jul 30 09:54:33 2006
@@ -54,13 +54,21 @@
<artifactId>xbean</artifactId>
<version>2.1.0</version>
</dependency>
-<!-- This JAR has disappeared from the Maven2 repository and needs to be downloaded manually.
<dependency>
- <groupId>xmlbeans</groupId>
- <artifactId>xmlbeans-jsr173-api</artifactId>
- <version>2.0-dev</version>
+ <groupId>commons-codec</groupId>
+ <artifactId>commons-codec</artifactId>
+ <version>1.3</version>
</dependency>
--->
+ <dependency>
+ <groupId>stax</groupId>
+ <artifactId>stax-api</artifactId>
+ <version>1.0</version>
+ </dependency>
+ <dependency>
+ <groupId>javax.servlet</groupId>
+ <artifactId>servlet-api</artifactId>
+ <version>2.4</version>
+ </dependency>
<dependency>
<groupId>annogen</groupId>
<artifactId>annogen</artifactId>
Modified: beehive/wsm/trunk/src/beehive-wsm.pom
URL: http://svn.apache.org/viewvc/beehive/wsm/trunk/src/beehive-wsm.pom?rev=426899&r1=426898&r2=426899&view=diff
==============================================================================
--- beehive/wsm/trunk/src/beehive-wsm.pom (original)
+++ beehive/wsm/trunk/src/beehive-wsm.pom Sun Jul 30 09:54:33 2006
@@ -20,8 +20,8 @@
<project>
<modelVersion>4.0.0</modelVersion>
<groupId>org.apache.beehive</groupId>
- <artifactId>beehive-wsdltypes</artifactId>
- <name>beehive-wsdltypes</name>
+ <artifactId>beehive-wsm</artifactId>
+ <name>beehive-wsm</name>
<version>1.0-SNAPSNOT</version>
<dependencies>
<dependency>
Modified: beehive/wsm/trunk/wsm-imports.xml
URL: http://svn.apache.org/viewvc/beehive/wsm/trunk/wsm-imports.xml?rev=426899&r1=426898&r2=426899&view=diff
==============================================================================
--- beehive/wsm/trunk/wsm-imports.xml (original)
+++ beehive/wsm/trunk/wsm-imports.xml Sun Jul 30 09:54:33 2006
@@ -37,7 +37,7 @@
<fileset id="commons-codec.fileset" file="${m2.repo}/commons-codec/commons-codec/1.3/commons-codec-1.3.jar"/>
<fileset id="servlet.fileset" file="${m2.repo}/javax/servlet/servlet-api/2.4/servlet-api-2.4.jar"/>
<fileset id="xbean.fileset" file="${m2.repo}/xmlbeans/xbean/2.1.0/xbean-2.1.0.jar"/>
- <fileset id="jsr173.fileset" file="${m2.repo}/xmlbeans/jsr173_1.0_api/1.0/jsr173_1.0_api-1.0.jar"/>
+ <fileset id="jsr173.fileset" file="${m2.repo}/stax/stax-api/1.0/stax-api-1.0.jar"/>
<fileset id="axis.fileset" file="${m2.repo}/axis/axis/1.3/axis-1.3.jar"/>
<fileset id="axis-jaxrpc.fileset" file="${m2.repo}/axis/axis-jaxrpc/1.3/axis-jaxrpc-1.3.jar"/>