examples/camel-example-servlet-rest-blueprint/README.md

# Camel Servlet REST and OSGi Blueprint example
=============================================

### Introduction
This example shows how to use Servlet REST to define REST endpoints in Camel routes using the Rest DSL


### Build
You will need to compile this example first:

	mvn install


### run
To install Apache Camel in Karaf you type in the shell (we use version ${project.version}):

	features:chooseurl camel ${project.version}
	features:install camel

First you need to install the following features in Karaf/ServiceMix with:

	features:install camel-servlet
	features:install camel-jackson
	features:install war

Then you can install the Camel example:

	osgi:install -s mvn:org.apache.camel/camel-example-servlet-rest-blueprint/${project.version}

And you can see the application running by tailing the logs

	log:tail

And you can use <kbd>ctrl</kbd>+<kbd>c</kbd> to stop tailing the log.

There is a user REST service that supports the following operations

 - GET /user/{id} - to view a user with the given id </li>
 - GET /user/final - to view all users</li>
 - PUT /user - to update/create an user</li>

The view operations are HTTP GET, and update is using HTTP PUT.

From a web browser you can access the first two services using the following links

      http://localhost:8181/camel-example-servlet-rest-blueprint/rest/user/123    - to view the user with id 123
      http://localhost:8181/camel-example-servlet-rest-blueprint/rest/user/findAll   - to list all users

From the command shell you can use curl to access the service as shown below:

    curl -X GET -H "Accept: application/json" http://localhost:8181/camel-example-servlet-rest-blueprint/rest/user/123
    curl -X GET -H "Accept: application/json" http://localhost:8181/camel-example-servlet-rest-blueprint/rest/user/findAll
    curl -X PUT -d "{ \"id\": 666, \"name\": \"The devil\"}" -H "Accept: application/json" http://localhost:8181/camel-example-servlet-rest-blueprint/rest/user


### Configuration
This example is implemented in XML DSL in the `src/main/resources/OSGI-INF/bluepring/camel.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>

Please help us make Apache Camel better - we appreciate any feedback you may
have.  Enjoy!