You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@camel.apache.org by da...@apache.org on 2015/12/10 07:45:45 UTC
[01/16] camel git commit: CAMEL-9337 Add readme.txt to all examples
Repository: camel
Updated Branches:
refs/heads/master 4adf56cda -> 3b7abccea
CAMEL-9337 Add readme.txt to all examples
Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/6f3e00cf
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/6f3e00cf
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/6f3e00cf
Branch: refs/heads/master
Commit: 6f3e00cff5f1d45800b119d20bd097c0d3509456
Parents: a261373
Author: gautric <ga...@redhat.com>
Authored: Wed Dec 9 18:36:30 2015 +0100
Committer: Claus Ibsen <da...@apache.org>
Committed: Thu Dec 10 07:44:57 2015 +0100
----------------------------------------------------------------------
.../camel-example-activemq-tomcat/README.md | 43 ++++++++++++++++++++
.../camel-example-activemq-tomcat/README.txt | 34 ----------------
2 files changed, 43 insertions(+), 34 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/6f3e00cf/examples/camel-example-activemq-tomcat/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-activemq-tomcat/README.md b/examples/camel-example-activemq-tomcat/README.md
new file mode 100644
index 0000000..b2f7719
--- /dev/null
+++ b/examples/camel-example-activemq-tomcat/README.md
@@ -0,0 +1,43 @@
+# Embedded ActiveMQ Broker with Camel running in Apache Tomcat
+
+## Introduction
+This example shows how you can embed Apache ActiveMQ Broker and Camel in a web application, which can run on Apache Tomcat or other web containers.
+
+### Camel component used in this example
+
+* camel-core
+* camel-jms
+* camel-spring
+
+## Build
+
+You will need to build this example first:
+
+ mvn install
+
+Which will create a `.war` file in the target directly.
+
+You can then deploy this `.war` file in any web container such as
+Apache Tomcat, by copying the `.war` file to its `/webapp` directory.
+
+This example embeds ActiveMQ Broker and a Camel application
+which will continuously send a message per second to an inbox queue.
+Then another Camel route will route messages from the inbox
+to the outbox queue.
+
+This example is documented at
+ [http://camel.apache.org/activemq-camel-tomcat.html](http://camel.apache.org/activemq-camel-tomcat.html)
+
+The ActiveMQ broker is configured in the `src/main/resources/broker.xml` file.
+And the Camel application in the `src/main/resources/camel-context.xml` file.
+
+## Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums
+ [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
+------------------------
+The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/6f3e00cf/examples/camel-example-activemq-tomcat/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-activemq-tomcat/README.txt b/examples/camel-example-activemq-tomcat/README.txt
deleted file mode 100644
index e9dbc21..0000000
--- a/examples/camel-example-activemq-tomcat/README.txt
+++ /dev/null
@@ -1,34 +0,0 @@
-Embedded ActiveMQ Broker with Camel running in Apache Tomcat
-============================================================
-
-This example shows how you can embed Apache ActiveMQ Broker
-and Camel in a web application,
-which can run on Apache Tomcat or other web containers.
-
-You will need to build this example first:
- mvn install
-
-Which will create a .war file in the target directly.
-
-You can then deploy this .war file in any web container such as
-Apache Tomcat, by copying the .war file to its /webapp directory.
-
-This example embeds ActiveMQ Broker and a Camel application
-which will continuously send a message per second to an inbox queue.
-Then another Camel route will route messages from the inbox
-to the outbox queue.
-
-This example is documented at
- http://camel.apache.org/activemq-camel-tomcat.html
-
-The ActiveMQ broker is configured in the src/main/resources/broker.xml file.
-And the Camel application in the src/main/resources/camel-context.xml file.
-
-If you hit an problems please let us know on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-Please help us make Apache Camel better - we appreciate any feedback you may
-have. Enjoy!
-
-------------------------
-The Camel riders!
[12/16] camel git commit: CAMEL-9337 Add readme.txt to all examples
Posted by da...@apache.org.
CAMEL-9337 Add readme.txt to all examples
Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/eea1c44d
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/eea1c44d
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/eea1c44d
Branch: refs/heads/master
Commit: eea1c44d001850389c23ecb530fe30733932a434
Parents: f9f54c1
Author: gautric <ga...@redhat.com>
Authored: Wed Dec 9 19:51:54 2015 +0100
Committer: Claus Ibsen <da...@apache.org>
Committed: Thu Dec 10 07:45:00 2015 +0100
----------------------------------------------------------------------
examples/README.md | 25 ++++++++++++
examples/README.txt | 26 -------------
examples/camel-example-gae/README.md | 3 +-
examples/camel-example-gauth/README.md | 14 +++++++
examples/camel-example-gauth/README.txt | 13 -------
examples/camel-example-guice-jms/README.md | 48 ++++++++++++++++++++++++
examples/camel-example-guice-jms/README.txt | 41 --------------------
examples/camel-example-jdbc/README.md | 46 +++++++++++++++++++++++
examples/camel-example-jdbc/README.txt | 43 ---------------------
examples/camel-example-jms-file/README.md | 36 ++++++++++++++++++
examples/camel-example-jms-file/README.txt | 28 --------------
11 files changed, 170 insertions(+), 153 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/eea1c44d/examples/README.md
----------------------------------------------------------------------
diff --git a/examples/README.md b/examples/README.md
new file mode 100644
index 0000000..35a87ac
--- /dev/null
+++ b/examples/README.md
@@ -0,0 +1,25 @@
+# Welcome to the Apache Camel Examples!
+
+### Introduction
+
+This directory contains the various examples for working with Apache
+Camel. The examples can be run using Maven. When using the Maven
+command, Maven will attempt to download the required dependencies from a
+central repository to your local repository.
+View the individual example READMEs for details.
+
+### Documentation
+
+They are described in detail here [http://camel.apache.org/examples.html](http://camel.apache.org/examples.html)
+
+Before you start we recommend you install a recent distribution of Maven, which we use to run our examples [http://maven.apache.org/](http://maven.apache.org/)
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
+------------------------
+The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/eea1c44d/examples/README.txt
----------------------------------------------------------------------
diff --git a/examples/README.txt b/examples/README.txt
deleted file mode 100644
index 2f5677a..0000000
--- a/examples/README.txt
+++ /dev/null
@@ -1,26 +0,0 @@
-Welcome to the Apache Camel Examples!
-=====================================
-
-This directory contains the various examples for working with Apache
-Camel. The examples can be run using Maven. When using the Maven
-command, Maven will attempt to download the required dependencies from a
-central repository to your local repository.
-View the individual example READMEs for details.
-
-They are described in detail here
- http://camel.apache.org/examples.html
-
-Before you start we recommend you install a recent distribution of
-Maven, which we use to run our examples
- http://maven.apache.org/
-
-If you hit any problems please let us know on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-Please help us make Apache Camel better - we appreciate any feedback you
-may have.
-
-Enjoy!
-
-------------------------
-The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/eea1c44d/examples/camel-example-gae/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-gae/README.md b/examples/camel-example-gae/README.md
index df53e02..51fe494 100644
--- a/examples/camel-example-gae/README.md
+++ b/examples/camel-example-gae/README.md
@@ -2,8 +2,7 @@
### Introduction
-Building, deplyoing and running this example is described in detail at
-[http://camel.apache.org/tutorial-for-camel-on-google-app-engine.html](http://camel.apache.org/tutorial-for-camel-on-google-app-engine.html)
+Building, deplyoing and running this example is described in detail at [http://camel.apache.org/tutorial-for-camel-on-google-app-engine.html](http://camel.apache.org/tutorial-for-camel-on-google-app-engine.html)
### Forum, Help, etc
http://git-wip-us.apache.org/repos/asf/camel/blob/eea1c44d/examples/camel-example-gauth/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-gauth/README.md b/examples/camel-example-gauth/README.md
new file mode 100644
index 0000000..9aef762
--- /dev/null
+++ b/examples/camel-example-gauth/README.md
@@ -0,0 +1,14 @@
+# GAuth Example
+
+### Introduction
+Building, deploying and running this example is described in detail at [http://camel.apache.org/tutorial-oauth.html](http://camel.apache.org/tutorial-oauth.html)
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
+------------------------
+The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/eea1c44d/examples/camel-example-gauth/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-gauth/README.txt b/examples/camel-example-gauth/README.txt
deleted file mode 100644
index 7d25b5b..0000000
--- a/examples/camel-example-gauth/README.txt
+++ /dev/null
@@ -1,13 +0,0 @@
-GAuth Example
-=============
-
-Building, deploying and running this example is described in detail at
-http://camel.apache.org/tutorial-oauth.html
-
-Please help us make Apache Camel better - we appreciate any feedback you
-may have.
-
-Enjoy!
-
-------------------------
-The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/eea1c44d/examples/camel-example-guice-jms/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-guice-jms/README.md b/examples/camel-example-guice-jms/README.md
new file mode 100644
index 0000000..860211c
--- /dev/null
+++ b/examples/camel-example-guice-jms/README.md
@@ -0,0 +1,48 @@
+# Guice Example
+
+### Introduction
+
+This example shows how to work with files and JMS, using Guice to boot up
+Camel and configure the routes.
+
+The example consumes messages from a queue and writes them to the file
+system.
+
+### Build
+
+You will need to compile this example first:
+
+ mvn compile
+
+### Run
+
+To run the example type:
+
+ mvn exec:java
+
+Alternatively to run the example you can also make use of the Guice Maven
+Plugin provided by Camel, so you can instead type:
+
+ mvn guice:run
+
+See the POM of this example about how to make use of this Maven Plugin
+
+You can see the routing rules by looking at the java code in the
+`src/main/java directory` and the `guicejndi.properties` file lives in
+`src/main/resources/guicejndi.properties`
+
+To stop the example hit `ctrl + c`
+
+### Documentation
+
+This example is documented at [http://camel.apache.org/guice-jms-example.html](http://camel.apache.org/guice-jms-example.html)
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
+------------------------
+The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/eea1c44d/examples/camel-example-guice-jms/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-guice-jms/README.txt b/examples/camel-example-guice-jms/README.txt
deleted file mode 100644
index 1c71ba8..0000000
--- a/examples/camel-example-guice-jms/README.txt
+++ /dev/null
@@ -1,41 +0,0 @@
-Guice Example
-=============
-
-This example shows how to work with files and JMS, using Guice to boot up
-Camel and configure the routes.
-
-The example consumes messages from a queue and writes them to the file
-system.
-
-You will need to compile this example first:
-
- mvn compile
-
-To run the example type:
-
- mvn exec:java
-
-Alternatively to run the example you can also make use of the Guice Maven
-Plugin provided by Camel, so you can instead type:
-
- mvn guice:run
-
-See the POM of this example about how to make use of this Maven Plugin
-
-You can see the routing rules by looking at the java code in the
-src/main/java directory and the guicejndi.properties file lives in
-src/main/resources/guicejndi.properties
-
-To stop the example hit ctrl + c
-
-This example is documented at
- http://camel.apache.org/guice-jms-example.html
-
-If you hit any problems please talk to us on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-Please help us make Apache Camel better - we appreciate any feedback you
-may have. Enjoy!
-
-------------------------
-The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/eea1c44d/examples/camel-example-jdbc/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-jdbc/README.md b/examples/camel-example-jdbc/README.md
new file mode 100644
index 0000000..72e8bbb
--- /dev/null
+++ b/examples/camel-example-jdbc/README.md
@@ -0,0 +1,46 @@
+# Camel JDBC Example
+
+### Introduction
+
+This example shows how to use camel-jdbc component with an embedded
+Apache Derby database.
+
+### Build
+
+First compile this example:
+
+ mvn compile
+
+### Compile
+
+Now to run the example type
+
+ mvn camel:run
+
+To stop the example hit `ctrl + c`
+
+### Configuration
+
+This example uses Spring to setup and configure the database,
+as well the CamelContext.
+
+You can see this in the following file:
+* `src/main/resources/META-INF/spring/camel-context.xml`
+
+The spring config setups three routes as follow:
+
+* `sample-generator-route`
+ - This route will generate sample data into database upon Camel starts.
+* `query-update-route-part1/query-update-route-part2`
+ - These two are connected together. It first query the database for NEW record to be process, invoke RecordProcess bean to do the work, then update the record as DONE so not to re-process on next polled.
+
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
+------------------------
+The Camel riders!
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/camel/blob/eea1c44d/examples/camel-example-jdbc/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-jdbc/README.txt b/examples/camel-example-jdbc/README.txt
deleted file mode 100644
index 8ddab78..0000000
--- a/examples/camel-example-jdbc/README.txt
+++ /dev/null
@@ -1,43 +0,0 @@
-Camel JDBC Example
-==================
-
-This example shows how to use camel-jdbc component with an embedded
-Apache Derby database.
-
-This example uses Spring to setup and configure the database,
-as well the CamelContext.
-
-You can see this in the following file:
- - src/main/resources/META-INF/spring/camel-context.xml
-
-The spring config setups three routes as follow:
-
- sample-generator-route
- This route will generate sample data into database upon Camel starts.
-
- query-update-route-part1/query-update-route-part2
- These two are connected together. It first query the database for
- NEW record to be process, invoke RecordProcess bean to do the work,
- then update the record as DONE so not to re-process on next polled.
-
-Standalone
-----------
-First compile this example:
- mvn compile
-
-Now to run the example type
- mvn camel:run
-
-To stop the example hit ctrl + c
-
-Help
-----
-
-If you hit any problems please talk to us on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-Please help us make Apache Camel better - we appreciate any feedback you
-may have. Enjoy!
-
-------------------------
-The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/eea1c44d/examples/camel-example-jms-file/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-jms-file/README.md b/examples/camel-example-jms-file/README.md
new file mode 100644
index 0000000..cbceb58
--- /dev/null
+++ b/examples/camel-example-jms-file/README.md
@@ -0,0 +1,36 @@
+# JMS & File Example
+
+### Introduction
+This example shows how to work with files and JMS.
+
+The example consumes messages from a queue and writes them to the file
+system.
+
+### Build
+
+You will need to compile this example first:
+
+ mvn compile
+
+### Run
+
+The example should run if you type
+
+ mvn exec:java -PExample
+
+After the example is complete, then there should be 10 files written
+in the test directory.
+
+### Documentation
+
+This example is documented at [http://camel.apache.org/walk-through-an-example.html](http://camel.apache.org/walk-through-an-example.html)
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
+------------------------
+The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/eea1c44d/examples/camel-example-jms-file/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-jms-file/README.txt b/examples/camel-example-jms-file/README.txt
deleted file mode 100644
index 9ee604b..0000000
--- a/examples/camel-example-jms-file/README.txt
+++ /dev/null
@@ -1,28 +0,0 @@
-JMS & File Example
-==================
-
-This example shows how to work with files and JMS.
-
-The example consumes messages from a queue and writes them to the file
-system.
-
-You will need to compile this example first:
- mvn compile
-
-The example should run if you type
- mvn exec:java -PExample
-
-After the example is complete, then there should be 10 files written
-in the test directory.
-
-This example is documented at
- http://camel.apache.org/walk-through-an-example.html
-
-If you hit an problems please let us know on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-Please help us make Apache Camel better - we appreciate any feedback you may
-have. Enjoy!
-
-------------------------
-The Camel riders!
[04/16] camel git commit: CAMEL-9337 Add readme.txt to all examples
Posted by da...@apache.org.
CAMEL-9337 Add readme.txt to all examples
Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/0364ff4a
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/0364ff4a
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/0364ff4a
Branch: refs/heads/master
Commit: 0364ff4a46b9bf5f58137828f0d0046e6d0378ac
Parents: e2ad607
Author: gautric <ga...@redhat.com>
Authored: Wed Dec 9 18:51:46 2015 +0100
Committer: Claus Ibsen <da...@apache.org>
Committed: Thu Dec 10 07:44:58 2015 +0100
----------------------------------------------------------------------
examples/camel-example-bam/README.md | 46 ++++++++++++++++++
examples/camel-example-bam/README.txt | 46 ------------------
examples/camel-example-box-osgi/README.md | 63 +++++++++++++++++++++++++
examples/camel-example-box-osgi/README.txt | 38 ---------------
4 files changed, 109 insertions(+), 84 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/0364ff4a/examples/camel-example-bam/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-bam/README.md b/examples/camel-example-bam/README.md
new file mode 100644
index 0000000..1c10542
--- /dev/null
+++ b/examples/camel-example-bam/README.md
@@ -0,0 +1,46 @@
+# Camel BAM Example
+
+## Introduction
+
+This example shows how to perform Business Activity Monitoring (BAM)
+with Camel.
+
+### Camel component used in this example
+
+* camel-bam
+* camel-jaxb
+* camel-juel
+
+## Build
+
+You will need to compile this example first:
+ mvn compile
+
+For a background in BAM see
+ http://camel.apache.org/bam.html
+
+## Run
+
+To run the example with Maven, type
+ mvn camel:run
+
+You can see the BAM activies defined in
+ src/main/java/org/apache/camel/example/bam/MyActivites.java
+
+To stop the example hit ctrl + c
+
+## Documentation
+
+This example is documented at
+ http://camel.apache.org/bam-example.html
+
+## Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums
+ [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
+------------------------
+The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/0364ff4a/examples/camel-example-bam/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-bam/README.txt b/examples/camel-example-bam/README.txt
deleted file mode 100644
index 1c10542..0000000
--- a/examples/camel-example-bam/README.txt
+++ /dev/null
@@ -1,46 +0,0 @@
-# Camel BAM Example
-
-## Introduction
-
-This example shows how to perform Business Activity Monitoring (BAM)
-with Camel.
-
-### Camel component used in this example
-
-* camel-bam
-* camel-jaxb
-* camel-juel
-
-## Build
-
-You will need to compile this example first:
- mvn compile
-
-For a background in BAM see
- http://camel.apache.org/bam.html
-
-## Run
-
-To run the example with Maven, type
- mvn camel:run
-
-You can see the BAM activies defined in
- src/main/java/org/apache/camel/example/bam/MyActivites.java
-
-To stop the example hit ctrl + c
-
-## Documentation
-
-This example is documented at
- http://camel.apache.org/bam-example.html
-
-## Forum, Help, etc
-
-If you hit an problems please let us know on the Camel Forums
- [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
-
-Please help us make Apache Camel better - we appreciate any feedback you may
-have. Enjoy!
-
-------------------------
-The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/0364ff4a/examples/camel-example-box-osgi/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-box-osgi/README.md b/examples/camel-example-box-osgi/README.md
new file mode 100644
index 0000000..2820f5b
--- /dev/null
+++ b/examples/camel-example-box-osgi/README.md
@@ -0,0 +1,63 @@
+# Box.com OSGi Example
+
+## Introduction
+
+A simple example which sets up a camel route to upload files
+found in an `inbox` directory to a box.com account.
+
+
+## Build
+
+First you will need to compile the example:
+ mvn install
+
+## Run
+
+To run the example on Apache Karaf 2.3.x
+
+## Step 1
+
+Launch karaf
+
+## Step 2
+
+Add features required
+
+ features:addUrl mvn:org.apache.camel.karaf/apache-camel/${version}/xml/features
+ features:install camel-spring
+ features:install camel-box
+
+## Step 3
+
+Create a `box.properties` file in the Karaf base directory with the following properties
+set to your box account credentials.
+
+ box.userName=
+ box.userPassword=
+ box.clientId=
+ box.clientSecret=
+
+## Step 4
+
+Deploy the example
+
+ osgi:install -s mvn:org.apache.camel/camel-example-box-osgi/${version}
+
+## Step 5
+
+Copy files to the `inbox` directory in the Karaf base directory.
+
+## Step 6
+
+Watch them get transferred to your box.com account.
+
+## Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums
+ [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
+------------------------
+The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/0364ff4a/examples/camel-example-box-osgi/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-box-osgi/README.txt b/examples/camel-example-box-osgi/README.txt
deleted file mode 100644
index 90004c5..0000000
--- a/examples/camel-example-box-osgi/README.txt
+++ /dev/null
@@ -1,38 +0,0 @@
-Box.com OSGi Example
-====================
-
-A simple example which sets up a camel route to upload files
-found in an `inbox` directory to a box.com account.
-
-First you will need to compile the example:
- mvn install
-
-To run the example on Apache Karaf 2.3.x
-
-1) launch karaf
-
-2) Add features required
-features:addUrl mvn:org.apache.camel.karaf/apache-camel/${version}/xml/features
-features:install camel-spring
-features:install camel-box
-
-3) Create a `box.properties` file in the Karaf base directory with the following properties
-set to your box account credentials.
-
- box.userName=
- box.userPassword=
- box.clientId=
- box.clientSecret=
-
-3) Deploy the example
-osgi:install -s mvn:org.apache.camel/camel-example-box-osgi/${version}
-
-4) Copy files to the `inbox` directory in the Karaf base directory.
-
-5) Watch them get transferred to your box.com account.
-
-Please help us make Apache Camel better - we appreciate any feedback you may
-have. Enjoy!
-
-------------------------
-The Camel Riders!
[15/16] camel git commit: CAMEL-9337 Add readme.txt to all examples
Posted by da...@apache.org.
CAMEL-9337 Add readme.txt to all examples
Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/9d82e261
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/9d82e261
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/9d82e261
Branch: refs/heads/master
Commit: 9d82e2619a5fde840725735f61efd78934685ea8
Parents: 6f51fb0
Author: gautric <ga...@redhat.com>
Authored: Wed Dec 9 19:39:29 2015 +0100
Committer: Claus Ibsen <da...@apache.org>
Committed: Thu Dec 10 07:45:00 2015 +0100
----------------------------------------------------------------------
examples/camel-example-cxf-proxy/README.md | 2 ++
1 file changed, 2 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/9d82e261/examples/camel-example-cxf-proxy/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-cxf-proxy/README.md b/examples/camel-example-cxf-proxy/README.md
index e1c9f37..bd16e37 100644
--- a/examples/camel-example-cxf-proxy/README.md
+++ b/examples/camel-example-cxf-proxy/README.md
@@ -49,6 +49,8 @@ Then make SOAP requests of this format:
</soapenv:Body>
</soapenv:Envelope>
+### Documentation
+
This example is documented at [http://camel.apache.org/cxf-proxy-example.html](http://camel.apache.org/cxf-proxy-example.html)
### Forum, Help, etc
[16/16] camel git commit: CAMEL-9337 Add readme.txt to all examples
Posted by da...@apache.org.
CAMEL-9337 Add readme.txt to all examples
Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/3b7abcce
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/3b7abcce
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/3b7abcce
Branch: refs/heads/master
Commit: 3b7abcceaf547c5e2e3eda40dfa39b254ff2a0fb
Parents: eea1c44
Author: gautric <ga...@redhat.com>
Authored: Wed Dec 9 22:10:34 2015 +0100
Committer: Claus Ibsen <da...@apache.org>
Committed: Thu Dec 10 07:45:01 2015 +0100
----------------------------------------------------------------------
examples/README.md | 6 +-
examples/camel-example-jmx/README.md | 39 ++++++++++
examples/camel-example-jmx/README.txt | 32 --------
examples/camel-example-loadbalancing/README.md | 55 ++++++++++++++
examples/camel-example-loadbalancing/README.txt | 50 -------------
examples/camel-example-loan-broker/README.md | 41 +++++++++++
examples/camel-example-loan-broker/README.txt | 34 ---------
examples/camel-example-management/README.md | 77 ++++++++++++++++++++
examples/camel-example-management/README.txt | 69 ------------------
examples/camel-example-mybatis/README.md | 53 ++++++++++++++
examples/camel-example-mybatis/README.txt | 44 -----------
examples/camel-example-netty-http/README.md | 68 +++++++++++++++++
examples/camel-example-netty-http/README.txt | 55 --------------
examples/camel-example-osgi-rmi/README.md | 51 +++++++++++++
examples/camel-example-osgi-rmi/README.txt | 39 ----------
examples/camel-example-osgi/README.md | 45 ++++++++++++
examples/camel-example-osgi/README.txt | 46 ------------
17 files changed, 432 insertions(+), 372 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/3b7abcce/examples/README.md
----------------------------------------------------------------------
diff --git a/examples/README.md b/examples/README.md
index 35a87ac..d8d65a3 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -10,13 +10,13 @@ View the individual example READMEs for details.
### Documentation
-They are described in detail here [http://camel.apache.org/examples.html](http://camel.apache.org/examples.html)
+They are described in detail here <http://camel.apache.org/examples.html>
-Before you start we recommend you install a recent distribution of Maven, which we use to run our examples [http://maven.apache.org/](http://maven.apache.org/)
+Before you start we recommend you install a recent distribution of Maven, which we use to run our examples <http://maven.apache.org/>
### Forum, Help, etc
-If you hit an problems please let us know on the Camel Forums [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
+If you hit an problems please let us know on the Camel Forums <http://camel.apache.org/discussion-forums.html>
Please help us make Apache Camel better - we appreciate any feedback you may
have. Enjoy!
http://git-wip-us.apache.org/repos/asf/camel/blob/3b7abcce/examples/camel-example-jmx/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-jmx/README.md b/examples/camel-example-jmx/README.md
new file mode 100644
index 0000000..fde6edf
--- /dev/null
+++ b/examples/camel-example-jmx/README.md
@@ -0,0 +1,39 @@
+# JMX Example
+
+### Introduction
+
+This example shows how to work with the Camel-JMX component.
+
+The example creates a simple MBean, registers a route to listen for
+notification events on that bean and creates another route that calls
+the MBean.
+
+### Build
+
+You will need to compile this example first:
+
+ mvn compile
+
+### Compile
+
+To run the example type
+
+ mvn camel:run
+
+You can see the routing rules by looking at the java code in the
+`src/main/java` directory and the Spring XML configuration lives in
+`src/main/resources/META-INF/spring`
+
+To stop the example hit `ctrl + c`
+
+### Documentation
+
+This example is documented at [http://camel.apache.org/jmx-component-example.html](http://camel.apache.org/jmx-component-example.html)
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
http://git-wip-us.apache.org/repos/asf/camel/blob/3b7abcce/examples/camel-example-jmx/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-jmx/README.txt b/examples/camel-example-jmx/README.txt
deleted file mode 100644
index 23cdc7b..0000000
--- a/examples/camel-example-jmx/README.txt
+++ /dev/null
@@ -1,32 +0,0 @@
-JMX Example
-===========
-
-This example shows how to work with the Camel-JMX component.
-
-The example creates a simple MBean, registers a route to listen for
-notification events on that bean and creates another route that calls
-the MBean.
-
-You will need to compile this example first:
- mvn compile
-
-To run the example type
- mvn camel:run
-
-You can see the routing rules by looking at the java code in the
-src/main/java directory and the Spring XML configuration lives in
-src/main/resources/META-INF/spring
-
-To stop the example hit ctrl + c
-
-This example is documented at
- http://camel.apache.org/jmx-component-example.html
-
-If you hit any problems please talk to us on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-Please help us make Apache Camel better - we appreciate any feedback you
-may have. Enjoy!
-
-------------------------
-The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/3b7abcce/examples/camel-example-loadbalancing/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-loadbalancing/README.md b/examples/camel-example-loadbalancing/README.md
new file mode 100644
index 0000000..a4f1bba
--- /dev/null
+++ b/examples/camel-example-loadbalancing/README.md
@@ -0,0 +1,55 @@
+# Load balancing with MINA Example
+
+
+### Introduction
+
+This example shows how you can easily use the Camel-MINA component to design a solution
+allowing for distributing message workload onto several servers.
+These servers are simple TCP/IP servers created by the Apache MINA framework and run in
+separate JVMs. The load balancer pattern of Camel which is used on top of them allows for
+sending in Round Robin mode the messages created from a Camel Bean component
+alternatively between each server running on localhost:9991 and localhost:9992.
+
+Within this demo every ten seconds, a Report object is created from the Camel load balancer server.
+This object is sent by the Camel load balancer to a MINA server where the object is then serialized.
+One of the two MINA servers (localhost:9991 and localhost:9992) receives the object and enriches
+the message by setting the field reply of the Report object. The reply is sent back by the MINA
+server to the client, which then logs the reply on the console.
+
+If any of the two MINA servers is not running, then the load balancer will automatic failover
+to the next server.
+
+### Build
+
+To compile and install the project in your maven repo, execute the following
+command on the root of the project
+
+ mvn clean install
+
+### Run
+
+To run the example, then execute the following command in the respective folder:
+
+>mina1
+
+ mvn exec:java -Pmina1
+
+>mina2
+
+ mvn exec:java -Pmina2
+
+>loadbalancing
+
+ mvn exec:java -Ploadbalancer
+
+### Documentation
+
+This example is documented at
+ <http://camel.apache.org/loadbalancing-mina-example.html>
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums <http://camel.apache.org/discussion-forums.html>
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
http://git-wip-us.apache.org/repos/asf/camel/blob/3b7abcce/examples/camel-example-loadbalancing/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-loadbalancing/README.txt b/examples/camel-example-loadbalancing/README.txt
deleted file mode 100644
index bb48641..0000000
--- a/examples/camel-example-loadbalancing/README.txt
+++ /dev/null
@@ -1,50 +0,0 @@
-Load balancing with MINA Example
-================================
-
-This example shows how you can easily use the Camel-MINA component to design a solution
-allowing for distributing message workload onto several servers.
-These servers are simple TCP/IP servers created by the Apache MINA framework and run in
-separate JVMs. The load balancer pattern of Camel which is used on top of them allows for
-sending in Round Robin mode the messages created from a Camel Bean component
-alternatively between each server running on localhost:9991 and localhost:9992.
-
-Within this demo every ten seconds, a Report object is created from the Camel load balancer server.
-This object is sent by the Camel load balancer to a MINA server where the object is then serialized.
-One of the two MINA servers (localhost:9991 and localhost:9992) receives the object and enriches
-the message by setting the field reply of the Report object. The reply is sent back by the MINA
-server to the client, which then logs the reply on the console.
-
-If any of the two MINA servers is not running, then the load balancer will automatic failover
-to the next server.
-
-Running the example
-===================
-
-To compile and install the project in your maven repo, execute the following
-command on the root of the project
-
-mvn clean install
-
-To run the example, then execute the following command in the respective folder:
-
->mina1
-mvn exec:java -Pmina1
-
->mina2
-mvn exec:java -Pmina2
-
->loadbalancing
-mvn exec:java -Ploadbalancer
-
-
-This example is documented at
- http://camel.apache.org/loadbalancing-mina-example.html
-
-If you hit any problems please let us know on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-Please help us make Apache Camel better - we appreciate any feedback you may
-have. Enjoy!
-
-------------------------
-The Camel Riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/3b7abcce/examples/camel-example-loan-broker/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-loan-broker/README.md b/examples/camel-example-loan-broker/README.md
new file mode 100644
index 0000000..9b77a84
--- /dev/null
+++ b/examples/camel-example-loan-broker/README.md
@@ -0,0 +1,41 @@
+# Loan Broker Example
+
+### Introduction
+This example shows how to use Camel to implement the EIP's loan broker example,
+from the EIP book (http://www.enterpriseintegrationpatterns.com/SystemManagementExample.html).
+
+The example has two versions (JMS queues, and web services),
+that uses a different transport for exchanging messages between
+the client, credit agency, and the banks.
+
+### Build
+
+You will need to compile this example first:
+
+ mvn compile
+
+### Run
+
+The example of JMS queue version should run if you type
+
+ mvn exec:java -PQueue.LoanBroker
+ mvn exec:java -PQueue.Client
+
+The example of web services version
+
+ mvn exec:java -PWS.LoanBroker
+ mvn exec:java -PWS.Client
+
+To stop the example hit `ctrl + c`
+
+### Documentation
+
+This example is documented at
+ <http://camel.apache.org/loan-broker-example.html>
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums <http://camel.apache.org/discussion-forums.html>
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
http://git-wip-us.apache.org/repos/asf/camel/blob/3b7abcce/examples/camel-example-loan-broker/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-loan-broker/README.txt b/examples/camel-example-loan-broker/README.txt
deleted file mode 100644
index 37727c6..0000000
--- a/examples/camel-example-loan-broker/README.txt
+++ /dev/null
@@ -1,34 +0,0 @@
-Loan Broker Example
-====================
-
-This example shows how to use Camel to implement the EIP's loan broker example,
-from the EIP book (http://www.enterpriseintegrationpatterns.com/SystemManagementExample.html).
-
-The example has two versions (JMS queues, and web services),
-that uses a different transport for exchanging messages between
-the client, credit agency, and the banks.
-
-You will need to compile this example first:
- mvn compile
-
-The example of JMS queue version should run if you type
- mvn exec:java -PQueue.LoanBroker
- mvn exec:java -PQueue.Client
-
-The example of web services version
- mvn exec:java -PWS.LoanBroker
- mvn exec:java -PWS.Client
-
-To stop the example hit ctrl + c
-
-This example is documented at
- http://camel.apache.org/loan-broker-example.html
-
-If you hit an problems please let us know on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-Please help us make Apache Camel better - we appreciate any feedback you may
-have. Enjoy!
-
-------------------------
-The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/3b7abcce/examples/camel-example-management/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-management/README.md b/examples/camel-example-management/README.md
new file mode 100644
index 0000000..d4a3656
--- /dev/null
+++ b/examples/camel-example-management/README.md
@@ -0,0 +1,77 @@
+# Camel JMX Management
+
+### Introduction
+
+This example shows how to manage Camel using JMX (with jconsole)
+
+The example uses a timer to every 5th second to generate a file with 100 stock quotes.
+
+Another route uses a file consumer to read the files and split the file and send every single
+stock quote to a JMS queue.
+
+Then a third route consumes from this JMS queue and simulate a little CPU heavy work (by delaying)
+before the data is transformed and logged. The logger will log the progress by logging how
+long time it takes to process 100 messages.
+
+Now the idea is to use the Camel JMX management to be able to adjust this during runtime.
+What it allows you to do is to improve the performance of this example.
+
+At first there is a throttler that will throttle how fast Camel sends message to the JMS queue.
+For starters you can change this at runtime from the default 10 msg/sec to 500 msg/sec etc.
+This is done by changing the JMX attribute maximumRequestsPerPeriod on the throttler in the /producer group.
+
+The next issue is that the JMS consumer now cannot catch up and you should see that the number of messages
+on the JMS queue grows a little by little. You can find the queue from the ActiveMQ mbean and drill down under /queues.
+
+If this goes a bit to slow you can increase the first route in Camel to produce files faster. This is done by
+changing the period in the timer endpoint from 5000 to let say 2000. Before this takes effect you have to
+restart the timer consumer. So find the timer consumer and invoke the stop and start JMX operation.
+
+Now you should see the messages start to pile up in the JMS queue.
+What we do next is to increase the number of concurrent consumers. To do that you have to set this on the JMS
+endpoint. Set the concurrentConsumers from 1 to 20. And just as the timer consumer this only takes effect when
+the JMS consumer is restarted. So do a stop and start operation.
+
+What you should see is that Camel should be able to process the files much faster now and the logger should
+output a higher throughput.
+
+### Build
+
+You will need to compile this example first:
+
+ mvn compile
+
+
+### Run
+
+To run the example type
+
+ mvn camel:run
+
+To use jconsole type
+
+ jconsole
+
+And you should be able to see a process id in the connect to agent tab.
+If its there then click in and you should be connected to the Camel application.
+If its missing you can click on the advanced tab and type in JMX URL:
+ `service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi/camel`
+ (some older versions of Java does not list the local processes)
+
+You can see the routing rules by looking at the java code in the
+`src/main/java directory` and the Spring XML configuration lives in
+`src/main/resources/META-INF/spring`
+
+To stop the example hit `ctrl + c`
+
+### Documentation
+
+This example is documented at
+ <http://camel.apache.org/management-example.html>
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums <http://camel.apache.org/discussion-forums.html>
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
http://git-wip-us.apache.org/repos/asf/camel/blob/3b7abcce/examples/camel-example-management/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-management/README.txt b/examples/camel-example-management/README.txt
deleted file mode 100644
index a748d77..0000000
--- a/examples/camel-example-management/README.txt
+++ /dev/null
@@ -1,69 +0,0 @@
-Camel JMX Management
-====================
-
-This example shows how to manage Camel using JMX (with jconsole)
-
-The example uses a timer to every 5th second to generate a file with 100 stock quotes.
-
-Another route uses a file consumer to read the files and split the file and send every single
-stock quote to a JMS queue.
-
-Then a third route consumes from this JMS queue and simulate a little CPU heavy work (by delaying)
-before the data is transformed and logged. The logger will log the progress by logging how
-long time it takes to process 100 messages.
-
-Now the idea is to use the Camel JMX management to be able to adjust this during runtime.
-What it allows you to do is to improve the performance of this example.
-
-At first there is a throttler that will throttle how fast Camel sends message to the JMS queue.
-For starters you can change this at runtime from the default 10 msg/sec to 500 msg/sec etc.
-This is done by changing the JMX attribute maximumRequestsPerPeriod on the throttler in the /producer group.
-
-The next issue is that the JMS consumer now cannot catch up and you should see that the number of messages
-on the JMS queue grows a little by little. You can find the queue from the ActiveMQ mbean and drill down under /queues.
-
-If this goes a bit to slow you can increase the first route in Camel to produce files faster. This is done by
-changing the period in the timer endpoint from 5000 to let say 2000. Before this takes effect you have to
-restart the timer consumer. So find the timer consumer and invoke the stop and start JMX operation.
-
-Now you should see the messages start to pile up in the JMS queue.
-What we do next is to increase the number of concurrent consumers. To do that you have to set this on the JMS
-endpoint. Set the concurrentConsumers from 1 to 20. And just as the timer consumer this only takes effect when
-the JMS consumer is restarted. So do a stop and start operation.
-
-What you should see is that Camel should be able to process the files much faster now and the logger should
-output a higher throughput.
-
-You will need to compile this example first:
- mvn compile
-
-To run the example type
- mvn camel:run
-
-To use jconsole type
- jconsole
-
-And you should be able to see a process id in the connect to agent tab.
-If its there then click in and you should be connected to the Camel application.
-If its missing you can click on the advanced tab and type in JMX URL:
- service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi/camel
- (some older versions of Java does not list the local processes)
-
-You can see the routing rules by looking at the java code in the
-src/main/java directory and the Spring XML configuration lives in
-src/main/resources/META-INF/spring
-
-To stop the example hit ctrl + c
-
-
-This example is documented at
- http://camel.apache.org/management-example.html
-
-If you hit any problems please talk to us on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-Please help us make Apache Camel better - we appreciate any feedback you
-may have. Enjoy!
-
-------------------------
-The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/3b7abcce/examples/camel-example-mybatis/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-mybatis/README.md b/examples/camel-example-mybatis/README.md
new file mode 100644
index 0000000..4d1b461
--- /dev/null
+++ b/examples/camel-example-mybatis/README.md
@@ -0,0 +1,53 @@
+# Camel MyBatis Example
+
+### Introduction
+
+This example shows how to exchange data using a shared database table.
+
+The example has two Camel routes. The first route insert new data into the table,
+triggered by a timer to run every 5th second.
+
+The second route pickup the newly inserted rows from the table,
+process the row(s), and mark the row(s) as processed when done;
+to avoid picking up the same rows again.
+
+### Build
+
+You will need to install this example first to your local maven repository with:
+
+ mvn install
+
+### Run
+
+This example requires running in Apache Karaf / ServiceMix
+
+You can install this example from the shell using this example's `features.xml`
+for easy provisioning.
+
+ features:addUrl mvn:org.apache.camel/camel-example-mybatis/${version}/xml/features
+ features:install camel-example-mybatis
+
+And you can see the application running by tailing the logs
+
+ log:tail
+
+And you can use `ctrl + c` to stop tailing the log.
+
+### Configuration
+
+This example uses OSGi Blueprint to setup and configure the database,
+as well the CamelContext. You can see this in the following file:
+In the `src/main/resources/OSGI-INF/blueprint/camel-mybatis.xml`
+
+
+### Documentation
+
+This example is documented at
+ <http://camel.apache.org/mybatis-example.html>
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums <http://camel.apache.org/discussion-forums.html>
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
http://git-wip-us.apache.org/repos/asf/camel/blob/3b7abcce/examples/camel-example-mybatis/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-mybatis/README.txt b/examples/camel-example-mybatis/README.txt
deleted file mode 100644
index e7dd342..0000000
--- a/examples/camel-example-mybatis/README.txt
+++ /dev/null
@@ -1,44 +0,0 @@
-Camel MyBatis Example
-=====================
-
-This example shows how to exchange data using a shared database table.
-
-The example has two Camel routes. The first route insert new data into the table,
-triggered by a timer to run every 5th second.
-
-The second route pickup the newly inserted rows from the table,
-process the row(s), and mark the row(s) as processed when done;
-to avoid picking up the same rows again.
-
-You will need to install this example first to your local maven repository with:
- mvn install
-
-This example requires running in Apache Karaf / ServiceMix
-
-You can install this example from the shell using this example's "features.xml"
-for easy provisioning.
-
- features:addUrl mvn:org.apache.camel/camel-example-mybatis/${version}/xml/features
- features:install camel-example-mybatis
-
-And you can see the application running by tailing the logs
-
- log:tail
-
-And you can use ctrl + c to stop tailing the log.
-
-This example uses OSGi Blueprint to setup and configure the database,
-as well the CamelContext. You can see this in the following file:
-In the src/main/resources/OSGI-INF/blueprint/camel-mybatis.xml
-
-This example is documented at
- http://camel.apache.org/mybatis-example.html
-
-If you hit any problems please talk to us on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-Please help us make Apache Camel better - we appreciate any feedback you
-may have. Enjoy!
-
-------------------------
-The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/3b7abcce/examples/camel-example-netty-http/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-netty-http/README.md b/examples/camel-example-netty-http/README.md
new file mode 100644
index 0000000..72ecf55
--- /dev/null
+++ b/examples/camel-example-netty-http/README.md
@@ -0,0 +1,68 @@
+# Camel Netty HTTP Server Example
+
+### Introduction
+
+This example shows how to use a shared Netty HTTP Server in an OSGi environment.
+
+There is 3 modules in this example
+
+* shared-netty-http-server - The Shared Netty HTTP server that the other Camel applications uses.
+* myapp-one - A Camel application that reuses the shared Netty HTTP server
+* myapp-two - A Camel application that reuses the shared Netty HTTP server
+
+
+### Build
+
+You will need to compile and prepared this example first:
+
+ mvn install
+
+### Run
+
+
+This example requires running in Apache Karaf / ServiceMix
+
+To install Apache Camel in Karaf you type in the shell (we use version 2.12.0):
+
+ features:chooseurl camel 2.12.0
+ features:install camel
+
+First you need to install the following features in Karaf/ServiceMix with:
+
+ features:install camel-netty-http
+
+Then you can install the shared Netty HTTP server which by default runs on port `8888`.
+The port number can be changed by editing the following source file:
+
+ `shared-netty-http-server/src/main/resources/OSGI-INF/blueprint/http-server.xml`
+
+In the Apache Karaf / ServiceMix shell type:
+
+ osgi:install -s mvn:org.apache.camel/camel-example-netty-http-shared/2.12.0
+
+Then you can install the Camel applications:
+
+ osgi:install -s mvn:org.apache.camel/camel-example-netty-myapp-one/2.12.0
+ osgi:install -s mvn:org.apache.camel/camel-example-netty-myapp-two/2.12.0
+
+From a web browser you can then try the example by accessing the followign URLs:
+
+<http://localhost:8888/one>
+
+<http://localhost:8888/two>
+
+This example is documented at
+ http://camel.apache.org/netty-http-server-example.html
+
+### Documentation
+
+This example is documented at
+ <http://camel.apache.org/netty-http-server-example.htmll>
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums <http://camel.apache.org/discussion-forums.html>
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
http://git-wip-us.apache.org/repos/asf/camel/blob/3b7abcce/examples/camel-example-netty-http/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-netty-http/README.txt b/examples/camel-example-netty-http/README.txt
deleted file mode 100644
index 580e2b8..0000000
--- a/examples/camel-example-netty-http/README.txt
+++ /dev/null
@@ -1,55 +0,0 @@
-Camel Netty HTTP Server Example
-===============================
-
-This example shows how to use a shared Netty HTTP Server in an OSGi environment.
-
-There is 3 modules in this example
-
-* shared-netty-http-server - The Shared Netty HTTP server that the other Camel applications uses.
-* myapp-one - A Camel application that reuses the shared Netty HTTP server
-* myapp-two - A Camel application that reuses the shared Netty HTTP server
-
-You will need to compile and prepared this example first:
- mvn install
-
-This example requires running in Apache Karaf / ServiceMix
-
-To install Apache Camel in Karaf you type in the shell (we use version 2.12.0):
-
- features:chooseurl camel 2.12.0
- features:install camel
-
-First you need to install the following features in Karaf/ServiceMix with:
-
- features:install camel-netty-http
-
-Then you can install the shared Netty HTTP server which by default runs on port 8888.
-The port number can be changed by editing the following source file:
-
- shared-netty-http-server/src/main/resources/OSGI-INF/blueprint/http-server.xml
-
-In the Apache Karaf / ServiceMix shell type:
-
- osgi:install -s mvn:org.apache.camel/camel-example-netty-http-shared/2.12.0
-
-Then you can install the Camel applications:
-
- osgi:install -s mvn:org.apache.camel/camel-example-netty-myapp-one/2.12.0
- osgi:install -s mvn:org.apache.camel/camel-example-netty-myapp-two/2.12.0
-
-From a web browser you can then try the example by accessing the followign URLs:
-
- http://localhost:8888/one
- http://localhost:8888/two
-
-This example is documented at
- http://camel.apache.org/netty-http-server-example.html
-
-If you hit any problems please talk to us on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-Please help us make Apache Camel better - we appreciate any feedback you
-may have. Enjoy!
-
-------------------------
-The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/3b7abcce/examples/camel-example-osgi-rmi/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-osgi-rmi/README.md b/examples/camel-example-osgi-rmi/README.md
new file mode 100644
index 0000000..7ba2ace
--- /dev/null
+++ b/examples/camel-example-osgi-rmi/README.md
@@ -0,0 +1,51 @@
+# Camel and RMI
+
+### Introduction
+
+This example shows how to work with the Camel-RMI Component.
+
+The example exposes a RMI service over port `37541` running as a Camel application.
+The Camel application must be running.
+
+The Client is standalone and run in a separate JVM. It invokes the RMI service and outputs the reply.
+
+### Build
+
+You will need to compile this example first:
+
+ mvn install
+
+### Run from cmd line outside OSGi container
+
+To start the server
+
+ mvn camel:run
+
+To run the client
+
+ mvn exec:java -PClient
+
+To stop the example hit `ctrl + c`
+
+
+### Run inside OSGi container
+
+If using Apache Karaf / Apache ServiceMix you can install this example
+from the shell
+
+First the camel-rmi feature must be installed
+
+ features:chooseurl camel ${version}
+ features:install camel-rmi
+
+Then install the example
+
+ osgi:install -s mvn:org.apache.camel/camel-example-osgi-rmi/${version}
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums <http://camel.apache.org/discussion-forums.html>
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
http://git-wip-us.apache.org/repos/asf/camel/blob/3b7abcce/examples/camel-example-osgi-rmi/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-osgi-rmi/README.txt b/examples/camel-example-osgi-rmi/README.txt
deleted file mode 100644
index 6290c7f..0000000
--- a/examples/camel-example-osgi-rmi/README.txt
+++ /dev/null
@@ -1,39 +0,0 @@
-Camel and RMI
-=============
-
-This example shows how to work with the Camel-RMI Component.
-
-The example exposes a RMI service over port 37541 running as a Camel application.
-The Camel application must be running.
-
-The Client is standalone and run in a separate JVM. It invokes the RMI service and outputs the reply.
-
-You will need to compile this example first:
- mvn compile
-
-To start the server
- mvn camel:run
-
-To run the client
- mvn exec:java -PClient
-
-To stop the example hit ctrl + c
-
-If using Apache Karaf / Apache ServiceMix you can install this example
-from the shell
-
-First the camel-rmi feature must be installed
- features:chooseurl camel ${version}
- features:install camel-rmi
-
-Then install the example
- osgi:install -s mvn:org.apache.camel/camel-example-osgi-rmi/${version}
-
-If you hit an problems please let us know on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-Please help us make Apache Camel better - we appreciate any feedback you may
-have. Enjoy!
-
-------------------------
-The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/3b7abcce/examples/camel-example-osgi/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-osgi/README.md b/examples/camel-example-osgi/README.md
new file mode 100644
index 0000000..76113aa
--- /dev/null
+++ b/examples/camel-example-osgi/README.md
@@ -0,0 +1,45 @@
+# OSGi Example
+
+### Introduction
+
+This example shows how use OSGi with Camel. It can be run using Maven.
+
+### Build
+You will need to compile this example first:
+
+ mvn install
+
+### Run from cmd line outside OSGi container
+To run the example using Maven type
+
+ mvn camel:run
+
+To stop the example hit `ctrl + c`
+
+### Run inside OSGi container
+You will need to compile and install this example first:
+
+ mvn install
+
+If using Apache Karaf / Apache ServiceMix you can install this example
+from the shell using this example's "features.xml" for easy provisioning.
+
+ features:addUrl mvn:org.apache.camel/camel-example-osgi/${version}/xml/features
+ features:install camel-example-osgi
+
+The example outputs to the log, which you can see using
+
+ log:display
+
+... or you can tail the log with
+
+ log:tail
+
+And use `ctrl+c` to break the tail.
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums <http://camel.apache.org/discussion-forums.html>
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
http://git-wip-us.apache.org/repos/asf/camel/blob/3b7abcce/examples/camel-example-osgi/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-osgi/README.txt b/examples/camel-example-osgi/README.txt
deleted file mode 100644
index d3071e1..0000000
--- a/examples/camel-example-osgi/README.txt
+++ /dev/null
@@ -1,46 +0,0 @@
-OSGi Example
-=====================
-
-This example shows how use OSGi with Camel. It can be run using Maven.
-
-Running from cmd line outside OSGi container
-============================================
-
-You will need to compile this example first:
- mvn compile
-
-To run the example using Maven type
- mvn camel:run
-
-To stop the example hit ctrl + c
-
-Running inside OSGi container
-=============================
-
-You will need to compile and install this example first:
- mvn install
-
-If using Apache Karaf / Apache ServiceMix you can install this example
-from the shell using this example's "features.xml" for easy provisioning.
-
- features:addUrl mvn:org.apache.camel/camel-example-osgi/${version}/xml/features
- features:install camel-example-osgi
-
-The example outputs to the log, which you can see using
-
- log:display
-
-... or you can tail the log with
-
- log:tail
-
-And use ctrl+c to break the tail.
-
-If you hit any problems please let us know on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-Please help us make Apache Camel better - we appreciate any feedback you
-may have. Enjoy!
-
-------------------------
-The Camel riders!
[14/16] camel git commit: CAMEL-9337 Add readme.txt to all examples
Posted by da...@apache.org.
CAMEL-9337 Add readme.txt to all examples
Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/6f51fb0d
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/6f51fb0d
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/6f51fb0d
Branch: refs/heads/master
Commit: 6f51fb0d4fd2af42369e423428df22925f12e5dd
Parents: 8502575
Author: gautric <ga...@redhat.com>
Authored: Wed Dec 9 19:39:14 2015 +0100
Committer: Claus Ibsen <da...@apache.org>
Committed: Thu Dec 10 07:45:00 2015 +0100
----------------------------------------------------------------------
examples/camel-example-etl/README.md | 65 ++++++++++++++++++++++++++++++
examples/camel-example-etl/README.txt | 47 ---------------------
2 files changed, 65 insertions(+), 47 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/6f51fb0d/examples/camel-example-etl/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-etl/README.md b/examples/camel-example-etl/README.md
new file mode 100644
index 0000000..ba742f1
--- /dev/null
+++ b/examples/camel-example-etl/README.md
@@ -0,0 +1,65 @@
+# Extract Transform Load (ETL) Example
+
+### Introduction
+
+This example shows how to use Camel as an ETL tool
+ [http://camel.apache.org/etl.html](http://camel.apache.org/etl.html)
+
+### Build
+
+You will need to compile this example first:
+
+ mvn compile
+
+### Run
+
+To run the example type
+
+ mvn camel:run
+
+You can see the routing rules by looking at the java code in the src/main/java
+directory and the Spring XML configuration lives in
+ `src/main/resources/META-INF/spring`
+
+To stop the example hit `ctrl + c`
+
+### Build and Run inside OSGi container
+
+
+#### Build
+
+You will need to compile and install this example first:
+
+ mvn install
+
+#### Install
+
+If using Apache Karaf / Apache ServiceMix you can install this example
+from the shell using this example's "features.xml" for easy provisioning.
+
+ features:addUrl mvn:org.apache.camel/camel-example-etl/${version}/xml/features
+ features:install camel-example-etl
+
+The example outputs logs into the console. When you're done just hit `ctrl + d` to exit the container.
+Next time you start the container again use the 'clean' option so that this example's bundle gets
+removed and you don't see the logs anymore written into the console, e.g. in case of Karaf start it
+again using:
+
+ karaf clean
+
+### Documentation
+
+For a full description of this example please see
+ [http://camel.apache.org/etl-example.html](http://camel.apache.org/etl-example.html)
+
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums
+ [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
+------------------------
+The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/6f51fb0d/examples/camel-example-etl/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-etl/README.txt b/examples/camel-example-etl/README.txt
deleted file mode 100644
index 1378a9e..0000000
--- a/examples/camel-example-etl/README.txt
+++ /dev/null
@@ -1,47 +0,0 @@
-Extract Transform Load (ETL) Example
-====================================
-
-This example shows how to use Camel as an ETL tool
- http://camel.apache.org/etl.html
-
-For a full description of this example please see
- http://camel.apache.org/etl-example.html
-
-You will need to compile this example first:
- mvn compile
-
-To run the example type
- mvn camel:run
-
-You can see the routing rules by looking at the java code in the src/main/java
-directory and the Spring XML configuration lives in
- src/main/resources/META-INF/spring
-
-To stop the example hit ctrl + c
-
-Running inside OSGi container
-=============================
-
-You will need to compile and install this example first:
- mvn install
-
-If using Apache Karaf / Apache ServiceMix you can install this example
-from the shell using this example's "features.xml" for easy provisioning.
-
- features:addUrl mvn:org.apache.camel/camel-example-etl/${version}/xml/features
- features:install camel-example-etl
-
-The example outputs logs into the console. When you're done just hit ctrl + d to exit the container.
-Next time you start the container again use the 'clean' option so that this example's bundle gets
-removed and you don't see the logs anymore written into the console, e.g. in case of Karaf start it
-again using:
- karaf clean
-
-If you hit any problems please let us know on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-Please help us make Apache Camel better - we appreciate any feedback you may
-have. Enjoy!
-
-------------------------
-The Camel riders!
[06/16] camel git commit: CAMEL-9337 Add readme.txt to all examples
Posted by da...@apache.org.
CAMEL-9337 Add readme.txt to all examples
Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/e2ad607c
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/e2ad607c
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/e2ad607c
Branch: refs/heads/master
Commit: e2ad607c99fb4122c3479fa381921b6d25fce6b4
Parents: 5c34a31
Author: gautric <ga...@redhat.com>
Authored: Wed Dec 9 18:47:24 2015 +0100
Committer: Claus Ibsen <da...@apache.org>
Committed: Thu Dec 10 07:44:58 2015 +0100
----------------------------------------------------------------------
examples/camel-example-bam/README.txt | 23 +++++++++++++++++++----
1 file changed, 19 insertions(+), 4 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/e2ad607c/examples/camel-example-bam/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-bam/README.txt b/examples/camel-example-bam/README.txt
index 2cacb3e..1c10542 100644
--- a/examples/camel-example-bam/README.txt
+++ b/examples/camel-example-bam/README.txt
@@ -1,15 +1,26 @@
-BAM Example
-===========
+# Camel BAM Example
+
+## Introduction
This example shows how to perform Business Activity Monitoring (BAM)
with Camel.
+### Camel component used in this example
+
+* camel-bam
+* camel-jaxb
+* camel-juel
+
+## Build
+
You will need to compile this example first:
mvn compile
For a background in BAM see
http://camel.apache.org/bam.html
+## Run
+
To run the example with Maven, type
mvn camel:run
@@ -18,11 +29,15 @@ You can see the BAM activies defined in
To stop the example hit ctrl + c
+## Documentation
+
This example is documented at
http://camel.apache.org/bam-example.html
-If you hit any problems please let us know on the Camel Forums
- http://camel.apache.org/discussion-forums.html
+## Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums
+ [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
Please help us make Apache Camel better - we appreciate any feedback you may
have. Enjoy!
[07/16] camel git commit: CAMEL-9337 Add readme.txt to all examples
Posted by da...@apache.org.
CAMEL-9337 Add readme.txt to all examples
Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/8569f2cb
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/8569f2cb
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/8569f2cb
Branch: refs/heads/master
Commit: 8569f2cb9a9b2c65bac7e473ba6fca35589da53b
Parents: 0364ff4
Author: gautric <ga...@redhat.com>
Authored: Wed Dec 9 18:58:57 2015 +0100
Committer: Claus Ibsen <da...@apache.org>
Committed: Thu Dec 10 07:44:58 2015 +0100
----------------------------------------------------------------------
.../camel-example-activemq-tomcat/README.md | 14 ++++++------
examples/camel-example-aggregate/README.md | 12 +++++-----
examples/camel-example-bam/README.md | 12 +++++-----
examples/camel-example-box-osgi/README.md | 24 ++++++++++++--------
4 files changed, 33 insertions(+), 29 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/8569f2cb/examples/camel-example-activemq-tomcat/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-activemq-tomcat/README.md b/examples/camel-example-activemq-tomcat/README.md
index 0739898..315a962 100644
--- a/examples/camel-example-activemq-tomcat/README.md
+++ b/examples/camel-example-activemq-tomcat/README.md
@@ -1,21 +1,21 @@
# Embedded ActiveMQ Broker with Camel running in Apache Tomcat
-## Introduction
+### Introduction
This example shows how you can embed Apache ActiveMQ Broker and Camel in a web application, which can run on Apache Tomcat or other web containers.
-### Camel component used in this example
+#### Camel component used in this example
* camel-core
* camel-jms
* camel-spring
-## Build
+### Build
You will need to build this example first:
mvn install
-## Run
+### Run
Which will create a `.war` file in the target directly.
@@ -27,17 +27,17 @@ which will continuously send a message per second to an inbox queue.
Then another Camel route will route messages from the inbox
to the outbox queue.
-## Configuration
+### Configuration
The ActiveMQ broker is configured in the `src/main/resources/broker.xml` file.
And the Camel application in the `src/main/resources/camel-context.xml` file.
-## Documentation
+### Documentation
This example is documented at
[http://camel.apache.org/activemq-camel-tomcat.html](http://camel.apache.org/activemq-camel-tomcat.html)
-## Forum, Help, etc
+### Forum, Help, etc
If you hit an problems please let us know on the Camel Forums
[http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
http://git-wip-us.apache.org/repos/asf/camel/blob/8569f2cb/examples/camel-example-aggregate/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-aggregate/README.md b/examples/camel-example-aggregate/README.md
index 1518d76..3ef3c65 100644
--- a/examples/camel-example-aggregate/README.md
+++ b/examples/camel-example-aggregate/README.md
@@ -1,6 +1,6 @@
# Camel Persistent Aggregate
-## Introduction
+### Introduction
This example shows how to use Camel Aggregator EIP which offers (since Camel 2.3)
database persistence.
@@ -9,21 +9,21 @@ It's an interactive example where you can type in some numbers which then are ag
(summed, per this sample's aggregation strategy) whenever the user types STOP.
The user can then enter more numbers to do another aggregation.
-### Camel component used in this example
+#### Camel component used in this example
* camel-core
* camel-hawtdb
* camel-spring
* camel-stream
-## Build
+### Build
The example is run using Maven.
First compile the example by entering:
mvn compile
-## Run
+### Run
To run the example type:
mvn camel:run
@@ -32,12 +32,12 @@ To stop the example hit Ctrl-C. If you restart it and resume entering numbers
you should see that it remembered previously entered values, as it
uses a persistent store.
-## Documentation
+### Documentation
This example is documented at
[http://camel.apache.org/aggregate-example.html](http://camel.apache.org/aggregate-example.html)
-## Forum, Help, etc
+### Forum, Help, etc
If you hit an problems please let us know on the Camel Forums
[http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
http://git-wip-us.apache.org/repos/asf/camel/blob/8569f2cb/examples/camel-example-bam/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-bam/README.md b/examples/camel-example-bam/README.md
index 1c10542..5bff285 100644
--- a/examples/camel-example-bam/README.md
+++ b/examples/camel-example-bam/README.md
@@ -1,17 +1,17 @@
# Camel BAM Example
-## Introduction
+### Introduction
This example shows how to perform Business Activity Monitoring (BAM)
with Camel.
-### Camel component used in this example
+#### Camel component used in this example
* camel-bam
* camel-jaxb
* camel-juel
-## Build
+### Build
You will need to compile this example first:
mvn compile
@@ -19,7 +19,7 @@ You will need to compile this example first:
For a background in BAM see
http://camel.apache.org/bam.html
-## Run
+### Run
To run the example with Maven, type
mvn camel:run
@@ -29,12 +29,12 @@ You can see the BAM activies defined in
To stop the example hit ctrl + c
-## Documentation
+### Documentation
This example is documented at
http://camel.apache.org/bam-example.html
-## Forum, Help, etc
+### Forum, Help, etc
If you hit an problems please let us know on the Camel Forums
[http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
http://git-wip-us.apache.org/repos/asf/camel/blob/8569f2cb/examples/camel-example-box-osgi/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-box-osgi/README.md b/examples/camel-example-box-osgi/README.md
index 2820f5b..803af9d 100644
--- a/examples/camel-example-box-osgi/README.md
+++ b/examples/camel-example-box-osgi/README.md
@@ -1,25 +1,29 @@
# Box.com OSGi Example
-## Introduction
+### Introduction
A simple example which sets up a camel route to upload files
found in an `inbox` directory to a box.com account.
+#### Camel component used in this example
-## Build
+* camel-code
+* camel-bom
+
+### Build
First you will need to compile the example:
mvn install
-## Run
+### Run
To run the example on Apache Karaf 2.3.x
-## Step 1
+#### Step 1
Launch karaf
-## Step 2
+#### Step 2
Add features required
@@ -27,7 +31,7 @@ Add features required
features:install camel-spring
features:install camel-box
-## Step 3
+#### Step 3
Create a `box.properties` file in the Karaf base directory with the following properties
set to your box account credentials.
@@ -37,21 +41,21 @@ set to your box account credentials.
box.clientId=
box.clientSecret=
-## Step 4
+#### Step 4
Deploy the example
osgi:install -s mvn:org.apache.camel/camel-example-box-osgi/${version}
-## Step 5
+#### Step 5
Copy files to the `inbox` directory in the Karaf base directory.
-## Step 6
+#### Step 6
Watch them get transferred to your box.com account.
-## Forum, Help, etc
+### Forum, Help, etc
If you hit an problems please let us know on the Camel Forums
[http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
[09/16] camel git commit: CAMEL-9337 Add readme.txt to all examples
Posted by da...@apache.org.
CAMEL-9337 Add readme.txt to all examples
Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/85025756
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/85025756
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/85025756
Branch: refs/heads/master
Commit: 85025756fc526448f4f1697926c8e5cbec4db78d
Parents: 403089f
Author: gautric <ga...@redhat.com>
Authored: Wed Dec 9 19:36:43 2015 +0100
Committer: Claus Ibsen <da...@apache.org>
Committed: Thu Dec 10 07:44:59 2015 +0100
----------------------------------------------------------------------
examples/camel-example-cxf-tomcat/README.md | 71 +++++++++++++++++++++++
examples/camel-example-cxf-tomcat/README.txt | 60 -------------------
2 files changed, 71 insertions(+), 60 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/85025756/examples/camel-example-cxf-tomcat/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-cxf-tomcat/README.md b/examples/camel-example-cxf-tomcat/README.md
new file mode 100644
index 0000000..b2e4abe
--- /dev/null
+++ b/examples/camel-example-cxf-tomcat/README.md
@@ -0,0 +1,71 @@
+# Camel CXF (code first) and Apache Tomcat example
+
+### Introduction
+An example which uses code-first to expose a web service in Camel running on Apache Tomcat.
+
+
+### Build
+It can be run using Maven.
+
+You will need to first need to build the example:
+
+ mvn clean install
+
+### Run
+
+To run the example deploy it in Apache Tomcat by copying the .war located
+in the target directory to the deploy folder of Apache Tomcat. Alternatively,
+if your Tomcat installation is set up to use the Tomcat Maven plugin
+([http://mojo.codehaus.org/tomcat-maven-plugin/usage.html](http://mojo.codehaus.org/tomcat-maven-plugin/usage.html)), you can simply
+run `mvn tomcat:deploy` (also `tomcat:undeploy`, `tomcat:redeploy`, etc.)
+to install the WAR file.
+
+The webservice is located at
+
+ [http://localhost:8080/camel-example-cxf-tomcat/webservices/incident?wsdl](http://localhost:8080/camel-example-cxf-tomcat/webservices/incident?wsdl)
+
+You can run a sample client using the "mvn exec:java" command, or, within
+soapUI, making sample SOAP requests such as the following:
+
+ <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
+ <soap:Body>
+ <ns1:reportIncident xmlns:ns1="http://incident.cxf.example.camel.apache.org/">
+ <arg0>
+ <details>blah blah</details>
+ <email>davsclaus@apache.org</email>
+ <familyName>Smith</familyName>
+ <givenName>Bob</givenName>
+ <incidentDate>2011-11-25</incidentDate>
+ <incidentId>123</incidentId>
+ <phone>123-456-7890</phone>
+ <summary>blah blah summary</summary>
+ </arg0>
+ </ns1:reportIncident>
+ </soap:Body>
+ </soap:Envelope>
+
+ <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
+ <soap:Body>
+ <ns1:statusIncident xmlns:ns1="http://incident.cxf.example.camel.apache.org/">
+ <arg0>
+ <incidentId>456</incidentId>
+ </arg0>
+ </ns1:statusIncident>
+ </soap:Body>
+ </soap:Envelope>
+
+### Documentation
+
+This example is further documented at
+ [http://camel.apache.org/cxf-tomcat-example.html](http://camel.apache.org/cxf-tomcat-example.html)
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums
+ [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
+------------------------
+The Camel riders!
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/camel/blob/85025756/examples/camel-example-cxf-tomcat/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-cxf-tomcat/README.txt b/examples/camel-example-cxf-tomcat/README.txt
deleted file mode 100644
index 271e10b..0000000
--- a/examples/camel-example-cxf-tomcat/README.txt
+++ /dev/null
@@ -1,60 +0,0 @@
-Camel CXF (code first) and Apache Tomcat example
-================================================
-An example which uses code-first to expose a web service in Camel running on Apache Tomcat.
-
-It can be run using Maven.
-
-You will need to first need to build the example:
- mvn clean install
-
-To run the example deploy it in Apache Tomcat by copying the .war located
-in the target directory to the deploy folder of Apache Tomcat. Alternatively,
-if your Tomcat installation is set up to use the Tomcat Maven plugin
-(http://mojo.codehaus.org/tomcat-maven-plugin/usage.html), you can simply
-run "mvn tomcat:deploy" (also "tomcat:undeploy", "tomcat:redeploy", etc.)
-to install the WAR file.
-
-The webservice is located at
- http://localhost:8080/camel-example-cxf-tomcat/webservices/incident?wsdl
-
-You can run a sample client using the "mvn exec:java" command, or, within
-soapUI, making sample SOAP requests such as the following:
-
-<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
- <soap:Body>
- <ns1:reportIncident xmlns:ns1="http://incident.cxf.example.camel.apache.org/">
- <arg0>
- <details>blah blah</details>
- <email>davsclaus@apache.org</email>
- <familyName>Smith</familyName>
- <givenName>Bob</givenName>
- <incidentDate>2011-11-25</incidentDate>
- <incidentId>123</incidentId>
- <phone>123-456-7890</phone>
- <summary>blah blah summary</summary>
- </arg0>
- </ns1:reportIncident>
- </soap:Body>
-</soap:Envelope>
-
-<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
- <soap:Body>
- <ns1:statusIncident xmlns:ns1="http://incident.cxf.example.camel.apache.org/">
- <arg0>
- <incidentId>456</incidentId>
- </arg0>
- </ns1:statusIncident>
- </soap:Body>
-</soap:Envelope>
-
-This example is further documented at
- http://camel.apache.org/cxf-tomcat-example.html
-
-If you hit any problems please let us know on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-Please help us make Apache Camel better - we appreciate any feedback you may
-have. Enjoy!
-
-------------------------
-The Camel Riders!
[13/16] camel git commit: CAMEL-9337 Add readme.txt to all examples
Posted by da...@apache.org.
CAMEL-9337 Add readme.txt to all examples
Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/f9f54c10
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/f9f54c10
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/f9f54c10
Branch: refs/heads/master
Commit: f9f54c10c89c989f87a0c74070f489d0f16b4c68
Parents: 9d82e26
Author: gautric <ga...@redhat.com>
Authored: Wed Dec 9 19:40:04 2015 +0100
Committer: Claus Ibsen <da...@apache.org>
Committed: Thu Dec 10 07:45:00 2015 +0100
----------------------------------------------------------------------
examples/camel-example-cxf-blueprint/README.md | 4 +-
examples/camel-example-cxf-osgi/README.md | 5 +-
examples/camel-example-cxf-proxy/README.md | 14 ++++--
examples/camel-example-cxf-tomcat/README.md | 4 +-
examples/camel-example-ftp/README.md | 54 +++++++++++++++++++++
examples/camel-example-ftp/README.txt | 42 ----------------
examples/camel-example-gae/README.md | 16 ++++++
examples/camel-example-gae/README.txt | 13 -----
8 files changed, 90 insertions(+), 62 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/f9f54c10/examples/camel-example-cxf-blueprint/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-cxf-blueprint/README.md b/examples/camel-example-cxf-blueprint/README.md
index 21d907e..ae14ea7 100644
--- a/examples/camel-example-cxf-blueprint/README.md
+++ b/examples/camel-example-cxf-blueprint/README.md
@@ -46,7 +46,9 @@ Deploy the example
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](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](http://localhost:8181/cxf/camel-example-cxf-blueprint/webservices/incident?wsdl)
+ http://localhost:8181/cxf/camel-example-cxf-blueprint/webservices/incident?wsdl
+
+[http://localhost:8181/cxf/camel-example-cxf-blueprint/webservices/incident?wsdl](http://localhost:8181/cxf/camel-example-cxf-blueprint/webservices/incident?wsdl)
#### Step 5: Start SOAPUI (2.x or later)
http://git-wip-us.apache.org/repos/asf/camel/blob/f9f54c10/examples/camel-example-cxf-osgi/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-cxf-osgi/README.md b/examples/camel-example-cxf-osgi/README.md
index 383c254..3853c15 100644
--- a/examples/camel-example-cxf-osgi/README.md
+++ b/examples/camel-example-cxf-osgi/README.md
@@ -1,5 +1,4 @@
# CXF OSGI Example
-================
### Introduction
@@ -63,7 +62,9 @@ port `8181` for http. If you would like to use another port or https, change the
the below URL) is configured via the org.apache.cxf.osgi.cfg file (Please see
[http://team.ops4j.org/wiki//display/paxweb/Pax+Web](http://team.ops4j.org/wiki//display/paxweb/Pax+Web) for more information on PAX Web).
- [http://localhost:8181/cxf/camel-example-cxf-osgi/webservices/incident?wsdl](http://localhost:8181/cxf/camel-example-cxf-osgi/webservices/incident?wsdl)
+ http://localhost:8181/cxf/camel-example-cxf-osgi/webservices/incident?wsdl
+
+[http://localhost:8181/cxf/camel-example-cxf-osgi/webservices/incident?wsdl](http://localhost:8181/cxf/camel-example-cxf-osgi/webservices/incident?wsdl)
#### Step 5: Start SOAPUI (2.x or later)
http://git-wip-us.apache.org/repos/asf/camel/blob/f9f54c10/examples/camel-example-cxf-proxy/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-cxf-proxy/README.md b/examples/camel-example-cxf-proxy/README.md
index bd16e37..66daca1 100644
--- a/examples/camel-example-cxf-proxy/README.md
+++ b/examples/camel-example-cxf-proxy/README.md
@@ -17,13 +17,21 @@ To run the example type:
The proxied webservice is located at
- [http://localhost:<port 1>/camel-example-cxf-proxy/webservices/incident](http://localhost:<port 1>/camel-example-cxf-proxy/webservices/incident)
+ http://localhost:<port 1>/camel-example-cxf-proxy/webservices/incident
+
+[http://localhost:<port 1>/camel-example-cxf-proxy/webservices/incident](http://localhost:<port 1>/camel-example-cxf-proxy/webservices/incident)
The real webservice is located at
- [http://localhost:<port 2>/real-webservice](http://localhost:<port 2>/real-webservice)
+
+ http://localhost:<port 2>/real-webservice
+
+[http://localhost:<port 2>/real-webservice](http://localhost:<port 2>/real-webservice)
The webservice WSDL is exposed at:
- [http://localhost:<port 1>/camel-example-cxf-proxy/webservices/incident?wsdl](http://localhost:<port 1>/camel-example-cxf-proxy/webservices/incident?wsdl)
+
+ http://localhost:<port 1>/camel-example-cxf-proxy/webservices/incident?wsdl
+
+[http://localhost:<port 1>/camel-example-cxf-proxy/webservices/incident?wsdl](http://localhost:<port 1>/camel-example-cxf-proxy/webservices/incident?wsdl)
Because we use dynamic port numbers, you have to check the console to get the used one.
To stop the example hit `ctrl + c`
http://git-wip-us.apache.org/repos/asf/camel/blob/f9f54c10/examples/camel-example-cxf-tomcat/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-cxf-tomcat/README.md b/examples/camel-example-cxf-tomcat/README.md
index b2e4abe..ca99a9b 100644
--- a/examples/camel-example-cxf-tomcat/README.md
+++ b/examples/camel-example-cxf-tomcat/README.md
@@ -22,7 +22,9 @@ to install the WAR file.
The webservice is located at
- [http://localhost:8080/camel-example-cxf-tomcat/webservices/incident?wsdl](http://localhost:8080/camel-example-cxf-tomcat/webservices/incident?wsdl)
+ http://localhost:8080/camel-example-cxf-tomcat/webservices/incident?wsdl
+
+[http://localhost:8080/camel-example-cxf-tomcat/webservices/incident?wsdl](http://localhost:8080/camel-example-cxf-tomcat/webservices/incident?wsdl)
You can run a sample client using the "mvn exec:java" command, or, within
soapUI, making sample SOAP requests such as the following:
http://git-wip-us.apache.org/repos/asf/camel/blob/f9f54c10/examples/camel-example-ftp/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-ftp/README.md b/examples/camel-example-ftp/README.md
new file mode 100644
index 0000000..c5be626
--- /dev/null
+++ b/examples/camel-example-ftp/README.md
@@ -0,0 +1,54 @@
+# Camel FTP example
+
+### Introduction
+
+An example which shows how to integrate Camel with an FTP server.
+
+This example requires that an existing FTP server is available.
+You can configure the location of this FTP server in the file:
+ `src/main/resources/ftp.properties`
+
+### Build
+
+You will need to compile this example first:
+
+ mvn compile
+
+### Run
+
+This example can either run as a Camel client or server.
+
+* The client will upload files from the `target/upload` directory
+ to the FTP server.
+
+* The server will download files from the FTP server to the local
+ file system in the `target/download` directory.
+
+To run the client you type:
+
+ mvn compile exec:java -Pclient
+
+... and instructions will be printed on the console.
+
+To run the server you type:
+
+ mvn compile exec:java -Pserver
+
+... and instructions will be printed on the console.
+
+
+### Documentation
+
+This example is documented at [http://camel.apache.org/ftp-example.html](http://camel.apache.org/ftp-example.html)
+
+You can enable verbose logging by adjustung the `src/main/resources/log4j.properties` file as documented in the file.
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
+------------------------
+The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/f9f54c10/examples/camel-example-ftp/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-ftp/README.txt b/examples/camel-example-ftp/README.txt
deleted file mode 100644
index f9d09cf..0000000
--- a/examples/camel-example-ftp/README.txt
+++ /dev/null
@@ -1,42 +0,0 @@
-Camel FTP example
-=================
-
-An example which shows how to integrate Camel with an FTP server.
-
-This example requires that an existing FTP server is available.
-You can configure the location of this FTP server in the file:
- src/main/resources/ftp.properties
-
-You will need to compile this example first:
- mvn compile
-
-This example can either run as a Camel client or server.
-
-* The client will upload files from the target/upload directory
- to the FTP server.
-
-* The server will download files from the FTP server to the local
- file system in the target/download directory.
-
-To run the client you type:
- mvn compile exec:java -Pclient
-... and instructions will be printed on the console.
-
-To run the server you type:
- mvn compile exec:java -Pserver
-... and instructions will be printed on the console.
-
-This example is documented at
- http://camel.apache.org/ftp-example.html
-
-You can enable verbose logging by adjustung the src/main/resources/log4j.properties
- file as documented in the file.
-
-If you hit any problems please let us know on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-Please help us make Apache Camel better - we appreciate any feedback you may
-have. Enjoy!
-
-------------------------
-The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/f9f54c10/examples/camel-example-gae/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-gae/README.md b/examples/camel-example-gae/README.md
new file mode 100644
index 0000000..df53e02
--- /dev/null
+++ b/examples/camel-example-gae/README.md
@@ -0,0 +1,16 @@
+# GAE Example
+
+### Introduction
+
+Building, deplyoing and running this example is described in detail at
+[http://camel.apache.org/tutorial-for-camel-on-google-app-engine.html](http://camel.apache.org/tutorial-for-camel-on-google-app-engine.html)
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
+------------------------
+The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/f9f54c10/examples/camel-example-gae/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-gae/README.txt b/examples/camel-example-gae/README.txt
deleted file mode 100644
index e33312e..0000000
--- a/examples/camel-example-gae/README.txt
+++ /dev/null
@@ -1,13 +0,0 @@
-GAE Example
-===========
-
-Building, deplyoing and running this example is described in detail at
-http://camel.apache.org/tutorial-for-camel-on-google-app-engine.html
-
-Please help us make Apache Camel better - we appreciate any feedback you
-may have.
-
-Enjoy!
-
-------------------------
-The Camel riders!
[02/16] camel git commit: [CAMEL-9404] Create .MD Readme for top
folder
Posted by da...@apache.org.
[CAMEL-9404] Create .MD Readme for top folder
Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/a261373e
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/a261373e
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/a261373e
Branch: refs/heads/master
Commit: a261373ece19fbc8d319b01e4dfff22400cb479d
Parents: 4adf56c
Author: gautric <ga...@redhat.com>
Authored: Wed Dec 9 22:35:14 2015 +0100
Committer: Claus Ibsen <da...@apache.org>
Committed: Thu Dec 10 07:44:57 2015 +0100
----------------------------------------------------------------------
README.md | 126 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
README.txt | 10 +++++
2 files changed, 136 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/a261373e/README.md
----------------------------------------------------------------------
diff --git a/README.md b/README.md
new file mode 100755
index 0000000..72a71d2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,126 @@
+# Welcome to Apache Camel
+
+[Apache Camel](http://camel.apache.org/) is a powerful open source integration framework based on known
+Enterprise Integration Patterns with powerful Bean Integration.
+
+### Introduction
+
+Camel lets you create the Enterprise Integration Patterns to implement routing
+and mediation rules in either a Java based Domain Specific Language (or Fluent API),
+via Spring or Blueprint based Xml Configuration files, or via the Scala DSL.
+This means you get smart completion of routing rules in your IDE whether
+in your Java, Scala or XML editor.
+
+Apache Camel uses URIs so that it can easily work directly with any kind of
+transport or messaging model such as HTTP, ActiveMQ, JMS, JBI, SCA, MINA
+or CXF together with working with pluggable Data Format options.
+Apache Camel is a small library which has minimal dependencies for easy embedding
+in any Java application. Apache Camel lets you work with the same API regardless
+which kind of transport used, so learn the API once and you will be able to
+interact with all the Components that is provided out-of-the-box.
+
+Apache Camel has powerful Bean Binding and integrated seamless with
+popular frameworks such as Spring, Blueprint and Guice.
+
+Apache Camel has extensive testing support allowing you to easily
+unit test your routes.
+
+Apache Camel can be used as a routing and mediation engine for the
+following projects:
+
+* Apache ServiceMix which is the most popular and powerful distributed open source ESB, JBI and OSGi container
+* Apache ActiveMQ which is the most popular and powerful open source message broker
+* Apache CXF which is a smart web services suite (JAX-WS and JAX-RS)
+* Apache Karaf which is a small OSGi based runtime which applications can be deployed
+* Apache MINA a networking framework
+
+
+## Getting Started
+
+To help you get started, try the following links:
+
+**Getting Started**
+
+<http://camel.apache.org/getting-started.html>
+
+**Building**
+
+<http://camel.apache.org/building.html>
+
+**Contributions**
+
+We welcome contributions of all kinds, for details of how you can help
+
+<http://camel.apache.org/contributing.html>
+
+Please refer to the website for details of finding the issue tracker,
+email lists, wiki or IRC channel
+
+Wiki: <http://camel.apache.org/>
+
+IRC: <http://camel.apache.org/irc-room.html>
+
+Mailing list: <http://camel.apache.org/mailing-lists.html>
+
+**Support**
+
+If you need support or help then read this page first
+
+<http://camel.apache.org/support.html>
+
+**Forum**
+
+If you hit any problems please talk to us on the Camel Forums
+
+<http://camel.apache.org/discussion-forums.html>
+
+Please help us make Apache Camel better - we appreciate any feedback
+you may have.
+
+Enjoy!
+
+-----------------
+The Camel riders!
+
+# Licensing
+
+This software is licensed under the terms you may find in the file
+named `LICENSE.txt` in this directory.
+
+This distribution includes cryptographic software. The country in
+which you currently reside may have restrictions on the import,
+possession, use, and/or re-export to another country, of
+encryption software. BEFORE using any encryption software, please
+check your country's laws, regulations and policies concerning the
+import, possession, or use, and re-export of encryption software, to
+see if this is permitted. See <http://www.wassenaar.org/> for more
+information.
+
+The U.S. Government Department of Commerce, Bureau of Industry and
+Security (BIS), has classified this software as Export Commodity
+Control Number (ECCN) 5D002.C.1, which includes information security
+software using or performing cryptographic functions with asymmetric
+algorithms. The form and manner of this Apache Software Foundation
+distribution makes it eligible for export under the License Exception
+ENC Technology Software Unrestricted (TSU) exception (see the BIS
+Export Administration Regulations, Section 740.13) for both object
+code and source code.
+
+The following provides more details on the included cryptographic
+software:
+
+* **camel-ahc** can be configured to use https
+* **camel-crypto** can be used for secure communications
+* **camel-cxf** can be configured for secure communications
+* **camel-ftp** can be configured for secure communications
+* **camel-gae** can be configured for secure communications
+* **camel-http** can be configured to use https
+* **camel-http4** can be configured to use https
+* **camel-jasypt** can be used for secure communications
+* **camel-jetty** can be configured to use https
+* **camel-mail** can be configured for secure communications
+* **camel-nagios** can be configured for secure communications
+* **camel-netty-http** can be configured to use https
+* **camel-netty4-http** can be configured to use https
+* **camel-undertow** can be configured to use https
+* **camel-xmlsecurity** can be configured for secure communications
http://git-wip-us.apache.org/repos/asf/camel/blob/a261373e/README.txt
----------------------------------------------------------------------
diff --git a/README.txt b/README.txt
index 7a600cb..8f43d0b 100755
--- a/README.txt
+++ b/README.txt
@@ -53,11 +53,21 @@ We welcome contributions of all kinds, for details of how you can help
Please refer to the website for details of finding the issue tracker,
email lists, wiki or IRC channel
+
+Wiki:
http://camel.apache.org/
+IRC:
+ http://camel.apache.org/irc-room.html
+
+Mailing list:
+ http://camel.apache.org/mailing-lists.html
+
+Support
If you need support or help then read this page first
http://camel.apache.org/support.html
+Forum
If you hit any problems please talk to us on the Camel Forums
http://camel.apache.org/discussion-forums.html
[10/16] camel git commit: CAMEL-9337 Add readme.txt to all examples
Posted by da...@apache.org.
CAMEL-9337 Add readme.txt to all examples
Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/bc2a393d
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/bc2a393d
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/bc2a393d
Branch: refs/heads/master
Commit: bc2a393db5ca005840a14fc61d9e580fa9e22b23
Parents: 6a018a9
Author: gautric <ga...@redhat.com>
Authored: Wed Dec 9 19:21:48 2015 +0100
Committer: Claus Ibsen <da...@apache.org>
Committed: Thu Dec 10 07:44:59 2015 +0100
----------------------------------------------------------------------
examples/camel-example-cxf-blueprint/README.md | 89 ++++++++++++++++++++
examples/camel-example-cxf-blueprint/README.txt | 77 -----------------
2 files changed, 89 insertions(+), 77 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/bc2a393d/examples/camel-example-cxf-blueprint/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-cxf-blueprint/README.md b/examples/camel-example-cxf-blueprint/README.md
new file mode 100644
index 0000000..21d907e
--- /dev/null
+++ b/examples/camel-example-cxf-blueprint/README.md
@@ -0,0 +1,89 @@
+# CXF OSGI Example using Blueprint
+
+### Introduction
+
+A simple example which receives web service calls (via a CXF consumer, using bean binding)
+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
+individual Jetty instances. Another advantage is that all provided services can now share
+the same port.
+
+### Build
+You will need to compile this example first:
+
+ mvn install
+
+### Run
+
+To run the example on Apache Karaf 2.3.1 or better
+
+#### Step 1: Laraf
+
+Launch the server
+
+ karaf / karaf.bat
+
+#### Step 2: Add features
+
+Add features required
+
+ features:chooseurl camel ${version}
+ features:install war
+ features:install cxf
+ features:install camel-jaxb
+ features:install camel-blueprint
+ features:install camel-cxf
+
+#### Step 3: Deploy
+Deploy the example
+
+ osgi:install -s mvn:org.apache.camel/camel-example-cxf-blueprint/${version}
+
+#### Step 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](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](http://localhost:8181/cxf/camel-example-cxf-blueprint/webservices/incident?wsdl)
+
+#### Step 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](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:
+
+ <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>cmueller@apache.org</email>
+ <phone>0049 69 1234567</phone>
+ </ns2:inputReportIncident>
+ </soap:Body>
+ </soap:Envelope>
+
+#### Step 6: Check the file system
+ Check the folder "target/inbox/" in the Karaf base directory to see that a message has arrived.
+
+### Documentation
+This example is described in more detail at [http://camel.apache.org/cxf-example-osgi-blueprint.html](http://camel.apache.org/cxf-example-osgi-blueprint.html)
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums
+ [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
+------------------------
+The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/bc2a393d/examples/camel-example-cxf-blueprint/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-cxf-blueprint/README.txt b/examples/camel-example-cxf-blueprint/README.txt
deleted file mode 100644
index a27746b..0000000
--- a/examples/camel-example-cxf-blueprint/README.txt
+++ /dev/null
@@ -1,77 +0,0 @@
-CXF OSGI Example using Blueprint
-================================
-
-A simple example which receives web service calls (via a CXF consumer, using bean binding)
-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
-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 Karaf 2.3.1 or better
-
-1) launch the server
- karaf / karaf.bat
-
-2) Add features required
- features:chooseurl camel ${version}
- features:install war
- features:install cxf
- features:install camel-jaxb
- features:install camel-blueprint
- features:install camel-cxf
-
-3) Deploy the example
- osgi:install -s mvn:org.apache.camel/camel-example-cxf-blueprint/${version}
-
-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:
-
- <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>cmueller@apache.org</email>
- <phone>0049 69 1234567</phone>
- </ns2:inputReportIncident>
- </soap:Body>
- </soap:Envelope>
-
-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 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
- http://camel.apache.org/discussion-forums.html
-
-Please help us make Apache Camel better - we appreciate any feedback you may
-have. Enjoy!
-
-------------------------
-The Camel Riders!
[03/16] camel git commit: CAMEL-9337 Add readme.txt to all examples
Posted by da...@apache.org.
CAMEL-9337 Add readme.txt to all examples
Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/d269666f
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/d269666f
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/d269666f
Branch: refs/heads/master
Commit: d269666faf65f531fcaf4947c68c4b2b256908df
Parents: 8569f2c
Author: gautric <ga...@redhat.com>
Authored: Wed Dec 9 19:06:46 2015 +0100
Committer: Claus Ibsen <da...@apache.org>
Committed: Thu Dec 10 07:44:58 2015 +0100
----------------------------------------------------------------------
examples/camel-example-aggregate/README.md | 8 +++--
examples/camel-example-bam/README.md | 12 ++++----
examples/camel-example-box-osgi/README.md | 7 +++--
examples/camel-example-cafe/README.md | 40 +++++++++++++++++++++++++
examples/camel-example-cafe/README.txt | 28 -----------------
5 files changed, 56 insertions(+), 39 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/d269666f/examples/camel-example-aggregate/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-aggregate/README.md b/examples/camel-example-aggregate/README.md
index 3ef3c65..8463c5c 100644
--- a/examples/camel-example-aggregate/README.md
+++ b/examples/camel-example-aggregate/README.md
@@ -21,14 +21,16 @@ The user can then enter more numbers to do another aggregation.
The example is run using Maven.
First compile the example by entering:
- mvn compile
+
+ mvn compile
### Run
To run the example type:
- mvn camel:run
-To stop the example hit Ctrl-C. If you restart it and resume entering numbers
+ mvn camel:run
+
+To stop the example hit `Ctrl-C`. If you restart it and resume entering numbers
you should see that it remembered previously entered values, as it
uses a persistent store.
http://git-wip-us.apache.org/repos/asf/camel/blob/d269666f/examples/camel-example-bam/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-bam/README.md b/examples/camel-example-bam/README.md
index 5bff285..ccf5c5d 100644
--- a/examples/camel-example-bam/README.md
+++ b/examples/camel-example-bam/README.md
@@ -14,25 +14,27 @@ with Camel.
### Build
You will need to compile this example first:
- mvn compile
+
+ mvn compile
For a background in BAM see
- http://camel.apache.org/bam.html
+ [http://camel.apache.org/bam.html](http://camel.apache.org/bam.html)
### Run
To run the example with Maven, type
- mvn camel:run
+
+ mvn camel:run
You can see the BAM activies defined in
- src/main/java/org/apache/camel/example/bam/MyActivites.java
+ `src/main/java/org/apache/camel/example/bam/MyActivites.java`
To stop the example hit ctrl + c
### Documentation
This example is documented at
- http://camel.apache.org/bam-example.html
+ [http://camel.apache.org/bam-example.html](http://camel.apache.org/bam-example.html)
### Forum, Help, etc
http://git-wip-us.apache.org/repos/asf/camel/blob/d269666f/examples/camel-example-box-osgi/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-box-osgi/README.md b/examples/camel-example-box-osgi/README.md
index 803af9d..f65c735 100644
--- a/examples/camel-example-box-osgi/README.md
+++ b/examples/camel-example-box-osgi/README.md
@@ -13,7 +13,8 @@ found in an `inbox` directory to a box.com account.
### Build
First you will need to compile the example:
- mvn install
+
+ mvn install
### Run
@@ -25,7 +26,7 @@ Launch karaf
#### Step 2
-Add features required
+Add features required into Karak
features:addUrl mvn:org.apache.camel.karaf/apache-camel/${version}/xml/features
features:install camel-spring
@@ -43,7 +44,7 @@ set to your box account credentials.
#### Step 4
-Deploy the example
+Deploy the example into Karak
osgi:install -s mvn:org.apache.camel/camel-example-box-osgi/${version}
http://git-wip-us.apache.org/repos/asf/camel/blob/d269666f/examples/camel-example-cafe/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-cafe/README.md b/examples/camel-example-cafe/README.md
new file mode 100644
index 0000000..61c81f3
--- /dev/null
+++ b/examples/camel-example-cafe/README.md
@@ -0,0 +1,40 @@
+# Cafe Example
+
+
+### Introduction
+
+This example shows how to work with splitter and aggregator to implement a Cafe demo.
+
+### Build
+
+You will need to compile this example first:
+
+ mvn compile
+
+### Run
+
+To run the example type
+
+ mvn camel:run
+
+You can see the routing rules by looking at the java code in the
+`src/main/java directory` and the Spring XML configuration lives in
+`src/main/resources/META-INF/spring`
+
+To stop the example hit `ctrl + c`
+
+### Documentation
+
+This example is documented at
+ [http://camel.apache.org/cafe-example.html](http://camel.apache.org/cafe-example.html)
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums
+ [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
+------------------------
+The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/d269666f/examples/camel-example-cafe/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-cafe/README.txt b/examples/camel-example-cafe/README.txt
deleted file mode 100644
index 205b834..0000000
--- a/examples/camel-example-cafe/README.txt
+++ /dev/null
@@ -1,28 +0,0 @@
-Cafe Example
-==============
-
-This example shows how to work with splitter and aggregator to implement a Cafe demo.
-
-You will need to compile this example first:
- mvn compile
-
-To run the example type
- mvn camel:run
-
-You can see the routing rules by looking at the java code in the
-src/main/java directory and the Spring XML configuration lives in
-src/main/resources/META-INF/spring
-
-To stop the example hit ctrl + c
-
-This example is documented at
- http://camel.apache.org/cafe-example.html
-
-If you hit any problems please talk to us on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-Please help us make Apache Camel better - we appreciate any feedback you
-may have. Enjoy!
-
-------------------------
-The Camel riders!
[05/16] camel git commit: CAMEL-9337 Add readme.txt to all examples
Posted by da...@apache.org.
CAMEL-9337 Add readme.txt to all examples
Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/5c34a315
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/5c34a315
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/5c34a315
Branch: refs/heads/master
Commit: 5c34a3154c1e65b32e2eeda473c72863fc97dd54
Parents: 6f3e00c
Author: gautric <ga...@redhat.com>
Authored: Wed Dec 9 18:43:39 2015 +0100
Committer: Claus Ibsen <da...@apache.org>
Committed: Thu Dec 10 07:44:58 2015 +0100
----------------------------------------------------------------------
.../camel-example-activemq-tomcat/README.md | 12 +++--
examples/camel-example-aggregate/README.md | 49 ++++++++++++++++++++
examples/camel-example-aggregate/README.txt | 33 -------------
3 files changed, 58 insertions(+), 36 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/5c34a315/examples/camel-example-activemq-tomcat/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-activemq-tomcat/README.md b/examples/camel-example-activemq-tomcat/README.md
index b2f7719..0739898 100644
--- a/examples/camel-example-activemq-tomcat/README.md
+++ b/examples/camel-example-activemq-tomcat/README.md
@@ -14,7 +14,9 @@ This example shows how you can embed Apache ActiveMQ Broker and Camel in a web a
You will need to build this example first:
mvn install
-
+
+## Run
+
Which will create a `.war` file in the target directly.
You can then deploy this `.war` file in any web container such as
@@ -25,12 +27,16 @@ which will continuously send a message per second to an inbox queue.
Then another Camel route will route messages from the inbox
to the outbox queue.
-This example is documented at
- [http://camel.apache.org/activemq-camel-tomcat.html](http://camel.apache.org/activemq-camel-tomcat.html)
+## Configuration
The ActiveMQ broker is configured in the `src/main/resources/broker.xml` file.
And the Camel application in the `src/main/resources/camel-context.xml` file.
+## Documentation
+
+This example is documented at
+ [http://camel.apache.org/activemq-camel-tomcat.html](http://camel.apache.org/activemq-camel-tomcat.html)
+
## Forum, Help, etc
If you hit an problems please let us know on the Camel Forums
http://git-wip-us.apache.org/repos/asf/camel/blob/5c34a315/examples/camel-example-aggregate/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-aggregate/README.md b/examples/camel-example-aggregate/README.md
new file mode 100644
index 0000000..1518d76
--- /dev/null
+++ b/examples/camel-example-aggregate/README.md
@@ -0,0 +1,49 @@
+# Camel Persistent Aggregate
+
+## Introduction
+
+This example shows how to use Camel Aggregator EIP which offers (since Camel 2.3)
+database persistence.
+
+It's an interactive example where you can type in some numbers which then are aggregated
+(summed, per this sample's aggregation strategy) whenever the user types STOP.
+The user can then enter more numbers to do another aggregation.
+
+### Camel component used in this example
+
+* camel-core
+* camel-hawtdb
+* camel-spring
+* camel-stream
+
+## Build
+
+The example is run using Maven.
+
+First compile the example by entering:
+ mvn compile
+
+## Run
+
+To run the example type:
+ mvn camel:run
+
+To stop the example hit Ctrl-C. If you restart it and resume entering numbers
+you should see that it remembered previously entered values, as it
+uses a persistent store.
+
+## Documentation
+
+This example is documented at
+ [http://camel.apache.org/aggregate-example.html](http://camel.apache.org/aggregate-example.html)
+
+## Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums
+ [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
+------------------------
+The Camel riders!
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/camel/blob/5c34a315/examples/camel-example-aggregate/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-aggregate/README.txt b/examples/camel-example-aggregate/README.txt
deleted file mode 100644
index 7b89bd6..0000000
--- a/examples/camel-example-aggregate/README.txt
+++ /dev/null
@@ -1,33 +0,0 @@
-Camel Persistent Aggregate
-==========================
-
-This example shows how to use Camel Aggregator EIP which offers (since Camel 2.3)
-database persistence.
-
-It's an interactive example where you can type in some numbers which then are aggregated
-(summed, per this sample's aggregation strategy) whenever the user types STOP.
-The user can then enter more numbers to do another aggregation.
-
-The example is run using Maven.
-
-First compile the example by entering:
- mvn compile
-
-To run the example type:
- mvn camel:run
-
-To stop the example hit Ctrl-C. If you restart it and resume entering numbers
-you should see that it remembered previously entered values, as it
-uses a persistent store.
-
-If you hit any problems please let us know on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-This example is documented at
- http://camel.apache.org/aggregate-example.html
-
-Please help us make Apache Camel better - we appreciate any feedback you may
-have. Enjoy!
-
-------------------------
-The Camel Riders!
[11/16] camel git commit: CAMEL-9337 Add readme.txt to all examples
Posted by da...@apache.org.
CAMEL-9337 Add readme.txt to all examples
Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/6a018a96
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/6a018a96
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/6a018a96
Branch: refs/heads/master
Commit: 6a018a9695e86389d5b91167b671968bfbe60626
Parents: d269666
Author: gautric <ga...@redhat.com>
Authored: Wed Dec 9 19:12:52 2015 +0100
Committer: Claus Ibsen <da...@apache.org>
Committed: Thu Dec 10 07:44:59 2015 +0100
----------------------------------------------------------------------
examples/camel-example-cdi/README.md | 39 +++++++++++++++++++++++
examples/camel-example-cdi/README.txt | 31 ------------------
examples/camel-example-console/README.md | 40 +++++++++++++++++++++++
examples/camel-example-console/README.txt | 31 ------------------
examples/camel-example-cxf/README.md | 44 ++++++++++++++++++++++++++
examples/camel-example-cxf/README.txt | 31 ------------------
6 files changed, 123 insertions(+), 93 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/6a018a96/examples/camel-example-cdi/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-cdi/README.md b/examples/camel-example-cdi/README.md
new file mode 100644
index 0000000..d5e64d7
--- /dev/null
+++ b/examples/camel-example-cdi/README.md
@@ -0,0 +1,39 @@
+# CDI Example
+
+### Introduction
+
+This example shows how to work with Camel using CDI to configure components,
+endpoints and beans.
+
+A timer triggers a Camel route to run every 5th second which creates a message that is logged to the console.
+
+### Build
+
+You will need to compile this example first:
+
+ mvn compile
+
+### Run
+
+To run the example type
+
+ mvn camel:run
+
+You can see the routing rules by looking at the java code in the
+ `src/main/java` directory
+
+ To stop the example hit `ctrl + c`
+
+When we launch the example using the camel maven plugin, a local CDI container
+is created and started.
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums
+ [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
+------------------------
+The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/6a018a96/examples/camel-example-cdi/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-cdi/README.txt b/examples/camel-example-cdi/README.txt
deleted file mode 100644
index d0978cc..0000000
--- a/examples/camel-example-cdi/README.txt
+++ /dev/null
@@ -1,31 +0,0 @@
-CDI Example
-===========
-
-This example shows how to work with Camel using CDI to configure components,
-endpoints and beans.
-
-A timer triggers a Camel route to run every 5th second which creates a message that is logged to the console.
-
-You will need to compile this example first:
- mvn compile
-
-To run the example type
- mvn camel:run
-
-You can see the routing rules by looking at the java code in the
- src/main/java directory
-
- To stop the example hit ctrl + c
-
-When we launch the example using the camel maven plugin, a local CDI container
-is created and started.
-
-If you hit any problems please talk to us on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-
-Please help us make Apache Camel better - we appreciate any feedback you
-may have. Enjoy!
-
-------------------------
-The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/6a018a96/examples/camel-example-console/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-console/README.md b/examples/camel-example-console/README.md
new file mode 100644
index 0000000..5d7a384
--- /dev/null
+++ b/examples/camel-example-console/README.md
@@ -0,0 +1,40 @@
+# Camel Console Example
+
+### Introduction
+
+This is a simple example that shows how to get started with Camel.
+
+### Build
+
+You will need to compile this example first:
+
+ mvn compile
+
+### Run
+
+To run the example type
+
+ mvn camel:run
+You can see the routing rules by looking at the XML in the directory:
+ `src/main/resources/META-INF/spring`
+
+To stop the example hit `ctrl + c`
+
+You can also run the example from your editor such as Eclipse, IDEA etc,
+by opening the org.apache.camel.example.console.CamelConsoleMain class
+and then right click, and chose run java application.
+
+### Documentation
+
+This example is documented at [http://camel.apache.org/console-example.html](http://camel.apache.org/console-example.html)
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums
+ [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
+------------------------
+The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/6a018a96/examples/camel-example-console/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-console/README.txt b/examples/camel-example-console/README.txt
deleted file mode 100644
index 7002036..0000000
--- a/examples/camel-example-console/README.txt
+++ /dev/null
@@ -1,31 +0,0 @@
-Console Example
-===============
-
-This is a simple example that shows how to get started with Camel.
-
-You will need to compile this example first:
- mvn compile
-
-To run the example type
- mvn camel:run
-
-You can see the routing rules by looking at the XML in the directory:
- src/main/resources/META-INF/spring
-
-To stop the example hit ctrl + c
-
-You can also run the example from your editor such as Eclipse, IDEA etc,
-by opening the org.apache.camel.example.console.CamelConsoleMain class
-and then right click, and chose run java application.
-
-This example is documented at
- http://camel.apache.org/console-example.html
-
-If you hit any problems please talk to us on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-Please help us make Apache Camel better - we appreciate any feedback you
-may have. Enjoy!
-
-------------------------
-The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/6a018a96/examples/camel-example-cxf/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-cxf/README.md b/examples/camel-example-cxf/README.md
new file mode 100644
index 0000000..3d9d57c
--- /dev/null
+++ b/examples/camel-example-cxf/README.md
@@ -0,0 +1,44 @@
+# Camel CXF Example
+
+### Introduction
+
+This example shows how to work with CXF and Camel.
+
+### Build
+
+You will need to compile this example first:
+
+ mvn compile
+
+### Run
+
+To run the example of routing between different transport type
+
+ mvn exec:java -PHttpToJMS
+
+To run the example of Camel transport type
+
+ mvn exec:java -PCamelTransport
+
+To run the example of using WebServiceProvider API
+
+ mvn exec:java -PWebServiceProvider
+
+To run the example of showing how to create CXF JAXRS endpoint
+
+ mvn exec:java -PJAXRS
+
+### Documentation
+
+This example is documented at [http://camel.apache.org/cxf-example.html](http://camel.apache.org/cxf-example.html)
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums
+ [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
+------------------------
+The Camel riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/6a018a96/examples/camel-example-cxf/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-cxf/README.txt b/examples/camel-example-cxf/README.txt
deleted file mode 100644
index 4fe01fb..0000000
--- a/examples/camel-example-cxf/README.txt
+++ /dev/null
@@ -1,31 +0,0 @@
-CXF Example
-===========
-
-This example shows how to work with CXF and Camel.
-
-You will need to compile this example first:
- mvn compile
-
-To run the example of routing between different transport type
- mvn exec:java -PHttpToJMS
-
-To run the example of Camel transport type
- mvn exec:java -PCamelTransport
-
-To run the example of using WebServiceProvider API
- mvn exec:java -PWebServiceProvider
-
-To run the example of showing how to create CXF JAXRS endpoint
- mvn exec:java -PJAXRS
-
-This example is documented at
- http://camel.apache.org/cxf-example.html
-
-If you hit any problems please let us know on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-Please help us make Apache Camel better - we appreciate any feedback you may
-have. Enjoy!
-
-------------------------
-The Camel Riders!
[08/16] camel git commit: CAMEL-9337 Add readme.txt to all examples
Posted by da...@apache.org.
CAMEL-9337 Add readme.txt to all examples
Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/403089fa
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/403089fa
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/403089fa
Branch: refs/heads/master
Commit: 403089fae06608c3b0c71ca5c53159fce4ce4864
Parents: bc2a393
Author: gautric <ga...@redhat.com>
Authored: Wed Dec 9 19:27:30 2015 +0100
Committer: Claus Ibsen <da...@apache.org>
Committed: Thu Dec 10 07:44:59 2015 +0100
----------------------------------------------------------------------
examples/camel-example-cxf-osgi/README.md | 110 +++++++++++++++++++++++
examples/camel-example-cxf-osgi/README.txt | 100 ---------------------
examples/camel-example-cxf-proxy/README.md | 63 +++++++++++++
examples/camel-example-cxf-proxy/README.txt | 55 ------------
4 files changed, 173 insertions(+), 155 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/403089fa/examples/camel-example-cxf-osgi/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-cxf-osgi/README.md b/examples/camel-example-cxf-osgi/README.md
new file mode 100644
index 0000000..383c254
--- /dev/null
+++ b/examples/camel-example-cxf-osgi/README.md
@@ -0,0 +1,110 @@
+# CXF OSGI Example
+================
+
+### Introduction
+
+A simple example which receives web service calls (via a CXF consumer, using bean binding)
+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
+individual Jetty instances. Another advantage is that all provided services can now share
+the same port.
+
+### Build
+
+You will need to compile the example first:
+
+ mvn install
+
+Remarks:
+- During the compilation phase, a unit test will be performed which simulates the
+ client calling the web service exposed by our camel/cxf route.
+- In Eclipse, I have used the following option when starting the junit test case. This option tells
+ CXF that it must use log4j : -Dorg.apache.cxf.Logger=org.apache.cxf.common.logging.Log4jLogger
+
+### Run
+
+To run the example on Apache ServiceMix 4.x or Apache Karaf 2.2.x
+
+#### Step 1: launch the server
+
+ karaf / karaf.bat
+
+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*.
+
+
+#### Step 2: Add features required
+
+ features:addUrl mvn:org.apache.camel.karaf/apache-camel/${version}/xml/features
+ features:install war
+ features:install cxf
+ features:install camel-spring
+ features:install camel-jaxb
+ features:install camel-cxf
+
+
+#### Step 3: Deploy the example
+ osgi:install -s mvn:org.apache.camel/camel-example-cxf-osgi/${version}
+
+#### Step 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](http://team.ops4j.org/wiki//display/paxweb/Pax+Web) for more information on PAX Web).
+
+ [http://localhost:8181/cxf/camel-example-cxf-osgi/webservices/incident?wsdl](http://localhost:8181/cxf/camel-example-cxf-osgi/webservices/incident?wsdl)
+
+
+#### Step 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-osgi/webservices/incident?wsdl
+Open the request 1 (under camel-example-cxf-osgi --> 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>cmueller@apache.org</email>
+ <phone>0049 69 1234567</phone>
+ </ns2:inputReportIncident>
+ </soap:Body>
+ </soap:Envelope>
+
+
+#### Step 6: Check the file system
+Check the folder `target/inbox/` in the Karaf base directory to see that a message has arrived.
+
+### Documentation
+
+This example is described in more detail at
+ [http://camel.apache.org/cxf-example-osgi.html](http://camel.apache.org/cxf-example-osgi.html)
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums
+ [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
+------------------------
+The Camel riders!
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/camel/blob/403089fa/examples/camel-example-cxf-osgi/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-cxf-osgi/README.txt b/examples/camel-example-cxf-osgi/README.txt
deleted file mode 100644
index fb49213..0000000
--- a/examples/camel-example-cxf-osgi/README.txt
+++ /dev/null
@@ -1,100 +0,0 @@
-CXF OSGI Example
-================
-
-A simple example which receives web service calls (via a CXF consumer, using bean binding)
-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
-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
-
-Remarks:
-- During the compilation phase, a unit test will be performed which simulates the
- client calling the web service exposed by our camel/cxf route.
-- In Eclipse, I have used the following option when starting the junit test case. This option tells
- CXF that it must use log4j : -Dorg.apache.cxf.Logger=org.apache.cxf.common.logging.Log4jLogger
-
-To run the example on Apache ServiceMix 4.x or Apache Karaf 2.2.x
-
-1) launch the server
-karaf.bat
-
-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/${version}/xml/features
-features:install war
-features:install cxf
-features:install camel-spring
-features:install camel-jaxb
-features:install camel-cxf
-
-
-3) Deploy the example
-osgi:install -s mvn:org.apache.camel/camel-example-cxf-osgi/${version}
-
-
-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-osgi/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-osgi/webservices/incident?wsdl
-Open the request 1 (under camel-example-cxf-osgi --> 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>cmueller@apache.org</email>
- <phone>0049 69 1234567</phone>
- </ns2:inputReportIncident>
- </soap:Body>
-</soap:Envelope>
-
-
-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 described in more detail at
- http://camel.apache.org/cxf-example-osgi.html
-
-If you hit any problems please let us know on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-Please help us make Apache Camel better - we appreciate any feedback you may
-have. Enjoy!
-
-------------------------
-The Camel Riders!
http://git-wip-us.apache.org/repos/asf/camel/blob/403089fa/examples/camel-example-cxf-proxy/README.md
----------------------------------------------------------------------
diff --git a/examples/camel-example-cxf-proxy/README.md b/examples/camel-example-cxf-proxy/README.md
new file mode 100644
index 0000000..e1c9f37
--- /dev/null
+++ b/examples/camel-example-cxf-proxy/README.md
@@ -0,0 +1,63 @@
+# CXF WebService Proxy example
+
+### Introduction
+
+An example which proxies a real web service by a Camel application using the camel-cxf component
+
+### Build
+You will need to compile this example first:
+
+ mvn compile
+
+### Run
+
+To run the example type:
+
+ mvn camel:run
+
+The proxied webservice is located at
+
+ [http://localhost:<port 1>/camel-example-cxf-proxy/webservices/incident](http://localhost:<port 1>/camel-example-cxf-proxy/webservices/incident)
+
+The real webservice is located at
+ [http://localhost:<port 2>/real-webservice](http://localhost:<port 2>/real-webservice)
+
+The webservice WSDL is exposed at:
+ [http://localhost:<port 1>/camel-example-cxf-proxy/webservices/incident?wsdl](http://localhost:<port 1>/camel-example-cxf-proxy/webservices/incident?wsdl)
+
+Because we use dynamic port numbers, you have to check the console to get the used one.
+To stop the example hit `ctrl + c`
+
+To make a SOAP call open soapUI or another SOAP query tool and create a new
+project w/WSDL of [http://localhost:<port 1>/camel-example-cxf-proxy/webservices/incident?wsdl](http://localhost:<port 1>/camel-example-cxf-proxy/webservices/incident?wsdl).
+Then make SOAP requests of this format:
+
+ <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
+ xmlns:rep="http://reportincident.example.camel.apache.org">
+ <soapenv:Header/>
+ <soapenv:Body>
+ <rep:inputReportIncident>
+ <incidentId></incidentId>
+ <incidentDate>2011-11-18</incidentDate>
+ <givenName>Bob</givenName>
+ <familyName>Smith</familyName>
+ <summary>Bla bla</summary>
+ <details>More bla</details>
+ <email>your@email.org</email>
+ <phone>12345678</phone>
+ </rep:inputReportIncident>
+ </soapenv:Body>
+ </soapenv:Envelope>
+
+This example is documented at [http://camel.apache.org/cxf-proxy-example.html](http://camel.apache.org/cxf-proxy-example.html)
+
+### Forum, Help, etc
+
+If you hit an problems please let us know on the Camel Forums
+ [http://camel.apache.org/discussion-forums.html](http://camel.apache.org/discussion-forums.html)
+
+Please help us make Apache Camel better - we appreciate any feedback you may
+have. Enjoy!
+
+------------------------
+The Camel riders!
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/camel/blob/403089fa/examples/camel-example-cxf-proxy/README.txt
----------------------------------------------------------------------
diff --git a/examples/camel-example-cxf-proxy/README.txt b/examples/camel-example-cxf-proxy/README.txt
deleted file mode 100644
index bdee92f..0000000
--- a/examples/camel-example-cxf-proxy/README.txt
+++ /dev/null
@@ -1,55 +0,0 @@
-CXF WebService Proxy example
-============================
-
-An example which proxies a real web service by a Camel application using the camel-cxf component
-
-You will need to compile this example first:
- mvn compile
-
-To run the example type:
- mvn camel:run
-
-The proxied webservice is located at
- http://localhost:<port 1>/camel-example-cxf-proxy/webservices/incident
-
-The real webservice is located at
- http://localhost:<port 2>/real-webservice
-
-The webservice WSDL is exposed at:
- http://localhost:<port 1>/camel-example-cxf-proxy/webservices/incident?wsdl
-
-Because we use dynamic port numbers, you have to check the console to get the used one.
-To stop the example hit ctrl + c
-
-To make a SOAP call open soapUI or another SOAP query tool and create a new
-project w/WSDL of http://localhost:<port 1>/camel-example-cxf-proxy/webservices/incident?wsdl.
-Then make SOAP requests of this format:
-
-<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
- xmlns:rep="http://reportincident.example.camel.apache.org">
- <soapenv:Header/>
- <soapenv:Body>
- <rep:inputReportIncident>
- <incidentId></incidentId>
- <incidentDate>2011-11-18</incidentDate>
- <givenName>Bob</givenName>
- <familyName>Smith</familyName>
- <summary>Bla bla</summary>
- <details>More bla</details>
- <email>davsclaus@apache.org</email>
- <phone>12345678</phone>
- </rep:inputReportIncident>
- </soapenv:Body>
-</soapenv:Envelope>
-
-This example is documented at
- http://camel.apache.org/cxf-proxy-example.html
-
-If you hit any problems please let us know on the Camel Forums
- http://camel.apache.org/discussion-forums.html
-
-Please help us make Apache Camel better - we appreciate any feedback you may
-have. Enjoy!
-
-------------------------
-The Camel Riders!