Author: davsclaus
Date: Tue Nov 8 06:41:23 2011
New Revision: 1199123
URL: http://svn.apache.org/viewvc?rev=1199123&view=rev
Log:
CAMEL-4638: Polished examples. Thanks to Glen for the patch.
Modified:
camel/trunk/examples/camel-example-cxf-blueprint/README.txt
camel/trunk/examples/camel-example-cxf-osgi/README.txt
camel/trunk/examples/camel-example-cxf-osgi/pom.xml
camel/trunk/examples/camel-example-cxf-proxy/pom.xml
camel/trunk/examples/camel-example-cxf-tomcat/pom.xml
camel/trunk/examples/camel-example-reportincident/pom.xml
Modified: camel/trunk/examples/camel-example-cxf-blueprint/README.txt
URL:
http://svn.apache.org/viewvc/camel/trunk/examples/camel-example-cxf-blueprint/README.txt?rev=1199123&r1=1199122&r2=1199123&view=diff
==============================================================================
--- camel/trunk/examples/camel-example-cxf-blueprint/README.txt (original)
+++ camel/trunk/examples/camel-example-cxf-blueprint/README.txt Tue Nov 8
06:41:23 2011
@@ -2,81 +2,83 @@ CXF OSGI Example using Blueprint
================================
A simple example which receives web service calls (via a CXF consumer, using
bean binding)
-and write these requests into the file system. It's not a very useful use
case, but the goal
+and writes these requests into the file system. It's not a very useful use
case, but the goal
of this example is to show you how you can use the CXF consumer component in
an OSGI
environment with the OSGI HTTP service. If your target container is Apache
Karaf or Apache
-ServiceMix, you can use PAX Web to setup and start an OSGI HTTP service. All
your Camel
-bundles using a Camel CXF consumer can use this HTTP service and do not have
to start it's
-own Jetty instance. Another possibility you get is, that all your provided
services can share
+ServiceMix, you can use PAX Web to setup and start an OSGI HTTP service. All
Camel
+bundles using a Camel CXF consumer can use this HTTP service without needing
to start
+individual Jetty instances. Another advantage is that all provided services
can now share
the same port.
-
You will need to compile this example first:
mvn install
-
To run the example on Apache ServiceMix 4.x or Apache Karaf 2.x
- 1) launch the server
- karaf.bat
-
- For Karaf 2.2 : edit the file jre.properties to add the following packages
to be exported
- jre-1.6=, \
- com.sun.org.apache.xerces.internal.dom, \
- com.sun.org.apache.xerces.internal.jaxp, \
-
- 2) Add features required
- features:addUrl mvn:org.apache.camel.karaf/apache-camel/2.8.0/xml/features
- features:install war
- features:install cxf
- features:install camel-jaxb
- features:install camel-blueprint
- features:install camel-cxf
-
- Note: In this example we use Apache Camel 2.8.0 as the version. You should
of course use the
- version number of Camel you are using.
-
- 3) Deploy our example
- osgi:install -s mvn:org.apache.camel/camel-example-cxf-blueprint
-
- 4) Verify that your service is available using in the browser the following
url. We assume you
- use the default PAX Web configuration which use the port 8181 for http. If
you would like to use
- another port or https, change the configuration in
${KARAF_HOME}/etc/org.ops4j.pax.web.cfg. Please
- see http://wiki.ops4j.org/display/paxweb/Pax+Web for more information.
-
-
http://localhost:8181/cxf/camel-example-cxf-blueprint/webservices/incident?wsdl
-
- 5) Start SOAPUI
- Create a new project called camel-example-cxf-blueprint
- Point to the following url :
http://localhost:8181/cxf/camel-example-cxf-blueprint/webservices/incident?wsdl
- Open the request 1 (under camel-example-cxf-blueprint -->
ReportIncidentBinding --> ReportIncident) and copy/paste the SOAP
- message generated by the unit test
-
- ex :
- --> and the message formatted that you copy in SOAPUI
+1) launch the server
+ karaf.bat
- <?xml version="1.0" encoding="UTF-8"?>
- <soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/";>
- <soap:Header />
- <soap:Body>
- <ns2:inputReportIncident
xmlns:ns2="http://reportincident.example.camel.apache.org";>
- <incidentId>111</incidentId>
- <incidentDate>2011-03-05</incidentDate>
- <givenName>Christian</givenName>
- <familyName>Mueller</familyName>
- <summary>Bla</summary>
- <details>Bla bla</details>
- <email>[email protected]</email>
- <phone>0049 69 1234567</phone>
- </ns2:inputReportIncident>
- </soap:Body>
- </soap:Envelope>
+Note for Karaf 2.2.x:
+ a) edit the etc/jre.properties file to add the following packages to be
exported
+ jre-1.6=, \
+ com.sun.org.apache.xerces.internal.dom, \
+ com.sun.org.apache.xerces.internal.jaxp, \
+
+ b) from the same file comment out the following exports already provided by
the bundles
+ that will be imported next: javax.xml.bind*, javax.jws*,
javax.xml.soap*, javax.xml.ws*,
+ javax.activation, javax.annotation, javax.xml.stream*.
+
+2) Add features required
+ features:addUrl mvn:org.apache.camel.karaf/apache-camel/2.9.0/xml/features
+ features:install war
+ features:install cxf
+ features:install camel-jaxb
+ features:install camel-blueprint
+ features:install camel-cxf
+
+ Note: Apache Camel 2.9.0 is being used above, but you should of course
change the
+ version number to the exact version of Camel being used.
+
+3) Deploy the example
+ osgi:install -s mvn:org.apache.camel/camel-example-cxf-blueprint
+
+4) Verify that your service is available using the following url in the
browser.
+ We assume you're using Karaf's default PAX Web configuration which uses
+ port 8181 for http. If you would like to use another port or https, change
the configuration in
+ ${KARAF_HOME}/etc/org.ops4j.pax.web.cfg. The immediate extension after the
hostname and port ("cxf" in
+ the below URL) is configured via the org.apache.cxf.osgi.cfg file (Please
see
+ http://team.ops4j.org/wiki//display/paxweb/Pax+Web for more information on
PAX Web).
+
+
http://localhost:8181/cxf/camel-example-cxf-blueprint/webservices/incident?wsdl
+
+5) Start SOAPUI (2.x or later)
+ Create a new project called camel-example-cxf-osgi
+ Point to the following url:
http://localhost:8181/cxf/camel-example-cxf-blueprint/webservices/incident?wsdl
+ Open the request 1 (under camel-example-cxf-blueprint -->
ReportIncidentBinding --> ReportIncident) and copy/paste a SOAP
+ message generated by the unit test, for example:
+
+ <xml version="1.0" encoding="UTF-8"?>
+ <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/";>
+ <soap:Header />
+ <soap:Body>
+ <ns2:inputReportIncident
xmlns:ns2="http://reportincident.example.camel.apache.org";>
+ <incidentId>111</incidentId>
+ <incidentDate>2011-03-05</incidentDate>
+ <givenName>Christian</givenName>
+ <familyName>Mueller</familyName>
+ <summary>Bla</summary>
+ <details>Bla bla</details>
+ <email>[email protected]</email>
+ <phone>0049 69 1234567</phone>
+ </ns2:inputReportIncident>
+ </soap:Body>
+ </soap:Envelope>
- 6) Check the file system
- Check the folder "target/inbox/" in your file system that a message has been
arrived.
+6) Check the file system
+ Check the folder "target/inbox/" in the Karaf base directory to see that a
message has arrived.
-This example is documented at
+This example is described in more detail at
http://camel.apache.org/cxf-example-osgi-blueprint.html
If you hit any problems please let us know on the Camel Forums
@@ -86,7 +88,7 @@ Please help us make Apache Camel better
have. Enjoy!
------------------------
-The Camel riders!
+The Camel Riders!
Modified: camel/trunk/examples/camel-example-cxf-osgi/README.txt
URL:
http://svn.apache.org/viewvc/camel/trunk/examples/camel-example-cxf-osgi/README.txt?rev=1199123&r1=1199122&r2=1199123&view=diff
==============================================================================
--- camel/trunk/examples/camel-example-cxf-osgi/README.txt (original)
+++ camel/trunk/examples/camel-example-cxf-osgi/README.txt Tue Nov 8 06:41:23
2011
@@ -2,14 +2,15 @@ CXF OSGI Example
================
A simple example which receives web service calls (via a CXF consumer, using
bean binding)
-and writes these requests to the file system. It's not a very useful use case,
but the goal
+and writes these requests into the file system. It's not a very useful use
case, but the goal
of this example is to show you how you can use the CXF consumer component in
an OSGI
environment with the OSGI HTTP service. If your target container is Apache
Karaf or Apache
ServiceMix, you can use PAX Web to setup and start an OSGI HTTP service. All
Camel
-bundles using a Camel CXF consumer can use this HTTP service without needing
to start
+bundles using a Camel CXF consumer can use this HTTP service without needing
to start
individual Jetty instances. Another advantage is that all provided services
can now share
the same port.
+
You will need to compile the example first:
mvn install
@@ -52,9 +53,9 @@ osgi:install -s mvn:org.apache.camel/cam
4) Verify that your service is available using the following url in the
browser.
-We assume assuming the OOTB Karaf defaults you use the default PAX Web
configuration which use the port 8181
-for http. If you would like to use another port or https, change the
configuration in
-${KARAF_HOME}/etc/org.ops4j.pax.web.cfg. The immediate extension after the
hostname and port ("services" in
+We assume you're using Karaf's default PAX Web configuration which uses
+port 8181 for http. If you would like to use another port or https, change the
configuration in
+${KARAF_HOME}/etc/org.ops4j.pax.web.cfg. The immediate extension after the
hostname and port ("cxf" in
the below URL) is configured via the org.apache.cxf.osgi.cfg file (Please see
http://team.ops4j.org/wiki//display/paxweb/Pax+Web for more information on PAX
Web).
Modified: camel/trunk/examples/camel-example-cxf-osgi/pom.xml
URL:
http://svn.apache.org/viewvc/camel/trunk/examples/camel-example-cxf-osgi/pom.xml?rev=1199123&r1=1199122&r2=1199123&view=diff
==============================================================================
--- camel/trunk/examples/camel-example-cxf-osgi/pom.xml (original)
+++ camel/trunk/examples/camel-example-cxf-osgi/pom.xml Tue Nov 8 06:41:23 2011
@@ -42,11 +42,6 @@
</dependency>
<dependency>
<groupId>org.apache.cxf</groupId>
- <artifactId>cxf-rt-core</artifactId>
- <version>${cxf-version}</version>
- </dependency>
- <dependency>
- <groupId>org.apache.cxf</groupId>
<artifactId>cxf-rt-frontend-jaxws</artifactId>
<version>${cxf-version}</version>
</dependency>
Modified: camel/trunk/examples/camel-example-cxf-proxy/pom.xml
URL:
http://svn.apache.org/viewvc/camel/trunk/examples/camel-example-cxf-proxy/pom.xml?rev=1199123&r1=1199122&r2=1199123&view=diff
==============================================================================
--- camel/trunk/examples/camel-example-cxf-proxy/pom.xml (original)
+++ camel/trunk/examples/camel-example-cxf-proxy/pom.xml Tue Nov 8 06:41:23
2011
@@ -67,11 +67,6 @@
</dependency>
<!-- cxf -->
- <dependency>
- <groupId>org.apache.cxf</groupId>
- <artifactId>cxf-rt-core</artifactId>
- <version>${cxf-version}</version>
- </dependency>
<!-- used by the real web service -->
<dependency>
<groupId>org.apache.cxf</groupId>
Modified: camel/trunk/examples/camel-example-cxf-tomcat/pom.xml
URL:
http://svn.apache.org/viewvc/camel/trunk/examples/camel-example-cxf-tomcat/pom.xml?rev=1199123&r1=1199122&r2=1199123&view=diff
==============================================================================
--- camel/trunk/examples/camel-example-cxf-tomcat/pom.xml (original)
+++ camel/trunk/examples/camel-example-cxf-tomcat/pom.xml Tue Nov 8 06:41:23
2011
@@ -54,11 +54,6 @@
<!-- cxf -->
<dependency>
<groupId>org.apache.cxf</groupId>
- <artifactId>cxf-rt-core</artifactId>
- <version>${cxf-version}</version>
- </dependency>
- <dependency>
- <groupId>org.apache.cxf</groupId>
<artifactId>cxf-rt-frontend-jaxws</artifactId>
<version>${cxf-version}</version>
</dependency>
Modified: camel/trunk/examples/camel-example-reportincident/pom.xml
URL:
http://svn.apache.org/viewvc/camel/trunk/examples/camel-example-reportincident/pom.xml?rev=1199123&r1=1199122&r2=1199123&view=diff
==============================================================================
--- camel/trunk/examples/camel-example-reportincident/pom.xml (original)
+++ camel/trunk/examples/camel-example-reportincident/pom.xml Tue Nov 8
06:41:23 2011
@@ -76,11 +76,6 @@
<!-- cxf -->
<dependency>
<groupId>org.apache.cxf</groupId>
- <artifactId>cxf-rt-core</artifactId>
- <version>${cxf-version}</version>
- </dependency>
- <dependency>
- <groupId>org.apache.cxf</groupId>
<artifactId>cxf-rt-frontend-jaxws</artifactId>
<version>${cxf-version}</version>
</dependency>
