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>