cxf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From gma...@apache.org
Subject svn commit: r1165421 - /cxf/trunk/distribution/src/main/release/samples/README.txt
Date Mon, 05 Sep 2011 21:34:15 GMT
Author: gmazza
Date: Mon Sep  5 21:34:15 2011
New Revision: 1165421

URL: http://svn.apache.org/viewvc?rev=1165421&view=rev
Log:
Updated to give Maven build instructions

Modified:
    cxf/trunk/distribution/src/main/release/samples/README.txt

Modified: cxf/trunk/distribution/src/main/release/samples/README.txt
URL: http://svn.apache.org/viewvc/cxf/trunk/distribution/src/main/release/samples/README.txt?rev=1165421&r1=1165420&r2=1165421&view=diff
==============================================================================
--- cxf/trunk/distribution/src/main/release/samples/README.txt (original)
+++ cxf/trunk/distribution/src/main/release/samples/README.txt Mon Sep  5 21:34:15 2011
@@ -3,14 +3,22 @@ Basic Setup for Building and Running the
 
 As described in the installation notes, extract the Apache CXF
 binary distribution archive into an installation directory
-under the root drive.  This creates the sub-directory cxf,
-which includes all of the product directories.
+under the root drive.  This creates the apache-cxf-x.x.x folder,
+which includes all of the product subdirectories.
 
 To build and run the demos, you must install the J2SE Development
-Kit (JDK) 5.0
+Kit (JDK) 5.0 or later.
 
-If you want to use ant to build and run the demos, you must
-install the Apache ant 1.6 build utility.
+Most of the samples are built using Apache Maven, version 2.2.x or
+later.  You can build the Mavenized samples all at once by running 
+"mvn build install" from the samples root folder or by running
+the same command within individual sample folders.  For running
+each sample, follow the READMEs located in each sample's folder.
+
+A few legacy samples as well as the "antbuild" sample (which
+shows how to manage a project using Ant as the buildtool) are 
+built using Apache Ant, version 1.6 or later.  The below instructions
+are only for building with Apache Ant:
 
 To build and run the demos provided in the Apache CXF binary
 distribution using either ant or wsdl2java, javac and java,
@@ -18,7 +26,7 @@ you need to set the environment so that 
 is on the CLASSPATH and to insure that the JDK, ant and
 CXF_HOME/bin directories are on the PATH.
 
-In each of the demos, source code files for the client and
+For the Ant-based demos, source code files for the client and
 server mainlines and the Service Endpoint Interface class are
 included in the src directory.  The build process will write
 generated code into a new directory, build/src, and then place
@@ -47,15 +55,24 @@ Save a copy of this script in CXF_HOME/s
 script prior to building and running the demos.
 
 
-Building the Demos in a Servlet Container
+Building the Demos in a Servlet Container Using Apache Maven
 =====================================================================
 
-Since Apache CXF requires JDK/JRE 5.0, you must use a servlet container
+"mvn clean install" will generate a WAR file for the servlet-based
+examples.  Either the WAR can be manually copied to your servlet
+container's war deployment directory (webapps by default with Tomcat)
+or the Tomcat Maven Plugin (http://mojo.codehaus.org/tomcat-maven-plugin/) 
+can be used to auto-install the WAR onto Tomcat.
+
+Building the Demos that run in a Servlet Container (Apache Ant only)
+=====================================================================
+
+Since Apache CXF uses JDK/JRE 5.0 or later, you must use a servlet container
 that is compatible with this JDK/JRE.  A suitable servlet container is
 Tomcat 5.5 or above.
 
 Be certain to start the servlet container under an environment in which
-the JAVA_HOME environment variable points to the JDK/JRE 5.0 installation
+the JAVA_HOME environment variable points to the JDK/JRE installation
 and the JAVA_HOME bin directory is included in the system PATH.
 
 Preparing deploy to APACHE TOMCAT
@@ -78,3 +95,5 @@ Deploy the application (Full WAR) into A
 Undeploy the application from the APACHE TOMCAT with the command:
 
   ant undeploy-tomcat
+
+



Mime
View raw message