Available as of Camel 2.11
The camel-urlrewrite component allows to plugin url rewrite functionality to HTTP, HTTP4, Jetty, or AHC components. This component integrates the UrlRewriteFilter project with Apache Camel. This allows you to use the capabilities from the url rewrite project with your Camel routes.
The camel-urlrewrite component offers the following options
You setup the url rewrite as a bean of the type org.apache.camel.component.urlrewrite.http.HttpUrlRewrite (when using HTTP component) as shown below:
And in XML DSL you can do:
In the bean above we configure it with the configFile option which is a XML UrlRewriteFilter configuration file.
In the Camel routes, you bridge the endpoints, and refer to the url rewrite on the producer endpoint as shown below. Notice how we refer to our url rewrite filter using the urlRewrite option in the endpoint uri.
You can also use Camel's Load Balancer together with UrlRewrite, as shown below. In this code we use the failover load balancer, to failover to the 2nd endpoint (which goes to myapp3) in case of any exception thrown.
The UrlRewriteFilter project also supports Apache mod_rewrite style configuration.
For example to configure the bean using the modRewriteConfFile property to refer to a mod configuration file:
Which then can contain mod rewrite rules and the likes:
You can have multiple RewriteRule rules and other configurations. See more details at UrlRewriteFilter project.
You can implement your custom url rewriters by implementing either of the following interfaces from the component of choice:
Component(s): camel-http / camel-jetty
The former is a simple and generic interface, which is not dependent on the Servlet API.
In this example we implement a custom org.apache.camel.component.http.UrlRewrite that just replaces yahoo with google. Mind this example is based on a unit test, and only for demonstration purposes. As its java code you have full power to implement more complex logic.
The url parameter contains the full url including scheme://hostname:port/path?query. The relativeUrl parameter is the url without the endpoint configured path. Notice this option may be null if the url doesn't start with the endpoint configured path.