XML-RPC Service uses the standard XML-RPC protocol to access remote calculations. The XML for the request is automatically generated from the provided attributes and arguments, and the response is parsed to unwrap the result of service call.

This manual will give you a walk-through on how to use XML-RPC services.


Example #1

In this example we want to calculate the number of specified atoms (e.g. C or O) in a SMILES string. The example service will call the following PHP code:

class TestService {
public function countAtoms($smiles, $atom) {
$count = 0;
$lastIndex = strpos($smiles, $atom);
while($lastIndex !== false) {
if($lastIndex + 2 < strlen($smiles)) {
$next = substr($smiles, $lastIndex + 1, 1);
if(ctype_alpha($next) && $next === strtolower($next)) {
$count--; //not counting
$lastIndex = strpos($smiles, $atom, $lastIndex + 1);
return $count;

The actual window of setting looks like this:


Fig. 1 Settings of the Preferences window to set up the service

We put here 2 running examples of calculating the number of C and O atoms in a SMILES string.


Fig. 2 Examples of calculating specified atoms in SMILES strings

Calling XML-RPC Services from API

Here is an API example of calling XML-RPC services:

 XMLRPCServiceDescriptor descriptor = new XMLRPCServiceDescriptor();
Object result = null;
try {
result = descriptor.getServiceHandler().callService(descriptor, "C1CCNCCC1", "C");
} catch (ServiceException e) {
System.err.println("Service call failed.");
System.out.println("Synchronized call returned: " + String.valueOf(result));
descriptor.getServiceHandler().callService(descriptor, new AsyncCallback<Integer>() {
public void onSuccess(Integer result) {
System.out.println("Asynchronous call returned: " + result);
public void onFailure(ServiceException caught) {
System.err.println("Asynchronous call failed.");
}, "C1CCNCCC1", "C");