[riftsaw-commits] riftsaw SVN: r1218 - in dsp/trunk: distribution/src/main/release and 2 other directories.

Author: objectiser Date: 2011-01-07 09:14:44 -0500 (Fri, 07 Jan 2011) New Revision: 1218 Added: dsp/trunk/docs/GettingStarted.txt Removed: dsp/trunk/distribution/src/main/release/samples/ dsp/trunk/docs/GettingStartedForTomcat.txt dsp/trunk/samples/pom.xml Modified: dsp/trunk/distribution/src/main/assembly/bin.xml Log: Changed way the example is distributed and built, to enable environment properties to be changed by the user prior to building the example. Modified: dsp/trunk/distribution/src/main/assembly/bin.xml =================================================================== --- dsp/trunk/distribution/src/main/assembly/bin.xml 2011-01-07 14:13:59 UTC (rev 1217) +++ dsp/trunk/distribution/src/main/assembly/bin.xml 2011-01-07 14:14:44 UTC (rev 1218) @@ -19,37 +19,37 @@ </fileSet> <fileSet> - <directory>src/main/release/samples</directory> - <outputDirectory>/samples</outputDirectory> + <directory>../docs</directory> + <outputDirectory>/docs</outputDirectory> </fileSet> - - <!-- Copy sample deploy war to samples --> + <fileSet> - <directory>../samples/deployer-assembly/target</directory> + <directory>../samples</directory> <outputDirectory>/samples</outputDirectory> - <includes> - <include>dsp-example-deployer.war</include> - </includes> </fileSet> - + </fileSets> <dependencySets> <dependencySet> - <outputDirectory>/samples</outputDirectory> - <includes> - <include>org.jboss.soa.dsp.samples:dsp-example-provider</include> - </includes> - </dependencySet> - - <dependencySet> <outputDirectory>/lib</outputDirectory> <includes> <include>org.jboss.soa.dsp:dsp-api</include> <include>org.jboss.soa.dsp:dsp-jboss</include> <include>org.jboss.soa.dsp:dsp-tomcat</include> + <include>commons-logging:commons-logging</include> + <include>javax.servlet:servlet-api</include> </includes> </dependencySet> + <dependencySet> + <outputDirectory>/samples/example-deployer/deployer/resources/WEB-INF/lib</outputDirectory> + <includes> + <include>commons-fileupload:commons-fileupload</include> + <include>commons-io:commons-io</include> + <include>javassist:javassist</include> + <include>wsdl4j:wsdl4j</include> + </includes> + </dependencySet> </dependencySets> </assembly> Copied: dsp/trunk/docs/GettingStarted.txt (from rev 1213, dsp/trunk/docs/GettingStartedForTomcat.txt) =================================================================== --- dsp/trunk/docs/GettingStarted.txt (rev 0) +++ dsp/trunk/docs/GettingStarted.txt 2011-01-07 14:14:44 UTC (rev 1218) @@ -0,0 +1,56 @@ +Getting Started Guide +===================== + +The Dynamic Service Provider project provides the means to deploy a web service, based on +a WSDL definition, and route requests received on the resulting service to a service provider +implementation. + +This capability is used within RiftSaw to create a web service dynamically, based on a +deployed BPEL process (and accompanying WSDL), and to route web service requests to the +process running in a BPEL engine. + + +Installation Instructions +------------------------- + +Installing on JBoss Application Server: + +The JBoss Application Server does not require any special pre-configuration. The dynamic service +provider capability can be embedded into any other deployable module, as demonstrated by the +$DSP/samples/example-deployer example. + + + +Installing on Apache Tomcat: + +Step 1 - Download and unpack the JAXWS Reference Implementation + +The reference implementation can be found at: http://jax-ws.java.net/. Version 2.2.1 has been used for testing. + +Step 2 - Setup the environment + +Set JAXWS_HOME to the JAXWS Reference Implementation installation folder. +Set CATALINA_HOME to the Apache Tomcat folder. + +Step 3 - Install JAXWS into Tomcat + +Open a command window and change to the JAXWS-RI root folder (JAXWS_HOME). Then run: + + ant install-api + +Step 4 - Copy libraries into Tomcat + +Copy all of the jars from $JAXWS_HOME/lib to $CATALINA_HOME/endorsed (folder created as part of "ant install-api"). + +Copy $CATALINA_HOME/lib/servlet-api.jar to $CATALINA_HOME/endorsed + +Install $DSP/lib/commons-logging-1.1.1.jar into $CATALINA_HOME/lib + +Install $DSP/samples/example-deployer/deployer/resources/WEB-INF/lib/wsdl4j-1.6.2.jar into $CATALINA_HOME/lib + +Install $DSP/lib/dsp-api-<version>.jar into $CATALINA_HOME/lib + + +The environment is now configured to be able to create a deployer (e.g. as a webapp), such as demonstrated +by the $DSP/samples/example-deployer. + Deleted: dsp/trunk/docs/GettingStartedForTomcat.txt =================================================================== --- dsp/trunk/docs/GettingStartedForTomcat.txt 2011-01-07 14:13:59 UTC (rev 1217) +++ dsp/trunk/docs/GettingStartedForTomcat.txt 2011-01-07 14:14:44 UTC (rev 1218) @@ -1,82 +0,0 @@ -Getting Started Guide for Apache Tomcat -======================================= - -Installing ----------- - -Step 1 - Download and unpack the JAXWS Reference Implementation - -The reference implementation can be found at: http://jax-ws.java.net/. Version 2.2.1 has been used for testing. - -Step 2 - Setup the environment - -Set JAXWS_HOME to the JAXWS Reference Implementation installation folder. -Set CATALINA_HOME to the Apache Tomcat folder. - -Step 3 - Install JAXWS into Tomcat - -Open a command window and change to the JAXWS-RI root folder (JAXWS_HOME). Then run: - - ant install-api - -Step 4 - Copy libraries into Tomcat - -Copy all of the jars from $JAXWS_HOME/lib to $CATALINA_HOME/endorsed (folder created as part of "ant install-api"). - -Copy $CATALINA_HOME/lib/servlet-api.jar to $CATALINA_HOME/endorsed - -Install commons-logging-1.1.1.jar (from http://commons.apache.org/logging/) into $CATALINA_HOME/lib - -Install wsdl4j-1.6.2.jar (from http://sourceforge.net/projects/wsdl4j/) into $CATALINA_HOME/lib - -Install dsp-api-<version>.jar (from DSP distribution) into $CATALINA_HOME/lib - - -Deploying and Running the Example ---------------------------------- - -Step 1 - Install the example service provider - -Copy the dsp-example-provider.jar into $CATALINA_HOME/lib - -Step 2 - Start the Apache Tomcat server - -NOTE: Make sure that the CATALINA_HOME environment variable is set correctly before starting the server. - -Step 3 - Install the Example Service Provider's Deployer Web App - -Copy the dsp-example-deployer.war into $CATALINA_HOME/webapps - -Step 4 - Deploy an Example WSDL - -Start a browser and enter the following URL: http://localhost:8080/dsp-example-deployer/ - -When the 'Dynamic Service Provider Example' page is displayed, requesting the web service details, browse to the -hello_world.zip contained in the samples folder. This zip contains a WSDL definition that will be used to provide -the web service implemented using the example dynamic service provider implementation. - -Step 5 - Send a message to the web service - -Using a suitable SOAP client, such as SOAPUI, send the following message to: -http://127.0.0.1:8080/Quickstart_bpel_hello_worldWS/ - -<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wsdl="http://www.jboss.org/bpel/examples/wsdl"> - <soapenv:Header/> - <soapenv:Body> - <wsdl:hello> - <TestPart>Hello World</TestPart> - </wsdl:hello> - </soapenv:Body> -</soapenv:Envelope> - -You should receive the following response: - -<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"> - <SOAP-ENV:Body> - <SOAP-ENV:Fault> - <faultcode xmlns:ns0="http://www.example.org">ns0:ExampleFault</faultcode> - <faultstring>Fault string, and possibly fault code, not set</faultstring> - </SOAP-ENV:Fault> - </SOAP-ENV:Body> -</SOAP-ENV:Envelope> - Deleted: dsp/trunk/samples/pom.xml =================================================================== --- dsp/trunk/samples/pom.xml 2011-01-07 14:13:59 UTC (rev 1217) +++ dsp/trunk/samples/pom.xml 2011-01-07 14:14:44 UTC (rev 1218) @@ -1,23 +0,0 @@ -<?xml version="1.0"?> -<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" - xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> - <modelVersion>4.0.0</modelVersion> - <groupId>org.jboss.soa.dsp</groupId> - <artifactId>samples</artifactId> - <packaging>pom</packaging> - <version>1.0.0-SNAPSHOT</version> - <name>SOA::DSP::Samples</name> - - <parent> - <groupId>org.jboss.soa.dsp</groupId> - <artifactId>dsp</artifactId> - <version>1.0.0-SNAPSHOT</version> - </parent> - - <modules> - <module>provider</module> - <module>deployer</module> - <module>deployer-assembly</module> - </modules> - -</project>