XmlRpc Component

Available as of Camel 2.11

This component provides a dataformat for xml, which allows serialization and deserialization of request messages and response message using Apache XmlRpc's binary dataformat. You can also invoke the XMLRPC Service through the camel-xmlrpc producer.

Maven users will need to add the following dependency to their pom.xml for this component:

XmlRpc Overview

It's a spec and a set of implementations that allow software running on disparate operating systems, running in different environments to make procedure calls over the Internet.

It's remote procedure calling using HTTP as the transport and XML as the encoding. XML-RPC is designed to be as simple as possible, while allowing complex data structures to be transmitted, processed and returned.

An example of a typical XML-RPC request would be:

An example of a typical XML-RPC response would be:

A typical XML-RPC fault would be:

URI format

Options

Property

Default

Description

basicEncoding

null

Sets the encoding for basic authentication, null means UTF-8 is chosen.

basicUserName

null

The user name for basic authentication.

basicPassword

null

The password for basic authentication.

clientConfigurer

null

The reference id of the XmlRpcClient configurer which implement the interface of XmlRpcClientConfigurer to setup the XmlRpcClient as user wants. The value should be start with "#" such as "#myConfigurer"

connectionTimeout

0

Set the connection timeout in milliseconds, 0 is to disable it

contentLengthOptional

false

whether a "Content-Length" header may be omitted. The XML-RPC specification demands, that such a header be present.

enabledForExceptions

false

whether the response should contain a "faultCause" element in case of errors. The "faultCause" is an exception, which the server has trapped and written into a byte stream as a serializable object.

enabledForExtensions

false

whether extensions are enabled. By default, the client or server is strictly compliant to the XML-RPC specification and extensions are disabled.

encoding

null

Sets the requests encoding, null means UTF-8 is chosen.

gzipCompressing

false

Whether gzip compression is being used for transmitting the request.

gzipRequesting

false

Whether gzip compression is being used for transmitting the request.

replyTimeout

0

Set the reply timeout in milliseconds, 0 is to disable it.

userAgent

null

The http user agent header to set when doing xmlrpc requests

Message Headers

Camel XmlRpc uses these headers.

Header

Description

CamelXmlRpcMethodName

The XmlRpc method name which will be use for invoking the XmlRpc server.

Using the XmlRpc data format

As the XmlRpc message could be request or response, when you use the XmlRpcDataFormat, you need to specify the dataformat is for request or not.

Invoke XmlRpc Service from Client

To invoke the XmlRpc service, you need to specify the methodName on the message header and put the parameters into the message body like below code, then you can get the result message as you want. If the fault message is return, you should get an exception which cause if XmlRpcException.

How to configure the XmlRpcClient with Java code

camel-xmlrpc provides a pluggable strategy for configuring the XmlRpcClient used by the component, user just to implement the XmlRpcClientConfigurer interface and can configure the XmlRpcClient as he wants. The clientConfigure instance reference can be set through the uri option clientConfigure.

© 2004-2014 The Apache Software Foundation.
Apache Camel, Camel, Apache, the Apache feather logo, and the Apache Camel project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
Graphic Design By Hiram