This documentation is for WSO2 ESB version 4.5.0. View documentation for the latest release.

URLRewrite Mediator

Owned by Former user (Deleted)
Last updated: Jul 06, 2012Version comment
2 min read

The URLRewrite Mediator (New in version 4.0) is used to modify and transform the URL values available in the message.

UI Configuration

Specify the following properties:

  • In Property - By default, the Rewrite Mediator will take the "To" header of the message and will apply the provided rewrite rules on it. If the user specifies an inPorperty attribute, the mediator will take the value of the specified property as the input URL.
  • Out Property - Similarly, the mediator by default sets the transformed URL as the "To" header of the message. Alternatively, users can use the outProperty attribute to instruct the mediator to set the resulting URL as a property.

The Rewrite Mediator applies URL transformations by evaluating a set of rules on the message. To add a rule to the mediator, click on the "Add Rule" link.

In the window which appears, specify the following options:

  • Condition - A rule can have an optional condition. If the condition is provided, it will be evaluated first.
  • Action - It states what type of an action should be executed on the URL. This defaults to "set" value.
  • Fragment - This attribute can be used to specify the URL fragment on which the action should be executed.
  • Option
  • Value/Expression - The values "set," "append" or "prepend" must be specified using either the "value" attribute or the XPath attribute. One of these two attributes is always needed unless the value of the "type" attribute is set to "remove."
  • Regex - When users set action to "replace," an additional "regex" attribute must be specified, which indicates the portion that should be replaced with the given value.
  • Delete - Allows to remove the action.

Example

<rewrite>
	<rewriterule>
		<action type="replace" regex="soap" value="services" fragment="path" />
	</rewriterule>
</rewrite>

For instance, if our request is as follows:

"ant stockquote -Daddurl=http://localhost:8280/services/StockQuoteProxy1"

The address URL of the request contains the context "soap." In the ESB server, all the services are deployed under a context named "services" by default. So, the "To" header will be re-written by replacing the "soap" context with "services." Hence, the requests will be delivered to the server successfully.